> ## Documentation Index
> Fetch the complete documentation index at: https://docs.0xinsider.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> The Markdown of an API reference page leaves out the OpenAPI schema.
> Every object an endpoint returns or a webhook carries, with each field's type, presence and meaning, is on https://docs.0xinsider.com/api-reference/objects.md.
> The full OpenAPI 3.1 spec names each operation's and each webhook's exact parameters, request body and response schema: https://docs.0xinsider.com/api-reference/openapi.json.

# Get fair price

> Get the Polymarket fair probability of one game outcome, with its odds, the taker fee and whether the book is fit to price a bet against.

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](https://docs.0xinsider.com/api-reference/endpoint/list-game-markets.md).

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`.

| Parameter | Meaning |
| - | - |
| `condition_id` | The market's condition id, raw or the `mkt_`-prefixed `market.id` from [List game markets](https://docs.0xinsider.com/api-reference/endpoint/list-game-markets.md). Send it with `outcome`. |
| `outcome` | The outcome index to price, `0` or `1`, as `outcomes[].index` on [List game markets](https://docs.0xinsider.com/api-reference/endpoint/list-game-markets.md). Required with `condition_id`, and a `400` with `event_slug`. |
| `event_slug` | The game's event slug from [List games](https://docs.0xinsider.com/api-reference/endpoint/list-games.md), for example `nfl-was-nyg-2026-11-13`. Matched case-insensitively. Send it with `market_type` and `outcome_label`. |
| `market_type` | `moneyline` (who wins), `spread` (a handicap) or `total` (over or under). Required with `event_slug`. |
| `outcome_label` | 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, an open side first. 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` | 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 `spread` or `total`, and a `400` with `moneyline`. |
| `max_spread_c` | Optional. The widest spread, best ask less best bid in cents, that still prices. Above 0, at most 100, in steps of 0.01. The default is `3`. A wider spread fails `wide_spread`. |
| `min_book_usd_within_2c` | Optional. The least USD each side of the outcome's book must hold within 2 cents of its midpoint. A whole number from 1 to 10,000,000. The default is `500`. A thinner side fails `thin_book`. |

## Key response fields

| Field | Meaning |
| - | - |
| `data.status` | `ok` when the book is two-sided, within `max_spread_c`, at or above `min_book_usd_within_2c` where the depth is known, and confirmed current within 60 seconds. `closed` when the market closed or resolved. `unavailable` when there is no midpoint. Otherwise the first entry of `failed_checks`. |
| `data.failed_checks` | Every check the quote failed, in this order: `wide_spread`, `thin_book`, `stale_quote` (the book was last confirmed current more than 60 seconds before `as_of`, so `quote.confirmed_age_seconds` is above 60). Empty when none failed. |
| `data.unavailable_reason` | Set exactly when `status` is `unavailable`. `cache_miss` means the cache holds no book for the outcome yet and this read starts its live book, so a read a few seconds later may answer. The spec lists every other reason. |
| `data.fair.prob`, `prob_mid` | The fair probability, 0 to 1, and the outcome's own midpoint before normalising. `null` without a midpoint. |
| `data.fair.decimal_odds`, `american_odds` | The odds the fair probability implies: `1 / prob`, and the same price as American odds. A price longer than these is positive expected value at the fair probability. |
| `data.fair.method` | `two_way_mid` or `three_way_mid`. |
| `data.quote` | The outcome's cached `best_bid`, `best_ask`, `mid` and `spread_c`, with `source`. `book_depth_within_2c` holds the USD resting within 2 cents of the midpoint on each side, as `bid_usd` and `ask_usd`. |
| `data.quote.observed_at`, `age_seconds` | When the bid or ask last changed, and the seconds since then. A quiet book keeps this time for as long as it stands, so a deep book nobody trades can show minutes here and still be current. |
| `data.quote.confirmed_at`, `confirmed_age_seconds` | The last time the book is known to have been current, and the seconds since then. It is `observed_at` or later: the live Polymarket stream keeps confirming an unchanged book about every 10 seconds. `stale_quote` reads `confirmed_age_seconds`. |
| `data.fee` | The taker fee a buy at `quote.best_ask` pays: fee per share = `rate` x (p x (1 - p))^`exponent`, with p the ask. `taker_all_in_ask` is what one share costs a taker. `basis` is `observed` (the market's own fee curve), `disabled` (the market charges no fee) or `assumed` (no record in hand: the 0.05 sports rate, exponent 1). |
| `data.game.start`, `started` | The stored kickoff, and whether it had passed at `as_of`. When `started` is `true`, the price may be in play. Both are `null` when the kickoff is unknown. |
| `data.thresholds` | The limits this answer was checked against: `max_spread_c`, `min_book_usd_within_2c` and `max_quote_age_seconds` (60). |
| `data.three_way` | `true` on a leg of a soccer 1X2 game. |
| `data.protocol_version` | The Polymarket protocol the market trades on: `v1` (CTF) or `v2` (Protocol V2). On a `v2` market, the outcome's token id is its Protocol V2 position id, so sign its orders for ExchangeV3 and read its balance as `CONDITIONAL-V2`. |

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](https://docs.0xinsider.com/api-reference/endpoint/list-game-markets.md) 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

```bash theme={null}
curl -sS \
  -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  'https://api.0xinsider.com/api/v1/fair-price?event_slug=nfl-was-nyg-2026-11-13&market_type=moneyline&outcome_label=Commanders'
```

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](https://docs.0xinsider.com/recipes/price-a-sportsbook-bet.md) 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](https://docs.0xinsider.com/api-reference/endpoint/list-games.md) 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.


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.0xinsider.com/llms.txt).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.