Resolutions - PolyOrderbooks

The resolution parameter controls bucket width for /prices, /metrics, and /books. Native capture runs at 1 second for open markets. Your plan determines the finest resolution you may request — see Pricing.

Supported values

Resolution	Bucket size	Typical use
`1s`	1 second	High-frequency analysis (Pro+)
`60s`	1 minute	Starter default; intraday backtests
`1m`	1 minute	Same bucket size as `60s`
`5m`	5 minutes	Order book snapshots, execution modeling
`10m`	10 minutes	Medium-frequency liquidity studies
`15m`	15 minutes	Session-level trend analysis
`1h`	1 hour	Multi-day dashboards
`6h`	6 hours	Weekly overviews
`1d`	1 day	Long-horizon research

Plan restrictions

Plan	Finest `resolution`	Max history
Starter	`60s`	7 days
Pro	`1s`	31 days
Scale	`1s`	90 days
Enterprise	`1s`	Custom

Requests finer than your plan allow return HTTP 403. Queries with start_ts older than your lookback also return 403. Check live limits on GET /v1/usage:

{
  "limits": {
    "granularity_allowed": "60s",
    "max_history_days": 7
  }
}

Selection guide

Scenario	Recommended resolution
Tick-level backtest	`1s` (Pro+)
Standard intraday bars	`60s` or `1m`
Slippage / depth analysis	`5m` on `/books`
Multi-week chart	`1h` or `1d`

Finer resolutions return more data points and consume more of your rate limit through pagination.

Timestamp format

Parameter	Format	Semantics
`start_ts`	ISO-8601 (`2026-07-26T00:00:00Z`) or Unix seconds	Inclusive
`end_ts`	ISO-8601 or Unix seconds	Exclusive

The query window is half-open: [start_ts, end_ts).

⌘I