Get wallet states

Returns wallet state for one or more addresses. Detects whether each address is a wallet contract and extracts wallet-specific fields (type, seqno, wallet_id, signature permissions). Non-wallet addresses are included with is_wallet: false.

GET /api/v3/walletStates

Get wallet states

cURL

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

200

{
  "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>"
    }
  ]
}

Query Parameters

address · string[] · required

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

Response

200

application/json

Wallet state for each requested address.

Response wrapper containing wallet states with address book and token metadata.

address_book · object

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

Show child attributes

metadata · object

Token and indexing metadata for all addresses referenced in the response.

Show child attributes

wallets · object[]

Array of wallet states, one per requested address.

Show child attributes