Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Get all markets

GET /api/v1/markets

Get all markets

get

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.

Query parameters
limitintegerOptional

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.

offsetintegerOptional

Offset (default 0)

orderstringOptional

Sort field: created_at, volume, volume_24h, collateral, start_timestamp, end_timestamp

ascendingbooleanOptional

Sort direction (default false = descending)

question_idstringOptional

Filter by question_id(s), comma-separated

market_addressstringOptional

Filter by market address(es), comma-separated

titlestringOptional

Filter by question title ILIKE pattern(s), comma-separated (any-of; include % wildcards, e.g. %BTC%,%Bitcoin%)

metadata_description_prefixstringOptional

Filter by question_metadata.description prefix (LIKE prefix%)

collateralstringOptional

Filter by collateral symbol or address

statusstringOptional

Filter by status: not_started, live, ended, resolved, finalised, all

volume_minnumberOptional

Minimum total volume

volume_maxnumberOptional

Maximum total volume

start_date_minstringOptional

Min start date (ISO 8601)

start_date_maxstringOptional

Max start date (ISO 8601)

end_date_minstringOptional

Min end date (ISO 8601)

end_date_maxstringOptional

Max end date (ISO 8601)

tagstringOptional

Filter by tag name (case-insensitive)

categorystringOptional

Filter by category name (case-insensitive)

subcategorystringOptional

Filter by subcategory name (case-insensitive)

topicstringOptional

Filter by topic name (case-insensitive)

oraclestringOptional

Filter by oracle address (v2 markets, case-insensitive)

creatorstringOptional

Filter by creator address (v2 markets, case-insensitive)

contract_versionintegerOptional

Filter by contract version (1 = legacy, 2 = v2)

localestringOptional

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.

fieldsstringOptional

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.

Responses
200

OK

application/json
get/api/v1/markets
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
  }
}
get

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.

Query parameters
per_tagintegerOptional

Markets per section (default 12, max 50)

localestringOptional

BCP-47 locale (e.g. zh, id) for the sibling translation wrapper on each market.

Responses
200

OK

application/json
get/api/v1/markets/featured
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