> 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-supply-cosmos.md).

# bank supply - Cosmos

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

Returns the total supply of all denominations on the chain, paginated.

## Endpoint

```http
GET /cosmos/bank/v1beta1/supply
```

## Query Parameters

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

## Example

{% code overflow="wrap" %}

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

curl "${COSMOS_REST}cosmos/bank/v1beta1/supply"
```

{% endcode %}

## Response

```json
{
    "supply": [
        {
            "denom": "uatom",
            "amount": "390000000000000"
        }
    ],
    "pagination": {
        "next_key": null,
        "total": "1"
    }
}
```

## Response Fields

| Field            | Type   | Description                                  |
| ---------------- | ------ | -------------------------------------------- |
| supply           | array  | Total supply per denom                       |
| supply\[].denom  | string | Base denomination                            |
| supply\[].amount | string | Total minted amount in the base denomination |

## Use Cases

* **Supply tracking**: Read total ATOM supply
* **Metrics**: Feed supply data into dashboards

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