Get wallet information

Returns wallet-specific information for an address. If the address is a known wallet contract, returns the wallet type, current seqno (needed for sending transactions), and wallet_id. Always check wallet: true before using wallet-specific fields. Call this before sending any transaction to get the current seqno.

POST /api/v2/getWalletInformation

Try it

Get wallet information

cURL

curl --request POST \
  --url https://toncenter.com/api/v2/getWalletInformation \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "address": "<string>",
  "seqno": "<string>"
}
'

200

{
  "ok": true,
  "result": {
    "@type": "ext.accounts.walletInformation",
    "wallet": true,
    "balance": "<string>",
    "account_state": "uninitialized",
    "last_transaction_id": {
      "@type": "internal.transactionId",
      "lt": "<string>",
      "hash": "<string>"
    },
    "wallet_type": "wallet v1 r1",
    "seqno": 123,
    "wallet_id": 123,
    "is_signature_allowed": true
  },
  "@extra": "<string>"
}

Authorizations

X-API-Key · string · header · required

Body

application/json

address · string · required

The account address in user-friendly format.

seqno

Block or wallet sequence number. For blocks, this is the block height. For wallets, increment this for each outgoing transaction.

Response

200

application/json

OK

Response containing wallet-specific information including type, seqno, and balance.

ok · boolean · default: true · required

Indicates if the request succeeded. If false, check the error field for details.

result · object · required

The response data. Only present when ok is true.

Show child attributes

result. @type · enum<string> · default: ext.accounts.walletInformation · required

Object type identifier.

Available options: ext.accounts.walletInformation

result. wallet · boolean · required

True if this address is a recognized wallet contract type. If false, wallet-specific fields won't be available.

result. balance · string · required

The account or token balance in the smallest unit (nanotons for TON, or base units for tokens). Divide by 10^decimals to get the human-readable amount.

result. account_state · enum<string> · required

Current lifecycle state: uninitialized, active, or frozen.

Available options: uninitialized, active, frozen

result. last_transaction_id · object · required

Reference to the most recent transaction. Use as starting point for getTransactions.

Show child attributes

result.last_transaction_id. @type · enum<string> · default: internal.transactionId · required

Object type identifier.

Available options: internal.transactionId

result.last_transaction_id. lt · string · required

Logical time of this event. A globally unique counter that orders all blockchain events. Higher values are more recent.

result.last_transaction_id. hash · string · required

Unique identifier hash for this object.

result. wallet_type · enum<string>

The wallet contract version: v1r1 through v5r1. Newer versions (v4, v5) have more features.

Available options: wallet v1 r1, wallet v1 r2, wallet v1 r3, wallet v2 r1, wallet v2 r2, wallet v3 r1, wallet v3 r2, wallet v4 r1, wallet v4 r2, wallet v5 beta, wallet v5 r1

result. seqno · integer<int64>

Block or wallet sequence number. For blocks, this is the block height. For wallets, increment this for each outgoing transaction.

result. wallet_id · integer

Subwallet ID for v3+ wallets. Allows creating multiple wallets from one key. Default is 698983191 for mainnet.

result. is_signature_allowed · boolean

For v5 wallets: whether external signatures are enabled. If false, wallet is controlled only by plugins.

@extra · string

Optional request ID that you can pass in the request and receive back in the response. Useful for matching async responses.