Alternativas a tonapi.io en 2026 para desarrolladores TON

La primera petición pasó, la número cien devolvió 429 — y ya estás buscando una alternativa a tonapi

Son las tres de la madrugada y estás desplegando un bot que vigila los depósitos de USDT en las wallets de tus usuarios. En local todo volaba. En producción — a los cinco minutos del arranque — los logs se llenan de lo mismo: HTTP 429 Too Many Requests. Los saldos se actualizan a saltos y los usuarios preguntan «¿dónde está mi dinero?». ¿Te suena? La API pública chocó contra su límite, y eso que el tráfico apenas empieza a crecer. Ahí es donde arranca la búsqueda: necesitas una alternativa a tonapi que aguante producción (en las búsquedas en inglés suena como «tonapi alternative 2026»).

Sin clave, el límite público de tonapi.io ronda 1 petición por segundo, y cualquier bucle de «recolectar saldos de una lista de wallets» o «traer el historial de transacciones» se estampa contra él al instante.

Aclaremos el folclore de entrada, para que no busques algo que no existe. En la comunidad de TON circula el «error 228» — es un número-meme, no un código de error de la API. Ni tonapi ni toncenter te devuelven jamás un «228». El código real del límite es 429, y ese es el que hay que capturar y manejar. Si estás googleando «tonapi 228», lo que en realidad necesitas es el fix del 429, y ya lo desmenuzamos en /blog/tonapi-429-fix.

Abajo va un repaso honesto: dónde está el techo de tonapi.io, quién más hay en el mercado y por qué cada vez más equipos entran a TON no por REST crudo, sino por MCP.

Qué es tonapi.io y dónde está su techo

tonapi.io es una API HTTP pública para TON (REST indexado encima del nodo). Mandas una petición, recibes JSON: saldo, transacciones, estado de la cuenta, datos de jettons y NFT. Cero infraestructura de tu lado. Para un prototipo, perfecto.

El techo empieza donde empieza producción:

• Rate limit compartido. Sin clave, ~1 rps; después, 429. Con clave el límite sube, pero sigue siendo infraestructura compartida. No es un ban ni una avería — así es exactamente como debe funcionar el rate limiting de un recurso común.
• REST crudo. Recibes JSON y escribes todo el código tú mismo: convertir unidades raw según decimals, calcular la dirección de la jetton wallet, armar la transacción de swap. La API no «sabe» hacer acciones — solo lee.
• Solo lectura. Nada de swaps, cross-chain ni generación de wallets de serie — no es su trabajo.

Para un dashboard, con eso basta. Para un agente que tiene que hacer algo en TON, ya no.

Por qué los desarrolladores buscan una alternativa a tonapi en 2026

Las tres razones más frecuentes:

1. Los límites golpean justo cuando el proyecto despega. Con diez usuarios, 1 rps sobra. Llegan mil y el 429 cae en ráfagas. Es el diseño de un endpoint público, no un bug. Las opciones las repasamos en alternativas a toncenter para 2026.
2. Cambió la capa de integración. Cada vez más, quien consulta TON no es tu backend directamente, sino un agente de IA — Claude, Cursor, ChatGPT/Codex. Para un agente, un endpoint REST es documentación: hay que dársela de comer, parsearla y no equivocarse con los parámetros. La interfaz nativa de un agente no es REST, son las herramientas vía MCP.
3. Hacen falta acciones, no solo datos. Swap GRAM⇄jetton, intercambio cross-chain, creación de wallets. tonapi no lo cubre: hay que ir pegando varios SDK con cinta adhesiva.

La analogía es simple. Una API pública es el autobús urbano: gratis, pasa según un horario, pero en hora pico va abarrotado y avanza a tirones. Para producción necesitas o un carril propio o un transporte de otra categoría.

Qué considerar: APIs públicas, liteservers, indexadores y MCP

El mapa honesto de opciones para 2026:

