Skip to main content
GET
Get the closing line value of a price
Use this endpoint to grade one price you got against the close: the Polymarket price in the last minute before the game started. Send a Polymarket fill as price, or sportsbook odds as odds with format, and the response says how far the price beat or missed the close. For the close alone, use Market closing line. For one wallet’s closing line value over many trades, use Trader closing line value.

Parameters

Key response fields

Every clv figure is null unless status is measured. Each figure is gross of fees.

Example

Grizzlies vs. Raptors closed at 0.525 for the Grizzlies on November 10, 2026. Against that close, +130 has a break-even of 43.48%, so clv.points is about 9.02 and clv.price_pct is 20.75. The figures are not rounded.

What it does not return

  • A figure in place of a missing close. A market without one says pending or unavailable, and every clv figure is null.
  • A close for a market outside sports and esports. That market returns 404 with error.reason market_out_of_scope, and a market 0xinsider has no record of returns 404 too.
  • Fees. Closing line value is gross of fees; the fee belongs in your profit and loss.
  • Several prices at once. Send one request per price.

Caching

Save the response’s ETag and send it in If-None-Match on your next request. If nothing has 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

Conditional GET validator from a previous ETag. Matching values return 304 Not Modified with an empty body.

Query Parameters

condition_id
string
required

Market condition ID. Accepts the raw provider-backed condition_id returned by /api/v1/markets/search or /api/v1/markets/explore, or the mkt_-prefixed market.id emitted by V1 responses.

outcome
enum<integer>
required

The outcome the entry is on: 0 is the first (YES) outcome, 1 the second (NO). The response names both in outcomes.

Available options:
0,
1
price
number

A Polymarket price paid, or received with side=sell, strictly between 0 and 1, such as 0.455. Send price or odds, not both.

odds
string

Sportsbook odds for the outcome: +130 or -140 with format=american (URL-encode the plus sign as %2B), 2.30 with format=decimal. American odds are +100 or more, or -100 or less; decimal odds are above 1; both within 100,000. Send price or odds, not both; odds are always a buy.

format
enum<string>

How odds is written. Required with odds.

Available options:
american,
decimal
side
enum<string>
default:buy

buy (the default) or sell. sell is a Polymarket price received and needs price.

Available options:
buy,
sell
placed_at
string<date-time>

RFC3339 time the bet was placed. At or after the close's anchor (kickoff) the answer is status in_play with no figures. Omitted, the bet is read as placed before kickoff.

Response

The CLV of the price against the market's stored close, or the state that says why there is none.

object
string
required
Allowed value: "clv"
data
object
required
meta
object
required