FIfireblocks
UTXO Management

List unspent outputs (UTXOs)

Returns a paginated list of unspent transaction outputs (UTXOs) for a UTXO-based asset in a vault account, with optional filters for labels, statuses, amounts, and more. Endpoint Permission: Admin, Non-Signing Admin, Signer, Approver, Editor, Viewer.

get/utxo_management/{vaultAccountId}/{assetId}/unspent_outputs

Request

Path parameters

vaultAccountIdstring numeric required

The ID of the vault account

assetIdstring required

The ID of the asset

Query parameters

pageCursorstring

Cursor for the next page of results

pageSizeinteger

Number of results per page (max 250, default 50)

sort'AMOUNT' | 'CONFIRMATIONS'

Field to sort by

order'ASC' | 'DESC'

Sort order

includeAllLabelsstring[]

Only return UTXOs that have ALL of these labels (AND logic).

includeAnyLabelsstring[]

Return UTXOs that have ANY of these labels (OR logic).

excludeAnyLabelsstring[]

Exclude UTXOs that have ANY of these labels.

includeStatusesstring[]

Filter by UTXO statuses to include.

addressstring

Filter by address

txHashstring

Filter by the on-chain hash of the transaction that created the UTXOs. Returns all UTXOs originating from that transaction.

txIdstring uuid

Filter by the Fireblocks transaction ID that created the UTXOs.

minAmountstring

Minimum amount filter

maxAmountstring

Maximum amount filter

Response

A paginated list of UTXOs

nextstring nullable

Cursor to the next page

Example response

{
  "data": [
    {
      "input": {
        "txHash": "b34f0c3ce612f1e5a5c19d6b1e6b5e3e7f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c"
      },
      "utxoId": "123456",
      "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
      "amount": "0.00150000",
      "confirmations": 6,
      "status": "AVAILABLE",
      "fbTxId": "b70701f4-d7b1-4795-a8ee-b09cdb5b850e",
      "createdByHash": "000000000000000000024bead8df69990852c202db0e0097c1a12ea637d7e96d",
      "spentByFbTxId": [
        "b70701f4-d7b1-4795-a8ee-b09cdb5b850e"
      ],
      "createdByHeight": 800100,
      "createdAt": "2025-01-16T15:45:00Z",
      "updatedAt": "2025-01-16T15:45:00Z",
      "labels": [
        "cold-storage",
        "vip"
      ],
      "hasNativeAssets": true
    }
  ],
  "next": "MjAyNS0wNy0wOSAxMDo1MzoxMy40NTI=:NA=="
}

Changes

No recorded changes to this operation across all 1 revision of this API.