• APIs HTTP públicas (tonapi.io, toncenter). Arranque rápido, datos indexados. Contras: rate limit compartido, 429, solo lectura.
• Liteservers públicos del config global (ADNL). Acceso nativo al nodo, pero los servidores son compartidos y limitados: bajo carga suelen responder not ready o con timeout de ADNL, y no guardan historial profundo.
• Tu propio liteserver / nodo de archivo / indexador. Máximo control y profundidad, pero lo pagas en hardware, sincronización y horas de devops. Es un proyecto de infraestructura, no self-serve.
• Un servidor MCP para TON. Herramientas en lugar de REST crudo: el agente llama a get_balance o build_swap_tx en vez de parsear JSON a mano. Sobre el protocolo en sí, mira MCP para TON, por dónde empezar.

TONNode: acceso a TON vía MCP, no vía REST crudo

TONNode (sitio tonnode.io) es un servidor MCP hosteado para TON. MCP (Model Context Protocol) es el estándar con el que los agentes de IA (Claude, Cursor, ChatGPT/Codex y cualquier cliente MCP) invocan herramientas. La diferencia con tonapi está en el planteamiento: en lugar de «dame el JSON, ya me las arreglo», le das al agente un set de herramientas tipadas y él decide cuál llamar.

Un ejemplo práctico. Para saber el saldo de USDT de una dirección vía REST crudo hay que: encontrar la dirección del jetton master de USDT, calcular la dirección de la jetton wallet del dueño, llamar a su get-method, tomar los decimals (en USDT son 6) y convertir las unidades raw. Con TONNode es una sola llamada a get_jetton_balance — la jetton wallet se calcula on-chain. Tienes el desglose completo del caso en saldo de USDT en TON con una sola llamada.

Un apunte importante de honestidad: TONNode no es pay-per-request, no es una API REST/indexada, no tiene streams SSE/WebSocket y no tiene webhooks. El nodo de archivo todavía se está sincronizando, así que no prometemos historial profundo como un servicio ya listo. Lo que hay hoy es lo que se describe abajo, sin adornos.

16 herramientas: lectura + swap + cross-chain + wallet

Exactamente 16 herramientas, cuatro grupos. Las dieciséis están disponibles en todos los planes.

Lectura (8):

• get_masterchain_info — el head actual de la masterchain
• get_balance — saldo de GRAM
• get_account_state — estado, flags, última transacción
• get_transactions — historial de transacciones
• run_get_method — cualquier get-method read-only de un contrato
• get_jetton_balance — saldo de un jetton/USDT; la dirección de la jetton wallet se calcula on-chain por ti
• get_jetton_info — metadatos del jetton: nombre, símbolo, decimals, emisión (los decimals hacen falta para convertir unidades raw: USDT=6, la mayoría de jettons 9)
• parse_address — conversión y validación de formatos EQ/UQ/raw, funciona offline

Swap (2):

• get_swap_quote — cotización firme de DEX GRAM⇄jetton vía el protocolo Omniston (liquidez de STON.fi + DeDust)
• build_swap_tx — transacción de swap sin firmar, lista para TonConnect

Cross-chain (5):

• get_crosschain_quote — cotización de un intercambio cross-chain
• build_crosschain_swap_tx — transacción HTLC de escrow sin firmar + secreto
• track_crosschain_swap — fases de la operación en ambas redes
• disclose_crosschain_secret — revelar el secreto para liquidar tras verificar on-chain que todo está listo
• build_crosschain_refund — recuperar los fondos del escrow si la operación se atascó

Escrow HTLC atómico, TON siempre es el origen. Redes de destino: Ethereum, Arbitrum, Base, BNB Chain, Polygon, Avalanche. TRON aún no está soportado.

Wallet (1):

• generate_wallet — crea wallets de versión v3r2 / v4 / v5r1 / highload_v3; devuelve la mnemónica, las claves y la dirección

Ese famoso «saldo de USDT», el que desata todo el dolor de la cadena manual de llamadas, aquí es una sola herramienta. Y al agente puedes darle las tareas en lenguaje humano:

Comprueba el saldo de USDT en la wallet EQC… y muéstrame las últimas 5 transacciones

