# Get all markets

GET /api/v1/markets

## Get all markets

> Returns a paginated list of all markets available on 42. Supports rich filtering by status, category, collateral, volume range, date range, and tags. Use \`order\` + \`ascending\` to control sort direction.

```json
{"openapi":"3.1.1","info":{"title":"FortyTwo Read API","version":"1.0"},"tags":[{"description":"GET /api/v1/markets","name":"get-all-markets"}],"servers":[{"url":"https://rest.ft.42.space/"}],"paths":{"/api/v1/markets":{"get":{"description":"Returns a paginated list of all markets available on 42. Supports rich filtering by status, category, collateral, volume range, date range, and tags. Use `order` + `ascending` to control sort direction.","tags":["get-all-markets"],"summary":"Get all markets","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"},"description":"Sort field: created_at, volume, collateral, start_timestamp","name":"order","in":"query"},{"schema":{"type":"boolean"},"description":"Sort direction (default false = descending)","name":"ascending","in":"query"},{"schema":{"type":"string"},"description":"Filter by question_id(s), comma-separated","name":"question_id","in":"query"},{"schema":{"type":"string"},"description":"Filter by market address(es), comma-separated","name":"market_address","in":"query"},{"schema":{"type":"string"},"description":"Filter by collateral symbol or address","name":"collateral","in":"query"},{"schema":{"type":"string"},"description":"Filter by status: live, ended, resolved, finalised, all","name":"status","in":"query"},{"schema":{"type":"number"},"description":"Minimum total volume","name":"volume_min","in":"query"},{"schema":{"type":"number"},"description":"Maximum total volume","name":"volume_max","in":"query"},{"schema":{"type":"string"},"description":"Min start date (ISO 8601)","name":"start_date_min","in":"query"},{"schema":{"type":"string"},"description":"Max start date (ISO 8601)","name":"start_date_max","in":"query"},{"schema":{"type":"string"},"description":"Min end date (ISO 8601)","name":"end_date_min","in":"query"},{"schema":{"type":"string"},"description":"Max end date (ISO 8601)","name":"end_date_max","in":"query"},{"schema":{"type":"string"},"description":"Filter by tag name (case-insensitive)","name":"tag","in":"query"},{"schema":{"type":"string"},"description":"Filter by category name (case-insensitive)","name":"category","in":"query"},{"schema":{"type":"string"},"description":"Filter by subcategory name (case-insensitive)","name":"subcategory","in":"query"},{"schema":{"type":"string"},"description":"Filter by topic name (case-insensitive)","name":"topic","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.PaginatedResponse-handler_MarketResponse"}}}},"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_MarketResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/handler.MarketResponse"}},"pagination":{"$ref":"#/components/schemas/api.Pagination"}}},"handler.MarketResponse":{"description":"Full market representation.","type":"object","properties":{"address":{"type":"string"},"categories":{"type":"array","items":{"type":"string"}},"collateralAddress":{"type":"string"},"collateralDecimals":{"type":"integer"},"collateralSymbol":{"type":"string"},"createdAt":{"type":"string"},"curve":{"type":"string"},"description":{"type":"string"},"elapsedPct":{"type":"number"},"endDate":{"type":"string"},"feeRate":{"type":"number"},"finalisedAt":{"type":"string"},"image":{"type":"string"},"outcomes":{"type":"array","items":{"$ref":"#/components/schemas/handler.OutcomeResponse"}},"proposer":{"$ref":"#/components/schemas/handler.ProposerResponse"},"question":{"type":"string"},"questionId":{"type":"string"},"resolvedAnswer":{"type":"string"},"resolutionTime":{"type":"string"},"slug":{"type":"string"},"startDate":{"type":"string"},"status":{"type":"string"},"subcategories":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"topics":{"type":"array","items":{"type":"string"}},"totalMarketCap":{"type":"number"},"traders":{"type":"integer"},"updatedAt":{"type":"string"},"volume":{"type":"number"}}},"handler.OutcomeResponse":{"description":"Per-outcome data including price, volume, and supply.","type":"object","properties":{"holdersAtFinalisation":{"type":"integer"},"image":{"type":"string"},"index":{"type":"integer"},"marketCap":{"type":"number"},"mintedQuantity":{"type":"number"},"name":{"type":"string"},"payout":{"type":"number"},"price":{"type":"number"},"symbol":{"type":"string"},"tokenId":{"type":"string"},"volume":{"type":"number"}}},"handler.ProposerResponse":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"image":{"type":"string"},"name":{"type":"string"}}},"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"}}}}}}
```