> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Helius para Agentes

> "Tudo o que agentes de IA precisam para desenvolver no Solana com Helius: cadastro programático, acesso à API, SDKs, integração MCP e fluxos de trabalho recomendados."

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](/docs/pt-BR/agents/mcp) — 10 ferramentas roteadas que cobrem consultas à blockchain, envio de transações, transmissão e mais
* [Plugin Claude Code](/docs/pt-BR/agents/claude-code-plugin) — 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](/docs/pt-BR/agents/skills/overview) — Conjuntos de instrução especializados para Claude: [Build](/docs/pt-BR/agents/skills/build), [Phantom](/docs/pt-BR/agents/skills/phantom), [Jupiter](/docs/pt-BR/agents/skills/jupiter), [DFlow](/docs/pt-BR/agents/skills/dflow), [OKX](/docs/pt-BR/agents/skills/okx), [SVM](/docs/pt-BR/agents/skills/svm)
* [TypeScript SDK](/docs/pt-BR/agents/typescript-sdk) — Métodos com tipagem segura para todas as APIs do Helius
* [Rust SDK](/docs/pt-BR/agents/rust-sdk) — SDK Rust de alta performance para APIs do Helius
* [Helius CLI](/docs/pt-BR/agents/cli) — Gerenciamento de contas e scripts de shell

