> ## 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.

# ETH Ghost Trader Track Record

> Full validated ETH trade history with derived performance stats

<Note>
  Public endpoint — no API key required. Powers the ETH tab on
  aioka.io/track-record. (Sprint 258 — first multi-asset expansion after BTC.)
</Note>

**Tier:** Public ✅
**Cache:** None
**Read-only:** No writes.

⚠️ **Paper-trading data.** AIOKA ETH Ghost Trader is a simulation and
never places real orders.

## Response Fields

### Top-level

| Field                  | Type   | Meaning                                   |
| ---------------------- | ------ | ----------------------------------------- |
| `trades`               | array  | Closed validated ETH trades, oldest first |
| `stats.totalTrades`    | int    | Count of closed validated trades          |
| `stats.winRate`        | number | % of trades with `pnlUsd > 0`             |
| `stats.totalPnl`       | number | Cumulative USD P\&L                       |
| `stats.avgHoldMinutes` | number | Average hold duration                     |
| `stats.bestTrade`      | number | Best single-trade P\&L                    |
| `stats.worstTrade`     | number | Worst single-trade P\&L                   |

### Per-trade

| Field                      | Type           | Meaning                                                          |
| -------------------------- | -------------- | ---------------------------------------------------------------- |
| `id`                       | string         | UUID                                                             |
| `entryTime` / `exitTime`   | string         | ISO 8601                                                         |
| `entryPrice` / `exitPrice` | number         | USD                                                              |
| `sizeEth`                  | number         | Position size                                                    |
| `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                                  |
| `result`                   | string         | `"WIN"` / `"LOSS"`                                               |
| `mode`                     | string         | Entry mode (`A` / `B` / `C`)                                     |

<RequestExample>
  ```bash curl theme={null}
  curl https://api.aioka.io/v1/eth/track-record
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "trades": [],
    "stats": {
      "totalTrades": 0,
      "winRate": 0.0,
      "totalPnl": 0.0,
      "avgHoldMinutes": 0.0,
      "bestTrade": 0.0,
      "worstTrade": 0.0
    }
  }
  ```
</ResponseExample>

## Track Record Restart

ETH track record begins at first ETH trade close — the table is empty
until the first validated ETH trade lands. (BTC track record similarly
restarted on Apr 12 2026 per Sprint 164.1 clean slate.)


## OpenAPI

````yaml GET /v1/eth/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/eth/track-record:
    get:
      tags:
        - ETH Ghost Trader
      summary: ETH Ghost Trader Track Record
      description: |-
        Returns the full ETH trade history with derived performance stats
        (total trades, win rate, total PnL, avg hold time, best/worst trade).

        ⚠️ **Paper-trading data.** AIOKA ETH Ghost Trader is a simulation and
        never places real orders via this endpoint.

        **Tier:** Public ✅
        **Cache:** None
        **Use:** aioka.io/track-record ETH tab
      operationId: get_eth_track_record_v1_eth_track_record_get
      responses:
        '200':
          description: ETH trade history
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ETHTrackRecordResponse'
      security: []
components:
  schemas:
    ETHTrackRecordResponse:
      properties:
        trades:
          items:
            $ref: '#/components/schemas/ETHTrackRecordTrade'
          type: array
          title: Trades
        stats:
          $ref: '#/components/schemas/ETHTrackRecordStats'
      type: object
      required:
        - trades
        - stats
      title: ETHTrackRecordResponse
      example:
        stats:
          avgHoldMinutes: 0
          bestTrade: 0
          totalPnl: 0
          totalTrades: 0
          winRate: 0
          worstTrade: 0
        trades: []
    ETHTrackRecordTrade:
      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
        sizeEth:
          type: number
          title: Sizeeth
        pnlUsd:
          type: number
          title: Pnlusd
        pnlPct:
          type: number
          title: Pnlpct
        tp1PnlUsd:
          anyOf:
            - type: number
            - type: 'null'
          title: Tp1Pnlusd
        result:
          type: string
          title: Result
        mode:
          type: string
          title: Mode
      type: object
      required:
        - id
        - entryTime
        - exitTime
        - entryPrice
        - exitPrice
        - sizeEth
        - pnlUsd
        - pnlPct
        - result
        - mode
      title: ETHTrackRecordTrade
    ETHTrackRecordStats:
      properties:
        totalTrades:
          type: integer
          title: Totaltrades
        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
        - winRate
        - totalPnl
        - avgHoldMinutes
        - bestTrade
        - worstTrade
      title: ETHTrackRecordStats

````