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

# Charm UTXOs by Address

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

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

---

[API](https://skmtc.net/maestro-org/apis/maestro-symphony.md) · [All operations](https://skmtc.net/maestro-org/apis/maestro-symphony/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maestro-org/maestro-symphony/versions/ddb6b00b2f90/schema)