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

# SOL Ghost Trader Track Record

> Full validated SOL trade history with derived performance stats

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

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

⚠️ **Paper-trading data.** AIOKA SOL Ghost Trader is a simulation and
never places real orders until 10 validated paper trades have been
completed.

## Response Fields

### Top-level

| Field                  | Type   | Meaning                                   |
| ---------------------- | ------ | ----------------------------------------- |
| `trades`               | array  | Closed validated SOL 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                                                                                         |
| `sizeSol`                  | number         | Position size in SOL                                                                        |
| `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                                                             |
| `networkHealthAtEntry`     | string         | **SOL-specific.** Solana network health label at entry (`HEALTHY` / `DEGRADED` / `UNKNOWN`) |
| `result`                   | string         | `"WIN"` / `"LOSS"`                                                                          |
| `mode`                     | string         | Entry mode (`A` / `B` / `C`)                                                                |

<RequestExample>
  ```bash curl theme={null}
  curl https://api.aioka.io/v1/sol/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

SOL track record begins at first SOL trade close -- the table is empty
until the first validated SOL trade lands. Per the SOL paper-mode rule
(SOL\_PAPER\_MODE, Sprint 183), 10 validated paper trades must complete
before SOL can graduate to live Kraken capital.


## OpenAPI

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

        Paper-trading data. AIOKA SOL Ghost Trader is a simulation and never
        places real orders via this endpoint until 10 validated paper trades
        have been completed.

        **Tier:** Public
        **Cache:** None
        **Use:** aioka.io/track-record SOL tab
      operationId: get_sol_track_record_v1_sol_track_record_get
      responses:
        '200':
          description: SOL trade history
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SOLTrackRecordResponse'
      security: []
components:
  schemas:
    SOLTrackRecordResponse:
      properties:
        trades:
          items:
            $ref: '#/components/schemas/SOLTrackRecordTrade'
          type: array
          title: Trades
        stats:
          $ref: '#/components/schemas/SOLTrackRecordStats'
      type: object
      required:
        - trades
        - stats
      title: SOLTrackRecordResponse
      example:
        stats:
          avgHoldMinutes: 0
          bestTrade: 0
          totalPnl: 0
          totalTrades: 0
          winRate: 0
          worstTrade: 0
        trades: []
    SOLTrackRecordTrade:
      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
        sizeSol:
          type: number
          title: Sizesol
        pnlUsd:
          type: number
          title: Pnlusd
        pnlPct:
          type: number
          title: Pnlpct
        tp1PnlUsd:
          anyOf:
            - type: number
            - type: 'null'
          title: Tp1Pnlusd
        networkHealthAtEntry:
          type: string
          title: Networkhealthatentry
          default: HEALTHY
        result:
          type: string
          title: Result
        mode:
          type: string
          title: Mode
      type: object
      required:
        - id
        - entryTime
        - exitTime
        - entryPrice
        - exitPrice
        - sizeSol
        - pnlUsd
        - pnlPct
        - result
        - mode
      title: SOLTrackRecordTrade
    SOLTrackRecordStats:
      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: SOLTrackRecordStats

````