Jettons - apiTON

Jetton (token) balances of an address.

Request. address (.ton names allowed), limit (≤ 100, default 10), offset.

Response. result — per jetton: address (the holder's jetton wallet), master_address, symbol, balance (decimals of the master applied; ~7 significant digits — read Address/Details of the jetton wallet for an exact amount), content (metadata), price_usd (absent when unknown), known / known_source (curated jetton — rank or hide the others, which is most airdropped scam).

Paging. total (int64 as a string) is set only when the page reached the end of the list.

Errors (Connect JSON envelope {"code":…,"message":…})

Code	When
`aborted` (409)	invalid address or a failed read — a retry usually succeeds

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Bodyapplication/json

Examples

SuccessKnown jettons (live, 2026-10-19)

{
    "result": [
        {
            "address": "UQC_lZX7J7IipDbpdiO7GuQeEqMKcj6x2rnfQQ9Rm8FhCljN",
            "balance": 10000000,
            "content": {
                "decimals": "9",
                "image": "https://i.postimg.cc/W4y53Zt2/IMG-20240327-174927-521.png",
                "name": "TON BULL",
                "symbol": "TONBULL"
            },
            "master_address": "UQDsJPo7tniAk3zGxqiHeIQZf4blkfuK7N5njp0fUytN00Cy",
            "symbol": "TONBULL"
        }
    ]
}

🔴500Server Error