Альтернативи tonapi.io у 2026 для TON-розробників

Перший запит пройшов, сотий повернув 429 — і ви шукаєте альтернативу tonapi

Третя година ночі, ви деплоїте бота, який стежить за надходженнями USDT на гаманці користувачів. Локально все літало. У проді — на п'ятій хвилині після запуску — логи забиті одним і тим самим: HTTP 429 Too Many Requests. Баланси оновлюються ривками, користувачі пишуть «де мої гроші». Знайомо? Публічний API вперся в ліміт, а трафік лише почав зростати. Із цього моменту й починається пошук: потрібна альтернатива tonapi, яка витримає продакшн (в англомовних запитах це звучить як «tonapi alternative 2026»).

Без ключа публічний ліміт tonapi.io — приблизно 1 запит на секунду, і будь-який цикл «зібрати баланси за списком гаманців» чи «підтягнути історію транзакцій» упирається в нього миттєво.

Одразу проговоримо фольклор, щоб ви не шукали того, чого не існує. У TON-спільноті гуляє «помилка 228» — це мем-число, а не код помилки API. Ані tonapi, ані toncenter не повертають вам «228». Реальний код ліміту — 429, і саме його треба ловити й обробляти. Якщо гуглите «tonapi 228» — насправді вам потрібен фікс 429, і розбір ми вже робили в /blog/tonapi-429-fix.

Нижче — чесний розбір: де в tonapi.io стеля, хто ще є на ринку і чому дедалі більше команд заходять у TON не через сирий REST, а через MCP.

Що таке tonapi.io і де в нього стеля

tonapi.io — публічний HTTP-API для TON (індексований REST поверх ноди). Ви надсилаєте запит, отримуєте JSON: баланс, транзакції, стан акаунта, дані жетонів і NFT. Нуль інфраструктури на вашому боці. Для прототипу — ідеально.

Стеля починається там, де починається продакшн:

• Спільний rate limit. Без ключа ~1 rps, далі 429. З ключем ліміт вищий, але це все одно shared-інфраструктура. Це не бан і не поломка — так і має працювати rate limiting спільного ресурсу.
• Сирий REST. Ви отримуєте JSON і самі пишете весь код: перерахунок raw-одиниць за decimals, обчислення адреси джетон-гаманця, збирання транзакції свапу. API не «вміє» діяти — лише читає.
• Лише читання. Жодного свапу, кросчейну чи генерації гаманця з коробки — це не його завдання.

Для дашборда цього достатньо. Для агента, який має щось зробити в TON, — уже ні.

Чому розробники шукають альтернативу tonapi у 2026

Три причини, що трапляються найчастіше:

1. Ліміти б'ють саме тоді, коли проєкт пішов угору. Поки користувачів десять — 1 rps вистачає. Прийшла тисяча — 429 сиплеться градом. Це дизайн публічного ендпоінта, а не баг. Про варіанти — в альтернативах toncenter на 2026.
2. Змінився шар інтеграції. Дедалі частіше до TON звертається не ваш бекенд напряму, а ШІ-агент — Claude, Cursor, ChatGPT/Codex. Для агента REST-ендпоінт — це документація, яку треба згодувати, розпарсити й не переплутати параметри. Природний інтерфейс агента — не REST, а інструменти через MCP.
3. Потрібні дії, а не лише дані. Свап GRAM⇄жетон, кросчейн-обмін, створення гаманця. tonapi цього не покриває — доводиться склеювати кілька SDK.

Аналогія проста. Публічний API — це міський автобус: безкоштовно, ходить за розкладом, але в годину пік напханий ущерть і їде ривками. Для продакшну потрібна або власна смуга, або принципово інший транспорт.

Кого розглядати: публічні API, лайтсервери, індексери та MCP

Чесна карта варіантів на 2026-й:

