Skip to main content
GET
cURL
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 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. Every plan with an API key can read it. Each request costs 1.

Parameters

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

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

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 using a weak semantic ETag from an earlier response. A matching payload returns 304 with an empty body; request_id and cost are excluded from the validator.

Query Parameters

league
string

One league prefix, lowercase, as the event slug starts: nba, nfl, epl, cs2. Name at most one of league, event_slug and condition_id.

event_slug
string

One Polymarket event (game): the moves of each of its markets. An event outside sports and esports returns 404 market_out_of_scope.

condition_id
string

One market's moves, as GET /api/v1/market/{condition_id}/price-moves returns them. Accepts the raw condition_id or the mkt_-prefixed market.id.

min_move_cents
integer
default:1

Least whole-cent level the move reached (level_cents). The detector stores moves of 2 cents or more, so 1 and 2 both return every move.

Required range: 1 <= x <= 99
window_seconds
enum<integer>

Only moves measured over this window, in seconds. Omitted: every window.

Available options:
60,
120,
300,
900
phase
enum<string>

Only moves detected in this game phase. Omitted: every phase, unknown included.

Available options:
pre_game,
in_play
held
enum<string>

Only moves that held at this checkpoint: outcome 0's midpoint there kept at least half of the move, (mid - from_price) / (to_price - from_price) >= 0.5. A move not measured there yet, or with no price there, is left out.

Available options:
15m,
60m,
kickoff
min_book_usd_within_2c
integer

Only moves whose book_depth_within_2c was measured and held at least this many USD within 2 cents of the midpoint on each side; a move with no measured depth is left out. The webhook filter of the same name applies the same rule.

Required range: 0 <= x <= 4294967295
since
string<date-time>

Inclusive RFC 3339 lower bound on episode_started_at. Earlier than the retention, or omitted: the retention, 90 days ago for pre-game moves and 14 days ago for in-play and phase-unknown moves.

until
string<date-time>

Exclusive RFC 3339 upper bound on episode_started_at. Omitted: now.

limit
integer
default:50

Page size. Out-of-range values are clamped to 1..200.

Required range: 1 <= x <= 200
cursor
string

Opaque pm_v1_ cursor from next_cursor. It continues the walk before the position it names; send the same filters with it. A cursor these routes did not issue returns 400 with error.param=cursor.

Response

One page of stored price moves

object
string
required
Allowed value: "list"
data
object[]
required

Newest episode first by episode_started_at, then move_id. Can hold fewer than limit moves, even none, while has_more is true.

has_more
boolean
required

True when older moves may remain: send next_cursor for them. A page reads a fixed share of the history, so follow next_cursor until has_more is false rather than stopping at a short page.

meta
object
required
next_cursor
string

Opaque pm_v1_ cursor for the next page; absent when has_more is false.

total
integer