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 for pagar via link de pagamento hospedado (--pay / --resume). Para autopay, envie 1 USDC e 0.001 SOL para o endereço da carteira fornecido na Etapa 2.

Inscreva-se e Obtenha a Chave de API

Melhores Práticas de Segurança

Variáveis de Ambiente

Armazene sua chave de API em variáveis de ambiente, não no seu código-fonte.

Restrições de IP

Configure restrições de IP para suas chaves de API no dashboard para limitar o acesso a endereços IP ou intervalos específicos.

Chaves Separadas

Use chaves de API diferentes para ambientes de desenvolvimento, teste e produção para isolar o uso e melhorar a segurança.

Monitorar Uso

Verifique regularmente seu uso de API no dashboard para detectar padrões incomuns ou possíveis problemas de segurança.

Gestão de Segredos

Limites de Taxa e Uso

Os limites de taxa variam conforme o plano de assinatura. Monitore seu uso no Helius Dashboard para garantir que você esteja dentro dos limites alocados.

Entendendo os Limites de Taxa

  • Requisições por segundo: Com base no seu nível de assinatura
  • Quota de requisições mensais: Total de requisições permitidas por ciclo de cobrança
  • Permissão de Estouro: Picos de curto prazo acima do seu limite base de taxa

Lidando com os Limites de Taxa

Solução de Problemas

Sintomas: 401 Unauthorized ou erros de “Chave de API Inválida”Soluções:
  • Verifique se sua chave de API está correta e não foi regenerada
  • Verifique se você está incluindo a chave de API como um parâmetro na query: ?api-key=YOUR_KEY
  • Certifique-se de que não há espaços ou caracteres extras na sua chave de API
  • Confirme se sua chave de API não expirou ou foi revogada
Sintomas: Erros 429 Too Many RequestsSoluções:
  • Verifique seu uso atual no dashboard
  • Implemente o backoff exponencial na sua lógica de reintento
  • Considere atualizar seu plano para limites mais altos
  • Otimize suas requisições para reduzir chamadas desnecessárias
Sintomas: Erros 403 ForbiddenSoluções:
  • Verifique se as restrições de IP não estão bloqueando suas requisições
  • Verifique se sua assinatura inclui acesso ao endpoint
  • Certifique-se de que sua chave de API tem as permissões necessárias

Próximos Passos

Guia de Início Rápido

Comece a fazer suas primeiras chamadas de API com Helius

Referência da API

Explore todos os endpoints e métodos disponíveis

Limites de Taxa

Entenda os limites de taxa e opções de upgrade

Dashboard

Monitore seu uso de API e gerencie chaves

Suporte

Precisa de ajuda com autenticação ou tem perguntas sobre chaves de API?

Comunidade no Discord

Participe do nosso Discord para suporte em tempo real e ajuda da comunidade

Suporte por Email

Entre em contato diretamente com nossa equipe de suporte