> For the complete documentation index, see [llms.txt](https://docs.42.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.42.space/for-developers/rest-api-alpha/markets/get-all-markets.md).

# 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, volume_24h, collateral, start_timestamp, end_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: not_started, 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"},{"schema":{"type":"string"},"description":"BCP-47 locale (e.g. zh, id) for the sibling `translation` wrapper. Source fields (`question`, outcome `name`, `ancillaryData`) stay raw; `translation:{title,ancillary[]}` and outcome `translation:{name}` are populated when a matching locale exists. Wrapper is null otherwise.","name":"locale","in":"query"},{"schema":{"type":"string"},"description":"Comma-separated top-level field whitelist (e.g. `questionId,subcategories,topics,endDate`). When set, each market is projected to only these fields, omitting large fields like ancillaryData/description/outcomes. Unknown names are ignored.","name":"fields","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. Always the raw on-chain form; translated human-readable bodies surface inside `translation.ancillary` (parallel array, same indexing).","type":"array","items":{"type":"string"}},"availableLocales":{"description":"Locales with an approved translation. Lets clients build a language switcher. Empty array when none. The internal pipeline status is intentionally not exposed.","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":{"description":"Deprecated: proposer metadata. Not translated and slated for removal.","allOf":[{"$ref":"#/components/schemas/internal_handler.ProposerResponse"}]},"question":{"type":"string"},"questionId":{"type":"string"},"resolutionTime":{"type":"string"},"resolvedAnswer":{"type":"string"},"slug":{"type":"string"},"sourceLocale":{"description":"Source locale of the on-chain `question`/`ancillaryData` fields (defaults to \"en\").","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"},"translation":{"description":"Translated display text for the locale requested via `?locale=`, or null when no `?locale=` was given, it equals `sourceLocale`, or the locale is not available. `ancillary` is index-aligned to `ancillaryData`.","allOf":[{"$ref":"#/components/schemas/internal_handler.MarketTranslation"}]},"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"},"translation":{"description":"Translated outcome name for the locale requested via `?locale=`, or null under the same rules as MarketResponse.Translation.","allOf":[{"$ref":"#/components/schemas/internal_handler.OutcomeTranslation"}]},"volume":{"type":"number"}}},"internal_handler.OutcomeTranslation":{"description":"Localized outcome text for the requested locale.","type":"object","properties":{"name":{"type":"string"}}},"internal_handler.ProposerResponse":{"description":"Deprecated: proposer metadata. Not translated. Will be removed in a future release.","type":"object","properties":{"image":{"type":"string"},"name":{"type":"string"}}},"internal_handler.MarketTranslation":{"description":"Localized market text for the requested locale.","type":"object","properties":{"ancillary":{"type":"array","items":{"type":"string"}},"title":{"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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.