tonapi.io баламалары 2026 — TON әзірлеушілері үшін

Бірінші сұрау өтті, жүзіншісі 429 қайтарды — сіз tonapi баламасын іздеп жүрсіз

Түнгі сағат үш, сіз пайдаланушылардың әмияндарына USDT түсімін бақылайтын ботты деплой жасап жатырсыз. Жергілікті ортада бәрі мінсіз әрі жылдам жұмыс істеді. Продта — іске қосқаннан кейінгі бесінші минутта — логтар бір ғана жолға толы: HTTP 429 Too Many Requests. Баланстар секіріп-секіріп жаңарады, пайдаланушылар «менің ақшам қайда» деп жазады. Таныс па? Ашық API лимитке тіреліп қалды, ал трафик енді ғана өсе бастаған. Дәл осы сәттен іздеу басталады: продты көтере алатын tonapi баламасы керек (ағылшын тілді сұрауларда бұл «tonapi alternative 2026» деп естіледі).

Кілтсіз пайдаланғанда tonapi.io-ның ашық лимиті — шамамен секундына 1 сұрау, ал «әмияндар тізімі бойынша баланстарды жинау» немесе «транзакциялар тарихын тарту» сияқты кез келген цикл оған сол сәтте-ақ тіреледі.

Жоқ нәрсені іздеп жүрмеуіңіз үшін фольклорды бірден айтып өтейік. TON қауымдастығында «228 қатесі» деген жүреді — бұл мем-сан, API қатесінің коды емес. «228»-ді сізге tonapi да, toncenter де қайтармайды. Лимиттің нақты коды — 429, әрі дәл соны ұстап, өңдеу керек. Егер «tonapi 228» деп гуглдеп жүрсеңіз — сізге шын мәнінде 429 фиксі керек, ал оны /blog/tonapi-429-fix жазбасында егжей-тегжейлі талдағанбыз.

Төменде — tonapi.io-ның төбесі қайда екенін, нарықта тағы кім бар екенін және командалардың TON-ға неге барған сайын шикі REST арқылы емес, MCP арқылы кіретінін адал талдаймыз.

tonapi.io деген не және оның төбесі қайда

tonapi.io — TON үшін ашық HTTP-API (нода үстіндегі индекстелген REST). Сіз сұрау жібересіз, JSON аласыз: баланс, транзакциялар, аккаунт күйі, жетондар мен NFT деректері. Сіздің жағыңызда ешқандай инфрақұрылым қажет емес. Прототип үшін — тамаша.

Төбесі продакшн басталған жерден басталады:

• Ортақ rate limit. Кілтсіз ~1 rps, әрі қарай 429. Кілтпен лимит жоғарырақ, бірақ бұл бәрібір shared-инфрақұрылым. Бұл бан да емес, ақау да емес — ортақ ресурстың rate limiting-і дәл осылай жұмыс істеуге тиіс.
• Шикі REST. Сіз JSON аласыз да, бүкіл кодты өзіңіз жазасыз: raw-бірліктерді decimals бойынша қайта санау, жетон-әмиянның мекенжайын есептеу, свап транзакциясын жинау. API әрекет жасай «білмейді» — тек оқиды.
• Тек оқу. Дайын күйінде свап та, кроссчейн де, әмиян генерациясы да жоқ — бұл оның міндеті емес.

Дашборд үшін бұл жетеді. TON-да бірдеңе істеуге тиіс агент үшін — енді жетпейді.

Әзірлеушілер 2026 жылы tonapi баламасын неге іздейді

Ең жиі кездесетін үш себеп:

1. Лимиттер дәл жоба жүре бастағанда соғады. Пайдаланушы он болғанда 1 rps жетеді. Мыңға жеткенде 429 жаңбырдай жауады. Бұл — ашық эндпоинттің дизайны, баг емес. Нұсқалар туралы — 2026 жылғы toncenter баламаларында.
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 емес, инфрақұрылымдық жоба.
• TON үшін MCP-сервер. Шикі REST-тің орнына құралдар: агент JSON-ды қолмен парсинг жасамай, get_balance немесе build_swap_tx шақырады. Протоколдың өзі туралы — TON үшін MCP, неден бастау керек.

