Skip to main content
A API Helius usa chaves de API para autenticar requisições. Toda requisição à API deve incluir sua chave de API para verificar sua identidade e permissões.
Sua chave de API é uma informação sensível que concede acesso à sua conta Helius. Nunca a exponha em código do lado do cliente, repositórios públicos ou áreas acessíveis por navegadores.

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.md

Instale 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 com helius 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

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

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
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
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