GET
/
wallet
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/wallet
{
  "wallet": true,
  "balance": "<string>",
  "account_state": "<string>",
  "wallet_type": "<string>",
  "seqno": 123,
  "last_transaction_lt": "<string>",
  "last_transaction_hash": "<string>"
}

Get Wallet Information

The wallet endpoint retrieves detailed information about a specific wallet on the TON blockchain. This endpoint allows you to fetch the current state, balance, and other relevant details of a wallet.

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.

Parameters

  • address (string, required) — The address of the wallet to retrieve information for.

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 (e.g., active, uninitialized).
  • wallet_type (string) — The type of the wallet contract.
  • seqno (integer) — The current sequence number of the wallet.
  • last_transaction_lt (string) — The logical time of the last transaction.
  • last_transaction_hash (string) — The hash of the last transaction.

Use case

The wallet endpoint is useful for various applications that need to retrieve or verify wallet information on the TON blockchain:

  1. Wallet applications can use this to display wallet balances and status to users.
  2. Decentralized applications (dApps) can verify wallet existence and status before interacting with them.
  3. Block explorers can use this to show detailed wallet information to users.
  4. Analytics platforms can track wallet balances and activities over time.
  5. Developers can use this endpoint to build wallet monitoring or notification systems.
  6. Exchange platforms can use this to verify user wallets and balances.
  7. Smart contract interfaces can use this to check if a wallet is active and has sufficient balance before allowing interactions.

Query Parameters

address
string
default:0QAvTjjA5ZBbHN3a-SYnO1qvzlgNx09OC2bhYBPAbfs3S6q7
required

The address of the wallet to retrieve information for

Response

200 - application/json
Successful 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 (e.g., active, uninitialized)

wallet_type
string

The type of the wallet contract

seqno
integer

The current sequence number of the wallet

last_transaction_lt
string

The logical time of the last transaction

last_transaction_hash
string

The hash of the last transaction