GET
/
getWalletInformation
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getWalletInformation
{
  "wallet": true,
  "balance": "<string>",
  "account_state": "<string>",
  "wallet_type": "<string>",
  "seqno": 123,
  "last_transaction_id": {
    "lt": "<string>",
    "hash": "<string>"
  }
}

The getWalletInformation method retrieves wallet-specific information about a TON address. This method is particularly useful for obtaining details about wallet contracts, including their type, balance, and current state.

Get you own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

TON pricing is the same for full, archive, v2, v3

There’s no difference between a full node an archive node in data availability or pricing.
All data is always available and all node requests are consumed as 1 request unit.

Example with seqno:

Shell
curl --request GET \

     --url 'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getWalletInformation?address=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2&seqno=45792554' \

     --header 'accept: application/json'

JSON-RPC example

Shell
curl -X POST \

  'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/jsonRPC' \

  -H 'Content-Type: application/json' \

  -d '{

    "jsonrpc": "2.0",

    "id": 1,

    "method": "getWalletInformation",

    "params": {

      "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2"

    }

  }'

Parameters

  • address (string, required) — The address for which wallet information is being requested. Example: EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2.

Response

  • wallet (boolean) — Indicates if the address is a wallet.
  • balance (string) — The balance of the wallet in nanotons.
  • account_state (string) — The state of the account (active, uninitialized, etc.).
  • wallet_type (string) — The type of the wallet contract.
  • seqno (integer) — The current sequence number of the wallet.
  • last_transaction_id (object) — The last transaction ID, containing:
    • lt (string) — The logical time of the last transaction.
    • hash (string) — The hash of the last transaction.

Use case

A possible use case for the getWalletInformation method in TON is for wallet applications or blockchain explorers that need to display specific information about wallet contracts. This method can be used to show the current balance, wallet type, and transaction sequence number, which are crucial for interacting with the wallet or monitoring its state.

Query Parameters

address
string
default:EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2
required

The address to get wallet information for

Response

200 - application/json
Wallet information for the specified address
wallet
boolean

Indicates if the address is a wallet

balance
string

The balance of the wallet in nanotons

account_state
string

The state of the account (active, uninitialized, etc.)

wallet_type
string

The type of the wallet contract

seqno
integer

The current sequence number of the wallet

last_transaction_id
object