• Публічні HTTP-API (tonapi.io, toncenter). Швидкий старт, індексовані дані. Мінус — спільний rate limit, 429, лише читання.
• Публічні лайтсервери з глобального конфігу (ADNL). Нативний доступ до ноди, але сервери спільні й лімітовані: під навантаженням часто відповідають not ready або ADNL-таймаутом і не тримають глибокої історії.
• Власний лайтсервер / архівна нода / індексер. Максимум контролю та глибини, але ви платите залізом, синхронізацією і devops-часом. Це інфраструктурний проєкт, а не self-serve.
• MCP-сервер для TON. Інструменти замість сирого REST: агент викликає get_balance чи build_swap_tx, а не парсить JSON руками. Про сам протокол — MCP для TON: з чого почати.

TONNode: доступ до TON через MCP, а не через сирий REST

TONNode (сайт tonnode.io) — це hosted MCP-сервер для TON. MCP (Model Context Protocol) — стандарт, за яким ШІ-агенти (Claude, Cursor, ChatGPT/Codex і будь-який MCP-клієнт) викликають інструменти. Відмінність від tonapi — у постановці завдання: замість «віддай мені JSON, я розберуся» ви даєте агенту набір типізованих інструментів, і він сам вирішує, який викликати.

Практичний приклад. Щоб дізнатися баланс USDT на адресі через сирий REST, потрібно: знайти адресу майстер-контракту жетона USDT, обчислити адресу джетон-гаманця власника, викликати його get-метод, взяти decimals (в USDT це 6) і перерахувати raw-одиниці. Через TONNode це один виклик get_jetton_balance — джетон-гаманець обчислюється он-чейн. Детальний розбір кейсу — баланс USDT на TON одним викликом.

Важливе про чесність: TONNode — це не pay-per-request, не REST/індексований API, не стріми SSE/WebSocket і не вебхуки. Архівна нода поки що синхронізується, тому глибоку історію як готову послугу не обіцяємо. Що є сьогодні — те й описано нижче, без прикрас.

16 інструментів: читання + свап + кросчейн + гаманець

Рівно 16 інструментів, чотири групи. На всіх тарифах доступні всі шістнадцять.

Читання (8):

• get_masterchain_info — голова мастерчейну
• get_balance — баланс GRAM
• get_account_state — статус, прапорці, остання транзакція
• get_transactions — історія транзакцій
• run_get_method — будь-який read-only get-метод контракту
• get_jetton_balance — баланс жетона/USDT; адреса джетон-гаманця обчислюється он-чейн за вас
• get_jetton_info — метадані жетона: ім'я, символ, decimals, емісія (decimals потрібні для перерахунку raw-одиниць: USDT=6, у більшості жетонів 9)
• parse_address — конвертація та перевірка форматів EQ/UQ/raw, працює офлайн

Свап (2):

• get_swap_quote — тверде котирування DEX GRAM⇄жетон через протокол Omniston (ліквідність STON.fi + DeDust)
• build_swap_tx — непідписана транзакція свапу, готова для TonConnect

Кросчейн (5):

• get_crosschain_quote — котирування кросчейн-обміну
• build_crosschain_swap_tx — непідписана HTLC-ескроу транзакція + секрет
• track_crosschain_swap — фази угоди в обох мережах
• disclose_crosschain_secret — розкрити секрет для розрахунку після перевірки готовності он-чейн
• build_crosschain_refund — повернути кошти з ескроу, якщо угода зависла

Атомарний HTLC-ескроу, TON завжди джерело. Мережі призначення: Ethereum, Arbitrum, Base, BNB Chain, Polygon, Avalanche. TRON поки що не підтримується.

Гаманець (1):

• generate_wallet — створює гаманець версій v3r2 / v4 / v5r1 / highload_v3; повертає мнемоніку, ключі та адресу

Той самий «баланс USDT», через який починається весь біль із ручним ланцюжком викликів, тут — один інструмент. А завдання агентові можна ставити людською мовою:

Перевір баланс USDT на гаманці EQC… і покажи останні 5 транзакцій

Дай тверде котирування на свап 100 GRAM в USDT і збери непідписану транзакцію

