Skip to main content

/cosmos/bank/v1beta1/denoms_metadata REST API Endpoint

Queries the client metadata for all registered coin denominations.

Updated on
May 09, 2024

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

metadatas
array

An array containing objects representing metadata information for different tokens

description
string

The description of the token

denom_units
array

An array containing objects representing different units of the token denomination

denom
string

The denomination or identifier of the token unit

exponent
integer

The exponent that denotes the magnitude of the unit relative to the base unit

aliases
array

An array containing alternative names or aliases for the unit

base
string

The base denomination or identifier of the token

display
string

The display denomination or identifier of the token

name
string

The name of the token

symbol
string

The symbol of the token

pagination
object

The pagination object which contains the following fields:

next_key
string | null

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