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

# Pricing & plans

> Plan tiers, enforced limits, and upgrade paths on the hosted API.

Plan limits are **enforced on every API key** at `api.polyorderbooks.com`. Your key inherits the tier on your account.

<Note>
  **Checkout for paid plans** (Pro, Scale) is rolling out soon. Until billing is live, new accounts receive **Starter** (free). Contact us for Enterprise or early Pro access.
</Note>

## Plans at a glance

| Plan           | Price   | Req / min | Req / day | Finest resolution | History window |
| -------------- | ------- | --------- | --------- | ----------------- | -------------- |
| **Starter**    | Free    | 60        | 1,000     | `60s`             | 7 days         |
| **Pro**        | \$19/mo | 300       | 50,000    | `1s`              | 31 days        |
| **Scale**      | \$49/mo | 1,000     | 200,000   | `1s`              | 90 days        |
| **Enterprise** | Custom  | Custom    | Custom    | `1s`              | Custom         |

Enterprise accounts receive negotiated limits (higher throughput, longer history, and SLAs). Contact [contact@polyorderbooks.com](mailto:contact@polyorderbooks.com) for details.

All plans include discovery, prices, metrics, and order books on **crypto** markets.

See live pricing copy at [polyorderbooks.com/pricing](https://polyorderbooks.com/pricing).

## What limits mean

### Rate limits

* **Per minute** — rolling window; when exceeded, responses are HTTP `429` with a `Retry-After` header (seconds).
* **Per day** — counted in UTC; resets at **midnight UTC**.

Monitor usage with [`GET /v1/usage`](/api-reference/utility/get-usage-information) or the [dashboard](https://polyorderbooks.com/dashboard).

### Resolution floor

Open markets are captured every **1 second**. Your plan controls the **finest `resolution` you may request**:

* **Starter** — down to `60s` (or `1m`, same bucket size).
* **Pro / Scale / Enterprise** — down to `1s`.

Requesting `1s` on Starter returns HTTP `403`.

### History window

`start_ts` cannot be older than your plan's lookback from now (UTC). Violations return HTTP `403` with the earliest allowed timestamp in the message.

## Example — Starter usage response

```bash theme={null}
curl -s -H "X-API-Key: $POLYORDERBOOKS_API_KEY" \
  "https://api.polyorderbooks.com/v1/usage" | jq
```

```json theme={null}
{
  "plan": "starter",
  "organization": "your-display-name",
  "limits": {
    "requests_per_minute": 60,
    "requests_remaining": 58,
    "granularity_allowed": "60s",
    "max_history_days": 7,
    "data_points": {
      "metrics": true,
      "prices": true,
      "books": true
    }
  },
  "reset_at": 1754140860
}
```

## Upgrading

When checkout launches, upgrade from the [pricing page](https://polyorderbooks.com/pricing) or dashboard. Until then:

* **Starter** — [sign up](https://polyorderbooks.com/signup) (free).
* **Enterprise** — email [contact@polyorderbooks.com](mailto:contact@polyorderbooks.com) for custom limits, exports, or SLAs.

## Related

<CardGroup cols={2}>
  <Card title="Rate limits" icon="gauge-high" href="/rate-limits">
    429 handling, backoff, and bulk access patterns.
  </Card>

  <Card title="Resolutions" icon="clock" href="/historical/resolutions">
    Bucket sizes and plan restrictions.
  </Card>
</CardGroup>