Thay thế tonapi.io 2026: lựa chọn cho lập trình viên TON

Request đầu tiên trót lọt, request thứ một trăm trả về 429 — và bạn đi tìm lựa chọn thay thế tonapi

Ba giờ sáng, bạn deploy con bot theo dõi USDT chảy vào ví người dùng. Chạy local thì bay vèo vèo. Lên production — phút thứ năm sau khi khởi động — log kín đặc một dòng duy nhất: HTTP 429 Too Many Requests. Số dư cập nhật giật cục, người dùng nhắn "tiền của tôi đâu". Nghe quen chứ? API công khai đã đụng trần, mà traffic thì mới chỉ bắt đầu lớn. Cuộc tìm kiếm bắt đầu đúng từ khoảnh khắc đó: bạn cần một lựa chọn thay thế tonapi đủ sức gánh production (trong các truy vấn tiếng Anh thì nó là "tonapi alternative 2026").

Khi không có key, giới hạn công khai của tonapi.io rơi vào khoảng 1 request mỗi giây, nên bất kỳ vòng lặp kiểu "gom số dư theo danh sách ví" hay "kéo lịch sử giao dịch" nào cũng đụng trần ngay lập tức.

Nói ngay về phần truyền miệng trong cộng đồng, để bạn khỏi mất công tìm thứ không tồn tại. Trong cộng đồng TON vẫn hay lưu truyền "lỗi 228" — đó là một con số meme, không phải mã lỗi API. Cả tonapi lẫn toncenter đều không bao giờ trả về "228" cho bạn. Mã giới hạn thật sự là 429, và đó mới là thứ cần bắt và xử lý. Nếu bạn đang google "tonapi 228" — thứ bạn thực sự cần là bản fix cho 429, và chúng tôi đã mổ xẻ nó trong bài /blog/tonapi-429-fix.

Bên dưới là bản phân tích thẳng thắn: trần của tonapi.io nằm ở đâu, trên thị trường còn những ai, và vì sao ngày càng nhiều team vào TON không phải qua REST thô mà qua MCP.

tonapi.io là gì và trần của nó nằm ở đâu

tonapi.io là HTTP API công khai cho TON (một lớp REST đã index dựng trên node). Bạn gửi request, nhận về JSON: số dư, giao dịch, trạng thái account, dữ liệu jetton và NFT. Không cần một chút hạ tầng nào ở phía bạn. Cho prototype thì quá lý tưởng.

Cái trần đó lộ ra đúng ở nơi production bắt đầu:

• Rate limit dùng chung. Không có key thì khoảng 1 rps, vượt qua là 429. Có key thì giới hạn cao hơn, nhưng vẫn là hạ tầng dùng chung. Đây không phải là bị ban, cũng chẳng phải hỏng hóc — rate limiting trên một tài nguyên dùng chung vốn phải hoạt động đúng như vậy.
• REST thô. Bạn nhận JSON rồi tự viết toàn bộ phần code còn lại: quy đổi đơn vị raw theo decimals, tính địa chỉ jetton wallet, dựng giao dịch swap. API không "biết làm" hành động — nó chỉ đọc.
• Chỉ đọc. Không swap, không crosschain, không tạo ví — chẳng thứ nào có sẵn, vì đó không phải việc của nó.

Với một dashboard thì thế là đủ. Với một agent phải làm được điều gì đó trên TON thì không còn đủ nữa.

Vì sao lập trình viên đi tìm lựa chọn thay thế tonapi trong năm 2026

Ba lý do hay gặp nhất:

1. Giới hạn ập đến đúng lúc dự án bắt đầu chạy. Lúc còn mười người dùng thì 1 rps là thừa. Đến khi có một nghìn người, 429 bay về như mưa. Đó là thiết kế của một endpoint công khai, không phải bug. Về các phương án, xem các lựa chọn thay thế toncenter cho 2026.
2. Tầng tích hợp đã đổi. Càng ngày, thứ gọi tới TON càng không còn là backend của bạn mà là một AI agent — Claude, Cursor, ChatGPT/Codex. Với agent, REST endpoint chỉ là một đống tài liệu phải nhồi cho nó đọc, phải parse, rồi phải canh cho khỏi nhầm tham số. Giao diện gốc của agent không phải REST, mà là tool qua MCP.
3. Cần hành động, chứ không chỉ dữ liệu. Swap GRAM⇄jetton, hoán đổi crosschain, tạo ví. tonapi không lo được những thứ đó — bạn phải chắp vá vài SDK lại với nhau.

Ví von cho dễ hình dung. API công khai là chiếc xe buýt thành phố: miễn phí, chạy theo lịch, nhưng giờ cao điểm thì nhồi chật cứng và đi giật cục. Với production, bạn cần hoặc một làn đường riêng, hoặc một phương tiện khác hẳn về bản chất.

