---
title: "Charm UTXOs by Address"
method: GET
path: "/addresses/{address}/charms/utxos"
tags: ["Addresses"]
---

# Charm UTXOs by Address

`GET /addresses/{address}/charms/utxos`

## Request

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

Returns all UTXOs controlled by the provided address which contain charms, sorted by height.

## Path parameters

- `address` string, required

## Query parameters

- `mempool` boolean

## Response `200`

All charm UTXOs at address

- ServeResponseVecCharmUtxo
  - `data` object[], required
    - `charms` CharmAndValue[], required
      - `app` string, required: Canonical charm app identifier (e.g. "t/identity/vk")
      - `value` unknown, required
    - `height` integer, required
    - `output_index` integer, required
    - `satoshis` string, required
    - `tx_hash` 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`: Not found
- `500`: Internal server error

## Changes

- **2026-07-17** `ddb6b00b2f90`: 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/addresses/:address/charms/utxos/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)