cosmos/bank/v1beta1/supply

Parameters

Object NameRequiredTypeDetail
pagination.key❌StringThe value returned in PageResponse.next_key to begin querying the next page most efficiently. If provided, then pagination.offset is not allowed.
pagination.offset❌IntegerA numeric offset that can be used when pagination.key is unavailable. It is less efficient than pagination.key. If provided, then pagination.key is not allowed.
pagination.limit❌IntegerThe 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❌BooleanIf set to true, the result will include a count of the total number of items available for pagination. count_total is only respected when offset is used. It is ignored when key is set.
pagination.reverse❌BooleanSet to true if results are to be returned in the descending order.
/cosmos/bank/v1beta1/supply

Result

The total supply of all coins.

Example

Request

curl <your-rest-endpoint>/cosmos/bank/v1beta1/supply \
  -X GET \
  -H "accept: application/json"

Return

{
  "supply": [
    {
      "denom": "ibc/0030B0AA8A1B9028703B1D17B965FBCBE0136571B854410BFEC3475B1DC765A1",
      "amount": "43210"
    },
    {
      "denom": "ibc/0276EC3A17E2BADE81821D73FE20CB6D71487F151FEE36E159962B8721942F9D",
      "amount": "1000000"
    },
    {
      "denom": "ibc/04F26F89E89475EBEDA75428CD312CF2DF569A3ED0C999CAC1CCA151FF30694A",
      "amount": "5000000000"
    },
    ...
    {
      "denom": "ibc/854A2B3F3C679598591411883DF60EF216E0DCA83E141808A55D8C4BC8443641",
      "amount": "2456933373"
    },
    {
      "denom": "ibc/857BB744A15CE6E4C423DBD4534F4430C3C364EA04316CFC1A69C7B02102BB9A",
      "amount": "2000"
    },
    {
      "denom": "ibc/861999A07B9A280A0262C761D2C8E030FDDF9B9E8A09BA8E0A967B0C381BA8E9",
      "amount": "100000"
    }
  ],
  "pagination": {
    "next_key": "aWJjLzg4NzBDNDIwM0NFQkYyMjc5QkEwNjVFM0RFOTVGQzNGOEUwNUE0QTkzNDI0RTdEQzcwN0EyMTUxNEJFMzUzQTA=",
    "total": "215"
  }
}