{
"id": "evt_market_settled_0xf5d7380019cbc6eb2fcfe9a6dc60a4bb238a38d97b6a3192cc1a0afb0ec081a0_2780",
"type": "market_settled",
"created_at": "2026-11-07T17:18:39.795275Z",
"data": {
"condition_id": "0xf5d7380019cbc6eb2fcfe9a6dc60a4bb238a38d97b6a3192cc1a0afb0ec081a0",
"settlement_id": 2780,
"event_slug": "epl-ars-hul-2026-11-07",
"game_id": "90114161",
"league": "epl",
"sports_market_type": "moneyline",
"outcomes": [
"Yes",
"No"
],
"copy_of_event_slug": null,
"settlement": {
"status": "observed",
"oracle_status": "resolved",
"settled": true,
"payouts": [
1000000,
0
],
"result": "outcome",
"winning_outcome_index": 0,
"was_disputed": false,
"resolved_at": "2026-11-07T17:18:19Z",
"oracle_updated_at": "2026-11-07T17:18:19Z",
"expected_settlement_time": null,
"settlement_time_basis": null,
"proposed_answer": null,
"observed_at": "2026-11-07T17:18:39.795275Z"
},
"protocol_version": "v1"
}
}market_settled
Sends a sports or esports game market’s settlement once per settled state: the game, its league, the market type, the outcome names, and the payouts.
{
"id": "evt_market_settled_0xf5d7380019cbc6eb2fcfe9a6dc60a4bb238a38d97b6a3192cc1a0afb0ec081a0_2780",
"type": "market_settled",
"created_at": "2026-11-07T17:18:39.795275Z",
"data": {
"condition_id": "0xf5d7380019cbc6eb2fcfe9a6dc60a4bb238a38d97b6a3192cc1a0afb0ec081a0",
"settlement_id": 2780,
"event_slug": "epl-ars-hul-2026-11-07",
"game_id": "90114161",
"league": "epl",
"sports_market_type": "moneyline",
"outcomes": [
"Yes",
"No"
],
"copy_of_event_slug": null,
"settlement": {
"status": "observed",
"oracle_status": "resolved",
"settled": true,
"payouts": [
1000000,
0
],
"result": "outcome",
"winning_outcome_index": 0,
"was_disputed": false,
"resolved_at": "2026-11-07T17:18:19Z",
"oracle_updated_at": "2026-11-07T17:18:19Z",
"expected_settlement_time": null,
"settlement_time_basis": null,
"proposed_answer": null,
"observed_at": "2026-11-07T17:18:39.795275Z"
},
"protocol_version": "v1"
}
}settlement_id. A state that names a winner already sent is not sent again. Pro and Max only.
Subscribe with settlement_filters on create or update to choose the markets: leagues (at most 32), sports_market_types (at most 64; * is every type), event_slugs (at most 100), and condition_ids (at most 100). Every field you set must match.
Without sports_market_types, an endpoint receives the markets Polymarket labels moneyline, or every type of the markets condition_ids names. Most markets that settle are props, spreads, and totals: name their types, or send ["*"], to receive them.
The moneyline label is each head-to-head game’s winner market. In golf and other field events, Polymarket labels every player market moneyline: the winner, make the cut, and round leader markets. One tournament can send hundreds of states. On November 7, 2026, one golf tournament sent 452 states to an endpoint with the default filter in about two minutes.
To leave those out, set leagues to the leagues you want, or name markets with condition_ids. A market’s league is the first part of its event slug, such as lpga or dpwt for those golf tours. A PGA Tour event slug starts with a year, such as 2026-world-wide-technology-championship, so its markets have the league pga.
settlement is the same object GET /api/v1/games/{event_slug}/markets serves: payouts per share in micro-USDC in outcome order, result (outcome or split), winning_outcome_index, was_disputed, resolved_at (null on a resolved oracle question), oracle_updated_at (when Polymarket last changed the oracle state; on an oracle question, when its answer settled it), and observed_at, when we first saw this state. outcomes holds each outcome name at its index, so outcomes[winning_outcome_index] names the winner.
A resolved oracle question carries no payouts, so payouts stays null on it. Its result and winning_outcome_index come from the payout Polymarket’s ConditionalTokens contract recorded on Polygon, which we read once per market. A question sent before that contract paid has a null winner, and its winner arrives as the next state.
A Polymarket polyv2 copy of a game carries copy_of_event_slug, the original game’s slug. It is sent only to a filter that names its condition ID or its own event slug, so a league subscription does not receive the same game twice. A state we first see more than 6 hours after it resolved is not sent.
protocol_version is the Polymarket protocol the market settles and redeems on: v1, or v2 for the Protocol V2 markets: any market whose Gamma version reads v2, the polyv2 copies included. It is the same value List settled markets returns for the market. A redelivery resends an event exactly as it was first delivered, so an event first delivered before the field existed does not carry it.
List settled markets returns the same rows, oldest first, from a time you choose, on every plan. Use it to catch up after your server was down, or to receive the states this webhook does not send: late ones, and a repeat of a winner already sent. The settlement notifier recipe combines the two.
The OpenAPI spec carries an example delivery, epl_moneyline_settled, that you can sign and post to your own server to test it. The MarketSettled frame on Stream carries the same fields for every game market, without settlement_filters. The Webhooks guide covers signatures, retries, and replay.Authorizations
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
Headers
v1= followed by the hex HMAC-SHA256 of {timestamp}.{raw body} under the endpoint signing secret. During a staged secret rotation, or while 0xinsider rotates the key every signing secret is derived from, it carries up to four comma-separated v1= candidates, the current secret's first: accept the delivery when any one verifies.
Body
market_settled data, also the MarketSettled frame on GET /api/v1/stream: a sports or esports game market settled, sent once per settled state the first time 0xinsider records it. A market can settle in more than one state: a resolved UMA question row with no winner yet, the same row with the winner ConditionalTokens paid on chain, and the condition row with the provider's payouts; each is its own event with its own settlement_id, except a state naming the winner an earlier event named, which is not sent.
Show child attributes
Show child attributes
Response
Return any 2xx status to acknowledge the delivery. Any other status, a redirect, a timeout or a connection error is retried on the published retry policy.
Was this page helpful?