---
updatedAt: 2025-06-11T20:37:08.000Z
agentTools:
  projectIndex: https://docs.allthatnode.com/llms.txt
---

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

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Cosmos SDK - gRPC Gateway docs",
    "description": "A REST interface for state queries.",
    "version": "1.0.0"
  },
  "paths": {
    "/cosmos/bank/v1beta1/denoms_metadata_by_query_string": {
      "get": {
        "summary": "DenomMetadataByQueryString queries the client metadata of a given coin denomination.",
        "operationId": "DenomMetadataByQueryString",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "*/*": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "metadata": {
                      "description": "metadata describes and provides all the client information for the requested token.",
                      "type": "object",
                      "properties": {
                        "description": {
                          "type": "string"
                        },
                        "denom_units": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "denom": {
                                "type": "string",
                                "description": "denom represents the string name of the given denom unit (e.g uatom)."
                              },
                              "exponent": {
                                "type": "integer",
                                "format": "int64",
                                "description": "exponent represents power of 10 exponent that one must\nraise the base_denom to in order to equal the given DenomUnit's denom\n1 denom = 10^exponent base_denom\n(e.g. with a base_denom of uatom, one can create a DenomUnit of 'atom' with\nexponent = 6, thus: 1 atom = 10^6 uatom)."
                              },
                              "aliases": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "title": "aliases is a list of string aliases for the given denom"
                              }
                            },
                            "description": "DenomUnit represents a struct that describes a given\ndenomination unit of the basic token."
                          },
                          "title": "denom_units represents the list of DenomUnit's for a given coin"
                        },
                        "base": {
                          "type": "string",
                          "description": "base represents the base denom (should be the DenomUnit with exponent = 0)."
                        },
                        "display": {
                          "type": "string",
                          "description": "display indicates the suggested denom that should be\ndisplayed in clients."
                        },
                        "name": {
                          "type": "string",
                          "title": "name defines the name of the token (eg: Cosmos Atom)"
                        },
                        "symbol": {
                          "type": "string",
                          "description": "symbol is the token symbol usually shown on exchanges (eg: ATOM). This can\nbe the same as the display."
                        },
                        "uri": {
                          "type": "string",
                          "description": "URI to a document (on or off-chain) that contains additional information. Optional."
                        },
                        "uri_hash": {
                          "type": "string",
                          "description": "URIHash is a sha256 hash of a document pointed by URI. It's used to verify that\nthe document didn't change. Optional."
                        }
                      }
                    }
                  },
                  "description": "QueryDenomMetadataByQueryStringResponse is the response type for the Query/DenomMetadata RPC\nmethod. Identical with QueryDenomMetadataResponse but receives denom as query string in request."
                }
              }
            }
          },
          "default": {
            "description": "An unexpected error response.",
            "content": {
              "*/*": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "format": "int32"
                    },
                    "message": {
                      "type": "string"
                    },
                    "details": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "@type": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": {}
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "denom",
            "description": "denom is the coin denom to query the metadata for.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "Query"
        ]
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```