v1
latestOpenAPI 3.1.12026-07-23195454.2 KBGet price history
Returns a historical price series for a single outcome token — the last traded price, step-held between trades (built from the outcome's on-chain trades). Every mode includes the market seed's carried-forward bootstrap price before the outcome's first genuine trade, so young markets chart a line from market open. Two modes: Duration mode (default): control the lookback with duration (bucket size is chosen for you); start_ts filters results after fetch. Range mode (pass interval): step-fills buckets at the given interval over the explicit [start_ts, end_ts] window for zoomable line charts. The first point is anchored from the last trade (or seed) before start_ts (so adjacent windows connect) or, if the market did not exist yet, the series begins at the seed. A window that would exceed ~10k buckets is rejected unless changes_only=true. changes_only auto mode (changes_only=true): returns the real price change points for the window (start_ts/end_ts, or end_ts−duration if no start_ts); interval is ignored. Resolution scales with trade density — sparse outcomes return exact change points, very active outcomes read the close price from a pre-aggregated bucket so the chart stays cheap and renderable. Capped at fidelity else ~1000 points. Use fidelity in either mode to cap the number of points (downsampled if exceeded).
Query parameters
Market contract address
Outcome token ID (provide token_id or outcome_index, not both)
Outcome index, 0-based (provide token_id or outcome_index, not both)
Bucket interval (range mode, changes_only=false). IGNORED when changes_only=true — that mode auto-picks resolution by trade density.
Lookback duration (duration mode, default 24h)
End unix timestamp (default: now)
Range mode: window start (required). Duration mode: filters results after fetch.
Max data points returned — downsamples if the window contains more
Return only step edges — drop flat gap-filled buckets where price/payout/collateral/minted_quantity are unchanged (default false; for step-rendered charts)
Response
OK