# Limits

> Plan around send rates, key limits, request sizes, connections and timeouts

<span id="send-rate" />

## Submission rate

The default is 15 sends per second per key at each metro, with bursts of up to one second.
Each metro counts separately, whichever hostname reaches it; `fra.tpu.supanode.xyz` counts
against the metro that serves you. Each transaction uses one submission; queries do
not count. Bundles have [their own rate](https://supanode.xyz/docs/solana/sender/bundles#rates).

Supanode confirms your key rate when issuing it. Request higher limits through [Supanode on Telegram](https://telegram.me/supanode_tgs).

For [`rate_limited`](https://supanode.xyz/docs/solana/sender/reference/errors#rate_limited), use `per_second` and `retry_after_ms` when
included. Slow down and wait before retrying; more connections do not raise the rate.

<span id="keys" />

## Issued keys

Supanode issues and manages keys through Telegram. Request additional keys, replacement or revocation there. Direct-provider team-account limits do not define your customer allocation.

<span id="sizes" />

## Request sizes

| Request | Limit |
| --- | --- |
| Legacy or v0 transaction | 1,232 wire bytes |
| v1 transaction | 4,096 wire bytes |
| Bundle | 1 to 4 transactions, each within its transaction limit |
| JSON-RPC request | 65,536 body bytes; one request per call, batches are refused |

Use base64 for transactions above 1,232 bytes. See [JSON-RPC](https://supanode.xyz/docs/solana/sender/reference/json-rpc),
[HTTP](https://supanode.xyz/docs/solana/sender/reference/http) and [QUIC](https://supanode.xyz/docs/solana/sender/reference/quic) for exact request formats.

[`too_large`](https://supanode.xyz/docs/solana/sender/reference/errors#too_large) reports the allowed `limit` and the submitted `size`
when known. For a bundle, `index` identifies the affected transaction.

## Connections

Reuse connections across submissions.

| Hosted connection | Limit per metro host |
| --- | --- |
| HTTP/HTTPS from one source IPv4 address | 256 open connections combined |
| QUIC using one API key | 32 open connections |

## Timeouts

Finish writing request bodies within 2 seconds. If a request times out or disconnects,
its outcome may be unknown: [check the transaction's signature](https://supanode.xyz/docs/solana/sender/confirmation)
before replacing it.

<span id="capacity" />

## Busy metros

For [`overloaded`](https://supanode.xyz/docs/solana/sender/reference/errors#overloaded) or a temporary [`not_ready`](https://supanode.xyz/docs/solana/sender/reference/errors#not_ready),
wait and retry while the transaction is valid, or choose another [metro host](https://supanode.xyz/docs/solana/sender/endpoints#regions).

<span id="billing" />

## Declared tips

[Arrange declared tips](https://supanode.xyz/docs/solana/sender/tips#declared-tips) with support before using them.
See [Billing](https://supanode.xyz/docs/solana/sender/api-keys) for payment and account guidance.
