> For the complete documentation index, see [llms.txt](https://docs.getblock.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getblock.io/api-reference/axelar-axl/rest-api/cosmos-bank-v1beta1-balances-address-axelar.md).

# /cosmos/bank/v1beta1/balances/{address} - Axelar

Example code for the cosmos/bank/v1beta1/balances/{address} REST method. Complete guide on how to use cosmos/bank/v1beta1/balances/{address} REST method in GetBlock Web3 documentation.

Returns all coin balances held by an address, each as a denom and amount. Native AXL is reported in uaxl.

## Endpoint

```http
GET /cosmos/bank/v1beta1/balances/{address}
```

## Path Parameters

| Parameter | Type   | Description                       |
| --------- | ------ | --------------------------------- |
| address   | string | Bech32 account address (axelar1…) |

## Query Parameters

| Parameter        | Type   | Description |
| ---------------- | ------ | ----------- |
| pagination.limit | string | Max results |

## Example

{% code overflow="wrap" %}

```bash
export AKASH_REST=https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/

curl "${AKASH_REST}cosmos/bank/v1beta1/balances/axelar1nl7dg3xj9j2y6q7z0v4w8c2b5d1f3g6h9k2m4p"
```

{% endcode %}

## Response

```json
{
    "balances": [
        {
            "denom": "uaxl",
            "amount": "150000000"
        }
    ],
    "pagination": {
        "total": "1"
    }
}
```

## Response Fields

| Field            | Type   | Description                      |
| ---------------- | ------ | -------------------------------- |
| balances         | array  | Coin balances as {denom, amount} |
| pagination.total | string | Total denoms                     |

## Use Cases

* **Balance Reads**: Display AXL and token balances
* **Portfolio**: Enumerate holdings
* **Accounting**: Reconcile balances

## Error Handling

| Error                     | Message       | Description                                       |
| ------------------------- | ------------- | ------------------------------------------------- |
| 400 / Bad request         | Bad request   | A parameter was invalid                           |
| 403 / RBAC: access denied | Access denied | The GetBlock access token is missing or incorrect |
