accounts

Get Address Information

Returns the current state of any account on the TON blockchain. Includes the balance (in nanotons), smart contract code and data (if deployed), account status, and a reference to the last transaction. This is the primary endpoint for checking if an address exists and what's deployed there.

get/api/v2/getAddressInformation

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/getAddressInformation
  • 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

The complete current state of the requested account.

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.