---
title: "TotalSupply queries the total supply of all coins."
method: GET
path: "/cosmos/bank/v1beta1/supply"
tags: ["Query"]
---

# TotalSupply queries the total supply of all coins.

`GET /cosmos/bank/v1beta1/supply`

When called from another module, this query might consume a high amount of
gas if the pagination field is incorrectly set.

## Query parameters

- `pagination.key` string, byte
- `pagination.offset` string, uint64
- `pagination.limit` string, uint64
- `pagination.count_total` boolean
- `pagination.reverse` boolean

## Response `200`

A successful response.

- CosmosBankV1beta1QueryTotalSupplyResponse
  - `pagination` CosmosBaseQueryV1beta1PageResponse — PageResponse is to be embedded in gRPC response messages where the corresponding request message has used PageRequest. message SomeResponse { repeated Bar results = 1; PageResponse page = 2; }
    - `next_key` string, byte — next_key is the key to be passed to PageRequest.key to query the next page most efficiently. It will be empty if there are no more results.
    - `total` string, uint64
  - `supply` CosmosBaseV1beta1Coin[]
    - `amount` string
    - `denom` string

## Other responses

- `default` — An unexpected error response.

## Changes

- **2025-05-21** `3874a03b0e7b` — 1 info
  - api operation id `UpgradeQuery_TotalSupply` removed and replaced with `EvidenceQuery_TotalSupply`
- **2025-05-09** `8dbfaa2bebb2` — 1 info
  - api operation id `CircuitQuery_TotalSupply` removed and replaced with `UpgradeQuery_TotalSupply`
- **2025-04-08** `21a675703a05` — 1 info
  - api operation id `AuthQuery_TotalSupply` removed and replaced with `CircuitQuery_TotalSupply`
- **2025-03-27** `4f349536c8f3` — 1 info
  - api operation id `FeegrantQuery_TotalSupply` removed and replaced with `AuthQuery_TotalSupply`
- **2025-02-24** `2ab9d24288c2` — 1 info
  - api operation id `CircuitQuery_TotalSupply` removed and replaced with `FeegrantQuery_TotalSupply`

[Full history](https://skmtc.dev/pokt-network/apis/http-api-console/changes/cosmos/bank/v1beta1/supply/get.md)

---

[API](https://skmtc.dev/pokt-network/apis/http-api-console.md) · [All operations](https://skmtc.dev/pokt-network/apis/http-api-console/llms.txt) · [OpenAPI document](https://skmtc.dev/pokt-network/apis/http-api-console/revisions/671fab54b729?raw)