Tous les articles
9 min de lecture

Alternatives à tonapi.io en 2026 pour les développeurs TON

Panorama honnête des alternatives à tonapi.io en 2026 : API publiques, limite 429 et TONNode — l'accès à TON via MCP, avec lecture, swap, cross-chain et wallet.

alternative tonapitonapi.ioAPI TONMCP TONerreur 429TONNode

La première requête passe, la centième renvoie 429 — et vous cherchez une alternative à tonapi

Trois heures du matin, vous déployez un bot qui surveille les arrivées d'USDT sur les wallets de vos utilisateurs. En local, tout tournait au quart de tour. En prod, cinq minutes après le lancement, les logs ne répètent plus qu'une seule et même chose : HTTP 429 Too Many Requests. Les soldes se rafraîchissent par à-coups, les utilisateurs vous écrivent « où est mon argent ? ». Ça vous parle ? L'API publique a tapé sa limite alors que le trafic ne fait que commencer à monter. C'est à ce moment précis que démarre la recherche : il vous faut une alternative à tonapi capable de tenir en production (côté requêtes anglophones, ça se cherche sous « tonapi alternative 2026 »).

Sans clé, la limite publique de tonapi.io tourne autour d'une requête par seconde, et n'importe quelle boucle « récupérer les soldes d'une liste de wallets » ou « charger l'historique des transactions » la sature instantanément.

Évacuons tout de suite le folklore, pour que vous ne cherchiez pas quelque chose qui n'existe pas. Dans la communauté TON circule l'« erreur 228 » : c'est un mème, pas un code d'erreur d'API. Ni tonapi ni toncenter ne vous renverront jamais un « 228 ». Le vrai code de rate-limit, c'est le 429, et c'est bien lui qu'il faut attraper et traiter. Si vous googlez « tonapi 228 », ce dont vous avez réellement besoin, c'est du correctif pour 429 — et l'analyse est déjà faite dans /blog/tonapi-429-fix.

Ci-dessous, une analyse honnête : où se situe le plafond de tonapi.io, qui d'autre existe sur le marché, et pourquoi de plus en plus d'équipes entrent dans TON non pas par du REST brut, mais par MCP.

Ce qu'est tonapi.io et où se situe son plafond

tonapi.io est une API HTTP publique pour TON — du REST indexé posé au-dessus d'un nœud. Vous envoyez une requête, vous recevez du JSON : solde, transactions, état d'un compte, données de jettons et de NFT. Zéro infrastructure de votre côté. Pour un prototype, c'est idéal.

Le plafond commence exactement là où commence la production :

  • Un rate limit mutualisé. Sans clé, environ 1 rps, puis 429. Avec une clé, la limite monte, mais l'infrastructure reste partagée. Ce n'est ni un ban ni une panne : c'est précisément ainsi que doit fonctionner le rate limiting d'une ressource commune.
  • Du REST brut. Vous récupérez du JSON et vous écrivez tout le code vous-même : la conversion des unités raw selon les decimals, le calcul de l'adresse du jetton-wallet, l'assemblage d'une transaction de swap. L'API ne « sait » pas agir — elle ne fait que lire.
  • Lecture seule. Aucun swap, aucun cross-chain, aucune génération de wallet prêts à l'emploi — ce n'est pas son rôle.

Pour un dashboard, ça suffit. Pour un agent censé faire quelque chose dans TON, ça ne suffit plus.

Pourquoi les développeurs cherchent une alternative à tonapi en 2026

Trois raisons reviennent le plus souvent :

  1. Les limites frappent précisément au moment où le projet décolle. Tant que vous avez dix utilisateurs, 1 rps suffit. À mille, les 429 partent en rafale. C'est le design d'un endpoint public, pas un bug. Pour les options, voyez les alternatives à toncenter en 2026.
  2. La couche d'intégration a changé. De plus en plus souvent, ce n'est plus votre backend qui s'adresse directement à TON, mais un agent IA — Claude, Cursor, ChatGPT/Codex. Pour un agent, un endpoint REST n'est qu'une documentation : il faut la lui faire ingurgiter, parser les réponses et ne pas se tromper de paramètres. L'interface native d'un agent, ce n'est pas le REST : ce sont des outils exposés via MCP.
  3. Il faut des actions, pas seulement des données. Un swap GRAM⇄jetton, un échange cross-chain, la création d'un wallet. tonapi ne couvre pas ça — il faut recoller plusieurs SDK entre eux.

L'analogie est simple. Une API publique, c'est le bus de ville : gratuit, il passe à l'heure, mais aux heures de pointe il est bondé et avance par à-coups. Pour la production, il vous faut soit votre propre voie réservée, soit un tout autre moyen de transport.

