Skip to main content
GET
/
topAccountsByBalance
Get Top Accounts by Balance
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/topAccountsByBalance
{
  "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 you own node endpoint todayStart 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, v3There’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

  • 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: 
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[]
​
address_book
object

Address book mapping