Cardano » Assets

Asset UTXOs

Changed on

List of unspent UTxOs containing the specified native asset.

get/assets/{asset}/utxos

Request

  • Base URL
    https://cardano-mainnet.blockfrost.io/api/v0
  • URL
    https://cardano-mainnet.blockfrost.io/api/v0/assets/{asset}/utxos
  • Auth
    API key in header project_id

Path parameters

assetstring required

Concatenation of the policy_id and hex-encoded asset_name

Query parameters

countinteger

The number of results displayed on one page.

pageinteger

The page number for listing the results.

order'asc' | 'desc'

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

fromstring

The block height from which (inclusive) to start search for results. Has to be lower than or equal to to parameter.

tostring

The block height where (inclusive) to end the search for results. Has to be higher than or equal to from parameter.

Response

Return the UTXOs containing the specified asset

addressstring required

Bech32 encoded address holding the UTxO

tx_hashstring required

Transaction hash of the UTXO

output_indexinteger required

UTXO index in the transaction

blockstring required

Block hash of the UTXO

block_heightinteger required

Block number of the UTXO

block_timeinteger required

UNIX time of the block

data_hashstring nullable required

The hash of the transaction output datum

inline_datumstring nullable required

CBOR encoded inline datum

inline_datum_jsonobject nullable required

JSON representation of the inline datum

reference_script_hashstring nullable required

The hash of the reference script of the output

Example response

[
  {
    "address": "addr1qxfdlum57a0083mnth9y583jvdcv5a9nwj5lzv9v34t9tl7wmz90ahznykuhr4ykwvfrge8yc63c6lpf7345yd5h59nq885d05",
    "tx_hash": "47abf925faa462fe7ddbf906e65b4f8a27da52c3638ec4ee4fffb2298096aced",
    "output_index": 0,
    "amount": [
      {
        "unit": "lovelace",
        "quantity": "1444443"
      },
      {
        "unit": "750900e4999ebe0d58f19b634768ba25e525aaf12403bfe8fe130501424f4f4b",
        "quantity": "1000"
      }
    ],
    "block": "8dadf03917c51b36c7580a49162224f71845a5492976e0449319da6e8eea243e",
    "block_height": 5804427,
    "block_time": 1622754311,
    "data_hash": null,
    "inline_datum": null,
    "inline_datum_json": null,
    "reference_script_hash": null
  }
]

Changes