List unspent outputs (UTXOs)

get

https://api.fireblocks.io/v1/utxo_management/{vaultAccountId}/{assetId}/unspent_outputs

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. Note: These endpoints are currently in beta and might be subject to changes.
Endpoint Permission: Admin, Non-Signing Admin, Signer, Approver, Editor, Viewer.

Path Params

vaultAccountId

string

required

The ID of the vault account

assetId

string

required

The ID of the asset

Query Params

pageCursor

string

Cursor for the next page of results

pageSize

integer

1 to 250

Defaults to 50

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

sort

string

enum

Field to sort by

Allowed:

order

string

enum

Sort order

Allowed:

includeAllLabels

array of strings

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

includeAllLabels

includeAnyLabels

array of strings

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

includeAnyLabels

excludeAnyLabels

array of strings

Exclude UTXOs that have ANY of these labels.

excludeAnyLabels

includeStatuses

array of strings

Filter by UTXO statuses to include.

includeStatuses

address

string

Filter by address

minAmount

string

Minimum amount filter

maxAmount

string

Maximum amount filter

useChange

boolean

Include change outputs

useCoinbase

boolean

Include coinbase outputs

Responses

Language

URL

Loading…

Response

Choose an example:

application/json

200A paginated list of UTXOs

defaultError Response