# Get outcome token stats

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

## Get outcome token 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.

```json
{"openapi":"3.1.1","info":{"title":"FortyTwo Read API","version":"1.0"},"tags":[{"description":"GET /api/v1/market-data/tokens/stats","name":"get-outcome-token-stats"}],"servers":[{"url":"https://rest.ft.42.space/"}],"paths":{"/api/v1/market-data/tokens/stats":{"get":{"description":"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.","tags":["get-outcome-token-stats"],"summary":"Get outcome token stats","parameters":[{"schema":{"type":"integer"},"description":"Page size (default 100, max 500)","name":"limit","in":"query"},{"schema":{"type":"integer"},"description":"Offset (default 0)","name":"offset","in":"query"},{"schema":{"type":"string","default":"volume"},"description":"Sort field: volume, price, collateral, traders","name":"order_by","in":"query"},{"schema":{"type":"boolean"},"description":"Sort ascending (default false = descending)","name":"ascending","in":"query"},{"schema":{"type":"string"},"description":"Filter by category name","name":"category","in":"query"},{"schema":{"type":"integer"},"description":"Filter by category ID","name":"category_id","in":"query"},{"schema":{"type":"string"},"description":"Filter by status: live, ended, resolved, finalised, all","name":"status","in":"query"},{"schema":{"type":"string"},"description":"Filter by market address(es), comma-separated","name":"market_address","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.PaginatedResponse-handler_TokenStatsEntry"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.ErrorResponse"}}}}}}}},"components":{"schemas":{"api.PaginatedResponse-handler_TokenStatsEntry":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/handler.TokenStatsEntry"}},"pagination":{"$ref":"#/components/schemas/api.Pagination"}}},"handler.TokenStatsEntry":{"type":"object","properties":{"buyVolume":{"type":"number"},"collateral":{"type":"number"},"market":{"$ref":"#/components/schemas/handler.TokenStatsMarket"},"marketAddress":{"type":"string"},"outcome":{"$ref":"#/components/schemas/handler.TokenStatsOutcome"},"payout":{"type":"number"},"price":{"type":"number"},"question":{"$ref":"#/components/schemas/handler.TokenStatsQuestion"},"questionId":{"type":"string"},"sellVolume":{"type":"number"},"statsChanges":{"$ref":"#/components/schemas/handler.StatsChanges"},"tokenId":{"type":"string"},"totalVolume":{"type":"number"},"traders":{"type":"integer"}}},"handler.TokenStatsMarket":{"type":"object","properties":{"collateralDecimals":{"type":"integer"}}},"handler.TokenStatsOutcome":{"type":"object","properties":{"image":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"}}},"handler.TokenStatsQuestion":{"type":"object","properties":{"categoryId":{"type":"integer"},"description":{"type":"string"},"endDate":{"type":"string"},"image":{"type":"string"},"title":{"type":"string"}}},"handler.StatsChanges":{"type":"object","properties":{"collateralChange1h":{"type":"number"},"collateralChange24h":{"type":"number"},"collateralChange30m":{"type":"number"},"collateralChange4h":{"type":"number"},"priceChange1h":{"type":"number"},"priceChange24h":{"type":"number"},"priceChange30m":{"type":"number"},"priceChange4h":{"type":"number"},"volumeChange1h":{"type":"number"},"volumeChange24h":{"type":"number"},"volumeChange30m":{"type":"number"},"volumeChange4h":{"type":"number"}}},"api.Pagination":{"type":"object","properties":{"hasMore":{"type":"boolean"},"totalResults":{"type":"integer"}}},"api.ErrorResponse":{"type":"object","properties":{"code":{"type":"integer"},"error":{"type":"string"},"message":{"type":"string"}}}}}}
```