Começando
1. Crie sua Chave de API
1
Cadastre-se ou faça login
Crie uma conta no Helius Dashboard ou faça login na sua conta existente.
2
Navegue até Chaves de API
Vá para a seção Chaves de API na barra lateral do seu dashboard.
3
Gere uma nova chave
Clique em Criar Nova Chave de API e forneça um nome descritivo para seu projeto (por exemplo, “Aplicativo de Produção”, “Ambiente de Desenvolvimento”).
4
Copie e proteja sua chave
Copie sua chave de API imediatamente e armazene-a com segurança. Você não poderá vê-la novamente após sair da página.
2. Usando sua Chave de API
Inclua sua chave de API como um parâmetro na query em todas as requisições:Começando (Para Agentes)
Agentes podem se inscrever programaticamente para contas Helius, criar projetos e gerar chaves de API usando o Helius CLI. Para instruções completas, leia: https://dashboard.helius.dev/agents.mdInstale o Helius CLI
Gere um Par de Chaves
Financie a Carteira Gerada (somente Autopay)
Pule esta etapa se você pagar pelo link de pagamento hospedado (o modo de cadastro padrão, finalizado comhelius signup --resume). O pagamento automático (--pay) é feito pelo par de chaves local: envie o valor do plano em USDC (US$ 10 para o plano Agent) e cerca de 0,001 SOL para o endereço da carteira obtido na etapa anterior.
Inscreva-se e Obtenha a Chave de API
Todo novo cadastro exige--email, --first-name e --last-name, incluindo o plano Agent. A carteira é usada apenas para pagamento.
Práticas recomendadas de segurança
Environment Variables
Armazene sua chave de API em variáveis de ambiente, não no código-fonte.
IP Restrictions
Configure restrições de IP para suas chaves de API no painel a fim de limitar o acesso a endereços IP ou intervalos específicos.
Separate Keys
Use chaves de API diferentes para os ambientes de desenvolvimento, homologação e produção a fim de isolar o uso e aumentar a segurança.
Monitor Usage
Verifique regularmente o uso da API no painel para detectar padrões incomuns ou possíveis problemas de segurança.
Gerenciamento de segredos
- Node.js
- Python
- Docker
Limites de taxa e uso
Os limites de taxa variam conforme o plano de assinatura. Monitore seu uso no painel da Helius para garantir que você permaneça dentro dos limites alocados.
Entenda os limites de taxa
- Solicitações por segundo: com base no seu nível de assinatura
- Cota mensal de solicitações: total de solicitações permitidas por ciclo de cobrança
- Margem para picos: aumentos de curto prazo acima do seu limite de taxa básico
Como lidar com limites de taxa
Solução de problemas
Invalid API Key Error
Invalid API Key Error
Sintomas: erros 401 Não autorizado ou “Chave de API inválida”Soluções:
- Verifique se sua chave de API está correta e não foi gerada novamente
- Confira se você incluiu a chave de API como parâmetro de consulta:
?api-key=YOUR_KEY - Confirme que não há espaços ou caracteres extras na sua chave de API
- Confirme que sua chave de API não expirou nem foi revogada
Rate Limit Exceeded
Rate Limit Exceeded
Sintomas: erros 429 Solicitações em excessoSoluções:
- Verifique seu uso atual no painel
- Implemente recuo exponencial na lógica de novas tentativas
- Considere fazer upgrade do seu plano para obter limites maiores
- Otimize suas solicitações para reduzir chamadas desnecessárias
Forbidden Access
Forbidden Access
Sintomas: erros 403 ProibidoSoluções:
- Verifique se as restrições de IP não estão bloqueando suas solicitações
- Confira se sua assinatura inclui acesso ao endpoint
- Confirme que sua chave de API tem as permissões necessárias
Próximas etapas
Quickstart Guide
Comece a fazer suas primeiras chamadas de API com a Helius
API Reference
Explore todos os endpoints e métodos disponíveis
Rate Limits
Entenda os limites de taxa e as opções de upgrade
Dashboard
Monitore o uso da API e gerencie as chaves
Suporte
Precisa de ajuda com a autenticação ou tem dúvidas sobre chaves de API?Discord Community
Entre no nosso Discord para obter ajuda em tempo real e suporte da comunidade
Email Support
Entre em contato diretamente com nossa equipe de suporte