Get top accounts by balance

Returns accounts sorted by balance in descending order. Use limit and offset for pagination. Useful for analytics and leaderboard views.

GET /api/v3/topAccountsByBalance

Get top accounts by balance

cURL

curl --request GET \
  --url https://toncenter.com/api/v3/topAccountsByBalance

200

[
  {
    "account": "<string>",
    "balance": "<string>"
  }
]

Query Parameters

limit · integer<int32> · default: 10

Limit number of queried rows. Use with offset to batch read.

Required range: 1 <= x <= 1000

offset · integer<int32> · default: 0

Skip first N rows. Use with limit to batch read.

Required range: x >= 0

Response

200 - application/json

Accounts sorted by balance descending.

account · string

Account address in raw format (workchain:hex), e.g., 0:abc123....

balance · string

Account balance in nanotons (the smallest unit of TON). 1 TON = 1,000,000,000 nanotons. Divide by 10^9 to get the human-readable TON amount.