Nên cân nhắc những gì: API công khai, liteserver, indexer và MCP

Bản đồ các phương án cho năm 2026, nói thẳng:

• HTTP API công khai (tonapi.io, toncenter). Khởi động nhanh, dữ liệu đã index. Nhược điểm — rate limit dùng chung, 429, chỉ đọc.
• Public liteserver từ global config (ADNL). Truy cập gốc tới node, nhưng server là dùng chung và bị giới hạn: cứ có tải là thường trả về not ready hoặc chết vì ADNL timeout, và chúng cũng không giữ lịch sử sâu.
• Liteserver / archive node / indexer riêng. Kiểm soát và độ sâu tối đa, nhưng bạn trả bằng phần cứng, bằng thời gian đồng bộ và bằng công devops. Đó là một dự án hạ tầng, chứ không phải thứ self-serve.
• MCP server cho TON. Tool thay vì REST thô: agent gọi get_balance hay build_swap_tx, chứ không parse JSON bằng tay. Về bản thân giao thức, xem MCP cho TON, bắt đầu từ đâu.

TONNode: truy cập TON qua MCP, chứ không qua REST thô

TONNode (website tonnode.io) là một MCP server hosted cho TON. MCP (Model Context Protocol) là chuẩn để các AI agent (Claude, Cursor, ChatGPT/Codex và mọi MCP client) gọi tool. Khác biệt so với tonapi nằm ở cách đặt bài toán: thay vì "đưa JSON đây, tôi tự xoay xở", bạn trao cho agent một bộ tool có kiểu rõ ràng, và nó tự quyết định gọi cái nào.

Ví dụ thực tế. Để biết số dư USDT của một địa chỉ qua REST thô, bạn cần: tìm địa chỉ jetton master của USDT, tính địa chỉ jetton wallet của chủ sở hữu, gọi get-method của nó, lấy decimals (USDT là 6) rồi quy đổi đơn vị raw. Qua TONNode thì đó là một lời gọi get_jetton_balance — jetton wallet được tính on-chain hộ bạn. Bài mổ xẻ chi tiết cho case này: số dư USDT trên TON chỉ với một lời gọi.

Điều quan trọng về sự trung thực: TONNode không phải pay-per-request, không phải REST/API đã index, không phải stream SSE/WebSocket và không phải webhook. Archive node hiện vẫn đang đồng bộ, nên chúng tôi không hứa hẹn lịch sử sâu như một dịch vụ sẵn sàng. Hôm nay có gì thì bên dưới mô tả đúng thế, không thêm thắt.

16 tool: đọc + swap + crosschain + ví

Đúng 16 tool, chia bốn nhóm. Ở mọi gói cước, cả mười sáu tool đều dùng được.

Đọc (8):

• get_masterchain_info — đầu masterchain
• get_balance — số dư GRAM
• get_account_state — trạng thái, cờ, giao dịch cuối
• get_transactions — lịch sử giao dịch
• run_get_method — bất kỳ get-method read-only nào của contract
• get_jetton_balance — số dư jetton/USDT; địa chỉ jetton wallet được tính on-chain hộ bạn
• get_jetton_info — metadata của jetton: tên, ký hiệu, decimals, tổng phát hành (decimals cần cho việc quy đổi đơn vị raw: USDT=6, đa số jetton là 9)
• parse_address — chuyển đổi và kiểm tra các định dạng EQ/UQ/raw, chạy offline

Swap (2):

• get_swap_quote — báo giá chắc chắn từ DEX cho GRAM⇄jetton qua giao thức Omniston (thanh khoản STON.fi + DeDust)
• build_swap_tx — giao dịch swap chưa ký, sẵn sàng cho TonConnect

Crosschain (5):

• get_crosschain_quote — báo giá hoán đổi crosschain
• build_crosschain_swap_tx — giao dịch escrow HTLC chưa ký + secret
• track_crosschain_swap — các pha của thương vụ trên cả hai mạng
• disclose_crosschain_secret — tiết lộ secret để thanh toán sau khi đã kiểm tra trạng thái sẵn sàng on-chain
• build_crosschain_refund — lấy lại tiền từ escrow nếu thương vụ bị treo

Escrow HTLC nguyên tử, TON luôn là nguồn. Các mạng đích: Ethereum, Arbitrum, Base, BNB Chain, Polygon, Avalanche. TRON hiện chưa được hỗ trợ.

Ví (1):

• generate_wallet — tạo ví phiên bản v3r2 / v4 / v5r1 / highload_v3; trả về mnemonic, khóa và địa chỉ

Chính cái "số dư USDT" — thứ khơi mào toàn bộ cơn đau đầu với chuỗi lời gọi thủ công — ở đây chỉ gói gọn trong một tool. Còn với agent, bạn có thể giao việc bằng ngôn ngữ đời thường:

Kiểm tra số dư USDT trên ví EQC… và cho xem 5 giao dịch gần nhất

