> 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/cosmos/cosmos-rest-api/bank-balance-by-denom-cosmos.md).

# bank balance by denom - Cosmos

Example code for the bank balance by denom REST method. Complete guide on how to use the bank balance by denom REST method in GetBlock Web3 documentation.

Returns the balance of a single denomination for an address.

## Endpoint

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

## Path Parameters

| Parameter | Type   | Description                         |
| --------- | ------ | ----------------------------------- |
| address   | string | Bech32 account address (cosmos1...) |

## Query Parameters

| Parameter | Type   | Description                           |
| --------- | ------ | ------------------------------------- |
| denom     | string | The denomination to query, e.g. uatom |

## Example

{% code overflow="wrap" %}

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

curl "${COSMOS_REST}cosmos/bank/v1beta1/balances/cosmos1xv9tklw7d82sezh9haa573wufgy59vmwe6xxe5/by_denom"
```

{% endcode %}

## Response

```json
{
    "balance": {
        "denom": "uatom",
        "amount": "125000000"
    }
}
```

## Response Fields

| Field          | Type   | Description                     |
| -------------- | ------ | ------------------------------- |
| balance.denom  | string | The queried denomination        |
| balance.amount | string | Amount in the base denomination |

## Use Cases

* **Single-asset read**: Fetch just the ATOM balance of an address

## Error Handling

| Error                     | Message       | Description                                                  |
| ------------------------- | ------------- | ------------------------------------------------------------ |
| 400 / Bad request         | Bad request   | A path, query, or body parameter was invalid                 |
| 404 / Not found           | Not found     | The account, validator, proposal, or resource does not exist |
| 403 / RBAC: access denied | Access denied | The GetBlock access token is missing or incorrect            |
