> ## 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
> Todo lo que los agentes de IA necesitan para desarrollar en Solana con Helius: registro programático, acceso a la API, SDK, integración con MCP y flujos de trabajo recomendados.
Helius ofrece soporte de primer nivel para los agentes de IA que desarrollan en Solana. Desde la creación programática de cuentas hasta la transmisión de datos en tiempo real, los agentes pueden acceder a todo el potencial de Helius sin ninguna intervención manual.
* [Helius MCP](/docs/es/agents/mcp) — 10 herramientas enrutadas que permiten consultar la blockchain, enviar transacciones, transmitir datos y mucho más
* [Plugin de Claude Code](/docs/es/agents/claude-code-plugin) — El primer y, actualmente, único plugin oficial de Claude Code de una empresa de criptomonedas. Una sola instalación: servidores MCP + habilidades + archivos de referencia
* [Habilidades](/docs/es/agents/skills/overview) — Conjuntos de instrucciones especializadas para Claude: [Build](/docs/es/agents/skills/build), [Phantom](/docs/es/agents/skills/phantom), [Jupiter](/docs/es/agents/skills/jupiter), [DFlow](/docs/es/agents/skills/dflow), [OKX](/docs/es/agents/skills/okx), [SVM](/docs/es/agents/skills/svm)
* [SDK de TypeScript](/docs/es/agents/typescript-sdk) — Métodos con seguridad de tipos para todas las API de Helius
* [SDK de Rust](/docs/es/agents/rust-sdk) — SDK de Rust de alto rendimiento para las API de Helius
* [Helius CLI](/docs/es/agents/cli) — Administración de cuentas y creación de scripts de shell
Hay una versión de esta sección legible por máquinas disponible en [agents/llms.txt](https://www.helius.dev/docs/agents/llms.txt) para que la utilicen los agentes de IA.
## MCP frente a CLI
El [servidor MCP de Helius](/docs/es/agents/mcp) es la forma recomendada para que los agentes de IA interactúen con Helius. Proporciona 10 herramientas enrutadas que ofrecen a la IA acceso directo y estructurado a Solana, sin comandos de shell, análisis de resultados ni llamadas manuales a la API.
| | [MCP](/docs/es/agents/mcp) | [CLI](/docs/es/agents/cli) |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| **Ideal para** | Agentes de IA en Claude Code, Cursor, Claude Desktop y cualquier herramienta compatible con MCP | Scripts de shell, canalizaciones de CI/CD y flujos de trabajo en la terminal |
| **Interfaz** | Llamadas estructuradas a herramientas con entradas y salidas tipadas | Línea de comandos con resultados en formato `--json` |
| **Capacidades** | 10 herramientas enrutadas (`heliusWallet`, `heliusAsset`, `heliusTransaction`, …) que abarcan consultas de blockchain, transacciones, webhooks, transmisión, análisis de billeteras, documentación y registro | Más de 95 comandos: las mismas capacidades, además de administración de configuración y flujos interactivos |
| **Configuración de la cuenta** | Integrada: acciones `heliusAccount` `generateKeypair` → `signup` (enlace o pago automático); no se necesitan herramientas externas | `helius keygen` → `helius signup` |
| **Cuándo usarlo** | Opción predeterminada para cualquier agente de IA | Cuando necesites automatización a nivel de shell o no uses una herramienta compatible con MCP |
**Comienza con MCP.** Si tu herramienta de IA admite MCP (Claude Code, Cursor, Claude Desktop, etc.), usa el [servidor MCP](/docs/es/agents/mcp) o el [plugin de Claude Code](/docs/es/agents/claude-code-plugin). La CLI es útil para crear scripts de shell y para CI/CD, pero MCP ofrece una experiencia más fluida en los flujos de trabajo basados en IA: la IA llama directamente a las herramientas en lugar de iniciar comandos de shell y analizar los resultados.
## Inicio rápido: registro de agentes
Los agentes pueden crear una cuenta de Helius y obtener una clave de API con la [Helius CLI](/docs/es/agents/cli):
```bash theme={"system"}
npm install -g helius-cli # Install CLI
helius keygen # Generate keypair
# Default: prints a hosted payment link — pay with any wallet in the browser
helius signup --email you@example.com --first-name Jane --last-name Doe --json
# After paying via the link, finalize the account
helius signup --resume --json
# Or autopay: fund the keypair with 1 USDC + ~0.001 SOL, then
helius signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe --json
```
Si el proceso se completa correctamente (`--resume` o `--pay`), tu agente recibe una clave de API, endpoints RPC y 1,000,000 de créditos. Consulta la [guía completa de la CLI](/docs/es/agents/cli) para obtener más detalles.
## Autenticación
Todas las solicitudes a la API de Helius requieren una clave de API enviada como parámetro de consulta:
```
?api-key=YOUR_API_KEY
```
Agrégala a cualquier endpoint RPC o de API. Por ejemplo: `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`
Obtén una clave de API en el [panel de Helius](https://dashboard.helius.dev) o de forma programática mediante la [Helius CLI](/docs/es/agents/cli).
**Usa Gatekeeper para reducir la latencia** — [Gatekeeper (Beta)](/docs/es/gatekeeper/overview) elimina Cloudflare de la ruta crítica, lo que reduce los tiempos de respuesta entre decenas y cientos de milisegundos. La misma clave de API y los mismos métodos; solo cambia el endpoint:
```
https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY
```
Admite todos los métodos de RPC, DAS, WebSocket, compresión ZK, tarifas de prioridad y transacciones mejoradas. Consulta la [guía de migración](/docs/es/gatekeeper/migration-guide) para obtener más detalles.
## Guía específica para las API de Helius
Usa estas API optimizadas por Helius en lugar de encadenar métodos RPC estándar de Solana:
| Si necesitas... | Usa esto | Motivo |
| ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Historial filtrado, recuperación de datos históricos o actividad de cuentas de tokens | [`getTransactionsForAddress`](/docs/es/rpc/gettransactionsforaddress) | Filtros y paginación; usa `transactionDetails: "full"` solo cuando necesites objetos de transacciones sin procesar y metadatos (`filters.tokenAccounts` usa `none` de forma predeterminada) |
| Actividad centrada en la billetera con cambios de saldo por transacción | [Historial de Wallet API](/docs/es/wallet-api/history) (beta) | Respuesta REST orientada a billeteras; no equivale a la recuperación histórica filtrada de GTFA ni a objetos completos de transacciones sin procesar |
| Registros de SOL o tokens a nivel de transferencia | [`getTransfersByAddress`](/docs/es/rpc/gettransfersbyaddress) | Transferencias normalizadas, no objetos completos de transacciones |
| Nuevo historial analizado y legible por humanos | [Eventos analizados](/docs/es/parsed-events) | Úsalo en lugar de las antiguas [transacciones mejoradas](/docs/es/enhanced-transactions/overview); GTFA no usa el formato de respuesta mejorada |
| Metadatos detallados de activos de una billetera | [`getAssetsByOwner`](/docs/es/api-reference/das/getassetsbyowner) (API de DAS) | Devuelve metadatos detallados, no solo cuentas de tokens sin procesar; las tenencias fungibles de SPL/Token-2022 requieren la opción `showFungible` específica del método |
| Estimaciones de tarifas de prioridad | [`getPriorityFeeEstimate`](/docs/es/api-reference/priority-fee/getpriorityfeeestimate) | Tarifas óptimas calculadas previamente, sin cálculos manuales |
| Historial de transacciones de NFT comprimidos | [`getSignaturesForAsset`](/docs/es/api-reference/das/getsignaturesforasset) (API de DAS) | El RPC estándar basado en direcciones no incluye el historial de NFT comprimidos |
| Búsqueda de NFT | [`searchAssets`](/docs/es/api-reference/das/searchassets) o [`getAssetsByGroup`](/docs/es/api-reference/das/getassetsbygroup) | Datos indexados más rápidos y económicos |
| Datos en tiempo real | [LaserStream WebSocket](/docs/es/rpc/websocket), [LaserStream gRPC](/docs/es/laserstream) o [webhooks](/docs/es/webhooks) | Flujos persistentes o callbacks HTTP sin sondeo |
| Transmisión de backend de alto rendimiento con reproducción | [Suscripción de LaserStream gRPC](/docs/es/api-reference/laserstream/grpc/subscribe) (SDK `subscribe`) | WSS para navegador o interfaz de usuario usa LaserStream WebSocket; `laserstreamSubscribe` de MCP solo genera configuraciones y ejemplos, no abre un flujo en vivo |
| Envío de transacciones con baja latencia | [Helius Sender](/docs/es/sending-transactions/sender) | Enrutamiento por varias rutas (Helius, Jito, Harmonic, Rakurai, etc.) y mayores tasas de inclusión |
## Flujos de trabajo recomendados
| Si estás desarrollando... | Productos de Helius que debes usar |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Bot de trading | [Gatekeeper](/docs/es/gatekeeper/overview) (RPC con la menor latencia) + [Sender](/docs/es/sending-transactions/sender) (envío rápido de transacciones) + [API de tarifas de prioridad](/docs/es/priority-fee-api) + [LaserStream](/docs/es/laserstream) (precios en tiempo real) |
| Aplicación de billetera | [API de DAS](/docs/es/das-api) para la propiedad y los metadatos de activos + [Historial de Wallet API](/docs/es/wallet-api/history) (actividad beta con cambios de saldo) o [`getTransactionsForAddress`](/docs/es/rpc/gettransactionsforaddress) para historial filtrado, recuperación de datos históricos, actividad de cuentas de tokens u objetos completos de transacciones sin procesar |
| Mercado de NFT | [API de DAS](/docs/es/das-api) (`searchAssets`, `getAssetsByGroup`) + [webhooks](/docs/es/webhooks) (seguimiento de ventas y publicaciones) |
| Sniper de tokens | [Gatekeeper](/docs/es/gatekeeper/overview) (RPC enrutado en el perímetro) + [LaserStream gRPC](/docs/es/laserstream) (latencia mínima) + [Sender](/docs/es/sending-transactions/sender) (conexiones con stake) |
| Rastreador de portafolio | [Saldos de Wallet API](/docs/es/wallet-api/balances) (resúmenes de portafolio en beta) + [API de DAS](/docs/es/das-api) (`getAssetsByOwner` con `showFungible` específico del método) para el inventario de NFT y metadatos |
| Monitor de billeteras | [LaserStream WebSocket](/docs/es/rpc/websocket) o [webhooks](/docs/es/webhooks) para recibir notificaciones en tiempo real |
| Panel de análisis | [`getTransactionsForAddress`](/docs/es/rpc/gettransactionsforaddress) para la recuperación filtrada de datos históricos; [eventos analizados](/docs/es/parsed-events) para nuevas integraciones analizadas; [transacciones mejoradas](/docs/es/enhanced-transactions/overview) solo para integraciones analizadas existentes |
| Herramienta de airdrop | [AirShip](https://airship.helius.dev) (95 % más económica con compresión ZK) |
Cuando uses [Saldos de Wallet API](/docs/es/wallet-api/balances) para los resúmenes de portafolio: la API está en beta; los tokens están limitados a 100 por página; los NFT se excluyen a menos que se use `showNfts=true` (como máximo 100 NFT y solo en la primera página); `pricePerToken` e `usdValue` pueden ser nulos; los precios son estimaciones por hora, no precios de mercado en tiempo real; `totalUsdValue` abarca la página actual, no todo el portafolio paginado; cada solicitud cuesta 100 créditos. Usa DAS con paginación para obtener un inventario completo de NFT y sus metadatos; no trates Balances como un inventario completo de NFT.
## Referencia rápida de límites de solicitudes
Los límites de solicitudes dependen de tu [plan](/docs/es/billing/plans). Los agentes comienzan en el nivel Agent con 1,000,000 de créditos. El nivel Agent requiere un pago de \$1 para evitar abusos.
| Plan | Precio | Créditos mensuales | Límite de solicitudes RPC | DAS y API mejoradas |
| ------------ | ------------------- | ------------------ | ------------------------- | ------------------- |
| Agent | \$1 por el registro | 1 M | 10 solicitudes/s | 2 solicitudes/s |
| Developer | \$49/mes | 10 M | 50 solicitudes/s | 10 solicitudes/s |
| Business | \$499/mes | 100 M | 200 solicitudes/s | 50 solicitudes/s |
| Professional | \$999/mes | 200 M | 500 solicitudes/s | 100 solicitudes/s |
Para consultar los límites detallados de cada API, consulta [Límites de solicitudes](/docs/es/billing/rate-limits).
## Créditos por llamada a la API
| API | Créditos | Notas |
| --------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Llamadas RPC estándar | 1 | La mayoría de los métodos RPC de Solana |
| `getProgramAccounts` | 10 | Usa la API de DAS en su lugar cuando sea posible |
| API de DAS | 10 | Todos los endpoints de DAS |
| Transacciones mejoradas | 100 | Datos de transacciones analizados |
| `getTransactionsForAddress` | 10+ | Las transacciones completas cuestan 10 créditos por cada 100 resultados; las respuestas que solo contienen firmas tienen un costo fijo de 10 créditos. |
| `getTransfersByAddress` | 10 | Solo para los planes Developer y superiores |
| Wallet API | 100 | Todos los endpoints de Wallet API |
| API de tarifas de prioridad | 1 | Estimación de tarifas |
| Sender | 0 | Gratis en todos los planes |
| Eventos de webhook | 1 | Por evento entregado |
| Administración de webhooks | 100 | Crear, editar y eliminar |
Para ver el desglose completo, consulta [Créditos](/docs/es/billing/credits).
## Reintentos y manejo de errores
### Códigos de estado HTTP
| Código | Significado | Acción |
| ------ | ------------------------------- | ------------------------------------------ |
| 200 | Correcto | Procesa la respuesta |
| 400 | Solicitud incorrecta | Corrige los parámetros de la solicitud |
| 401 | No autorizado | Comprueba la clave de API |
| 429 | Límite de solicitudes alcanzado | Espera y vuelve a intentarlo |
| 5xx | Error del servidor | Vuelve a intentarlo con espera exponencial |
### Patrón de reintentos
```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');
}
```
### Supervisar el uso de créditos
```bash theme={"system"}
helius usage --json
```
## Referencia rápida
* **RPC de Mainnet**: `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **RPC de Mainnet (Gatekeeper Beta)**: `https://beta.helius-rpc.com/?api-key=YOUR_API_KEY`
* **RPC de Devnet**: `https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **WSS de Mainnet**: `wss://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **WSS de Mainnet (Gatekeeper Beta)**: `wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY`
* **WSS de Devnet**: `wss://devnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **Endpoint de Sender**: `https://sender.helius-rpc.com/fast`
* **Servidor MCP**: `https://www.helius.dev/docs/mcp`
* **Panel**: [dashboard.helius.dev](https://dashboard.helius.dev)
* **Estado**: [helius.statuspage.io](https://helius.statuspage.io)