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

# List price moves

> List the stored price moves in sports and esports markets, newest first, with whether each move held 15 minutes, 60 minutes and at kickoff.

Use this endpoint to read past price moves: every time a sports or esports market's price moved 2 cents or more inside 60, 120, 300 or 900 seconds. Each item is the [`market_price_moved`](https://docs.0xinsider.com/api-reference/webhooks/market-price-moved) webhook payload, plus whether the move held afterwards. Use it to catch up on pushes you missed, or to study how often moves of a given size hold. For one market only, use [List market price moves](https://docs.0xinsider.com/api-reference/endpoint/list-market-price-moves.md).

Every plan with an API key can read it. Each request costs 1.

## Parameters

| Parameter | Meaning |
| - | - |
| `league` | Optional. One league, lowercase, as the event slug starts: `nba`, `nfl`, `epl`, `cs2`. A league with no stored move returns an empty page. |
| `event_slug` | Optional. One Polymarket event, a game: the moves of each of its markets. An event outside sports and esports is a `404` with `error.reason` `market_out_of_scope`. A slug that no market we store carries is a `404` with `error.code` `not_found` and `error.param` `event_slug`. |
| `condition_id` | Optional. One market: its raw `condition_id`, or the `mkt_` id other responses carry. A market outside sports and esports is a `404` with `error.reason` `market_out_of_scope`. An id that no market we store has is a `404` with `error.code` `not_found` and `error.param` `condition_id`. |
| `min_move_cents` | Optional. The smallest whole-cent level the move reached, from 1 to 99. The default is 1. Moves are stored from 2 cents, so 1 and 2 both return every move. |
| `window_seconds` | Optional. `60`, `120`, `300` or `900`: only moves measured over that window. |
| `phase` | Optional. `pre_game` or `in_play`. Without it, every move is listed, including moves whose game phase was unknown. |
| `held` | Optional. `15m`, `60m` or `kickoff`: only moves that held at that checkpoint. A move not measured there yet is left out. |
| `min_book_usd_within_2c` | Optional. A whole number of dollars. Only moves with at least this much resting within 2 cents of the midpoint, on each side, when the move was detected. A move with no depth reading is left out. |
| `since` | Optional. An RFC 3339 time. Only moves whose episode started at or after it. Pre-game moves are served for 90 days, in-play and phase-unknown moves for 14. |
| `until` | Optional. An RFC 3339 time. Only moves whose episode started before it. `since` must be before `until`, or the read is a `400` with `error.param` `since`. |
| `limit` | Optional. How many moves to return, from 1 to 200. The default is 50, and a value outside the range is clamped. |
| `cursor` | Optional. The `next_cursor` value from an earlier response. Send the same filters with it. |

Name at most one of `league`, `event_slug` and `condition_id`. Two of them is a `400` whose `error.param` names the second.

## Key response fields

| Field | Meaning |
| - | - |
| `data[]` | The moves, newest first by `episode_started_at`, then `move_id`. |
| `data[].move_id` | `mv_` and a number. It stays the same for the life of the move. |
| `data[].episode_started_at` | When the move began. The order of every page, and what `since` and `until` filter. |
| `data[].condition_id`, `event_slug`, `league`, `label` | The market, its game, its league, and outcome 0's name. |
| `data[].direction`, `from_price`, `to_price`, `move_cents`, `level_cents` | Which way outcome 0's midpoint moved, from what price to what price, by how many cents, and the whole-cent level it reached. |
| `data[].window_seconds`, `detected_at` | The window the move was measured over, and when it was detected. One market and window can fire several times as a move grows; the item holds the largest step. |
| `data[].best_bid`, `best_ask`, `spread_cents`, `book_depth_within_2c` | The book when the move was detected. |
| `data[].phase`, `game_state`, `concurrent_sharp_flow` | The game phase and score, and the large trades on the market during the window. |
| `data[].outcome_after.mid_15m`, `mid_60m`, `mid_kickoff` | Outcome 0's midpoint 15 minutes after `detected_at`, 60 minutes after it, and at the scheduled kickoff of a pre-game move. Each comes with the time it was read (`mid_15m_at`, and so on). |
| `data[].outcome_after.held_15m`, `held_60m`, `held_kickoff` | `true` when the midpoint there kept at least half of the move: `(mid - from_price) / (to_price - from_price)` is 0.5 or more. `false` when it gave back more than half. `null` when it was not measured. |
| `data[].outcome_after.*_unavailable_reason` | Why a checkpoint has no midpoint: `no_quote` when the book had no two-sided quote with a spread of 10 cents or less, `missed` when no read happened within 5 minutes of the checkpoint, and for kickoff `not_pre_game` or `no_scheduled_start`. |
| `data[].outcome_after.status` | `pending` while a checkpoint is still to come, `final` once nothing in `outcome_after` changes again. |
| `has_more` | `true` when older moves may remain. Send `next_cursor` for them. |
| `next_cursor` | The cursor for the next page. It is absent when `has_more` is `false`. |

A page reads a fixed share of the stored moves, so with narrow filters it can hold fewer than `limit` moves, even none, while `has_more` is `true`. Keep sending `next_cursor` until `has_more` is `false`.

If a read misses our 200 ms read deadline, the response is a `503` with `error.reason` `read_model_warming` and `Retry-After: 1`. Send the same request again after it.

## Example

NBA moves before kickoff of 3 cents or more that held at 60 minutes:

```bash theme={null}
curl -sS \
  -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  'https://api.0xinsider.com/api/v1/price-moves?league=nba&phase=pre_game&min_move_cents=3&held=60m'
```

The `list_price_moves` MCP tool calls this endpoint with the same parameters. So do the CLI command `0xinsider price-moves list`, and the TypeScript SDK's `listPriceMoves()`, from `@0xinsider/sdk` 0.67.0.

## What it does not return

* Moves before storing began in November 2026. Earlier moves were only pushed by webhook and stream.
* Pre-game moves older than 90 days, and in-play and phase-unknown moves older than 14 days. They are deleted. With `phase=in_play`, the last page is the one that reaches 14 days back. Without `phase`, pages older than that hold pre-game moves only.
* Moves smaller than 2 cents, and moves on a book with no two-sided quote.
* Moves on outcome 1. A move is measured on outcome 0, and outcome 1 is its complement.

## Caching

The response carries a weak semantic `ETag`. Send it back as `If-None-Match` for a `304` with an empty body. `request_id` and `cost` are excluded from the validator.


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