> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aioka.io/llms.txt
> Use this file to discover all available pages before exploring further.
# TAO Ghost Trader Track Record
> Full validated TAO trade history with derived performance stats and paper validation progress
Public endpoint -- no API key required. Powers the TAO tab on
aioka.io/track-record. (Sprint TAO -- third multi-asset expansion after ETH and SOL.)
**Tier:** Public
**Cache:** None
**Read-only:** No writes.
⚠️ **Paper-trading data.** AIOKA TAO Ghost Trader is a simulation and
never places real orders until 10 validated paper trades have been
completed. The `stats.validatedPaperTrades` field tracks progress toward
this milestone.
## Response Fields
TAO track record mirrors the SOL schema but adds three TAO-specific per-trade
audit fields: `liquidityAtEntry`, `daysSinceHalving`, and `isPaper`. The stats
block also exposes the paper validation gate progress via `validatedPaperTrades`
and `paperValidationTarget`.
### Top-level
| Field | Type | Meaning |
| ----------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------- |
| `trades` | array | Closed validated TAO trades, oldest first |
| `stats.totalTrades` | int | Count of closed validated trades |
| `stats.validatedPaperTrades` | int | **TAO-specific.** Count of validated paper trades closed (0 -- 10). Milestone: at 10, live capital gates open for K-1 sign-off. |
| `stats.paperValidationTarget` | int | Always `10` -- the milestone before live trading. |
| `stats.winRate` | number | % of trades with `pnlUsd > 0` |
| `stats.totalPnl` | number | Cumulative USD P\&L |
| `stats.avgHoldMinutes` | number | Average hold duration in minutes |
| `stats.bestTrade` | number | Best single-trade P\&L (USD) |
| `stats.worstTrade` | number | Worst single-trade P\&L (USD) |
### Per-trade
| Field | Type | Meaning |
| -------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------ |
| `id` | string | UUID |
| `entryTime` / `exitTime` | string | ISO 8601 |
| `entryPrice` / `exitPrice` | number | USD |
| `sizeTao` | number | Position size in TAO |
| `pnlUsd` | number | Total P\&L (entry-to-exit, includes TP1 partial when applicable) |
| `pnlPct` | number | P\&L as % of position cost |
| `tp1PnlUsd` | number \| null | TP1 partial P\&L when TP1 fired |
| `liquidityAtEntry` | number \| null | **TAO-specific.** Kraken order-book depth (USD) at the moment of entry -- audit field for Gate 0 compliance. |
| `daysSinceHalving` | int \| null | **TAO-specific.** Days since the 2025-12-01 TAO emission halving at entry time -- cycle-position audit. |
| `isPaper` | bool | `true` for all paper trades. Becomes `false` after live capital is enabled. |
| `result` | string | `"WIN"` / `"LOSS"` |
| `mode` | string | Entry mode (`A` / `B` / `C`) |
```bash curl theme={null}
curl https://api.aioka.io/v1/tao/track-record
```
```json 200 theme={null}
{
"trades": [],
"stats": {
"totalTrades": 0,
"validatedPaperTrades": 0,
"paperValidationTarget": 10,
"winRate": 0.0,
"totalPnl": 0.0,
"avgHoldMinutes": 0.0,
"bestTrade": 0.0,
"worstTrade": 0.0
}
}
```
## Track Record Restart
TAO track record begins at the first TAO trade close -- the trades array is
empty until the first validated TAO paper trade lands. Per the TAO paper-mode
rule (TAO\_PAPER\_MODE), 10 validated paper trades must complete before TAO can
graduate to live Kraken capital.
The `validatedPaperTrades` / `paperValidationTarget` fields provide a
real-time view of this milestone. When `validatedPaperTrades` reaches 10,
an explicit K-1 sign-off sprint activates live trading with Kraken.
## OpenAPI
````yaml GET /v1/tao/track-record
openapi: 3.1.0
info:
title: AIOKA Intelligence API
description: |
## AI-powered crypto market intelligence
AIOKA Intelligence API provides real-time access to our AI Council verdicts,
market signals, regime detection, and Ghost Trader entry signals.
### Tiers
- **Free**: 100 calls/day — Verdict + Regime
- **Basic** ($49/mo): 1,000 calls/day — + Signals
- **Pro** ($199/mo): 10,000 calls/day — + Council + Ghost
### Authentication
Pass your API key in the `X-API-Key` header:
```
X-API-Key: aik_free_xxxxxxxxxxxx
```
### Get your API key
`POST /v1/keys/generate` (free tier, no credit card)
contact:
name: AIOKA Support
url: https://docs.aioka.io/
email: api@aioka.io
license:
name: Commercial
url: https://aioka.io/terms
version: 1.0.0
servers:
- url: https://api.aioka.io
description: Production — AIOKA Intelligence API
security: []
paths:
/v1/tao/track-record:
get:
tags:
- TAO Ghost Trader
summary: TAO Ghost Trader Track Record
description: |-
Returns the full TAO trade history with derived performance stats
(total trades, validated paper trades X/10, win rate, total PnL,
avg hold time, best/worst trade).
Paper-trading data. AIOKA TAO Ghost Trader runs in paper mode until
10 validated paper trades have closed. Live trading remains gated
behind an explicit follow-up sprint with K-1 verification.
**Tier:** Free (no auth)
**Cache:** None
**Use:** aioka.io/track-record TAO tab
operationId: get_tao_track_record_v1_tao_track_record_get
responses:
'200':
description: TAO trade history
content:
application/json:
schema:
$ref: '#/components/schemas/TAOTrackRecordResponse'
security: []
components:
schemas:
TAOTrackRecordResponse:
properties:
trades:
items:
$ref: '#/components/schemas/TAOTrackRecordTrade'
type: array
title: Trades
stats:
$ref: '#/components/schemas/TAOTrackRecordStats'
type: object
required:
- trades
- stats
title: TAOTrackRecordResponse
example:
stats:
avgHoldMinutes: 0
bestTrade: 0
paperValidationTarget: 10
totalPnl: 0
totalTrades: 0
validatedPaperTrades: 0
winRate: 0
worstTrade: 0
trades: []
TAOTrackRecordTrade:
properties:
id:
type: string
title: Id
entryTime:
type: string
title: Entrytime
exitTime:
type: string
title: Exittime
entryPrice:
type: number
title: Entryprice
exitPrice:
type: number
title: Exitprice
sizeTao:
type: number
title: Sizetao
pnlUsd:
type: number
title: Pnlusd
pnlPct:
type: number
title: Pnlpct
tp1PnlUsd:
anyOf:
- type: number
- type: 'null'
title: Tp1Pnlusd
liquidityAtEntry:
anyOf:
- type: number
- type: 'null'
title: Liquidityatentry
daysSinceHalving:
anyOf:
- type: integer
- type: 'null'
title: Dayssincehalving
isPaper:
type: boolean
title: Ispaper
default: true
result:
type: string
title: Result
mode:
type: string
title: Mode
type: object
required:
- id
- entryTime
- exitTime
- entryPrice
- exitPrice
- sizeTao
- pnlUsd
- pnlPct
- result
- mode
title: TAOTrackRecordTrade
TAOTrackRecordStats:
properties:
totalTrades:
type: integer
title: Totaltrades
validatedPaperTrades:
type: integer
title: Validatedpapertrades
paperValidationTarget:
type: integer
title: Papervalidationtarget
default: 10
winRate:
type: number
title: Winrate
totalPnl:
type: number
title: Totalpnl
avgHoldMinutes:
type: number
title: Avgholdminutes
bestTrade:
type: number
title: Besttrade
worstTrade:
type: number
title: Worsttrade
type: object
required:
- totalTrades
- validatedPaperTrades
- winRate
- totalPnl
- avgHoldMinutes
- bestTrade
- worstTrade
title: TAOTrackRecordStats
````