accounts

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.

get/api/v2/getAddressBalance

Request

  • Base URL: https://toncenter.com (the document declares no server; this is the origin it was published from)
  • URL: https://toncenter.com/api/v2/getAddressBalance
  • Auth: one of:
    • API key in header X-API-Key
    • API key in query parameter api_key

Query parameters

addressstring required

Account address in raw format (e.g., 0:ca6e321c...) or user-friendly format (e.g., EQDKbjIcfM...). All formats are automatically detected.

The account address to query, in raw or user-friendly format.

seqnointeger

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

Returns the account balance in nanotons.

okboolean required

Returns true if the request succeeded; otherwise false. See the error field for details.

@extrastring required
jsonrpcstring

JSON-RPC protocol version identifier.

idstring

Changes

No recorded changes to this operation across all 1 revision of this API.