GET
/
account
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/account
{
  "address": "<string>",
  "balance": "<string>",
  "last_activity": 123,
  "status": "<string>",
  "code_hash": "<string>",
  "data_hash": "<string>"
}

Get Account Information

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

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 account to retrieve information for.

Response

  • address (string) — The account address.
  • balance (string) — The account balance in nanotons.
  • last_activity (integer) — The timestamp of the last account activity.
  • status (string) — The status of the account (e.g., active, frozen).
  • code_hash (string) — The hash of the account’s code.
  • data_hash (string) — The hash of the account’s data.

Use case

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

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

Query Parameters

address
string
default:Ef-1JetbPF9ubc1ga-57oHoOyDA1IShJt-BVlJnA9rrVTfrB
required

The address of the account to retrieve information for

Response

200 - application/json
Successful response
address
string

The account address

balance
string

The account balance in nanotons

last_activity
integer

The timestamp of the last account activity

status
string

The status of the account (e.g., active, frozen)

code_hash
string

The hash of the account's code

data_hash
string

The hash of the account's data