---
title: "Charm Value at UTXO"
method: GET
path: "/charms/{charm}/utxos/{utxo}/value"
tags: ["Charms (Metaprotocol)"]
---

# Charm Value at UTXO

`GET /charms/{charm}/utxos/{utxo}/value`

## Request

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

Returns the value of the specified charm at the provided UTXO. For fungible tokens (tag `t`),
the value is a u64 amount. For other charms, it can be any JSON value.

## Path parameters

- `utxo` string, required
- `charm` string, required

## Query parameters

- `mempool` boolean

## Response `200`

Charm value at UTXO

- ServeResponseCharmAndValue
  - `data` object, required
    - `app` string, required: Canonical charm app identifier (e.g. "t/identity/vk")
    - `value` unknown, 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`: Charm or UTXO 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/charms/:charm/utxos/:utxo/value/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)