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

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/haqq-network/apis/haqq-network-grpc-api/docs/haqq/ucdao/v1/holders/get.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Changes

- **2025-06-26** `4d2f0cb0a49d`: 1 info
  - endpoint added
- **2023-11-17** `f416fba3183f`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/haqq-network/apis/haqq-network-grpc-api/changes/haqq/ucdao/v1/holders/get.md)

---

[API](https://skmtc.dev/haqq-network/apis/haqq-network-grpc-api.md) - [All operations](https://skmtc.dev/haqq-network/apis/haqq-network-grpc-api/llms.txt) - [OpenAPI document](https://skmtc.dev/haqq-network/apis/haqq-network-grpc-api/revisions/2d0419923f40?raw)