Que regarder : API publiques, liteservers, indexeurs et MCP

La carte honnête des options en 2026 :

  • Les API HTTP publiques (tonapi.io, toncenter). Démarrage rapide, données indexées. En face : un rate limit mutualisé, des 429, et de la lecture seule.
  • Les liteservers publics de la configuration globale (ADNL). Un accès natif au nœud, mais des serveurs partagés et limités : sous charge, ils répondent souvent not ready ou tombent en timeout ADNL, et ne conservent pas d'historique profond.
  • Votre propre liteserver / nœud d'archive / indexeur. Contrôle et profondeur maximum, mais vous payez en matériel, en synchronisation et en temps devops. C'est un projet d'infrastructure, pas du self-serve.
  • Un serveur MCP pour TON. Des outils au lieu du REST brut : l'agent appelle get_balance ou build_swap_tx plutôt que de parser du JSON à la main. Sur le protocole lui-même : MCP pour TON, par où commencer.

TONNode : l'accès à TON via MCP, pas via du REST brut

TONNode (site tonnode.io) est un serveur MCP hébergé pour TON. MCP (Model Context Protocol) est le standard par lequel les agents IA (Claude, Cursor, ChatGPT/Codex et n'importe quel client MCP) appellent des outils. La différence avec tonapi tient à la façon de poser le problème : au lieu de « donne-moi le JSON, je me débrouillerai », vous confiez à l'agent un jeu d'outils typés, et c'est lui qui décide lequel appeler.

Exemple concret. Pour connaître le solde USDT d'une adresse en REST brut, il faut : retrouver l'adresse du jetton-master d'USDT, calculer l'adresse du jetton-wallet du propriétaire, appeler son get-method, récupérer les decimals (6 pour USDT) et convertir les unités raw. Avec TONNode, c'est un seul appel get_jetton_balance — le jetton-wallet est calculé on-chain. Le cas est détaillé dans le solde USDT sur TON en un seul appel.

Point d'honnêteté important : TONNode, ce n'est pas du pay-per-request, pas une API REST/indexée, pas des flux SSE/WebSocket et pas des webhooks. Le nœud d'archive est encore en cours de synchronisation, donc nous ne promettons pas l'historique profond comme un service prêt à l'emploi. Ce qui existe aujourd'hui est décrit ci-dessous, sans rien y ajouter.

16 outils : lecture + swap + cross-chain + wallet

Exactement 16 outils, en quatre groupes. Les seize sont disponibles sur tous les plans.

Lecture (8) :

  • get_masterchain_info — la tête de la masterchain
  • get_balance — le solde en GRAM
  • get_account_state — statut, flags, dernière transaction
  • get_transactions — l'historique des transactions
  • run_get_method — n'importe quel get-method read-only d'un contrat
  • get_jetton_balance — le solde d'un jetton / d'USDT ; l'adresse du jetton-wallet est calculée on-chain pour vous
  • get_jetton_info — les métadonnées d'un jetton : nom, symbole, decimals, supply (les decimals servent à convertir les unités raw : USDT=6, 9 pour la plupart des jettons)
  • parse_address — conversion et validation des formats EQ/UQ/raw, fonctionne hors ligne

Swap (2) :

  • get_swap_quote — une cotation DEX ferme GRAM⇄jetton via le protocole Omniston (liquidité STON.fi + DeDust)
  • build_swap_tx — la transaction de swap non signée, prête pour TonConnect

Cross-chain (5) :

  • get_crosschain_quote — la cotation d'un échange cross-chain
  • build_crosschain_swap_tx — la transaction d'escrow HTLC non signée + le secret
  • track_crosschain_swap — les phases de l'opération sur les deux réseaux
  • disclose_crosschain_secret — révéler le secret pour le règlement, après vérification on-chain que tout est prêt
  • build_crosschain_refund — récupérer les fonds de l'escrow si l'opération reste bloquée

Escrow HTLC atomique, TON est toujours la chaîne source. Réseaux de destination : Ethereum, Arbitrum, Base, BNB Chain, Polygon, Avalanche. TRON n'est pas encore supporté.

Wallet (1) :

  • generate_wallet — crée un wallet en version v3r2 / v4 / v5r1 / highload_v3 ; renvoie la mnémonique, les clés et l'adresse

Ce fameux « solde USDT », d'où part tout le calvaire de la chaîne d'appels manuelle, tient ici en un seul outil. Et les tâches, vous pouvez les donner à l'agent en langage humain :

Vérifie le solde USDT du wallet EQC… et montre-moi les 5 dernières transactions
Donne-moi une cotation ferme pour swapper 100 GRAM en USDT et assemble la transaction non signée

Le premier prompt, l'agent le décomposera en get_jetton_balance + get_transactions ; le second en get_swap_quote + build_swap_tx. Le résultat du swap sera signé par le wallet de l'utilisateur — sans une seule ligne de code de parsing de votre part.

Non-custodial : le serveur ne signe rien et ne détient aucune clé

C'est la différence clé, celle pour laquelle il vaut la peine de lire la suite. Les outils de swap, de cross-chain et de wallet sont strictement non-custodial :

  • Le serveur ne signe jamais de transactions et ne détient jamais de fonds ni de clés privées.
  • build_swap_tx, build_crosschain_swap_tx et les autres renvoient des messages TonConnect non signés. C'est le wallet de l'utilisateur qui les signe — le serveur ne voit qu'un message prêt à être signé.
  • Le wallet issu de generate_wallet vous est remis en entier (mnémonique + clés + adresse) et ne reste pas sur le serveur.

Autrement dit : TONNode prépare la transaction, mais seul le détenteur de la clé peut appuyer sur « signer ».

Pour une comparaison honnête : le @ton/mcp officiel de la TON Foundation est un agent-wallet custodial (split-key : la clé operator chez l'agent, la clé owner chez l'utilisateur). Il signe lui-même, sait dépenser de façon autonome et travailler avec les NFT/DNS. Il a ses propres forces. La différence est simple : il est custodial et TON uniquement ; TONNode est non-custodial et fait du cross-chain. Comparaison détaillée sur tonnode.io/mcp/vs-official.

Comment se connecter : gratuitement en local, ou avec une clé hébergée

Gratuit et en local. Le paquet @tonnode/mcp est open source (MIT), publié sur npm et GitHub (tonnode/mcp), et parle le protocole natif ADNL de TON, sans couches HTTP intermédiaires. Le jeu complet d'outils de lecture, tout de suite :

{
  "mcpServers": {
    "ton": {
      "command": "npx",
      "args": ["-y", "@tonnode/mcp"]
    }
  }
}

Clé hébergée — quand il vous faut un débit garanti rattaché à votre propre clé :

{
  "mcpServers": {
    "ton": {
      "type": "http",
      "url": "https://mcp.tonnode.io/mcp",
      "headers": { "Authorization": "Bearer tn_live_…" }
    }
  }
}

Tarifs (partout les 16 outils, vous ne payez que le débit) :

Plan Prix Limite
Hobby gratuit pour toujours 60 requêtes/min
Pro $29/mois 300 requêtes/min
Scale $199/mois 1200 requêtes/min

La clé gratuite Hobby est délivrée dès la connexion, sans carte bancaire. Les plans payants se règlent en GRAM ou en USDT sur le réseau TON via TonConnect, ou bien en BTC/ETH/SOL et d'autres devises via une facture xRocket dans Telegram ; la clé est délivrée automatiquement une fois le paiement confirmé. (GRAM est le nouveau nom de Toncoin depuis juin 2026 ; le réseau, lui, s'appelle toujours TON.)