Перший промпт агент розкладе на get_jetton_balance + get_transactions, другий — на get_swap_quote + build_swap_tx. Підписувати результат свапу буде гаманець користувача — без жодного рядка вашого коду для парсингу.

Некастодіальність: сервер не підписує і не зберігає ключі

Ключова відмінність, заради якої варто читати далі. Інструменти свапу, кросчейну та гаманця суворо некастодіальні:

• Сервер ніколи не підписує транзакції і ніколи не зберігає кошти та приватні ключі.
• build_swap_tx, build_crosschain_swap_tx та інші повертають непідписані TonConnect-повідомлення. Підписує їх гаманець користувача — сервер бачить лише вже готове до підпису повідомлення.
• Гаманець із generate_wallet віддається вам повністю (мнемоніка + ключі + адреса) і на сервері не залишається.

Тобто TONNode готує транзакцію, але натиснути «підписати» може лише власник ключа.

Для чесного порівняння: офіційний @ton/mcp від TON Foundation — це кастодіальний агент-гаманець (split-key: operator-ключ в агента, owner-ключ у користувача). Він підписує сам, вміє автономно витрачати, працювати з NFT/DNS. У нього свої сильні сторони. Різниця проста: він кастодіальний і лише TON; TONNode некастодіальний і з кросчейном. Детальне порівняння — на tonnode.io/mcp/vs-official.

Як підключити: безкоштовно локально або hosted-ключ

Безкоштовно й локально. Пакет @tonnode/mcp відкритий (MIT), лежить на npm і GitHub (tonnode/mcp), працює за нативним ADNL-протоколом TON без HTTP-прошарків. Повний набір читання — одразу:

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

Hosted-ключ — коли потрібна гарантована пропускна здатність під власним ключем:

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

Тарифи (скрізь — усі 16 інструментів, платите лише за пропускну здатність):

Тариф	Ціна	Ліміт
Hobby	безкоштовно назавжди	60 запитів/хв
Pro	$29/міс	300 запитів/хв
Scale	$199/міс	1200 запитів/хв

Безкоштовний ключ Hobby видається одразу після входу, без картки. Оплата платних тарифів — GRAM або USDT у мережі TON через TonConnect, або BTC/ETH/SOL та інші через рахунок xRocket у Telegram; ключ видається автоматично після розрахунку платежу. (GRAM — це перейменований у червні 2026 Toncoin; мережа, як і раніше, називається TON.)

Що обрати під своє завдання

• Прототип чи разовий скрипт, де вистачає читання. Публічний tonapi.io / toncenter або локальний npx -y @tonnode/mcp — безкоштовно й достатньо. Пам'ятайте про 429 і не будуйте на цьому прод.
• Агент читає TON (баланси, транзакції, USDT, get-методи). Ставте @tonnode/mcp локально — безкоштовно, повний набір читання, нуль інфраструктури.
• Прод під навантаженням + свап/кросчейн/генерація гаманців. Hosted-ключ TONNode: гарантований ліміт, некастодіальні непідписані транзакції, атомарний кросчейн на 6 EVM-мереж.
• Потрібен автономний агент-гаманець із NFT/DNS. Дивіться офіційний @ton/mcp — з поправкою на кастодіальність. У TONNode NFT/DNS-інструменти в роадмапі, глибока архівна історія поки що синхронізується, а виділений лайтсервер ставиться вручну за запитом — якщо це критично, напишіть нам.

Якщо коротко: 429 — це сигнал, що ви переросли автобус, і найкраща альтернатива tonapi під навантаженням — не ще один спільний REST, а гарантована пропускна здатність через MCP. Почніть із безкоштовного набору читання локально, а коли впретеся в ліміт — візьміть ключ, який цю здатність гарантує.

Отримати безкоштовний ключ Hobby (без картки) → tonnode.io/dashboard?plan=hobby

Подивитися всі інструменти — tonnode.io/mcp · тарифи — tonnode.io/pricing