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

# getAddressBalance | TON v2

> The getAddressBalance method retrieves the balance of a specific address on the TON blockchain. Available on TON v2 via Chainstack.

The `getAddressBalance` method retrieves the balance of a specific address on the TON blockchain. This method provides a straightforward way to check the current balance of any TON address.

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

## JSON-RPC example

```shell Shell theme={"system"}
curl -X POST \
  'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/jsonRPC' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getAddressBalance",
    "params": {
      "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2"
    }
  }'
```

## Parameters

* `address` (string, required) — The address for which to retrieve the balance. Example: `EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2`.

## Response

* `balance` (string) — The balance of the address in nanotons. 1 TON = 1,000,000,000 nanotons.

## Use case

A possible use case for the `getAddressBalance` method in TON is for wallet applications, blockchain explorers, or any DApp that needs to display or work with account balances. This method can be used to:

1. Show users their current balance.
2. Check if an account has sufficient funds before initiating a transaction.
3. Monitor balance changes over time for analytics purposes.


## OpenAPI

````yaml openapi/ton_node_api/v2/getAddressBalance.json GET /getAddressBalance
openapi: 3.0.0
info:
  title: getAddressBalance example
  version: 1.0.0
  description: >-
    This is an API example for getAddressBalance, a method to retrieve the
    balance of a specific address on the TON blockchain.
servers:
  - url: >-
      https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2
security: []
paths:
  /getAddressBalance:
    get:
      tags:
        - TON Operations
      summary: getAddressBalance
      operationId: getAddressBalance
      parameters:
        - name: address
          in: query
          required: true
          description: The address to get the balance for
          schema:
            type: string
            default: EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2
          example: EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2
      responses:
        '200':
          description: The balance of the specified address
          content:
            application/json:
              schema:
                type: object
                properties:
                  balance:
                    type: string
                    description: The balance of the address in nanotons

````