Skip to main content
GET
List markets

Query Parameters

cursor
string

Omit for the first page; then send the previous response's next_cursor unchanged. Opaque list cursor. Send a previous response's next_cursor back unchanged; never build or parse one.

Required string length: 1 - 2048
category
enum<string>

Platform taxonomy category slug. The cursor is bound to this filter.

Available options:
crypto,
economics,
entertainment,
finance,
politics,
sports,
tech,
weather
subcategory
enum<string>

Platform taxonomy subcategory slug. The cursor is bound to this filter.

Available options:
nba,
ncaa,
nfl,
nhl,
mlb,
ufc,
lol,
epl,
efl,
la_liga,
world_cup,
bundesliga,
liga_portugal,
ligue_1,
f1,
ipl,
cricket,
transfers,
btc,
eth,
sol,
up_down,
stocks,
indices,
etfs,
earnings,
rates,
inflation,
commodities,
fx,
usa,
global,
other
limit
integer
default:50

Maximum items per page, 1 to 200, default 50. A page may hold fewer, even none, while has_more is true. Maximum items in one page. A page may hold fewer, even none, while has_more is true.

Required range: 1 <= x <= 200

Response

One page of active markets, grouped by question. Each market is one HIP-4 outcome with its YES and NO sides; fallback and settled outcomes are left out. A listed market is not a promise that an RFQ on it will be quoted or accepted.

items
object[]
required

Markets on this page, ascending by outcome ID.

Maximum array length: 200
catalog_generation
string<positive-int64-decimal>
required

Catalog generation every item was read from; pages from different generations must not be mixed.

Maximum string length: 19
Pattern: ^[1-9][0-9]*$
next_cursor
string | null
required

Pass as cursor to read the next page; null when there are no more pages.

Required string length: 1 - 2048
has_more
boolean
required

True when another page follows.