---
title: "TotalBalance queries the total balance of all coins locked in the module."
method: GET
path: "/haqq/ucdao/v1/total_balance"
tags: ["Query"]
---

# TotalBalance queries the total balance of all coins locked in the module.

`GET /haqq/ucdao/v1/total_balance`

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

- HaqqUcdaoV1QueryTotalBalanceResponse
  - `totalBalance` CosmosBaseV1beta1Coin[]
    - `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

- **2024-08-01** `b1f358a545d4`: 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/total_balance/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)