Rate Limit

Limites sustentados e burst por endpoint.

Tiers

Cada endpoint tem dois limites: sustained (req/min) e burst (req em janela de 5s). Excedeu burst = 429 imediato. Excedeu sustained = 429 até reset.

Headers de rate limit

  • X-RateLimit-Limit
  • X-RateLimit-Remaining
  • X-RateLimit-Reset
  • X-Burst-Limit
  • X-Burst-Remaining

Tabela por endpoint

EndpointSustainedBurst
GET /v1/health60/min10/5s
GET /v1/market/rates60/min10/5s
GET /v1/scopes60/min10/5s
GET /v1/account/me30/min5/5s
PATCH /v1/account/me10/min3/5s
GET /v1/account/wallets30/min5/5s
GET /v1/transactions30/min5/5s
GET /v1/fee-rules30/min5/5s
POST /v1/deposit/create10/min3/5s
GET /v1/deposit-status/:id60/min10/5s
GET /v1/deposit/quote30/min5/5s
POST /v1/qr/create15/min3/5s
GET /v1/qr30/min5/5s
GET /v1/qr/:slug60/min10/5s
POST /v1/qr/update
alias REST: PATCH /v1/qr/:slug
15/min3/5s
POST /v1/qr/delete
alias REST: DELETE /v1/qr/:slug
10/min3/5s
POST /v1/qr/pay30/min5/5s
POST /v1/links/create15/min3/5s
GET /v1/links30/min5/5s
GET /v1/links/:slug60/min10/5s
GET /v1/links/:slug/transactions30/min5/5s
POST /v1/links/update
alias REST: PATCH /v1/links/:slug
15/min3/5s
POST /v1/links/delete
alias REST: DELETE /v1/links/:slug
10/min3/5s
POST /v1/links/pay30/min5/5s
POST /v1/withdraw/create6/min2/5s
GET /v1/withdraw-status30/min5/5s
GET /v1/withdraw-status/:id60/min10/5s

Códigos 429

  • RATE_LIMIT_EXCEEDED
  • BURST_EXCEEDED
  • PROVIDER_BACKPRESSURE
  • ABUSE_SUSPEND

Estratégia de retry

Em 429, leia Retry-After e implemente backoff exponencial com jitter. Não retry sem espera.