Skip to main content

O que são limites de taxa?

Limites de taxa controlam quantas solicitações você pode fazer por segundo. Quando os limites de taxa são excedidos, você receberá uma resposta HTTP 429. Para orientações sobre o que fazer quando você atingir um erro 429 ou outra falha transitória, veja Repetições e tratamento de erros abaixo.

Limites de Taxa Padrão

Seu plano possui dois grupos padrão de limites de taxa: um para solicitações RPC e outro para solicitações da API DAS. Aqui estão os limites de taxa base para cada plano Helius:
PlanoLimite de Taxa RPCAPIs DAS & Aprimoradas
Grátis10 solicitações/s2 solicitações/s
Desenvolvedor50 solicitações/s10 solicitações/s
Empresarial200 solicitações/s50 solicitações/s
Profissional500 solicitações/s100 solicitações/s
EnterprisePersonalizadoPersonalizado

Aumentar Limites de Taxa

Equipes em planos Profissionais podem adquirir um adicional de 100 RPS por $100/mês. Se você precisar de limites de taxa personalizados antes dos lançamentos, contate nossa equipe de vendas. Se você está no nível Desenvolvedor ou Empresarial, atualize seu plano para aumentar seus limites de taxa.

Limites de Taxa Especiais

Alguns endpoints e produtos especializados Helius têm limites de taxa especiais devido aos seus requisitos computacionais.

Envio de Transações

EndpointGrátisDesenvolvedorEmpresarialProfissional
Sender50/s50/s50/s50/s
sendTransaction1/s5/s50/s100/s
sendBundle5/s5/s
simulateBundle10/s50/s200/s500/s
Se você estiver em um plano Profissional e precisar aumentar seus limites de taxa sendTransaction, contate nossa equipe de vendas. Usuários do plano Profissional também podem solicitar aumentos de limites de taxa e arranjos de gorjeta personalizados para o Sender, para suportar aplicativos de negociação de maior throughput.

Chamadas RPC Complexas

EndpointGrátisDesenvolvedorEmpresarialProfissional
getProgramAccounts5/s25/s50/s75/s

Dados Históricos

Ao fazer solicitações em lote para métodos de dados históricos, os seguintes limites se aplicam:
MétodoTamanho Máximo do Lote
getTransaction100 itens por solicitação
getTransactionsForAddressNão são permitidas solicitações em lote
getTransfersByAddressNão são permitidas solicitações em lote
Todos os outros métodos históricos10 itens por solicitação
Exceder os limites de lote resultará em uma resposta de erro. Para getTransactionsForAddress e getTransfersByAddress, cada endereço deve ser consultado em uma solicitação separada.

LaserStream

RecursoGrátisDesenvolvedorEmpresarialProfissional
RedesDevnetDevnet, MainnetDevnet, Mainnet
Máx. de Chaves Públicas10M10M10M
Conexões Ativas10100

API de Carteira

A API de Carteira segue os mesmos limites de taxa que as APIs DAS & Aprimoradas. Todos os endpoints compartilham esses limites:
EndpointGrátisDesenvolvedorEmpresarialProfissional
Todos os Endpoints da API de Carteira2/s10/s50/s100/s
Isso inclui buscas de identidade, saldos, histórico, transferências e endpoints de fonte de financiamento. Saiba mais em nossa documentação da API de Carteira.

WebSocket LaserStream

RecursoGrátisDesenvolvedorEmpresarialProfissional
Conexões Concorrentes51502501.000
Assinaturas por Conexão1.0001.0001.0001.000
Tipos de WebSocketPadrãoPadrão, AprimoradoPadrão, AprimoradoPadrão, Aprimorado

Webhooks

RecursoGrátisDesenvolvedorEmpresarialProfissional
Máx. de Webhooks5505050
Endereços por Webhook100k100k100k100k

Compressão ZK

ServiçoGrátisDesenvolvedorEmpresarialProfissional
APIs Photon2/s10/s50/s100/s
getValidityProof1/s5/s10/s20/s

Repetições e tratamento de erros

Quando sua aplicação recebe uma 429 Too Many Requests, 503 Service Unavailable, ou resposta transitória 5xx, espere um momento e tente novamente — não tente novamente imediatamente. Repetições imediatas acumulam solicitações e tornam a recuperação do limite de taxa mais lenta, não mais rápida.

Estratégia recomendada

  • Espere cerca de 1 segundo antes da primeira repetição.
  • Dobre a espera cada vez que tentar de novo, até um máximo de 30 segundos.
  • Adicione uma pequena variação aleatória de ±25% a cada espera para que várias aplicações não repitam todas ao mesmo tempo.
  • Desista após 5 tentativas e retorne o erro ao código que o chamou.

Quais erros repetir

Exemplo

Formato da resposta de erro

Todas as APIs Helius retornam um corpo JSON estruturado em caso de erro. Os endpoints JSON-RPC (Solana RPC, DAS, Sender, Priority Fee, ZK Compression) retornam o envelope padrão JSON-RPC 2.0:
Os endpoints REST (API de Carteira, API de Administração) retornam:
Veja Códigos de erro comuns para a lista completa de códigos de erro e o que cada um significa.