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

## Request

- Base URL: `https://api.nymtech.net` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nymtech.net/cosmos/bank/v1beta1/supply`
- Auth: none declared
- TypeScript: <https://skmtc.dev/nymtech/apis/cosmos-sdk-grpc-gateway-docs/docs/cosmos/bank/v1beta1/supply/get.ts> (a function with typed inputs; its response is checked against the schema)

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.

- object
  - `supply` object[]
    - `denom` string
    - `amount` string
  - `pagination` object: pagination defines the pagination in the response. Since: cosmos-sdk 0.43
    - `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

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/nymtech/apis/cosmos-sdk-grpc-gateway-docs.md) - [All operations](https://skmtc.dev/nymtech/apis/cosmos-sdk-grpc-gateway-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/nymtech/apis/cosmos-sdk-grpc-gateway-docs/revisions/46fa771059b6?raw)