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

# Rate limits & quotas

> Per-plan limits, enforced in fixed UTC windows, surfaced in headers.

## Plans

| Plan  | Price         | Per minute | Per day | Per month |
| ----- | ------------- | ---------- | ------- | --------- |
| Free  | \$0           | 30         | 250     | —         |
| Build | contact sales | 300        | —       | 100,000   |
| Scale | custom        | custom     | —       | custom    |

Terminal Pro subscribers get Build limits included with their subscription. Build and
Scale are not self-serve at the moment — both are set up with the team:
[saif@astreus.ai](mailto:saif@astreus.ai).

Limits are per **account**, not per key — minting more keys does not raise your ceiling.
Windows are fixed and UTC-aligned (minute, day, calendar month), enforced atomically across
all serving instances.

## Prepaid credits

Volume beyond your plan's included allowance can be covered by **prepaid credits** at a
flat **\$0.02/request**. Credits are currently arranged with the team rather than bought
self-serve; existing balances keep working. When a request is paid from
credits the response carries `X-Billing-Source: credits` and `X-Credits-Remaining-USD`.
Credits buy volume, never rate: the per-minute ceiling always applies. With no quota left
**and** no credits, the `429` carries `code: "quota_exceeded"` and a `sales_email`.

## Headers

Every API-key response reports where you stand:

```
RateLimit-Limit: 30
RateLimit-Remaining: 27
RateLimit-Reset: 41
X-Quota-Limit: 100000        (quota-carrying plans)
X-Quota-Remaining: 98314
X-Quota-Reset: 2026-10-01T00:00:00.000Z
```

## When you hit a limit

A `429` tells you which ceiling you hit and when to come back:

```json theme={null}
{ "error": "Too many requests. Slow down.", "code": "rate_limited", "retry_after_s": 41 }
```

```json theme={null}
{
  "error": "Monthly request quota exhausted and no prepaid credits available. API plans and credits are currently set up by our team rather than self-serve. Contact sales at …",
  "code": "quota_exceeded",
  "quota": 100000,
  "resets_at": "2026-10-01T00:00:00.000Z",
  "sales_email": "…"
}
```

Honour `Retry-After`. Well-behaved clients back off exponentially and never retry a
`quota_exceeded` before the reset instant.

<Tip>
  Fetch whole objects, not lines: one `/financials` call returns the complete income
  statement, balance sheet and cash flow for up to 200 periods.
</Tip>