> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# topAccountsByBalance | TON v3

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

# 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.

<Note>
  **TON billing: full (1 RU)**

  This method is always billed as full. See [Request units — TON method scope](/docs/request-units#ton-method-scope).
</Note>

## 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:

<CodeGroup>
  ```shell shell theme={"system"}
  curl -X GET \
    'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/topAccountsByBalance?limit=10' \
    -H 'accept: application/json'
  ```
</CodeGroup>

<Tip>
  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.
</Tip>


## OpenAPI

````yaml openapi/ton_node_api/v3/getTopAccountsByBalance.json GET /topAccountsByBalance
openapi: 3.0.0
info:
  title: TON API
  version: 3.0.0
  description: API for interacting with The Open Network (TON) blockchain
servers:
  - url: >-
      https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3
security: []
paths:
  /topAccountsByBalance:
    get:
      tags:
        - Statistics
      summary: Get Top Accounts by Balance
      description: Get accounts with the highest TON balances
      operationId: getTopAccountsByBalance
      parameters:
        - name: limit
          in: query
          description: Maximum number of accounts to return
          schema:
            type: integer
            default: 10
        - name: offset
          in: query
          description: Number of accounts to skip
          schema:
            type: integer
            default: 0
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  accounts:
                    type: array
                    items:
                      type: object
                      properties:
                        address:
                          type: string
                          description: Account address
                        balance:
                          type: string
                          description: Balance in nanotons
                        account_status:
                          type: string
                          description: Account status
                        last_activity:
                          type: integer
                          description: Last activity timestamp
                  address_book:
                    type: object
                    description: Address book mapping

````