topAccountsByBalance | TON v3

The topAccountsByBalance endpoint retrieves accounts with the highest TON balances on the network. Use it on TON v3 via Chainstack.

GET /topAccountsByBalance

Get Top Accounts by Balance

cURL

curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/topAccountsByBalance

200

{
  "accounts": [
    {
      "address": "<string>",
      "balance": "<string>",
      "account_status": "<string>",
      "last_activity": 123
    }
  ],
  "address_book": {}
}

Top Accounts by Balance

The topAccountsByBalance endpoint retrieves accounts with the highest TON balances on the network. This provides a snapshot of the wealthiest addresses on the TON blockchain.

Get your 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 billing: full (1 RU)

This method is always billed as full. See Request units — TON method scope.

Parameters

• limit (integer, optional) — Maximum number of accounts to return. Default: 10.
• offset (integer, optional) — Number of accounts to skip for pagination. Default: 0.

Response

• accounts (array) — Array of account objects sorted by balance descending:

  • address (string) — Account address.
  • balance (string) — Balance in nanotons.
  • account_status (string) — Account status (active, uninit, frozen).
  • last_activity (integer) — Last activity timestamp.

• address_book (object) — Address book mapping with names for known addresses.

Use case

The topAccountsByBalance endpoint is valuable for network analysis and research:

1. Network statistics dashboards showing wealth distribution.
2. Research tools analyzing TON token concentration.
3. Block explorers displaying rich list pages.
4. Market analysis tools tracking whale wallets.
5. Ecosystem health monitoring and reporting.

Here’s an example of getting the top 10 accounts:

shell

curl -X GET \
  'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/topAccountsByBalance?limit=10' \
  -H 'accept: application/json'

The address_book in the response will include names for well-known addresses like exchanges and major contracts, making it easier to identify the top holders.

Query Parameters

limit · integer · default: 10

Maximum number of accounts to return

offset · integer · default: 0

Number of accounts to skip

Response

200 - application/json

Successful response

accounts · object[]

Show child attributes

address_book · object

Address book mapping