APIsTON CenterAccounts
Get address balance
Returns the TON balance of an account in nanotons. 1 TON = 1,000,000,000 nanotons. A lightweight endpoint that returns only the balance without contract code, data, or other account details. Returns "0" for addresses that have never received any funds.
X-API-Key<token>
API key header of the form X-API-Key: <token>, where <token> is the API key. Requests without a key are limited to 1 RPS. Refer to the authentication guide for details.
In: header
Query Parameters
address*string
The account address to query.
seqno?integer
Query state at a specific block height. If omitted, returns the current state. Use this to look up historical data at a specific point in time.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v2/getAddressBalance?address=string"{
"ok": true,
"result": "string",
"@extra": "string"
}{
"ok": false,
"code": 401,
"error": "API key does not exist"
}{
"ok": false,
"code": 403,
"error": "Network not allowed"
}{
"ok": false,
"code": 422,
"error": "empty address"
}{
"ok": false,
"code": 429,
"error": "Ratelimit exceeded"
}{
"ok": false,
"code": 504,
"error": "LITE_SERVER_NETWORK timeout"
}