Get address balance

Returns just the TON balance of an account in nanotons. 1 TON = 1,000,000,000 nanotons. This is a lightweight alternative to getAddressInformation when you only need the balance. Returns “0” for addresses that don’t exist yet.

POST /api/v2/getAddressBalance

Try it

Get address balance

cURL

curl --request POST \
  --url https://toncenter.com/api/v2/getAddressBalance \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "address": "<string>",
  "seqno": "<string>"
}
'

200

{
  "ok": true,
  "result": "<string>",
  "@extra": "<string>"
}

Authorizations

X-API-Key · string · header · required

Body

application/json

address · string · required

The account address in user-friendly format.

seqno

Block or wallet sequence number. For blocks, this is the block height. For wallets, increment this for each outgoing transaction.

Response

200

application/json

OK

Response containing the account balance in nanotons.

ok · boolean · default: true · required

Indicates if the request succeeded. If false, check the error field for details.

result · string · required

The response data. Only present when ok is true.

@extra · string

Optional request ID that you can pass in the request and receive back in the response. Useful for matching async responses.