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

# Rate limits

> 5 turns per minute per wallet - 50 free turns each day.

Kviria's limits key on your wallet — the address you sign in with:

| Limit      | Value    | Scope                  |
| ---------- | -------- | ---------------------- |
| Minute     | 5 turns  | per minute, per wallet |
| Free daily | 50 turns | per day, per wallet    |

A "turn" is one call to `POST /v1/agent` (or one playground chat
message) - it includes the candidate picks and confirmations inside a
narrowing conversation. Paid turns (a positive balance) have no daily
cap: they settle per turn at [the per-turn price](/api/payments).

## When you hit a limit

You receive `429` with:

* `Retry-After` - seconds to wait

For a free wallet past its daily 50, the answer is a `402` with
top-up options in the `PAYMENT-REQUIRED` header — see
[Payments](/api/payments).

Back off and retry after the header says so. Never retry in a tight
loop - the answer to a rate limit is patience, not repetition.

## Living within the limits

* A full narrowing conversation is typically **2-4 calls** (candidates ->
  pick -> confirm).
* Questions about a previous answer ("how far was it?") do not need a
  call - the facts are already in your last response.