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,
esports,
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,
counter_strike,
epl,
ucl,
uel,
efl,
copa_del_rey,
dfb_pokal,
la_liga,
serie_a,
bundesliga,
ligue_1,
liga_portugal,
super_lig,
nations_league,
world_cup,
f1,
ipl,
cricket,
transfers,
btc,
eth,
sol,
hype,
up_down,
stocks,
indices,
etfs,
earnings,
rates,
inflation,
commodities,
fx,
usa,
global,
other
eligibility
enum<string>

Keep only markets whose current eligibility.state is this value: ENABLED for markets that accept new positions now, DISABLED for the rest. Eligibility is live, so a market can change state between pages. The filter applies after paging, so a page can be short or empty while has_more is true; next_cursor being null is the only terminal signal. The cursor is bound to this filter.

Available options:
ENABLED,
DISABLED
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 in one flat list, not grouped by question. Each market is one HIP-4 outcome with its YES and NO sides, its own title and its native_question_id, but not the question's title; 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 in this page was read from. A cursor continues by native ID when a new generation is published, so a later page can name a newer generation than an earlier one.

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.