Cho báo giá chắc chắn để swap 100 GRAM sang USDT và dựng giao dịch chưa ký

Prompt thứ nhất agent sẽ tách thành get_jetton_balance + get_transactions, prompt thứ hai thành get_swap_quote + build_swap_tx. Còn kết quả swap thì ví của người dùng mới là bên ký — không cần một dòng code parse nào từ phía bạn.

Phi lưu ký: server không ký và không giữ khóa

Khác biệt cốt lõi, đáng để bạn đọc tiếp. Các tool swap, crosschain và ví là phi lưu ký nghiêm ngặt:

• Server không bao giờ ký giao dịch và không bao giờ giữ tiền hay khóa riêng tư.
• build_swap_tx, build_crosschain_swap_tx và các tool khác trả về message TonConnect chưa ký. Ví của người dùng mới là bên ký chúng — server chỉ nhìn thấy một message đã sẵn sàng để ký.
• Ví từ generate_wallet được trao cho bạn trọn vẹn (mnemonic + khóa + địa chỉ) và không đọng lại trên server.

Nghĩa là TONNode chuẩn bị giao dịch, còn bấm "ký" thì chỉ chủ nhân của khóa mới làm được.

Để so sánh cho sòng phẳng: @ton/mcp chính thức của TON Foundation là một agent-wallet lưu ký (sơ đồ split-key: operator-key nằm ở agent, owner-key ở người dùng). Nó tự ký, có thể tự chủ chi tiêu, làm việc được với NFT/DNS. Nó có thế mạnh riêng của nó. Khác biệt rất đơn giản: nó lưu ký và chỉ có TON; TONNode phi lưu ký và có crosschain. So sánh chi tiết nằm ở tonnode.io/mcp/vs-official.

Cách kết nối: miễn phí chạy local hoặc key hosted

Miễn phí và chạy local. Package @tonnode/mcp là mã nguồn mở (MIT), nằm trên npm và GitHub (tonnode/mcp), chạy trên giao thức ADNL gốc của TON, không qua lớp trung gian HTTP. Trọn bộ tool đọc — có ngay lập tức:

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

Key hosted — khi bạn cần băng thông được đảm bảo dưới key của riêng mình:

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

Gói cước (ở đâu cũng đủ 16 tool, bạn chỉ trả tiền cho băng thông):

Gói	Giá	Giới hạn
Hobby	miễn phí vĩnh viễn	60 request/phút
Pro	$29/tháng	300 request/phút
Scale	$199/tháng	1200 request/phút

Key Hobby miễn phí được cấp ngay sau khi đăng nhập, không cần thẻ. Thanh toán các gói trả phí bằng GRAM hoặc USDT trên mạng TON qua TonConnect, hoặc bằng BTC/ETH/SOL và các đồng khác qua hóa đơn xRocket trong Telegram; key được cấp tự động sau khi thanh toán được ghi nhận. (GRAM là Toncoin đã được đổi tên hồi tháng 6/2026; còn bản thân mạng vẫn mang tên TON.)

Chọn gì cho bài toán của bạn

• Prototype hoặc script dùng một lần, chỉ cần đọc là đủ. tonapi.io / toncenter công khai hoặc chạy local npx -y @tonnode/mcp — miễn phí và đủ dùng. Nhớ giữ 429 trong đầu và đừng dựng production trên nền đó.
• Agent đọc TON (số dư, giao dịch, USDT, get-method). Cài @tonnode/mcp chạy local — miễn phí, trọn bộ tool đọc, không cần hạ tầng.
• Production có tải + swap/crosschain/tạo ví. Key hosted của TONNode: giới hạn được đảm bảo, giao dịch chưa ký phi lưu ký, crosschain nguyên tử tới 6 mạng EVM.
• Cần một agent-wallet tự chủ có NFT/DNS. Hãy xem @ton/mcp chính thức — với lưu ý về tính lưu ký. Ở TONNode, các tool NFT/DNS còn nằm trong roadmap, lịch sử archive sâu vẫn đang đồng bộ, còn liteserver riêng thì được dựng thủ công theo yêu cầu — nếu điều đó là tối quan trọng với bạn, hãy liên hệ với chúng tôi.

Nói ngắn gọn: 429 là tín hiệu cho thấy bạn đã lớn hơn chiếc xe buýt, và lựa chọn thay thế tonapi tốt nhất khi có tải không phải là thêm một REST dùng chung nữa, mà là băng thông được đảm bảo qua MCP. Hãy bắt đầu bằng bộ tool đọc miễn phí chạy local, và khi đụng trần thì lấy cái key đảm bảo được băng thông đó.

Lấy key Hobby miễn phí (không cần thẻ) → tonnode.io/dashboard?plan=hobby

Xem toàn bộ tool — tonnode.io/mcp · bảng giá — tonnode.io/pricing