Skip to main content

/cosmos/bank/v1beta1/supply REST API Endpoint

Queries the total supply of all coins.

Updated on
Mar 17, 2026

Query Parameters

pagination.key
string

The value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set

pagination.offset
string

The numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set

pagination.limit
string

The total number of results to be returned in the result page. If left empty it will default to a value to be set by each app

pagination.count_total
boolean

When set to true it indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set

pagination.reverse
boolean

It is set to true if results are to be returned in the descending order

Returns

supply
array

An array of supply of the coins

denom
string

The denomination or identifier of the token

amount
string

The amount of the token held by the address

pagination
object

The pagination object which contains the following fields:

next_key
string

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

The total number of results available if PageRequest.count_total was set, its value is undefined otherwise

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free