---
title: "Get outcome token stats"
method: GET
path: "/api/v1/market-data/tokens/stats"
tags: ["get-outcome-token-stats"]
---

# Get outcome token stats

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

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

- `limit` integer
- `offset` integer
- `order_by` string
- `ascending` boolean
- `category` string
- `category_id` integer
- `status` string
- `market_address` string

## Response `200`

OK

- FtMarketServiceV2PkgApiPaginatedResponseInternalHandlerTokenStatsEntry
  - `data` InternalHandlerTokenStatsEntry[]
    - `buyVolume` number
    - `collateral` number
    - `market` InternalHandlerTokenStatsMarket
      - `collateralDecimals` integer
    - `marketAddress` string
    - `outcome` InternalHandlerTokenStatsOutcome
      - `image` string
      - `name` string
      - `symbol` string
    - `payout` number
    - `price` number
    - `question` InternalHandlerTokenStatsQuestion
      - `categoryId` integer
      - `description` string
      - `endDate` string
      - `image` string
      - `title` string
    - `questionId` string
    - `sellVolume` number
    - `statsChanges` InternalHandlerStatsChanges
      - `collateralChange1h` number
      - `collateralChange24h` number
      - `collateralChange30m` number
      - `collateralChange4h` number
      - `priceChange1h` number
      - `priceChange24h` number
      - `priceChange30m` number
      - `priceChange4h` number
      - `volumeChange1h` number
      - `volumeChange24h` number
      - `volumeChange30m` number
      - `volumeChange4h` number
    - `tokenId` string
    - `totalVolume` number
    - `traders` integer
  - `pagination` FtMarketServiceV2PkgApiPagination
    - `hasMore` boolean
    - `totalResults` integer

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.dev/42/apis/fortytwo-read-api.md) · [All operations](https://skmtc.dev/42/apis/fortytwo-read-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/42/fortytwo-read-api/revisions/660740bda403/schema)