Get wallet information

Returns wallet-specific information for an account. Identifies the wallet version and extracts wallet fields like seqno and wallet_id. Supported wallets: v1r1, v1r2, v1r3, v2r1, v2r2, v3r1, v3r2, v4r1, v4r2, v5beta, v5r1. Returns error 409 if the account exists but isn’t a wallet contract.

GET /api/v3/walletInformation

Get wallet information

cURL

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

200

{
  "balance": "<string>",
  "last_transaction_hash": "<string>",
  "last_transaction_lt": "<string>",
  "seqno": 123,
  "status": "<string>",
  "wallet_id": 123,
  "wallet_type": "<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

Wallet-specific details: type, seqno, wallet ID, and balance.

Wallet-specific information in the v2 API-compatible format. Extends basic account information with wallet-specific fields: detected wallet version, current sequence number (needed for constructing transactions), and subwallet ID.

balance · string

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

last_transaction_hash · string

Hash of the most recent transaction on this wallet.

last_transaction_lt · string

Logical time of the most recent transaction on this wallet.

seqno · integer

Current wallet sequence number. Used for replay protection: each outgoing transaction must include the current seqno, which increments by 1 after each transaction. Always fetch the current value before sending a transaction.

status · string

Account lifecycle status: uninit, active, or frozen.

wallet_id · integer

Subwallet ID. Allows creating multiple independent wallets from a single key pair. The default value is 698983191 (0x29a9a317).

wallet_type · string

Detected wallet contract version (e.g., wallet_v3r2, wallet_v4r2, wallet_v5r1). Determines which message format and features are supported.