Que choisir selon votre cas

  • Un prototype ou un script ponctuel où la lecture suffit. Le tonapi.io / toncenter public, ou npx -y @tonnode/mcp en local — gratuit et amplement suffisant. Gardez le 429 en tête et ne bâtissez pas votre prod là-dessus.
  • Un agent qui lit TON (soldes, transactions, USDT, get-methods). Installez @tonnode/mcp en local — gratuit, jeu de lecture complet, zéro infrastructure.
  • De la prod sous charge + swap / cross-chain / génération de wallets. La clé hébergée TONNode : limite garantie, transactions non signées et non-custodial, cross-chain atomique vers 6 réseaux EVM.
  • Il vous faut un agent-wallet autonome avec NFT/DNS. Regardez le @ton/mcp officiel — en assumant son côté custodial. Chez TONNode, les outils NFT/DNS sont sur la roadmap, l'historique d'archive profond est encore en cours de synchronisation, et un liteserver dédié s'installe manuellement sur demande — si c'est critique pour vous, écrivez-nous.

En résumé : un 429, c'est le signal que vous avez dépassé le stade du bus — et la meilleure alternative à tonapi sous charge n'est pas un énième REST mutualisé, mais un débit garanti via MCP. Commencez par le jeu de lecture gratuit en local, et quand vous taperez la limite, prenez la clé qui vous garantit ce débit.

Obtenir la clé gratuite Hobby (sans carte bancaire) → tonnode.io/dashboard?plan=hobby

Voir tous les outils — tonnode.io/mcp · les tarifs — tonnode.io/pricing

Donnez à votre agent l'accès à TON

16 outils MCP : lecture, swaps non-custodial, cross-chain et wallets. Forfait gratuit — 60 req/min, sans carte.