---
title: "DenomsMetadata queries the client metadata for all registered coin denominations."
method: GET
path: "/cosmos/bank/v1beta1/denoms_metadata"
tags: ["Query"]
---

# DenomsMetadata queries the client metadata for all registered coin denominations.

`GET /cosmos/bank/v1beta1/denoms_metadata`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/notional-labs/apis/http-api-console/docs/cosmos/bank/v1beta1/denoms_metadata/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

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

## Response `200`

A successful response.

- object: QueryDenomsMetadataResponse is the response type for the Query/DenomsMetadata RPC method.
  - `metadatas` object[]: metadata provides the client information for all the registered tokens.
    - `description` string
    - `denomUnits` object[]
      - `denom` string: denom represents the string name of the given denom unit (e.g uatom).
      - `exponent` integer: exponent represents power of 10 exponent that one must raise the base_denom to in order to equal the given DenomUnit's denom 1 denom = 1^exponent base_denom (e.g. with a base_denom of uatom, one can create a DenomUnit of 'atom' with exponent = 6, thus: 1 atom = 10^6 uatom).
      - `aliases` string[]
    - `base` string: base represents the base denom (should be the DenomUnit with exponent = 0).
    - `display` string: display indicates the suggested denom that should be displayed in clients.
    - `name` string: Since: cosmos-sdk 0.43
    - `symbol` string: symbol is the token symbol usually shown on exchanges (eg: ATOM). This can be the same as the display. Since: cosmos-sdk 0.43
  - `pagination` object: pagination defines the pagination in the response.
    - `nextKey` string, byte
    - `total` string, uint64

## Other responses

- `default`: An unexpected error response.

## Changes

- **2021-09-03** `4165dbef2a32`: 1 info
  - added the new optional `query` request parameter `pagination.reverse`
- **2021-08-25** `c8a66a59aefb`: 1 warning
  - deleted the `query` request parameter `pagination.reverse`
- **2021-08-05** `4165dbef2a32`: 1 info
  - added the new optional `query` request parameter `pagination.reverse`
- **2021-06-05** `7528569a81ca`: 1 warning
  - deleted the `query` request parameter `pagination.reverse`

[Operation history](https://skmtc.dev/notional-labs/apis/http-api-console/changes/cosmos/bank/v1beta1/denoms_metadata/get.md)

---

[API](https://skmtc.dev/notional-labs/apis/http-api-console.md) - [All operations](https://skmtc.dev/notional-labs/apis/http-api-console/llms.txt) - [OpenAPI document](https://skmtc.dev/notional-labs/apis/http-api-console/revisions/b52b697c5776?raw)