Skip to main content
GET
cURL
Open a combo returned by Combo fills to inspect its market legs, recorded totals, and up to 100 latest taker fills. The route requires paid API access and returns the full detail payload.

Parameters

Key response fields

A leg’s pick_price_daily is a stored daily observation for that leg’s own outcome. Read pick_price_as_of and pick_price_age_days alongside it; it is not a live quote. A leg’s game_start_time is the kickoff stored on that market, in UTC, and it is null when the leg has no local market or the market has no kickoff. kickoff_date_passed is true only when that date is before today in UTC, and false on the kickoff’s own date. True does not mean the game is over: a game that kicks off late in the UTC day is still in play after midnight UTC. game_ended says that: true when the market’s game has ended, false while it is scheduled, in play or postponed, and null when no game state is stored for it, which means unknown, not in play. The date in the question can stay on an earlier day after a postponement, so read these fields; state stays pending until the market resolves.

Example

Keep the condition_id from a fill in COMBO_CONDITION_ID:

What it does not return

  • More than the latest 100 fills or a continuation for the detail’s fill array.
  • A current order book or an execution price for a new order.
  • A wallet’s realized P&L or proof that it won from a combo’s status alone.
  • A lifecycle total of 0 when no lifecycle event is recorded. data.lifecycle is null instead.

Caching

Save the response’s ETag and send it in If-None-Match on your next request. If the representation has not changed, the server returns 304 Not Modified with no body.

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

ETag from a prior response; a matching representation returns 304.

Path Parameters

condition_id
string
required

Combo identifier: 0x followed by 62 lowercase hex characters. This differs from a binary market condition ID.

Pattern: ^0x[0-9a-f]{62}$

Response

Get combo detail

object
string
required
Allowed value: "combo"
data
object
required

One combo with its newest 100 fills and all-time lifecycle totals. Paid API callers receive full access.

meta
object
required