Skip to main content
Time-bucketed OHLCV candles computed from every on-chain fill for one outcome token. Each bucket contains open/high/low/close prices, total USDC volume, share volume, per-side buy/sell volume split, trade count, and VWAP. Top-level response includes market metadata so you never have to look up the market name separately. Built on the v2.fill view — bucketing happens in SQL, not client-side.

Request

Authentication

Paid tier required. Pass your API key via x-api-key, Authorization: Bearer, or ?key=:

Path parameters

Query parameters

Parameter validation

  • token_id: 1-78 digits, ^[0-9]+$.
  • resolution: whitelist {1m, 5m, 15m, 1h, 4h, 1d}.
  • limit: 1-1000. Timestamps: non-negative i64.
Validation failures return 400 Bad Request with {"error": "..."}.

Response

Response fields — candles

Ordered newest-first. Each bucket:

Response fields — envelope

Examples

Error responses

Notes

  • Candles are always returned newest-first (time DESC). If you need oldest-first for charting, reverse client-side.
  • Empty buckets (no trades) are not emitted — callers that want a dense time-series should fill gaps client-side.
  • Price = USDC_amount / share_amount from the fill. In pair-mint fills (rare; both sides outcome tokens), fills are excluded from the candles because there’s no implied price.
  • volume_buy / volume_sell distinguish direction: a buy = someone paid USDC to receive the token, a sell = someone paid the token to receive USDC.
  • VWAP is computed per-bucket, not cumulative. Reconstruct a trailing VWAP client-side by weighting adjacent buckets.
  • If the token_id has never been filled on v2, you get count: 0 with an empty candles: [] — not a 404.