---
title: "TokenHolders queries the all balances of all coins locked in the module and
group them by account address."
method: GET
path: "/haqq/ucdao/v1/holders"
tags: ["Query"]
---

# TokenHolders queries the all balances of all coins locked in the module and
group them by account address.

`GET /haqq/ucdao/v1/holders`

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

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

- HaqqUcdaoV1QueryHoldersResponse — QueryHoldersResponse is the response type for the Query/Holders RPC method.
  - `balances` HaqqUcdaoV1Balance[] — balances is the balances of all the coins.
    - `address` string — address is the address of the balance holder.
    - `coins` CosmosBaseV1beta1Coin[] — coins defines the different coins this balance holds.
      - `denom` string
      - `amount` string
  - `pagination` CosmosBaseQueryV1beta1PageResponse — PageResponse is to be embedded in gRPC response messages where the corresponding request message has used PageRequest. message SomeResponse { repeated Bar results = 1; PageResponse page = 2; }
    - `nextKey` string, byte — 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.
    - `total` string, uint64

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/haqq-network/apis/haqq-network-grpc-api.md) · [All operations](https://skmtc.net/haqq-network/apis/haqq-network-grpc-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/haqq-network/haqq-network-grpc-api/revisions/2d0419923f40/schema)