---
title: "Rune Balance by UTXO and Rune"
method: GET
path: "/runes/{rune}/utxos/{utxo}/balance"
tags: ["Runes (Metaprotocol)"]
---

# Rune Balance by UTXO and Rune

`GET /runes/{rune}/utxos/{utxo}/balance`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/maestro-org/apis/maestro-symphony/docs/runes/:rune/utxos/:utxo/balance/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the amount of the specified rune contained in the provided UTXO. If the rune is not
present in the UTXO, `0` is returned.

## Path parameters

- `utxo` string, required
- `rune` string, required

## Query parameters

- `mempool` boolean

## Response `200`

Requested data

- ServeResponseString
  - `data` string, required
  - `indexer_info` IndexerInfo, required
    - `chain_tip` ChainTip, required
      - `block_hash` string, required: The hash of the block
      - `block_height` integer, required: The height of the block in the blockchain
    - `estimated_blocks` EstimatedBlock[], required: Information about any estimated blocks from the mempool that were indexed in addition to the mainchain
      - `block_height` integer, required
    - `mempool_timestamp` string, nullable: Timestamp of the indexed mempool snapshot, if any estimated blocks from the mempool have been indexed

## Other responses

- `400`: Malformed query parameters
- `404`: Requested rune or UTXO not found on-chain
- `500`: Internal server error

## Changes

- **2025-09-18** `ab4d830a0321`: 1 info
  - endpoint added
- **2025-07-07** `d63b72f7ab24`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/maestro-org/apis/maestro-symphony/changes/runes/:rune/utxos/:utxo/balance/get.md)

---

[API](https://skmtc.dev/maestro-org/apis/maestro-symphony.md) - [All operations](https://skmtc.dev/maestro-org/apis/maestro-symphony/llms.txt) - [OpenAPI document](https://skmtc.dev/maestro-org/apis/maestro-symphony/revisions/ddb6b00b2f90?raw)