Dame una cotización firme para un swap de 100 GRAM a USDT y arma la transacción sin firmar

El primer prompt el agente lo descompone en get_jetton_balance + get_transactions; el segundo, en get_swap_quote + build_swap_tx. El resultado del swap lo firmará la wallet del usuario — sin una sola línea tuya de código de parseo.

No custodial: el servidor no firma ni guarda claves

La diferencia clave por la que vale la pena seguir leyendo. Las herramientas de swap, cross-chain y wallet son estrictamente no custodiales:

• El servidor nunca firma transacciones y nunca guarda fondos ni claves privadas.
• build_swap_tx, build_crosschain_swap_tx y compañía devuelven mensajes TonConnect sin firmar. Los firma la wallet del usuario — el servidor solo ve el mensaje ya listo para firmar.
• La wallet de generate_wallet se te entrega entera (mnemónica + claves + dirección) y no queda nada en el servidor.

Es decir: TONNode prepara la transacción, pero el botón «firmar» solo lo puede presionar el dueño de la clave.

Para comparar con honestidad: el @ton/mcp oficial de la TON Foundation es una wallet-agente custodial (split-key: la clave operator la tiene el agente, la clave owner el usuario). Firma por sí mismo, puede gastar de forma autónoma, trabaja con NFT/DNS. Tiene sus puntos fuertes. La diferencia es simple: es custodial y solo TON; TONNode es no custodial y con cross-chain. Tienes la comparación detallada en tonnode.io/mcp/vs-official.

Cómo conectarlo: gratis en local o con clave hosted

Gratis y en local. El paquete @tonnode/mcp es de código abierto (MIT), está en npm y GitHub (tonnode/mcp) y habla el protocolo nativo ADNL de TON sin capas HTTP intermedias. El set completo de lectura, desde el minuto uno:

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

Clave hosted — cuando necesitas capacidad garantizada con tu propia clave:

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

Planes (en todos están las 16 herramientas; solo pagas por la capacidad):

Plan	Precio	Límite
Hobby	gratis para siempre	60 peticiones/min
Pro	$29/mes	300 peticiones/min
Scale	$199/mes	1200 peticiones/min

La clave gratuita Hobby se emite apenas inicias sesión, sin tarjeta. Los planes de pago se abonan en GRAM o USDT en la red TON vía TonConnect, o en BTC/ETH/SOL y otras monedas mediante una factura de xRocket en Telegram; la clave se emite automáticamente al liquidarse el pago. (GRAM es el Toncoin renombrado en junio de 2026; la red sigue llamándose TON.)

Qué elegir según tu caso

• Prototipo o script puntual donde basta con leer. tonapi.io / toncenter público o npx -y @tonnode/mcp en local — gratis y suficiente. Ten presente el 429 y no montes producción encima.
• Un agente que lee TON (saldos, transacciones, USDT, get-methods). Instala @tonnode/mcp en local — gratis, set completo de lectura, cero infraestructura.
• Producción bajo carga + swap/cross-chain/generación de wallets. Clave hosted de TONNode: límite garantizado, transacciones sin firmar no custodiales, cross-chain atómico hacia 6 redes EVM.
• Necesitas una wallet-agente autónoma con NFT/DNS. Mira el @ton/mcp oficial, teniendo en cuenta que es custodial. En TONNode las herramientas de NFT/DNS están en el roadmap, el historial de archivo profundo aún se sincroniza y el liteserver dedicado se monta a mano bajo pedido — si es crítico para ti, escríbenos.

En resumen: el 429 es la señal de que se te quedó pequeño el autobús, y la mejor alternativa a tonapi bajo carga no es otro REST compartido, sino capacidad garantizada vía MCP. Empieza con el set de lectura gratis en local y, cuando choques con el límite, toma una clave que te la garantice.

Obtener la clave Hobby gratis (sin tarjeta) → tonnode.io/dashboard?plan=hobby

Ver todas las herramientas — tonnode.io/mcp · planes — tonnode.io/pricing