Skip to main content
Helius oferece suporte de primeira classe para agentes de IA construindo no Solana. Desde a criação de contas programáticas até transmissão de dados em tempo real, agentes podem acessar todo o poder do Helius sem qualquer intervenção manual.
  • Helius MCP — 10 ferramentas roteadas que cobrem consultas à blockchain, envio de transações, transmissão e mais
  • Plugin Claude Code — O primeiro, e atualmente único, plugin oficial Claude Code de uma empresa de cripto. Uma instalação: servidores MCP + habilidades + arquivos de referência
  • Habilidades — Conjuntos de instrução especializados para Claude: Build, Phantom, Jupiter, DFlow, OKX, SVM
  • TypeScript SDK — Métodos com tipagem segura para todas as APIs do Helius
  • Rust SDK — SDK Rust de alta performance para APIs do Helius
  • Helius CLI — Gerenciamento de contas e scripts de shell
Uma versão legível por máquina desta seção está disponível em agents/llms.txt para consumo de agentes de IA.

MCP vs CLI

O servidor Helius MCP é a maneira recomendada para agentes de IA interagirem com o Helius. Ele fornece 10 ferramentas roteadas que dão acesso direto e estruturado ao Solana — sem comandos de shell, sem análise de saída, sem chamadas manuais de API.
Comece com o MCP. Se sua ferramenta de IA suporta MCP (Claude Code, Cursor, Claude Desktop, etc.), use o servidor MCP ou o Plugin Claude Code. O CLI é útil para scripts de shell e CI/CD, mas para fluxos de trabalho orientados por IA o MCP oferece uma experiência mais fluida — a IA chama ferramentas diretamente em vez de gerar comandos de shell e analisar a saída.

Início Rápido: Cadastro de Agente

Os agentes podem criar uma conta Helius e obter uma chave API com o Helius CLI:
Cada novo cadastro, incluindo o plano Agent, exige um endereço de e-mail, nome e sobrenome. A carteira é usada apenas para pagamento.
Em caso de sucesso (--resume ou --pay), seu agente recebe uma chave de API, endpoints RPC e 1.000.000 de créditos. Consulte o guia completo da CLI para obter detalhes.

Autenticação

Todas as solicitações à API da Helius exigem uma chave de API passada como parâmetro de consulta:
Acrescente isso a qualquer endpoint RPC ou de API. Por exemplo: https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY Obtenha uma chave de API no Painel da Helius ou programaticamente pela CLI da Helius.
Use o Gatekeeper para reduzir a latência — o Gatekeeper (Beta) remove o Cloudflare do caminho crítico, reduzindo os tempos de resposta em dezenas ou centenas de milissegundos. A mesma chave de API e os mesmos métodos — basta trocar o endpoint:
Compatível com todos os métodos de RPC, DAS, WebSocket, ZK Compression, Priority Fee e Enhanced Transaction. Consulte o guia de migração para obter detalhes.

Orientações específicas para as APIs da Helius

Use estas APIs otimizadas da Helius em vez de encadear métodos RPC padrão da Solana:

Fluxos de trabalho recomendados

Ao usar os Saldos da Wallet API para resumos de portfólio: a API está em beta; os tokens são limitados a 100 por página; os NFTs são excluídos, a menos que showNfts=true (no máximo 100 NFTs e somente na primeira página); pricePerToken e usdValue podem ser nulos; os preços são estimativas por hora, não preços de mercado em tempo real; totalUsdValue abrange a página atual, não todo o portfólio paginado; cada solicitação custa 100 créditos. Use o DAS paginado para obter o inventário completo de NFTs e seus metadados — não trate Balances como um inventário completo de NFTs.

Referência rápida de limites de taxa

Os limites de taxa dependem do seu plano. Os agentes começam no nível Agent com 1.000.000 de créditos. O nível Agent exige um pagamento único de USDC 10, e cada novo cadastro precisa de e-mail, nome e sobrenome.
Todos os preços exibidos em dólares estão em dólares dos Estados Unidos (USD).
Para ver os limites de taxa detalhados por API, consulte Limites de taxa.

Créditos por chamada de API

Para ver o detalhamento completo, consulte Créditos.

Novas tentativas e tratamento de erros

Códigos de status HTTP

Padrão de novas tentativas

Monitorar o uso de créditos

Referência rápida

  • RPC da Mainnet: https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • RPC da Mainnet (Gatekeeper Beta): https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
  • RPC da Devnet: https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • WSS da Mainnet: wss://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • WSS da Mainnet (Gatekeeper Beta): wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY
  • WSS da Devnet: wss://devnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • Endpoint do Sender: https://sender.helius-rpc.com/fast
  • Servidor MCP: https://www.helius.dev/docs/mcp
  • Painel: dashboard.helius.dev
  • Status: helius.statuspage.io