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

# Closing line value of a price

> Grade a Polymarket price or sportsbook odds against a sports or esports market's stored close, in cents, points and percent.

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](https://docs.0xinsider.com/api-reference/endpoint/get-market-close.md). For one wallet's closing line value over many trades, use [Trader closing line value](https://docs.0xinsider.com/api-reference/endpoint/get-trader-clv.md).

## Parameters

| Parameter | Description |
| - | - |
| `condition_id` | Polymarket's own id for the market, or the market's `mkt_` id. Required. |
| `outcome` | `0` for the first outcome (YES), `1` for the second (NO). Required. |
| `price` | A Polymarket price from 0 to 1, such as `0.45`. Send `price` or `odds`, not both. |
| `odds` | Sportsbook odds, such as `+130` or `2.30`. Requires `format`. |
| `format` | `american` or `decimal`. Required with `odds`. |
| `side` | `buy` (the default) or `sell`. A sell is graded as a buy of the other outcome at 1 minus `price`. Sportsbook odds are always a buy. |
| `placed_at` | When the bet was placed, as an RFC 3339 timestamp. A bet placed at or after kickoff returns `in_play` and no figures. Leave it out for a bet placed before kickoff. |

## Key response fields

| Field | Meaning |
| - | - |
| `status` | `measured` when the close is stored and `clv` carries the figures. `in_play` when `placed_at` is at or after the close. `pending` when the close is not stored yet, for example before kickoff. `unavailable` when no close will be served. |
| `unavailable_reason` | Why there is no close. It is set only when `status` is `unavailable`, with the values [Market closing line](https://docs.0xinsider.com/api-reference/endpoint/get-market-close.md) lists, plus `anchor_stale` when the kickoff moved after the close was stored. |
| `entry.price` | Your break-even probability from 0 to 1: the Polymarket price you paid, or 1 divided by the decimal odds. For a sell, the price you received. |
| `entry.decimal_odds` | The bought side's decimal odds: the total return per 1 staked. |
| `close.price` | The outcome's closing price from 0 to 1. The NO side's is 1 minus the YES side's. It is `null` without a stored close, never `0`. |
| `close.status`, `close.close_anchor_at`, `close.anchor_stale` | The close as [Market closing line](https://docs.0xinsider.com/api-reference/endpoint/get-market-close.md) serves it. |
| `clv.cents` | For a `price` entry: the close minus the price paid, in cents per share. For a sell, the price received minus the close. `null` for an `odds` entry. |
| `clv.points` | The close's probability minus your break-even probability, in percentage points. Positive means you beat the close. |
| `clv.price_pct` | Your decimal odds divided by the close's decimal odds, minus 1, in percent. |
| `clv.ev_at_close_pct` | Your decimal odds times the close's probability, minus 1, in percent: the return your bet carried if the close was the fair price. Against a Polymarket close it equals `price_pct`. |
| `basis_version` | `clv@v1`, the definition every large trade's `clv` uses. |

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

## Example

```bash theme={null}
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/tools/clv?condition_id=0x87b847e161ea1a750e1f094223a644ca374e4d97a7b9d0397974a2f3c67e547d&outcome=0&odds=%2B130&format=american"
```

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.


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