v1

latestOpenAPI 3.1.12026-07-23195454.2 KB
get-all-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.

get/api/v1/markets

Query parameters

limitinteger

Page size (default 100, max 500)

offsetinteger

Offset (default 0)

orderstring

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

ascendingboolean

Sort direction (default false = descending)

question_idstring

Filter by question_id(s), comma-separated

market_addressstring

Filter by market address(es), comma-separated

collateralstring

Filter by collateral symbol or address

statusstring

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

volume_minnumber

Minimum total volume

volume_maxnumber

Maximum total volume

start_date_minstring

Min start date (ISO 8601)

start_date_maxstring

Max start date (ISO 8601)

end_date_minstring

Min end date (ISO 8601)

end_date_maxstring

Max end date (ISO 8601)

tagstring

Filter by tag name (case-insensitive)

categorystring

Filter by category name (case-insensitive)

subcategorystring

Filter by subcategory name (case-insensitive)

topicstring

Filter by topic name (case-insensitive)

oraclestring

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

creatorstring

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

contract_versioninteger

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

localestring

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.

fieldsstring

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.

Response

OK

All 19 operations