Trader Analytics

Get a trader's recent trade/fill history

Returns a paginated page of a wallet's fills, served independently of the full profile as the fast path for the History tab. Reads only trade rows (plus market-title enrichment) — it deliberately skips the heavier positions/inventory and PnL-summary computations used by the full profile build. Each trade carries the realized PnL booked by that fill (populated for SELLs; BUYs report null/0). Public endpoint — no authentication required (trader data is public). Rate-limited per client IP at 60 requests/minute. Responses are cacheable at the edge.

get/trader-stats/trades/{wallet_address}

Request

Base URL
https://data.kairos.trade
Auth
none required

Path parameters

wallet_addressstring required

Ethereum or Solana wallet address (validated/normalized as above).

Query parameters

trade_limitinteger

Max trades to fetch per page.

trade_offsetinteger

Offset for trade pagination.

providerstring

Provider override (polymarket, kalshi, opinion, predictfun). Auto-detected if omitted.

Response

Page of the wallet's trade history.

wallet_addressstring required

has_moreboolean

Example response

{
  "wallet_address": "0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b",
  "trades": [
    {
      "trade_id": "trd_9f2c3a1b",
      "order_id": "0x9f2a1c...7bd4",
      "market_id": "0xabc123condition",
      "market_name": "Will the Fed cut rates in September?",
      "icon": "https://cdn.kairos.trade/markets/abc123.png",
      "token_id": "10723948572...4",
      "outcome": "YES",
      "size": "25.0",
      "price": "0.47",
      "timestamp": "2026-07-20T09:14:02Z",
      "tx_hash": "0xfeedface...beef",
      "realized_pnl": "3.75",
      "provider": "polymarket"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.