<Note>
  Uma versão legível por máquina desta seção está disponível em [agents/llms.txt](https://www.helius.dev/docs/agents/llms.txt) para consumo de agentes de IA.
</Note>

## MCP vs CLI

O [servidor Helius MCP](/docs/pt-BR/agents/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.

|                           | [MCP](/docs/pt-BR/agents/mcp)                                                                                                                                                               | [CLI](/docs/pt-BR/agents/cli)                                                                               |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| **Melhor para**           | Agentes de IA em Claude Code, Cursor, Claude Desktop e qualquer ferramenta compatível com MCP                                                                                          | Scripts de shell, pipelines CI/CD, fluxos de trabalho de terminal                                      |
| **Interface**             | Chamadas de ferramenta estruturadas com entradas/saídas tipadas                                                                                                                        | Linha de comando com saída `--json`                                                                    |
| **Capacidades**           | 10 ferramentas roteadas (`heliusWallet`, `heliusAsset`, `heliusTransaction`, …) abrangendo consultas blockchain, transações, webhooks, streaming, análise de carteira, docs e cadastro | 95+ comandos: mesmas capacidades mais gerenciamento de configuração e fluxos interativos               |
| **Configuração da conta** | Integrado: ações `heliusAccount` `generateKeypair` → `signup` (link ou pagamento automático) — sem ferramentas externas necessárias                                                    | `helius keygen` → `helius signup`                                                                      |
| **Quando usar**           | Escolha padrão para qualquer agente de IA                                                                                                                                              | Quando você precisa de automação a nível de shell ou não está usando uma ferramenta compatível com MCP |

<Tip>
  **Comece com o MCP.** Se sua ferramenta de IA suporta MCP (Claude Code, Cursor, Claude Desktop, etc.), use o [servidor MCP](/docs/pt-BR/agents/mcp) ou o [Plugin Claude Code](/docs/pt-BR/agents/claude-code-plugin). 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.
</Tip>

## Início Rápido: Cadastro de Agente

Agentes podem criar uma conta Helius e obter uma chave de API em quatro etapas usando o [Helius CLI](/docs/pt-BR/agents/cli):

```bash theme={"system"}
npm install -g helius-cli    # Install CLI
helius keygen                 # Generate keypair
# (Autopay only) Fund wallet with 1 USDC + ~0.001 SOL — skip if paying via the hosted link
helius signup --email you@example.com --first-name Jane --last-name Doe --json          # Get API key (JSON output)
```

Com sucesso, seu agente recebe uma chave de API, endpoints RPC e 1.000.000 de créditos. Veja o [guia completo do CLI](/docs/pt-BR/agents/cli) para mais detalhes.

## Autenticação

Todas as solicitações às APIs do Helius requerem uma chave de API passada como um parâmetro de consulta:

```
?api-key=YOUR_API_KEY
```

Anexe isso a qualquer endpoint RPC ou API. Por exemplo: `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`

Obtenha uma chave de API do [Helius Dashboard](https://dashboard.helius.dev) ou programaticamente via [Helius CLI](/docs/pt-BR/agents/cli).

<Tip>
  **Use o Gatekeeper para menor latência** — [Gatekeeper (Beta)](/docs/pt-BR/gatekeeper/overview) remove o Cloudflare do caminho crítico, reduzindo os tempos de resposta em dezenas a centenas de milissegundos. Mesma chave de API, mesmos métodos — apenas troque o endpoint:

  ```
  https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
  wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY
  ```

  Suporta todos os métodos RPC, DAS, WebSocket, ZK Compression, Priority Fee e Enhanced Transaction. Veja o [guia de migração](/docs/pt-BR/gatekeeper/migration-guide) para detalhes.
</Tip>

## Orientações Específicas das APIs Helius

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

| Em vez de...                                 | Use isto                                                                                                                   | Por que                                                                                    |
| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| `getSignaturesForAddress` + `getTransaction` | [`getTransactionsForAddress`](/docs/pt-BR/rpc/gettransactionsforaddress)                                                        | Chamada única retorna histórico completo de transações com dados de conta de token         |
| `getTokenAccountsByOwner`                    | [`getAssetsByOwner`](/docs/pt-BR/api-reference/das/getassetsbyowner) (API DAS)                                                  | Retorna metadados ricos, não apenas contas brutas                                          |
| `getRecentPrioritizationFees`                | [`getPriorityFeeEstimate`](/docs/pt-BR/api-reference/priority-fee/getpriorityfeeestimate)                                       | Taxas ótimas pré-calculadas, sem cálculo manual                                            |
| `getSignaturesForAddress` (para cNFTs)       | [`getSignaturesForAsset`](/docs/pt-BR/api-reference/das/getsignaturesforasset) (API DAS)                                        | RPC padrão não funciona para NFTs comprimidos                                              |
| `getProgramAccounts` (para busca de NFT)     | [`searchAssets`](/docs/pt-BR/api-reference/das/searchassets) ou [`getAssetsByGroup`](/docs/pt-BR/api-reference/das/getassetsbygroup) | Dados indexados mais rápidos e baratos                                                     |
| Pesquisa de dados em tempo real              | [LaserStream WebSocket](/docs/pt-BR/rpc/websocket) ou [LaserStream gRPC](/docs/pt-BR/laserstream)                                    | Menor latência, mais eficiente                                                             |
| `sendTransaction` padrão                     | [Helius Sender](/docs/pt-BR/sending-transactions/sender)                                                                        | Roteamento multi-caminho (Helius, Jito, Harmonic, Rakurai, etc.), maiores taxas de captura |

## Fluxos de Trabalho Recomendados

| Construindo...          | Produtos Helius para Usar                                                                                                                                                                                                                          |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Bot de trading          | [Gatekeeper](/docs/pt-BR/gatekeeper/overview) (RPC de mais baixa latência) + [Sender](/docs/pt-BR/sending-transactions/sender) (envio rápido de tx) + [Priority Fee API](/docs/pt-BR/priority-fee-api) + [LaserStream](/docs/pt-BR/laserstream) (preços em tempo real) |
| Aplicativo de carteira  | [API DAS](/docs/pt-BR/das-api) (`getAssetsByOwner`) + [`getTransactionsForAddress`](/docs/pt-BR/rpc/gettransactionsforaddress) (histórico completo)                                                                                                          |
| Marketplace de NFT      | [API DAS](/docs/pt-BR/das-api) (`searchAssets`, `getAssetsByGroup`) + [Webhooks](/docs/pt-BR/webhooks) (rastrear vendas/listagens)                                                                                                                           |
| Token sniper            | [Gatekeeper](/docs/pt-BR/gatekeeper/overview) (RPC roteado na borda) + [LaserStream gRPC](/docs/pt-BR/laserstream) (menor latência) + [Sender](/docs/pt-BR/sending-transactions/sender) (conexões em staking)                                                     |
| Rastreador de portfólio | [API DAS](/docs/pt-BR/das-api) (`getAssetsByOwner` com `showFungible`) + [Enhanced Transactions](/docs/pt-BR/enhanced-transactions/overview)                                                                                                                 |
| Monitor de carteira     | [LaserStream WebSocket](/docs/pt-BR/rpc/websocket) ou [Webhooks](/docs/pt-BR/webhooks) para notificações em tempo real                                                                                                                                       |
| Painel de análise       | [Enhanced Transactions API](/docs/pt-BR/enhanced-transactions/overview) + [`getTransactionsForAddress`](/docs/pt-BR/rpc/gettransactionsforaddress)                                                                                                           |
| Ferramenta de airdrop   | [AirShip](https://airship.helius.dev) (95% mais barato com compressão ZK)                                                                                                                                                                          |

## Referência Rápida de Limites de Taxa

Os limites de taxa dependem do seu [plano](/docs/pt-BR/billing/plans). Agentes começam no nível Agent com 1.000.000 de créditos. O nível Agent requer um pagamento de \$1 para prevenir abusos.

| Plano        | Preço        | Créditos Mensais | Limite de Taxa RPC | DAS & Enhanced APIs |
| ------------ | ------------ | ---------------- | ------------------ | ------------------- |
| Agent        | \$1 cadastro | 1M               | 10 req/s           | 2 req/s             |
| Developer    | \$49/mês     | 10M              | 50 req/s           | 10 req/s            |
| Business     | \$499/mês    | 100M             | 200 req/s          | 50 req/s            |
| Professional | \$999/mês    | 200M             | 500 req/s          | 100 req/s           |

Para limites de taxa detalhados por API, veja [Limites de Taxa](/docs/pt-BR/billing/rate-limits).

## Créditos por Chamada de API

| API                         | Créditos | Notas                                                                                                                  |
| --------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------- |
| Chamadas padrão RPC         | 1        | A maioria dos métodos RPC do Solana                                                                                    |
| `getProgramAccounts`        | 10       | Use a API DAS quando possível                                                                                          |
| API DAS                     | 10       | Todos os endpoints DAS                                                                                                 |
| Enhanced Transactions       | 100      | Dados de transação analisados                                                                                          |
| `getTransactionsForAddress` | 10+      | Transações completas custam 10 créditos por 100 retornadas; respostas apenas com assinaturas custam 10 créditos fixos. |
| `getTransfersByAddress`     | 10       | Apenas planos Developer+                                                                                               |
| API de Carteira             | 100      | Todos os endpoints da API de Carteira                                                                                  |
| API de Taxa de Prioridade   | 1        | Estimativa de taxa                                                                                                     |
| Sender                      | 0        | Gratuito em todos os planos                                                                                            |
| Eventos de Webhook          | 1        | Por evento entregue                                                                                                    |
| Gestão de Webhook           | 100      | Criar, editar, deletar                                                                                                 |

Para a análise completa, veja [Créditos](/docs/pt-BR/billing/credits).

## Repetições e Tratamento de Erros

### Códigos de Status HTTP

| Código | Significado          | Ação                                                  |
| ------ | -------------------- | ----------------------------------------------------- |
| 200    | Sucesso              | Processar resposta                                    |
| 400    | Solicitação inválida | Corrigir parâmetros de solicitação                    |
| 401    | Não autorizado       | Verificar chave de API                                |
| 429    | Limite de taxa       | Retardar e tentar novamente                           |
| 5xx    | Erro de servidor     | Tentar novamente com aumento exponencial de intervalo |

### Padrão de Repetição

```typescript theme={"system"}
async function heliusRequest(url: string, data: object, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const response = await fetch(url, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(data),
    });

    if (response.ok) return response.json();

    if (response.status === 429) {
      const retryAfter = response.headers.get('Retry-After');
      const delay = retryAfter ? parseInt(retryAfter) * 1000 : Math.pow(2, attempt) * 1000;
      await new Promise(resolve => setTimeout(resolve, delay));
      continue;
    }

    if (response.status >= 500) {
      await new Promise(resolve => setTimeout(resolve, Math.pow(2, attempt) * 1000));
      continue;
    }

    throw new Error(`Request failed: ${response.status} ${await response.text()}`);
  }
  throw new Error('Max retries exceeded');
}
```

### Monitorar Uso de Créditos

```bash theme={"system"}
helius usage --json
```

## Referência Rápida

* **Mainnet RPC**: `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **Mainnet RPC (Gatekeeper Beta)**: `https://beta.helius-rpc.com/?api-key=YOUR_API_KEY`
* **Devnet RPC**: `https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **Mainnet WSS**: `wss://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **Mainnet WSS (Gatekeeper Beta)**: `wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY`
* **Devnet WSS**: `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](https://dashboard.helius.dev)
* **Status**: [helius.statuspage.io](https://helius.statuspage.io)