Get outcome token stats

GET /api/v1/market-data/tokens/stats

Get outcome token stats

get

Returns outcome-level stats including time-bucketed price, volume, and collateral deltas (30m, 1h, 4h, 24h). Supports filtering by category, status, or specific market addresses.

Query parameters

limitintegerOptional

Page size (default 100, max 500)

offsetintegerOptional

Offset (default 0)

order_bystringOptional

Sort: volume, price, collateral, traders

Default: volume

ascendingbooleanOptional

Sort ascending (default false)

categorystringOptional

Filter by category name

category_idintegerOptional

Filter by category ID

statusstringOptional

Filter by status: live, ended, resolved, finalised, all

market_addressstringOptional

Filter by market address(es), comma-separated

Responses

200

OK

application/json

400

Bad Request

application/json

500

Internal Server Error

application/json

get

/api/v1/market-data/tokens/stats

HTTPcURLJavaScriptPython

GET /api/v1/market-data/tokens/stats HTTP/1.1
Host: rest.ft.42.space/
Accept: */*

{
  "data": [
    {
      "buyVolume": 1,
      "collateral": 1,
      "market": {
        "collateralDecimals": 1
      },
      "marketAddress": "text",
      "outcome": {
        "image": "text",
        "name": "text",
        "symbol": "text"
      },
      "payout": 1,
      "price": 1,
      "question": {
        "categoryId": 1,
        "description": "text",
        "endDate": "text",
        "image": "text",
        "title": "text"
      },
      "questionId": "text",
      "sellVolume": 1,
      "statsChanges": {
        "collateralChange1h": 1,
        "collateralChange24h": 1,
        "collateralChange30m": 1,
        "collateralChange4h": 1,
        "priceChange1h": 1,
        "priceChange24h": 1,
        "priceChange30m": 1,
        "priceChange4h": 1,
        "volumeChange1h": 1,
        "volumeChange24h": 1,
        "volumeChange30m": 1,
        "volumeChange4h": 1
      },
      "tokenId": "text",
      "totalVolume": 1,
      "traders": 1
    }
  ],
  "pagination": {
    "hasMore": true,
    "totalResults": 1
  }
}