Passer au contenu principal
Helius offre un support de premier ordre pour les agents AI construisant sur Solana. De la création de compte programmatique au streaming de données en temps réel, les agents peuvent accéder à toute la puissance de Helius sans aucune intervention manuelle.
  • Helius MCP — 10 outils routés couvrant la requête de blockchain, l’envoi de transactions, le streaming, et plus encore
  • Claude Code Plugin — Le premier, et actuellement le seul, plugin officiel Claude Code d’une entreprise crypto. Une installation : serveurs MCP + compétences + fichiers de référence
  • Compétences — Ensembles d’instructions experts pour Claude : Construire, Phantom, Jupiter, DFlow, OKX, SVM
  • TypeScript SDK — Méthodes typées pour toutes les API Helius
  • Rust SDK — SDK Rust haute performance pour les API Helius
  • Helius CLI — Gestion de compte et scripts shell
Une version lisible par machine de cette section est disponible sur agents/llms.txt pour la consommation par les agents AI.

MCP vs CLI

Le serveur Helius MCP est le moyen recommandé pour les agents AI d’interagir avec Helius. Il fournit 10 outils routés qui donnent aux AI un accès direct et structuré à Solana — pas de commandes shell, pas de parsing de sortie, pas d’appels API manuels.
Commencez avec MCP. Si votre outil AI supporte MCP (Claude Code, Cursor, Claude Desktop, etc.), utilisez le serveur MCP ou le Claude Code Plugin. Le CLI est utile pour le scripting shell et CI/CD, mais pour les flux de travail pilotés par AI, le MCP offre une expérience plus fluide — l’AI appelle directement les outils au lieu de lancer des commandes shell et d’analyser les sorties.

Démarrage rapide : Inscription de l’Agent

Les agents peuvent créer un compte Helius et obtenir une clé API avec le Helius CLI :
Chaque nouvelle inscription, y compris à l’offre Agent, nécessite une adresse e-mail, un prénom et un nom. Le portefeuille sert uniquement au paiement.
En cas de réussite (--resume ou --pay), votre agent reçoit une clé API, des points de terminaison RPC et 1 000 000 de crédits. Consultez le guide complet de la CLI pour plus de détails.

Authentification

Toutes les requêtes adressées à l’API Helius nécessitent une clé API transmise comme paramètre de requête :
Ajoutez-la à n’importe quel point de terminaison RPC ou API. Par exemple : https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY Obtenez une clé API depuis le tableau de bord Helius ou par programmation avec la CLI Helius.
Utilisez Gatekeeper pour réduire la latence — Gatekeeper (bêta) retire Cloudflare du chemin critique, réduisant les temps de réponse de plusieurs dizaines à plusieurs centaines de millisecondes. Même clé API, mêmes méthodes : il suffit de remplacer le point de terminaison :
Prend en charge toutes les méthodes RPC, DAS, WebSocket, de compression ZK, de frais de priorité et de transactions enrichies. Consultez le guide de migration pour plus de détails.

Recommandations propres aux API Helius

Utilisez ces API optimisées par Helius plutôt que d’enchaîner les méthodes RPC Solana standard :

Flux de travail recommandés

Lorsque vous utilisez les soldes de la Wallet API pour obtenir des récapitulatifs de portefeuille : l’API est en bêta ; les tokens sont limités à 100 par page ; les NFT sont exclus sauf avec showNfts=true (100 NFT au maximum, uniquement sur la première page) ; pricePerToken et usdValue peuvent être null ; les prix sont des estimations horaires, et non les prix du marché en temps réel ; totalUsdValue couvre la page actuelle, et non l’intégralité du portefeuille paginé ; chaque requête coûte 100 crédits. Utilisez DAS avec pagination pour obtenir un inventaire complet des NFT et de leurs métadonnées — ne considérez pas Balances comme un inventaire complet des NFT.

Référence rapide des limites de débit

Les limites de débit dépendent de votre offre. Les agents commencent avec l’offre Agent et 1 000 000 de crédits. L’offre Agent nécessite un paiement unique de 10 $ USDC, et chaque nouvelle inscription requiert une adresse e-mail, un prénom et un nom.
Tous les prix indiqués en dollars sont exprimés en dollars des États-Unis (USD).
Pour connaître les limites de débit détaillées de chaque API, consultez Limites de débit.

Crédits par appel d’API

Pour obtenir la répartition complète, consultez Crédits.

Nouvelles tentatives et gestion des erreurs

Codes d’état HTTP

Modèle de nouvelle tentative

Surveiller l’utilisation des crédits

Référence rapide

  • RPC du réseau principal : https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • RPC du réseau principal (Gatekeeper bêta) : https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
  • RPC du réseau de développement : https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • WSS du réseau principal : wss://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • WSS du réseau principal (Gatekeeper bêta) : wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY
  • WSS du réseau de développement : wss://devnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • Point de terminaison Sender : https://sender.helius-rpc.com/fast
  • Serveur MCP : https://www.helius.dev/docs/mcp
  • Tableau de bord : dashboard.helius.dev
  • État : helius.statuspage.io