---
title: "DenomMetadataByQueryString queries the client metadata of a given coin denomination."
method: GET
path: "/cosmos/bank/v1beta1/denoms_metadata_by_query_string"
tags: ["Query"]
---

# DenomMetadataByQueryString queries the client metadata of a given coin denomination.

`GET /cosmos/bank/v1beta1/denoms_metadata_by_query_string`

## Request

- The document declares no server URL.
- Auth: none declared

## Query parameters

- `denom` string

## Response `200`

A successful response.

- object: QueryDenomMetadataByQueryStringResponse is the response type for the Query/DenomMetadata RPC method. Identical with QueryDenomMetadataResponse but receives denom as query string in request.
  - `metadata` object: metadata describes and provides all the client information for the requested token.
    - `description` string
    - `denom_units` 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 = 10^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
    - `symbol` string: symbol is the token symbol usually shown on exchanges (eg: ATOM). This can be the same as the display.
    - `uri` string: URI to a document (on or off-chain) that contains additional information. Optional.
    - `uri_hash` string: URIHash is a sha256 hash of a document pointed by URI. It's used to verify that the document didn't change. Optional.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2025-01-28** `7ee619f48b09`: 1 info
  - endpoint added
- **2024-03-22** `f6ed714cd62d`: 1 breaking
  - api path removed without deprecation
- **2024-03-22** `426ef0503938`: 1 info
  - endpoint added
- **2024-02-21** `9da39c06448a`: 1 breaking
  - api path removed without deprecation
- **2024-02-07** `0345868c59cf`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tellor-io/apis/layer-grpc-gateway-docs/changes/cosmos/bank/v1beta1/denoms_metadata_by_query_string/get.md)

---

[API](https://skmtc.dev/tellor-io/apis/layer-grpc-gateway-docs.md) - [All operations](https://skmtc.dev/tellor-io/apis/layer-grpc-gateway-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/tellor-io/apis/layer-grpc-gateway-docs/revisions/52aa42be34ad?raw)