Skip to main content
GET
cURL
Use this endpoint to read how one market’s price moved, and whether each move held. It returns the same items, filters and pages as List price moves with condition_id, for one market. A market with no stored move returns an empty page. Every plan with an API key can read it. Each request costs 1.

Parameters

Key response fields

The fields are the same as List price moves: the market_price_moved payload of each move, plus move_id, episode_started_at and outcome_after, the midpoint 15 and 60 minutes later and at kickoff, with held_15m, held_60m and held_kickoff. A null held flag means the checkpoint was not measured, never that the move failed to hold. A page can hold fewer than limit moves while has_more is true. Keep sending next_cursor until has_more is false.

Example

One market’s moves over 5-minute windows:
The CLI command 0xinsider market price-moves <condition_id> and the TypeScript SDK’s listMarketPriceMoves(), from @0xinsider/sdk 0.67.0, call this endpoint. The list_price_moves MCP tool reads the same moves with condition_id.

What it does not return

  • Moves before storing began in November 2026, pre-game moves older than 90 days, and in-play and phase-unknown moves older than 14 days.
  • Moves of other markets in the same game. Use List price moves with event_slug for those.

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.

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

Query Parameters

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