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)

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

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

400

Bad Request

application/json

500

Internal Server Error

application/json

get/api/v1/markets

HTTPcURLJavaScriptPython

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,
      "oracle": {
        "address": "text",
        "image": "text",
        "name": "text"
      },
      "outcomes": [
        {
          "holdersAtFinalisation": 1,
          "image": "text",
          "index": 1,
          "marketCap": 1,
          "mintedQuantity": 1,
          "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
  }
}