---
title: "Rune Balances by Address"
method: GET
path: "/addresses/{address}/runes/balances"
tags: ["Addresses"]
---

# Rune Balances by Address

`GET /addresses/{address}/runes/balances`

## Request

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

Returns total rune balances held in UTxOs controlled by the provided address, sorted by rune ID.

## Path parameters

- `address` string, required

## Query parameters

- `mempool` boolean
- `include_info` boolean

## Response `200`

Requested data

- ServeResponseVecRuneBalanceWithInfo
  - `data` object[], required
    - `amount` string, required
    - `id` string, required
    - `info` RuneInfo
      - `divisibility` integer, required
      - `etching_height` integer, required
      - `etching_tx` string, required
      - `id` string, required
      - `name` string, required
      - `premine` string, required
      - `spaced_name` string, required
      - `symbol` string, nullable
      - `terms` RuneTerms
        - `amount` string, nullable
        - `cap` string, nullable
        - `end_height` integer, nullable
        - `start_height` integer, nullable
  - `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 entity not found on-chain
- `500`: Internal server error

## Changes

- **2025-09-09** `ea25be771a01`: 2 info
  - added the new optional `query` request parameter `include_info`
  - added the optional property `data/items/info` to the response with the `200` status
- **2025-07-07** `d63b72f7ab24`: 2 warning
  - deleted the `query` request parameter `include_info`
  - removed the optional property `data/items/info` from the response with the `200` status

[Operation history](https://skmtc.dev/maestro-org/apis/maestro-symphony/changes/addresses/:address/runes/balances/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)