Get address information

Returns the current state of an account on the TON blockchain. Includes balance (in nanotons), smart contract code and data (as BOC-encoded strings), account status, and a reference to the last transaction. Compatible with the v2 API response format.

GET /api/v3/addressInformation

Get address information

cURL

curl --request GET \
  --url https://toncenter.com/api/v3/addressInformation

200

{
  "balance": "<string>",
  "code": "<string>",
  "data": "<string>",
  "frozen_hash": "<string>",
  "last_transaction_hash": "<string>",
  "last_transaction_lt": "<string>",
  "status": "<string>"
}

Query Parameters

address · string · required

Account address in any form.

use_v2 · boolean · default: true

Use method from api/v2. Not recommended

Response

200

application/json

Current account state in v2-compatible format.

Account information in the v2 API-compatible format. Returns balance, contract code and data as base64-encoded BOCs, account status, and last transaction reference.

balance · string

Account balance in nanotons. 1 TON = 1,000,000,000 nanotons.

code · string

Smart contract code in BOC format, base64 encoded. Empty string if the account is uninitialized.

data · string

Smart contract persistent storage in BOC format, base64 encoded. Empty string if the account is uninitialized.

frozen_hash · string

Hash of the frozen state. Present only when the account is frozen.

last_transaction_hash · string

Hash of the most recent transaction on this account. Use together with last_transaction_lt to start paginating transaction history.

last_transaction_lt · string

Logical time of the most recent transaction. A globally unique counter ordering all blockchain events.

status · string

Account lifecycle status: uninit, active, or frozen.