> ## Documentation Index
> Fetch the complete documentation index at: https://vlyai-1c28d863.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Rate limits

> Per-key rate limits, headers, and how to handle 429 responses.

vly's API enforces a per-key rate limit. Default is **60 requests per minute**, with burst capacity of \~10 requests in the first second. Plans above Pro raise the limit.

## Limits by plan

| Plan | Requests / min | Burst |
| - | - | - |
| Free | 60 | 10 |
| Pro | 600 | 50 |
| Business | 6,000 | 200 |
| Enterprise | Custom | Custom |

## Headers

Every API response includes:

```
X-RateLimit-Limit:     600
X-RateLimit-Remaining: 587
X-RateLimit-Reset:     1713400000
```

`Reset` is a Unix timestamp; the limit refills at that time.

## Handling 429

When you exceed the limit:

```http theme={null}
HTTP/1.1 429 Too Many Requests
Retry-After: 12

{
  "error": {
    "code": "key_rate_limited",
    "message": "Rate limit exceeded. Retry in 12 seconds."
  }
}
```

Wait `Retry-After` seconds, then retry. The vly SDKs do this automatically with exponential backoff.

## Best practices

<CardGroup cols={2}>
  <Card title="Use the SDKs" icon="package">
    They handle 429s, retries, and backoff for you.
  </Card>

  <Card title="Batch where possible" icon="layers">
    Many small calls = high request count. One bigger call = lower.
  </Card>

  <Card title="Cache idempotent responses" icon="archive">
    Especially for `GET` endpoints whose data doesn't change often.
  </Card>

  <Card title="Use webhooks" icon="webhook">
    Don't poll. Subscribe to events you care about; vly pushes them.
  </Card>
</CardGroup>

## Related

<CardGroup cols={3}>
  <Card title="Errors" icon="alert-triangle" href="/api-reference/errors">
    Full error code reference.
  </Card>

  <Card title="Authentication" icon="key" href="/api-reference/authentication">
    Per-key scoping affects rate limits.
  </Card>

  <Card title="SDKs" icon="code" href="/api-reference/sdks/typescript">
    Auto-handle rate limit retries.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.