> 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). Above 100 the request must send `Accept-Encoding: gzip` (or `br`), else 406 — an uncompressed page of that size is 8x the bytes.","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 question title ILIKE pattern(s), comma-separated (any-of; include % wildcards, e.g. `%BTC%,%Bitcoin%`)","name":"title","in":"query"},{"schema":{"type":"string"},"description":"Filter by question_metadata.description prefix (LIKE prefix%)","name":"metadata_description_prefix","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"}}}},"406":{"description":"Not Acceptable","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"}},"backgroundImage":{"description":"Admin-set background image for the market's grid card (off-chain metadata only). Null when unset.","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"},"metadataDescription":{"description":"Admin-curated description from question_metadata (off-chain). Null when unset.","type":"string"},"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"},"mintedQuantityRaw":{"description":"Raw on-chain minted supply (uint256 decimal string, no HMR scaling).\nBigInt-safe: never a float. \"0\" when the outcome has no stats yet.","type":"string"},"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"}}}}}}
```

## Get all featured market sections

> Returns every \`featured\_N\` tag's top live markets (ranked by rolling 24h volume) in one response — one section per tag, ordered by the tag's numeric suffix. Replaces issuing a separate \`/markets?tag=featured\_N\` request per section.

```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/featured":{"get":{"description":"Returns every `featured_N` tag's top live markets (ranked by rolling 24h volume) in one response — one section per tag, ordered by the tag's numeric suffix. Replaces issuing a separate `/markets?tag=featured_N` request per section.","tags":["get-all-markets"],"summary":"Get all featured market sections","parameters":[{"schema":{"type":"integer"},"description":"Markets per section (default 12, max 50)","name":"per_tag","in":"query"},{"schema":{"type":"string"},"description":"BCP-47 locale (e.g. zh, id) for the sibling `translation` wrapper on each market.","name":"locale","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/internal_handler.FeaturedMarketsResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ft_market-service-v2_pkg_api.ErrorResponse"}}}}}}}},"components":{"schemas":{"internal_handler.FeaturedMarketsResponse":{"type":"object","properties":{"sections":{"type":"array","items":{"$ref":"#/components/schemas/internal_handler.FeaturedSection"}}}},"internal_handler.FeaturedSection":{"type":"object","properties":{"markets":{"type":"array","items":{"$ref":"#/components/schemas/internal_handler.MarketResponse"}},"tag":{"type":"string"}}},"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"}},"backgroundImage":{"description":"Admin-set background image for the market's grid card (off-chain metadata only). Null when unset.","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"},"metadataDescription":{"description":"Admin-curated description from question_metadata (off-chain). Null when unset.","type":"string"},"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"},"mintedQuantityRaw":{"description":"Raw on-chain minted supply (uint256 decimal string, no HMR scaling).\nBigInt-safe: never a float. \"0\" when the outcome has no stats yet.","type":"string"},"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.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.