Saltar al contenido principal
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 — 10 herramientas enrutadas que permiten consultar la blockchain, enviar transacciones, transmitir datos y mucho más
  • Plugin de Claude Code — 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 — Conjuntos de instrucciones especializadas para Claude: Build, Phantom, Jupiter, DFlow, OKX, SVM
  • SDK de TypeScript — Métodos con seguridad de tipos para todas las API de Helius
  • SDK de Rust — SDK de Rust de alto rendimiento para las API de Helius
  • Helius 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 para que la utilicen los agentes de IA.

MCP frente a CLI

El servidor MCP de Helius 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.
Comienza con MCP. Si tu herramienta de IA admite MCP (Claude Code, Cursor, Claude Desktop, etc.), usa el servidor MCP o el plugin de Claude Code. 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:
Cada nuevo registro, incluido el plan Agent, requiere una dirección de correo electrónico, nombre y apellido. La billetera solo se usa para pagar.
Si 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 para obtener más información.

Autenticación

Todas las solicitudes a la API de Helius requieren una clave de API que se pasa como parámetro de consulta:
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 o de forma programática mediante la CLI de Helius.
Usa Gatekeeper para reducir la latencia — Gatekeeper (Beta) 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:
Admite todos los métodos de RPC, DAS, WebSocket, ZK Compression, Priority Fee y Enhanced Transaction. Consulta la guía de migración para obtener más información.

Guía sobre las API específicas de Helius

Usa estas API optimizadas por Helius en lugar de encadenar métodos RPC estándar de Solana:

Flujos de trabajo recomendados

Cuando uses Saldos de Wallet API para obtener resúmenes de portafolios: 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 null; 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 paginado para obtener un inventario y metadatos completos de NFT; no trates Balances como un inventario completo de NFT.

Referencia rápida de límites de tasa

Los límites de tasa dependen de tu plan. Los agentes comienzan en el nivel Agent con 1,000,000 de créditos. El nivel Agent requiere un pago único de $10 USDC, y cada nuevo registro necesita una dirección de correo electrónico, nombre y apellido.
Todos los precios expresados en dólares están en dólares estadounidenses (USD).
Para consultar los límites de tasa detallados de cada API, consulta Límites de tasa.

Créditos por llamada a la API

Para consultar el desglose completo, consulta Créditos.

Reintentos y manejo de errores

Códigos de estado HTTP

Patrón de reintentos

Monitorear el uso de créditos

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
  • Estado: helius.statuspage.io