Skip to main content
GET
cURL
Use this endpoint to find a game’s spreads, totals, team totals, period lines and player props. List games and Game carry only the winner markets, and Search markets returns one market per game. Each row has the condition_id and both outcome token ids. Send expand=quotes to get each outcome’s current price, best bid and best ask on the same page, and expand=trading_terms to get each market’s fees, liquidity rewards, order delay, tick and minimum order size, or pass a condition_id to Market holders and Market snapshot. Polymarket files some markets of a game under child events. A soccer game’s exact score, halftime result and “more markets” events are examples. This endpoint returns those markets too, and each row’s event_slug names the event it belongs to.

Parameters

Key response fields

Rows are ordered by sports_market_type, then line, then condition_id. Markets with no type come last.

Example

The list_game_markets MCP tool calls this endpoint with the same parameters. Pass expand as an array, for example ["quotes", "trading_terms"].

Conditional reads

The response carries a weak semantic ETag. Send it back as If-None-Match for a 304 with an empty body. request_id and cost are excluded from the validator. With expand=quotes, the ETag changes whenever a quote does. With expand=trading_terms, it changes each time a market’s terms are read again, about once a minute.

What it does not return

  • Prices, unless you send expand=quotes. Liquidity is on Market snapshot, one market per request.
  • Holder identity. Use Game holders to read the holders of several of the game’s markets in one request.
  • Fees, liquidity rewards, the order delay, the tick or the minimum order size, unless you send expand=trading_terms.
  • A sharp-money split, unless you send expand=sharp_money. It needs a Pro or Max key; any other key gets 402 subscription_required.
  • A slug with no stored market. That is a 404 with error.code not_found.
  • An event outside sports and esports. That is a 404 with error.reason market_out_of_scope. Stop requesting it.

Authorizations

Authorization
string
header
required

Legacy default or named integration API key, or OAuth 2.1 access token, in the Authorization header as Bearer oxi_sk_live_... or Bearer oxi_at_.... Default keys retain full access; integration keys are limited to their approved read, webhooks, export and usage scopes and expire within 90 days. All credentials share the owner's account limits. Data calls require an active Pro subscription and return live data. A 401 carries WWW-Authenticate: Bearer resource_metadata="https://api.0xinsider.com/.well-known/oauth-protected-resource" (RFC 6750 section 3, RFC 9728).

Scopes

read

Read markets, traders, large trades, positions, reports, search, the event stream and every MCP tool

Headers

X-Query-Validation
enum<string>

Opt into strict query-name validation. The default is compatible: unknown names are ignored and reported in X-Query-Ignored. With strict, an unknown name returns 400 bad_request with error.reason unknown_query_parameter before the handler runs, including when its percent escape is incomplete.

Available options:
strict
If-None-Match
string

Conditional GET using a weak semantic ETag from an earlier response. A matching payload returns 304 with an empty body; request_id and cost are excluded from the validator.

Path Parameters

event_slug
string
required

The event slug from GET /api/v1/games, GET /api/v1/games/{event_slug} or a markets/search result's event_slug, for example nba-bos-orl-2026-11-01. Matched case-insensitively.

Query Parameters

sports_market_type
string

Comma-separated provider market types to keep, case-insensitive: spreads, totals, points, first_half_totals. Omitted keeps every type. An unknown type returns an empty page, not a 400; families lists the event's types.

Maximum string length: 512
status
enum<string>
default:all

active, closed or all. closed means the provider closed the market or it resolved.

Available options:
active,
closed,
all
protocol_version
enum<string>

v1 keeps the markets that trade on Polymarket's CTF exchanges, v2 the ones on Protocol V2 (ExchangeV3), each row's protocol_version. Omitted keeps both. Any other value returns 400 bad_request naming v1 and v2.

Available options:
v1,
v2
limit
integer
default:20

Page size. Out-of-range values are clamped to 1..100.

Required range: 1 <= x <= 100
cursor
string

Opaque gmk_v1_ cursor from next_cursor, sent with the same filters. It pins the page position (sports_market_type, line, condition_id), not a snapshot. A cursor this endpoint did not issue returns 400 with error.param=cursor.

expand
enum<string>[]

sharp_money adds each row's sharp_money: the game page's per-line split, side USD and S, A and B wallet counts per outcome. One read for the event whatever the page size; the request costs 5 instead of 2. Pro and Max. quotes adds each outcome's quote: the cached display price and best bid and ask, each with its observation time, in one cache read for the page; it adds 1 to the cost, on every plan. trading_terms adds each row's fee schedule, reward settings and allocations, order delay, tick and minimum order size in shares from its Gamma record, with the read's time; it adds 1 to the cost, on every plan. Repeatable: sharp_money, quotes, trading_terms.

Available options:
sharp_money,
quotes,
trading_terms
expand[]
enum<string>[]

Backward-compatible alias for expand. Repeatable: sharp_money, quotes, trading_terms.

Available options:
sharp_money,
quotes,
trading_terms

Response

One page of the event's markets

data
object[]
required
event_slug
string
required
families
object[]
required
has_more
boolean
required
meta
object
required
object
string
required
next_cursor
string