Skip to main content

RATE_LIMITED

You are sending faster than your rate class allows.

HTTP status429
GroupRelay path
RetryableYes — the same request may be sent again
Re-signSAME_BYTES — resend the transaction you already have, byte for byte

What happened​

Rate classes bound Relay Units per second, gas per second per shard and Relay Units per hour.

What to do​

Honour Retry-After / details.retryAfterMs and resend the same bytes.

Extra members​

This code carries retryAfterMs, scope in the problem document, on top of the common members.

The problem document​

Every error is application/problem+json (RFC 9457) with the same shape:

{
"type": "https://docs.co-relayer.com/errors/rate-limited",
"title": "You are sending faster than your rate class allows.",
"status": 429,
"detail": "A sentence about this specific occurrence.",
"instance": "req_01JB…",
"code": "RATE_LIMITED",
"retryable": true,
"resign": "SAME_BYTES",
"hint": "Honour `Retry-After` / `details.retryAfterMs` and resend the same bytes."
}

See the error model for what each member means and how to handle unknown codes.