> ## 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 pour Agents
> Tout ce dont les agents AI ont besoin pour construire sur Solana avec Helius : inscription programmatique, accès API, SDKs, intégration MCP, et flux de travail recommandés.
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](/docs/fr/agents/mcp) — 10 outils routés couvrant la requête de blockchain, l'envoi de transactions, le streaming, et plus encore
* [Claude Code Plugin](/docs/fr/agents/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](/docs/fr/agents/skills/overview) — Ensembles d'instructions experts pour Claude : [Construire](/docs/fr/agents/skills/build), [Phantom](/docs/fr/agents/skills/phantom), [Jupiter](/docs/fr/agents/skills/jupiter), [DFlow](/docs/fr/agents/skills/dflow), [OKX](/docs/fr/agents/skills/okx), [SVM](/docs/fr/agents/skills/svm)
* [TypeScript SDK](/docs/fr/agents/typescript-sdk) — Méthodes typées pour toutes les API Helius
* [Rust SDK](/docs/fr/agents/rust-sdk) — SDK Rust haute performance pour les API Helius
* [Helius CLI](/docs/fr/agents/cli) — Gestion de compte et scripts shell
Une version lisible par machine de cette section est disponible sur [agents/llms.txt](https://www.helius.dev/docs/agents/llms.txt) pour la consommation par les agents AI.
## MCP vs CLI
Le [serveur Helius MCP](/docs/fr/agents/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.
| | [MCP](/docs/fr/agents/mcp) | [CLI](/docs/fr/agents/cli) |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- |
| **Idéal pour** | Agents AI dans Claude Code, Cursor, Claude Desktop, et tout outil compatible MCP | Scripts shell, pipelines CI/CD, flux de travail terminaux |
| **Interface** | Appels d'outils structurés avec entrées/sorties typées | Ligne de commande avec sortie `--json` |
| **Capacités** | 10 outils routés (`heliusWallet`, `heliusAsset`, `heliusTransaction`, …) couvrant les requêtes blockchain, transactions, webhooks, streaming, analyse de portefeuille, documents, et inscription | 95+ commandes : mêmes capacités plus gestion de configuration et flux interactifs |
| **Configuration de compte** | Intégré : actions `heliusAccount` `generateKeypair` → `signup` (lien ou paiement automatique) — pas besoin d'outils externes | `helius keygen` → `helius signup` |
| **Quand l'utiliser** | Choix par défaut pour tout agent AI | Quand vous avez besoin d'une automatisation au niveau shell ou que vous n'utilisez pas d'outil compatible MCP |
**Commencez avec MCP.** Si votre outil AI supporte MCP (Claude Code, Cursor, Claude Desktop, etc.), utilisez le [serveur MCP](/docs/fr/agents/mcp) ou le [Claude Code Plugin](/docs/fr/agents/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](/docs/fr/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
```
En cas de succès (`--resume` ou `--pay`), votre agent reçoit une clé API, des points de terminaison RPC, et 1,000,000 crédits. Voir le [guide complet du CLI](/docs/fr/agents/cli) pour plus de détails.
## Authentification
Toutes les requêtes API Helius nécessitent une clé API passée en tant que paramètre de requête :
```
?api-key=YOUR_API_KEY
```
Ajoutez ceci à tout 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](https://dashboard.helius.dev) ou de manière programmatique via le [Helius CLI](/docs/fr/agents/cli).
**Utilisez Gatekeeper pour une latence réduite** — [Gatekeeper (Beta)](/docs/fr/gatekeeper/overview) supprime Cloudflare du chemin critique, réduisant les temps de réponse de dizaines à centaines de millisecondes. Même clé API, mêmes méthodes — il suffit de changer le point de terminaison :
```
https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY
```
Supporte toutes les méthodes RPC, DAS, WebSocket, ZK Compression, Priority Fee, et Enhanced Transaction. Voir le [guide de migration](/docs/fr/gatekeeper/migration-guide) pour plus de détails.
## Conseils spécifiques à l'API Helius
Utilisez ces API optimisées pour Helius au lieu d'enchaîner des méthodes RPC Solana standard :
| Si vous avez besoin de... | Utilisez ceci | Pourquoi |
| -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Historique filtré, remplissage ou activité du compte token | [`getTransactionsForAddress`](/docs/fr/rpc/gettransactionsforaddress) | Filtres et pagination ; utilisez `transactionDetails: "full"` uniquement lorsque des transactions brutes et des objets métadonnées sont nécessaires (`filters.tokenAccounts` par défaut à `none`) |
| Activité centrée sur le portefeuille avec changements de balance par transaction | [Historique API Wallet](/docs/fr/wallet-api/history) (beta) | Réponse REST orientée portefeuille — pas équivalent au remplissage filtré GTFA ou aux objets transactions complètes brutes |
| Enregistrements de SOL/token au niveau transfert | [`getTransfersByAddress`](/docs/fr/rpc/gettransfersbyaddress) | Transferts normalisés — pas d'objets transactions complètes |
| Nouvel historique parsé lisible | [Événements Parsés](/docs/fr/parsed-events) | Préféré aux [Transactions Améliorées](/docs/fr/enhanced-transactions/overview) ; GTFA n'est pas le format de réponse Amélioré |
| Métadonnées riches des actifs de portefeuille | [`getAssetsByOwner`](/docs/fr/api-reference/das/getassetsbyowner) (DAS API) | Retourne des métadonnées riches, pas seulement des comptes token bruts ; les avoirs SPL/Token-2022 fongibles nécessitent l'option spécifique au moyen `showFungible` |
| Estimations de frais prioritaires | [`getPriorityFeeEstimate`](/docs/fr/api-reference/priority-fee/getpriorityfeeestimate) | Frais optimaux pré-calculés, aucun calcul manuel |
| Historique des transactions NFT compressé | [`getSignaturesForAsset`](/docs/fr/api-reference/das/getsignaturesforasset) (DAS API) | RPC basé sur l'adresse standard n'inclut pas l'historique NFT compressé |
| Recherche NFT | [`searchAssets`](/docs/fr/api-reference/das/searchassets) ou [`getAssetsByGroup`](/docs/fr/api-reference/das/getassetsbygroup) | Données indexées plus rapides et moins chères |
| Données en temps réel | [LaserStream WebSocket](/docs/fr/rpc/websocket), [LaserStream gRPC](/docs/fr/laserstream), ou [Webhooks](/docs/fr/webhooks) | Flots persistants ou callbacks HTTP sans sondage |
| Streaming backend à haute capacité avec replay | [LaserStream gRPC Subscribe](/docs/fr/api-reference/laserstream/grpc/subscribe) (SDK `subscribe`) | WSS pour navigateur/UI utilise LaserStream WebSocket ; MCP `laserstreamSubscribe` génère config/exemples uniquement — il n'ouvre pas un flux en direct |
| Soumission de transactions à faible latence | [Helius Sender](/docs/fr/sending-transactions/sender) | Routage multi-chemin (Helius, Jito, Harmonic, Rakurai, etc.), taux de réussite plus élevés |
## Flux de travail recommandés
| Construire... | Produits Helius à utiliser |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Bot de trading | [Gatekeeper](/docs/fr/gatekeeper/overview) (RPC à latence la plus faible) + [Sender](/docs/fr/sending-transactions/sender) (soumission tx rapide) + [API Priority Fee](/docs/fr/priority-fee-api) + [LaserStream](/docs/fr/laserstream) (prix en temps réel) |
| Application de portefeuille | [DAS API](/docs/fr/das-api) pour la propriété et les métadonnées des actifs + [Historique API Wallet](/docs/fr/wallet-api/history) (activité beta avec changements de solde) ou [`getTransactionsForAddress`](/docs/fr/rpc/gettransactionsforaddress) pour historique filtré, remplissage, activité du compte token, ou objets transactions complètes brutes |
| Marketplace NFT | [DAS API](/docs/fr/das-api) (`searchAssets`, `getAssetsByGroup`) + [Webhooks](/docs/fr/webhooks) (suivre les ventes/annonces) |
| Sniper de token | [Gatekeeper](/docs/fr/gatekeeper/overview) (RPC routé par bordure) + [LaserStream gRPC](/docs/fr/laserstream) (latence la plus faible) + [Sender](/docs/fr/sending-transactions/sender) (connexions mises en jeu) |
| Suivi de portefeuille | [Bilans API Wallet](/docs/fr/wallet-api/balances) (résumés de portefeuille beta) + [DAS API](/docs/fr/das-api) (`getAssetsByOwner` avec `showFungible` spécifique au moyen) pour inventaire/métadonnées NFT |
| Moniteur de portefeuille | [LaserStream WebSocket](/docs/fr/rpc/websocket) ou [Webhooks](/docs/fr/webhooks) pour notifications en temps réel |
| Tableau de bord analytique | [`getTransactionsForAddress`](/docs/fr/rpc/gettransactionsforaddress) pour remplissage filtré ; [Événements Parsés](/docs/fr/parsed-events) pour nouvelles intégrations parsées ; [Transactions Améliorées](/docs/fr/enhanced-transactions/overview) uniquement pour intégrations parsées existantes |
| Outil d'airdrop | [AirShip](https://airship.helius.dev) (95% moins cher avec ZK compression) |
Lorsque vous utilisez [Bilans API Wallet](/docs/fr/wallet-api/balances) pour des résumés de portefeuille : l'API est en beta ; les tokens sont limités à 100 par page ; les NFTs sont exclus sauf `showNfts=true` (au maximum 100 NFTs sur la première page seulement) ; `pricePerToken` et `usdValue` peuvent être null ; les prix sont des estimations horaires, pas des prix de marché en temps réel ; `totalUsdValue` couvre la page actuelle, pas le portefeuille paginé complet ; chaque requête coûte 100 crédits. Utilisez le DAS paginé pour un inventaire complet NFT et métadonnées — ne traitez pas Bilans comme un inventaire complet NFT.
## Référence rapide des limites de taux
Les limites de taux dépendent de votre [plan](/docs/fr/billing/plans). Les agents commencent au niveau Agent avec 1,000,000 crédits. Le niveau Agent nécessite un paiement de 1 \$ pour prévenir les abus.
| Plan | Prix | Crédits mensuels | Limite de taux RPC | DAS & APIs Améliorées |
| ------------- | ------------------ | ---------------- | ------------------ | --------------------- |
| Agent | Inscription à 1 \$ | 1M | 10 req/s | 2 req/s |
| Développeur | 49 \$/mois | 10M | 50 req/s | 10 req/s |
| Business | 499 \$/mois | 100M | 200 req/s | 50 req/s |
| Professionnel | 999 \$/mois | 200M | 500 req/s | 100 req/s |
Pour les limites de taux détaillées par API, voir [Limites de Taux](/docs/fr/billing/rate-limits).
## Crédits par appel API
| API | Crédits | Remarques |
| --------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------- |
| Appels RPC standards | 1 | La plupart des méthodes RPC Solana |
| `getProgramAccounts` | 10 | Utilisez DAS API autant que possible |
| DAS API | 10 | Tous les endpoints DAS |
| Transactions Améliorées | 100 | Données transactionnelles parsées |
| `getTransactionsForAddress` | 10+ | Transactions complètes coûtent 10 crédits par 100 retournés ; réponses uniquement signatures coûtent 10 crédits fixes. |
| `getTransfersByAddress` | 10 | Plans Développeur+ uniquement |
| Wallet API | 100 | Tous les endpoints Wallet API |
| Priority Fee API | 1 | Estimation de frais |
| Sender | 0 | Gratuit sur tous les plans |
| Événements Webhook | 1 | Par événement livré |
| Gestion Webhook | 100 | Créer, modifier, supprimer |
Pour la répartition complète, voir [Crédits](/docs/fr/billing/credits).
## Réessais et gestion des erreurs
### Codes de statut HTTP
| Code | Signification | Action |
| ---- | ----------------------- | ------------------------------------ |
| 200 | Succès | Traiter la réponse |
| 400 | Mauvaise requête | Corriger les paramètres de requête |
| 401 | Non autorisé | Vérifier la clé API |
| 429 | Limite de taux atteinte | Attendez et réessayez |
| 5xx | Erreur serveur | Réessayez avec un retour exponentiel |
### Modèle de réessai
```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');
}
```
### Suivre l'utilisation des crédits
```bash theme={"system"}
helius usage --json
```
## Référence rapide
* **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`
* **Point de terminaison Sender** : `https://sender.helius-rpc.com/fast`
* **Serveur MCP** : `https://www.helius.dev/docs/mcp`
* **Tableau de bord** : [dashboard.helius.dev](https://dashboard.helius.dev)
* **Statut** : [helius.statuspage.io](https://helius.statuspage.io)