> ## 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.

# DenomOwners

> gRPC: `cosmos.bank.v1beta1.Query/DenomOwners` ([reference](/sdk/latest/api-reference/grpc/bank#denomowners))

DenomOwners queries for all account addresses that own a particular token
denomination.

When called from another module, this query might consume a high amount of
gas if the pagination field is incorrectly set.



## OpenAPI

````yaml /sdk/latest/api-reference/rest/openapi.yaml get /cosmos/bank/v1beta1/denom_owners/{denom}
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.


    Generated from cosmos/cosmos-sdk at commit
    2086680ff8b08fd269ee653e087ea577bab79534 on ref `release/v0.55.x`.


    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
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/denom_owners/{denom}:
    get:
      tags:
        - bank
      summary: DenomOwners
      description: >-
        gRPC: `cosmos.bank.v1beta1.Query/DenomOwners`
        ([reference](/sdk/latest/api-reference/grpc/bank#denomowners))


        DenomOwners queries for all account addresses that own a particular
        token

        denomination.


        When called from another module, this query might consume a high amount
        of

        gas if the pagination field is incorrectly set.
      operationId: bank_v1beta1_DenomOwners
      parameters:
        - name: denom
          description: >-
            denom defines the coin denomination to query all account holders
            for.
          in: path
          required: true
          schema:
            type: string
            pattern: .+
        - 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:
                  denom_owners:
                    type: array
                    items:
                      type: object
                      properties:
                        address:
                          type: string
                          description: >-
                            address defines the address that owns a particular
                            denomination.
                        balance:
                          description: >-
                            balance is the balance of the denominated coin for
                            an account.
                          type: object
                          properties:
                            denom:
                              type: string
                            amount:
                              type: string
                          nullable: true
                          additionalProperties: false
                      description: >-
                        DenomOwner defines structure representing an account
                        that owns or holds a

                        particular denominated token. It contains the account
                        address and account

                        balance of the denominated token.
                      additionalProperties: false
                    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: >-
                  QueryDenomOwnersResponse defines the RPC response of a
                  DenomOwners RPC query.
                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: {}

````