> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cosmos.network/llms.txt
> Use this file to discover all available pages before exploring further.

# DenomsMetadata

> gRPC: `cosmos.bank.v1beta1.Query/DenomsMetadata` ([reference](/sdk/next/api-reference/grpc/bank#denomsmetadata))

DenomsMetadata queries the client metadata for all registered coin
denominations.



## OpenAPI

````yaml /sdk/next/api-reference/rest/openapi.yaml get /cosmos/bank/v1beta1/denoms_metadata
openapi: 3.0.0
info:
  title: Cosmos SDK REST API
  description: >-
    HTTP bindings for the gRPC query services of the standard Cosmos SDK
    modules, documenting Cosmos SDK v0.55 (unreleased).


    Generated from cosmos/cosmos-sdk at commit
    c1126e4e5460571378bf9bd9c49cce476b0791e2 on ref `main`.


    A chain exposes only the modules its application registers, so it may serve
    a subset of these routes alongside routes of its own.
  version: v0.55 (unreleased)
servers:
  - url: https://cosmos-rest.publicnode.com
    description: >-
      Community-run public endpoint serving Cosmos Hub. Not operated by the
      Cosmos SDK team, and running a different SDK version than these pages
      document. Endpoints for modules the chain does not include return 501.
  - url: http://localhost:1317
    description: Your own node. Requires api.enable in app.toml.
security: []
tags:
  - name: auth
  - name: authz
  - name: bank
  - name: base
  - name: consensus
  - name: distribution
  - name: epochs
  - name: evidence
  - name: feegrant
  - name: gov
  - name: mint
  - name: slashing
  - name: staking
  - name: tx
  - name: upgrade
paths:
  /cosmos/bank/v1beta1/denoms_metadata:
    get:
      tags:
        - bank
      summary: DenomsMetadata
      description: >-
        gRPC: `cosmos.bank.v1beta1.Query/DenomsMetadata`
        ([reference](/sdk/next/api-reference/grpc/bank#denomsmetadata))


        DenomsMetadata queries the client metadata for all registered coin

        denominations.
      operationId: bank_v1beta1_DenomsMetadata
      parameters:
        - name: pagination.key
          description: |-
            key is a value returned in PageResponse.next_key to begin
            querying the next page most efficiently. Only one of offset or key
            should be set.
          in: query
          required: false
          schema:
            type: string
            format: byte
        - name: pagination.offset
          description: >-
            offset is a 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.
          in: query
          required: false
          schema:
            type: string
            format: uint64
        - name: pagination.limit
          description: >-
            limit is 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.
          in: query
          required: false
          schema:
            type: string
            format: uint64
        - name: pagination.countTotal
          description: >-
            count_total is set to true  to 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.
          in: query
          required: false
          schema:
            type: boolean
        - name: pagination.reverse
          description: >-
            reverse is set to true if results are to be returned in the
            descending order.
          in: query
          required: false
          schema:
            type: boolean
      responses:
        '200':
          description: A successful response.
          content:
            '*/*':
              schema:
                type: object
                properties:
                  metadatas:
                    type: array
                    items:
                      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

                                  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:
                                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

                              denomination unit of the basic token.
                            additionalProperties: false
                          title: >-
                            denom_units represents the list of DenomUnit's for a
                            given coin
                          nullable: true
                        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
                            displayed 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

                            be 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

                            the document didn't change. Optional.
                      description: |-
                        Metadata represents a struct that describes
                        a basic token.
                      additionalProperties: false
                    description: >-
                      metadata provides the client information for all the
                      registered tokens.
                    nullable: true
                  pagination:
                    description: pagination defines the pagination in the response.
                    type: object
                    properties:
                      next_key:
                        type: string
                        format: byte
                        description: >-
                          next_key is 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.
                        nullable: true
                      total:
                        type: string
                        format: uint64
                        title: >-
                          total is total number of results available if
                          PageRequest.count_total

                          was set, its value is undefined otherwise
                    nullable: true
                    additionalProperties: false
                description: >-
                  QueryDenomsMetadataResponse is the response type for the
                  Query/DenomsMetadata RPC

                  method.
                additionalProperties: false
        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: {}

````