Get all markets
GET /api/v1/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.
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.
Offset (default 0)
Sort field: created_at, volume, volume_24h, collateral, start_timestamp, end_timestamp
Sort direction (default false = descending)
Filter by question_id(s), comma-separated
Filter by market address(es), comma-separated
Filter by question title ILIKE pattern(s), comma-separated (any-of; include % wildcards, e.g. %BTC%,%Bitcoin%)
Filter by question_metadata.description prefix (LIKE prefix%)
Filter by collateral symbol or address
Filter by status: not_started, live, ended, resolved, finalised, all
Minimum total volume
Maximum total volume
Min start date (ISO 8601)
Max start date (ISO 8601)
Min end date (ISO 8601)
Max end date (ISO 8601)
Filter by tag name (case-insensitive)
Filter by category name (case-insensitive)
Filter by subcategory name (case-insensitive)
Filter by topic name (case-insensitive)
Filter by oracle address (v2 markets, case-insensitive)
Filter by creator address (v2 markets, case-insensitive)
Filter by contract version (1 = legacy, 2 = v2)
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.
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.
OK
Bad Request
Not Acceptable
Internal Server Error
GET /api/v1/markets HTTP/1.1
Host: rest.ft.42.space/
Accept: */*
{
"data": [
{
"address": "text",
"ancillaryData": [
"text"
],
"availableLocales": [
"text"
],
"backgroundImage": "text",
"categories": [
"text"
],
"collateralAddress": "text",
"collateralDecimals": 1,
"collateralSymbol": "text",
"contractVersion": 1,
"createdAt": "text",
"creator": {
"address": "text",
"image": "text",
"name": "text"
},
"curve": "text",
"description": "text",
"elapsedPct": 1,
"endDate": "text",
"feeRate": 1,
"finalisedAt": "text",
"image": "text",
"isFlagged": true,
"metadataDescription": "text",
"oracle": {
"address": "text",
"image": "text",
"name": "text"
},
"outcomes": [
{
"holdersAtFinalisation": 1,
"image": "text",
"index": 1,
"marketCap": 1,
"mintedQuantity": 1,
"mintedQuantityRaw": "text",
"name": "text",
"payout": 1,
"price": 1,
"symbol": "text",
"tokenId": "text",
"translation": {
"name": "text"
},
"volume": 1
}
],
"proposer": {
"image": "text",
"name": "text"
},
"question": "text",
"questionId": "text",
"resolutionTime": "text",
"resolvedAnswer": "text",
"slug": "text",
"sourceLocale": "text",
"startDate": "text",
"status": "text",
"subcategories": [
"text"
],
"tags": [
"text"
],
"topics": [
"text"
],
"totalMarketCap": 1,
"traders": 1,
"translation": {
"ancillary": [
"text"
],
"title": "text"
},
"updatedAt": "text",
"volume": 1
}
],
"pagination": {
"hasMore": true,
"totalResults": 1
}
}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.
Markets per section (default 12, max 50)
BCP-47 locale (e.g. zh, id) for the sibling translation wrapper on each market.
OK
Internal Server Error
GET /api/v1/markets/featured HTTP/1.1
Host: rest.ft.42.space/
Accept: */*
{
"sections": [
{
"markets": [
{
"address": "text",
"ancillaryData": [
"text"
],
"availableLocales": [
"text"
],
"backgroundImage": "text",
"categories": [
"text"
],
"collateralAddress": "text",
"collateralDecimals": 1,
"collateralSymbol": "text",
"contractVersion": 1,
"createdAt": "text",
"creator": {
"address": "text",
"image": "text",
"name": "text"
},
"curve": "text",
"description": "text",
"elapsedPct": 1,
"endDate": "text",
"feeRate": 1,
"finalisedAt": "text",
"image": "text",
"isFlagged": true,
"metadataDescription": "text",
"oracle": {
"address": "text",
"image": "text",
"name": "text"
},
"outcomes": [
{
"holdersAtFinalisation": 1,
"image": "text",
"index": 1,
"marketCap": 1,
"mintedQuantity": 1,
"mintedQuantityRaw": "text",
"name": "text",
"payout": 1,
"price": 1,
"symbol": "text",
"tokenId": "text",
"translation": {
"name": "text"
},
"volume": 1
}
],
"proposer": {
"image": "text",
"name": "text"
},
"question": "text",
"questionId": "text",
"resolutionTime": "text",
"resolvedAnswer": "text",
"slug": "text",
"sourceLocale": "text",
"startDate": "text",
"status": "text",
"subcategories": [
"text"
],
"tags": [
"text"
],
"topics": [
"text"
],
"totalMarketCap": 1,
"traders": 1,
"translation": {
"ancillary": [
"text"
],
"title": "text"
},
"updatedAt": "text",
"volume": 1
}
],
"tag": "text"
}
]
}Last updated