# 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"},{"schema":{"type":"string"},"description":"Filter by oracle address (v2 markets, case-insensitive)","name":"oracle","in":"query"},{"schema":{"type":"string"},"description":"Filter by creator address (v2 markets, case-insensitive)","name":"creator","in":"query"},{"schema":{"type":"integer"},"description":"Filter by contract version (1 = legacy, 2 = v2)","name":"contract_version","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ft_market-service-v2_pkg_api.PaginatedResponse-internal_handler_MarketResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ft_market-service-v2_pkg_api.ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ft_market-service-v2_pkg_api.ErrorResponse"}}}}}}}},"components":{"schemas":{"ft_market-service-v2_pkg_api.PaginatedResponse-internal_handler_MarketResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/internal_handler.MarketResponse"}},"pagination":{"$ref":"#/components/schemas/ft_market-service-v2_pkg_api.Pagination"}}},"internal_handler.MarketResponse":{"description":"Full market representation.","type":"object","properties":{"address":{"type":"string"},"ancillaryData":{"description":"Ancillary metadata entries posted on-chain by the question creator, oldest-first. Each entry is a comma-separated \"key:value\" pair list with `\\,`, `\\:`, and `\\\\` as escapes. Empty array for legacy markets.","type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}},"collateralAddress":{"type":"string"},"collateralDecimals":{"type":"integer"},"collateralSymbol":{"type":"string"},"contractVersion":{"description":"On-chain contract version that produced this market (1 = legacy, 2 = v2).","type":"integer"},"createdAt":{"type":"string"},"creator":{"description":"Creator of the question, with curated `name`/`image` joined from `identified_address`. Non-null for v2 markets only.","allOf":[{"$ref":"#/components/schemas/internal_handler.AddressInfoResponse"}]},"curve":{"type":"string"},"description":{"description":"Deprecated: populated from on-chain metadata for legacy v1 markets. For v2 markets, use AncillaryData — the first entry carries the creator's metadata including a `description` key.","type":"string"},"elapsedPct":{"type":"number"},"endDate":{"type":"string"},"feeRate":{"type":"number"},"finalisedAt":{"type":"string"},"image":{"type":"string"},"isFlagged":{"description":"True when the question currently has an active creator-issued flag whose expiry (if any) is in the future.","type":"boolean"},"oracle":{"description":"Oracle responsible for resolving the question, with curated `name`/`image` joined from `identified_address`. Non-null for v2 markets only.","allOf":[{"$ref":"#/components/schemas/internal_handler.AddressInfoResponse"}]},"outcomes":{"type":"array","items":{"$ref":"#/components/schemas/internal_handler.OutcomeResponse"}},"proposer":{"$ref":"#/components/schemas/internal_handler.ProposerResponse"},"question":{"type":"string"},"questionId":{"type":"string"},"resolutionTime":{"type":"string"},"resolvedAnswer":{"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"}}},"internal_handler.AddressInfoResponse":{"type":"object","properties":{"address":{"type":"string"},"image":{"type":"string"},"name":{"type":"string"}}},"internal_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"}}},"internal_handler.ProposerResponse":{"type":"object","properties":{"image":{"type":"string"},"name":{"type":"string"}}},"ft_market-service-v2_pkg_api.Pagination":{"type":"object","properties":{"hasMore":{"type":"boolean"},"totalResults":{"type":"integer"}}},"ft_market-service-v2_pkg_api.ErrorResponse":{"type":"object","properties":{"code":{"type":"integer"},"error":{"type":"string"},"message":{"type":"string"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.42.space/api/rest-api-alpha/markets/get-all-markets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.