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:
| Plano | Limite de Taxa RPC | APIs DAS & Aprimoradas |
|---|
| Grátis | 10 solicitações/s | 2 solicitações/s |
| Desenvolvedor | 50 solicitações/s | 10 solicitações/s |
| Empresarial | 200 solicitações/s | 50 solicitações/s |
| Profissional | 500 solicitações/s | 100 solicitações/s |
| Enterprise | Personalizado | Personalizado |
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
| Endpoint | Grátis | Desenvolvedor | Empresarial | Profissional |
|---|
Sender | 50/s | 50/s | 50/s | 50/s |
sendTransaction | 1/s | 5/s | 50/s | 100/s |
sendBundle | — | — | 5/s | 5/s |
simulateBundle | 10/s | 50/s | 200/s | 500/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
| Endpoint | Grátis | Desenvolvedor | Empresarial | Profissional |
|---|
getProgramAccounts | 5/s | 25/s | 50/s | 75/s |
Dados Históricos
Ao fazer solicitações em lote para métodos de dados históricos, os seguintes limites se aplicam:
| Método | Tamanho Máximo do Lote |
|---|
getTransaction | 100 itens por solicitação |
getTransactionsForAddress | Não são permitidas solicitações em lote |
getTransfersByAddress | Não são permitidas solicitações em lote |
| Todos os outros métodos históricos | 10 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
| Recurso | Grátis | Desenvolvedor | Empresarial | Profissional |
|---|
| Redes | — | Devnet | Devnet, Mainnet | Devnet, Mainnet |
| Máx. de Chaves Públicas | — | 10M | 10M | 10M |
| Conexões Ativas | — | — | 10 | 100 |
API de Carteira
A API de Carteira segue os mesmos limites de taxa que as APIs DAS & Aprimoradas. Todos os endpoints compartilham esses limites:
| Endpoint | Grátis | Desenvolvedor | Empresarial | Profissional |
|---|
| Todos os Endpoints da API de Carteira | 2/s | 10/s | 50/s | 100/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
| Recurso | Grátis | Desenvolvedor | Empresarial | Profissional |
|---|
| Conexões Concorrentes | 5 | 150 | 250 | 1.000 |
| Assinaturas por Conexão | 1.000 | 1.000 | 1.000 | 1.000 |
| Tipos de WebSocket | Padrão | Padrão, Aprimorado | Padrão, Aprimorado | Padrão, Aprimorado |
Webhooks
| Recurso | Grátis | Desenvolvedor | Empresarial | Profissional |
|---|
| Máx. de Webhooks | 5 | 50 | 50 | 50 |
| Endereços por Webhook | 100k | 100k | 100k | 100k |
Compressão ZK
| Serviço | Grátis | Desenvolvedor | Empresarial | Profissional |
|---|
| APIs Photon | 2/s | 10/s | 50/s | 100/s |
getValidityProof | 1/s | 5/s | 10/s | 20/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.