# Get batch market stats

GET /api/v1/market-data/stats

## Get batch market stats

> Returns lightweight polling stats (market cap, total volume, trader count, and per-outcome prices) for up to 50 markets at once.

```json
{"openapi":"3.1.1","info":{"title":"FortyTwo Read API","version":"1.0"},"tags":[{"description":"GET /api/v1/market-data/stats","name":"get-batch-market-stats"}],"servers":[{"url":"https://rest.ft.42.space/"}],"paths":{"/api/v1/market-data/stats":{"get":{"description":"Returns lightweight polling stats (market cap, total volume, trader count, and per-outcome prices) for up to 50 markets at once.","tags":["get-batch-market-stats"],"summary":"Get batch market stats","parameters":[{"schema":{"type":"string"},"description":"Comma-separated market addresses (max 50) — required","name":"market","in":"query","required":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/handler.MarketStatsResponse"}}}}},"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":{"handler.MarketStatsResponse":{"description":"Lightweight market stats for polling.","type":"object","properties":{"market":{"type":"string"},"marketCap":{"type":"number"},"outcomeStats":{"type":"array","items":{"$ref":"#/components/schemas/handler.OutcomeStatsCompact"}},"totalVolume":{"type":"number"},"traders":{"type":"integer"},"updatedAt":{"type":"string"}}},"handler.OutcomeStatsCompact":{"description":"Compact outcome stats for polling.","type":"object","properties":{"marketCap":{"type":"number"},"name":{"type":"string"},"payout":{"type":"number"},"price":{"type":"number"},"tokenId":{"type":"string"}}},"api.ErrorResponse":{"type":"object","properties":{"code":{"type":"integer"},"error":{"type":"string"},"message":{"type":"string"}}}}}}
```