> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polyorderbooks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Resolutions

> Time bucket granularity for historical endpoints.

The `resolution` parameter controls bucket width for [`/prices`](/api-reference/history/get-market-token-prices-history), [`/metrics`](/api-reference/history/get-market-metrics-history), and [`/books`](/api-reference/history/get-market-order-book-history).

Native capture runs at **1 second** for open markets. Your plan determines the **finest resolution you may request** — see [Pricing](/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`](/api-reference/utility/get-usage-information):

```json theme={null}
{
  "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)`.