Developer Docs

Experimental API Notice

The current API structure represents the initial public release of the RANNTA developer platform. Some endpoints are active, some are partially connected, and others are reserved for the staged production rollout.

Authentication, quotas, and response formats may evolve during the testing phase.

RANNTA API documentation overview

Use the RANNTA Developer Platform to power TON-native services through branded infrastructure endpoints, gateway controls, and future ecosystem billing.

Base URL

https://api.ranntaverse.app

The production gateway should expose a stable, developer-facing API layer while TON infrastructure runs behind the platform.

Authentication

X-API-Key: rannta_your_key_here

Requests should be authorized through gateway-issued API keys. Quota, usage tracking, and billing can be attached to each key.

Core endpoints

GET/v1/health

Platform health status.

GET/v1/block/latest

Latest masterchain block information.

GET/v1/address/:address

Address information and account details.

GET/v1/address/:address/balance

Balance lookup for a TON address.

GET/v1/address/:address/state

State lookup for a TON address.

GET/v1/address/:address/transactions

Recent transactions for an address.

GET/v1/wallet/:address

Wallet-oriented information for an address.

Onboarding

Create your developer account
Generate an API key from the dashboard
Call a health endpoint
Integrate address and block queries
Scale into wallet, NFT, and Jetton products

Planned expansion

Jetton-aware endpoints
NFT and collection APIs
Webhook support
Usage analytics exports
RANNTA utility billing flows

Jetton Balance API

Live TON endpoint for querying a wallet balance for the configured Jetton master.

GET /api/jetton/balance?wallet=EQ...

{
  "ok": true,
  "network": "TON",
  "wallet": "EQ...",
  "jettonMaster": "EQ...",
  "found": true,
  "balanceRaw": "123456789",
  "balanceFormatted": "1234.56789"
}