Skip to main content
GET
Get one game outcome's fair price
Use this endpoint to price a bet offered elsewhere against Polymarket: it returns one outcome’s fair probability, the odds that probability implies, and a status that says whether the book is tight, deep and fresh enough to trust. To read every market of a game with its quotes, use List game markets. The fair probability is the outcome’s midpoint, normalised over the market’s mutually exclusive outcomes. On a two-way market that is the outcome’s midpoint over the sum of both sides’ midpoints. A soccer 1X2 game lists three Yes/No moneylines, and a leg’s Yes is its midpoint over the three Yes midpoints.

Parameters

Name the outcome one of two ways, not both: condition_id with outcome, or event_slug with market_type and outcome_label. Sending both is a 400.

Key response fields

A value we do not hold is null, never 0. A depth the cache does not hold is book_depth_within_2c: null: it is unknown and fails no check.

Where the quote comes from

The quote is read from the same cache as List game markets with expand=quotes. The request makes no call to Polymarket. When the outcome’s book is not cached yet, the answer is unavailable with cache_miss and the read starts the book, so read again after a few seconds. A book counts as confirmed while the live stream that carries it stays connected and its copy of the book still matches Polymarket’s. Three cases confirm nothing past observed_at: a dropped or stalled stream, a book whose copy stopped matching, and a book read from Polymarket’s REST API (source: clob_rest). Those fail stale_quote 60 seconds after their last change.

Example

The get_fair_price MCP tool calls this endpoint with the same parameters, and @0xinsider/sdk 0.67.0 adds getFairPrice. Price a sportsbook bet against Polymarket turns the answer into an edge, an expected value and a stake.

What it does not return

  • Expected value, an edge or a stake. Compute them from fair.prob and the price you were offered, as the recipe shows.
  • Any price but Polymarket’s. Bring the price you were offered.
  • A market outside a covered game. Its condition id is a 404, and List games lists the covered games.

Caching

The response carries a weak semantic ETag. Send it back as If-None-Match for a 304 with an empty body. The validator leaves out as_of, quote.age_seconds, quote.confirmed_at, quote.confirmed_age_seconds, request_id and cost, so a 304 means the quote, the fee, the fair price and the status are the ones you hold. status still changes to stale_quote once the book goes 60 seconds without a confirmation.

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 validator from a previous ETag. Matching values return 304 Not Modified with an empty body.

Query Parameters

condition_id
string

The market's condition id, raw or the mkt_-prefixed market.id V1 responses emit, from GET /api/v1/games/{event_slug}/markets. Pass it with outcome, or pass event_slug instead; both is a 400.

outcome
enum<integer>

The outcome index to price, 0 or 1, as outcomes[].index on GET /api/v1/games/{event_slug}/markets. Required with condition_id; a 400 with event_slug.

Available options:
0,
1
event_slug
string

The game's event slug from GET /api/v1/games, for example nfl-was-nyg-2026-11-13. Matched case-insensitively. Pass it with market_type and outcome_label, or pass condition_id instead.

market_type
enum<string>

Which of the game's markets: moneyline (who wins), spread (a handicap) or total (over or under). Required with event_slug.

Available options:
moneyline,
spread,
total
outcome_label
string

The side, as the provider labels it: a team name such as Commanders, or Over or Under. A soccer 1X2 leg is named by its title, the team or Draw, and prices that leg's Yes. Matched case-insensitively against the sides of market_type, an open one first. Required with event_slug. When it matches no side, the 404 message lists the game's open sides; when it matches more than one market, the 400 message lists their condition ids.

line
number

The side's own handicap on a spread (-3.5 for the favourite, 3.5 for the underdog) or the total on a total (222.5). Required with market_type spread or total; a 400 with moneyline.

Required range: -1000 <= x <= 1000
max_spread_c
number
default:3

The widest spread, best ask less best bid in cents, that still prices: above 0, at most 100, in steps of 0.01. Default 3. A wider spread fails wide_spread.

Required range: x <= 100Must be a multiple of 0.01
min_book_usd_within_2c
integer
default:500

The least USD each side of the outcome's book must hold within 2 cents of its midpoint: bids at or above the midpoint minus 0.02 and asks at or below the midpoint plus 0.02, each level's price times size. A whole number from 1 to 10000000. Default 500. A thinner side fails thin_book; a depth the cache does not hold fails nothing.

Required range: 1 <= x <= 10000000

Response

The outcome's fair price, or the status that says why it is not fit to price against.

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

One game outcome's Polymarket fair price, with the checks that say whether it is fit to price a bet against.

meta
object
required