TONNode: TON-ға шикі REST арқылы емес, MCP арқылы қолжетімділік

TONNode (сайты tonnode.io) — TON үшін hosted MCP-сервер. MCP (Model Context Protocol) — ЖИ-агенттер (Claude, Cursor, ChatGPT/Codex және кез келген MCP-клиент) құралдарды шақыратын стандарт. tonapi-дан айырмашылығы — міндеттің қойылуында: «маған JSON бер, өзім түсінемін» дегеннің орнына сіз агентке типтелген құралдар жинағын бересіз, ал ол қайсысын шақыруды өзі шешеді.

Практикалық мысал. Мекенжайдағы USDT балансын шикі REST арқылы білу үшін мыналар керек: USDT жетон-мастерінің мекенжайын табу, иеленушінің жетон-әмиянының мекенжайын есептеу, оның get-әдісін шақыру, decimals алу (USDT-де ол 6) және raw-бірліктерді қайта санау. TONNode арқылы бұл — бір ғана get_jetton_balance шақыруы, әрі жетон-әмиян он-чейн есептеледі. Кейстің толық талдауы — TON-дағы USDT балансы бір шақыруда.

Адалдық туралы маңыздысы: 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 — Omniston протоколы арқылы GRAM⇄жетон бойынша DEX-тің нақты котировкасы (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 балансы» мұнда — бір ғана құрал. Ал агентке тапсырманы адам тілінде беруге болады:

EQC… әмиянындағы USDT балансын тексер және соңғы 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 Foundation-ның ресми @ton/mcp-і — кастодиалды агент-әмиян (split-key: operator-кілт агентте, owner-кілт пайдаланушыда). Ол өзі қол қояды, автономды түрде қаражат жұмсай алады, NFT/DNS-пен жұмыс істей алады. Оның өз күшті жақтары бар. Айырмашылық қарапайым: ол кастодиалды әрі тек TON; TONNode кастодиалды емес әрі кроссчейнмен. Егжей-тегжейлі салыстыру — tonnode.io/mcp/vs-official бетінде.

Қалай қосуға болады: жергілікті тегін немесе hosted-кілт

Тегін әрі жергілікті. @tonnode/mcp пакеті ашық (MIT), npm мен GitHub-та (tonnode/mcp) жатыр, аралық HTTP-қабаттарсыз, TON-ның нативті ADNL-протоколы бойынша жұмыс істейді. Оқудың толық жинағы — бірден:

{
  "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 кілті кірген бойда, картасыз беріледі. Ақылы тарифтерді төлеу — TON желісіндегі GRAM немесе USDT арқылы TonConnect-пен, не болмаса Telegram-дағы xRocket шоты арқылы BTC/ETH/SOL және басқалармен; кілт төлем есептелген соң автоматты түрде беріледі. (GRAM — 2026 жылдың маусымында атауы өзгертілген Toncoin; желі бұрынғысынша TON деп аталады.)

Өз тапсырмаңызға нені таңдау керек

• Прототип немесе оқу жеткілікті бір реттік скрипт. Ашық tonapi.io / toncenter немесе жергілікті npx -y @tonnode/mcp — тегін әрі жеткілікті. 429-ды есте ұстаңыз да, оның үстіне продты құрмаңыз.
• Агент TON-ды оқиды (баланстар, транзакциялар, USDT, get-әдістер). @tonnode/mcp-ті жергілікті қойыңыз — тегін, оқудың толық жинағы, нөл инфрақұрылым.
• Жүктеме астындағы прод + свап/кроссчейн/әмиян генерациясы. TONNode-тың hosted-кілті: кепілді лимит, кастодиалды емес қол қойылмаған транзакциялар, 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