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 os limites de taxa

As equipes com planos Profissionais podem comprar mais 100 RPS por US$ 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
sendBundle——5/s5/s
simulateBundle10/s50/s200/s500/s
As solicitações sem chave do Sender /fast são limitadas a 1 solicitação por segundo por IP de saída, por região. Os clientes que estão atrás da mesma NAT compartilham esse limite. As solicitações 429 rejeitadas contam para o limite; /ping não conta. Acrescente a chave de API do seu projeto Helius existente para obter o limite de 50 solicitações por segundo, por chave e por região.
Se você usa um plano Profissional e precisa aumentar os limites de taxa de sendTransaction, entre em contato com nossa equipe de vendas. Os usuários do plano Profissional também podem solicitar aumentos dos limites de taxa e configurações personalizadas de gorjetas para que o Sender ofereça suporte a aplicativos de negociação com maior volume de processamento.

Chamadas RPC complexas

EndpointGratuitoDesenvolvedorEmpresarialProfissional
getProgramAccounts5/s25/s50/s75/s

Dados históricos

Ao fazer solicitações em lote para métodos de dados históricos, aplicam-se os seguintes limites:
MétodoTamanho máximo do lote
getTransaction100 itens por solicitação
getTransactionsForAddressSolicitações em lote não são permitidas
getTransfersByAddressSolicitações em lote não são permitidas
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

RecursoGratuitoDesenvolvedorEmpresarialProfissional
Redes—DevnetDevnet, MainnetDevnet, Mainnet
Máximo de chaves públicas—10M10M10M
Conexões ativas——10100

Wallet API

A Wallet API segue os mesmos limites de taxa que as APIs DAS e Enhanced. Todos os endpoints compartilham estes limites:
EndpointGratuitoDesenvolvedorEmpresarialProfissional
Todos os endpoints da Wallet API2/s10/s50/s100/s
Isso inclui endpoints de consultas de identidade, saldos, histórico, transferências e fontes de financiamento. Saiba mais em nossa documentação da Wallet API.

Fluxos analisados

RecursoGratuitoDesenvolvedorEmpresarialProfissional
Conexões simultâneas5105050
Assinaturas por conexão25252525
As conexões são contabilizadas por projeto, considerando todas as suas chaves de API. Um projeto que atinge seu limite de conexões recebe HTTP 429. Consulte os limites de fluxos analisados para ver os limites por filtro e por mensagem.

WebSocket do LaserStream

RecursoGratuitoDesenvolvedorEmpresarialProfissional
Conexões simultâneas51502501,000
Assinaturas por conexão1,0001,0001,0001,000
Tipos de WebSocketPadrãoPadrão, avançadoPadrão, avançadoPadrão, avançado

Webhooks

RecursoGratuitoDesenvolvedorEmpresarialProfissional
Máximo de webhooks5505050
Endereços por webhook100k100k100k100k

Compactação ZK

ServiçoGratuitoDesenvolvedorEmpresarialProfissional
APIs Photon2/s10/s50/s100/s
getValidityProof1/s5/s10/s20/s

Novas tentativas e tratamento de erros

Quando seu aplicativo receber uma resposta 429 Too Many Requests, 503 Service Unavailable ou 5xx transitória, aguarde um momento e tente novamente — não tente de novo imediatamente. As novas tentativas imediatas acumulam solicitações e tornam a recuperação do limite de taxa mais lenta, não mais rápida.

Estratégia recomendada

  • Aguarde cerca de 1 segundo antes da primeira nova tentativa.
  • Dobre o tempo de espera a cada nova tentativa, até o máximo de 30 segundos.
  • Adicione uma pequena variação aleatória de ±25% a cada espera para que vários aplicativos não tentem novamente no mesmo instante.
  • Desista após 5 tentativas e retorne o erro ao código que fez a chamada.

Quais erros devem ser repetidos

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 (Wallet API, Admin API) retornam:
Consulte Códigos de erro comuns para ver a lista completa de códigos de erro e o significado de cada um.