Get account states

Returns the current on-chain state for one or more accounts. Includes balance, contract code and data hashes, account status, and last transaction reference. Use include_boc to control whether full code and data BOCs are returned.

GET /api/v3/accountStates

Get account states

cURL

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

200

{
  "accounts": [
    {
      "account_state_hash": "<string>",
      "address": "<string>",
      "balance": "<string>",
      "code_boc": "<string>",
      "code_hash": "<string>",
      "contract_methods": [
        123
      ],
      "data_boc": "<string>",
      "data_hash": "<string>",
      "extra_currencies": {},
      "frozen_hash": "<string>",
      "interfaces": [
        "<string>"
      ],
      "last_transaction_hash": "<string>",
      "last_transaction_lt": "0",
      "status": "<string>"
    }
  ],
  "address_book": {},
  "metadata": {}
}

Query Parameters

address · string[] · required

List of addresses in any form. Maximum 1000 addresses allowed.

include_boc · boolean · default: true

Include code and data BOCs. Default: true

Response

200

application/json

Current state for each requested account.

Response wrapper for account state queries. Contains the requested account states along with an address book (for converting raw addresses to user-friendly form) and metadata (for token information).

accounts · object[]

Array of full account state objects, one per requested address.

Show child attributes

address_book · object

Address book mapping raw addresses to user-friendly base64url forms and detected interfaces for all addresses referenced in the response.

Show child attributes

metadata · object

Token and indexing metadata for all addresses referenced in the response. Includes token name, symbol, and image for recognized Jetton and NFT contracts.

Show child attributes