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.

GET /api/v2/getWalletInformation

Get wallet information

cURL

curl --request GET \
  --url https://toncenter.com/api/v2/getWalletInformation \
  --header 'X-API-Key: <api-key>'

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

APIKeyHeaderAPIKeyQuery

X-API-Key · string · header · required

API key header of the form X-API-Key: <token>, where <token> is the API key. Requests without a key are limited to 1 RPS. Refer to the authentication guide for details.

Query Parameters

address · string · required

The account address to query. Account address in raw format (e.g., 0:ca6e321c...) or user-friendly format (e.g., EQDKbjIcfM...). All formats are automatically detected.

seqno · integer<int32>

Query state at a specific block height. If omitted, returns the current state. Use this to look up historical data at a specific point in time.

Response

200

application/json

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

ok · boolean · default: true · required

Returns true if the request succeeded; otherwise false. See the error field for details.

result · object · required

Response data. Present only when ok is true.

Show child attributes

@extra · string

Optional request ID that can be passed in the request and received back in the response. Useful for matching async responses.