Skip to main content
GET
/
api
/
v3
/
accountStates
Get Account States
curl --request GET \
  --url https://toncenter.com/api/v3/accountStates
{
  "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": {}
}

​
SDK Usage

import asyncio

from toncenter.rest import ToncenterRestClient
from toncenter.types import Network

ADDRESS = ["EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2"]


async def main() -> None:
    async with ToncenterRestClient(network=Network.MAINNET) as client:
        result = await client.v3.accounts.get_account_states(
            address=ADDRESS,
        )
        print(result.model_dump_json(indent=4))


if __name__ == "__main__":
    asyncio.run(main())

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

OK

​
accounts
object[]
​
address_book
object
​
metadata
object