Skip to main content
GET
/
api
/
v3
/
walletStates
Get Wallet States
curl --request GET \
  --url https://toncenter.com/api/v3/walletStates
{
  "address_book": {},
  "metadata": {},
  "wallets": [
    {
      "address": "<string>",
      "balance": "<string>",
      "code_hash": "<string>",
      "extra_currencies": {},
      "is_signature_allowed": true,
      "is_wallet": true,
      "last_transaction_hash": "<string>",
      "last_transaction_lt": "0",
      "seqno": 123,
      "status": "<string>",
      "wallet_id": 123,
      "wallet_type": "<string>"
    }
  ]
}

​
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_wallet_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.

Response

OK

​
address_book
object
​
metadata
object
​
wallets
object[]