UTXOs by Stake Key

GET /v1/utxos/stake/:stakeKey

Retrieve all unspent transaction outputs (UTXOs) for addresses containing a given stake key.

WARNING

Assets on stake credential does not mean ownership of the assets. It can be used for easier grouping of addresses/assets, but ownership is defined by payment credential.

Parameters:

Parameter	Type	Description
stakeKey	string	The stake key (bech32 stake1... or 56 hex characters)

Example Request:

# Using bech32 stake address
curl -X GET "https://api.fireblocks.partners.iagon.com/v1/utxos/stake/stake1u9yy380n3yrnn0ap2uaq8cx5vspm5qqr77c3f9f7qqxf4ugev3aru" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Using hex stake credential
curl -X GET "https://api.fireblocks.partners.iagon.com/v1/utxos/stake/48489df3890739bfa1573a03e0d46403ba0003f7b114953e000c9af1" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

Content-Type: application/json;charset=utf-8

{
  "success": true,
  "data": [
    {
      "transaction_id": "402df03a9444a21e1be12550f381b9b99cb17705e697bb1b7c00859beb8bb4ae",
      "output_index": 1,
      "address": "addr_test1qqavk877khkt3hsv07nvewrd856j0nl2y49r28spzt7ws3gscl5lqldc5eadzh9ddvlcsdwr493uny93h7e2x63wqmxs2d2efz",
      "value": {
        "lovelace": 21839080681,
        "assets": {
          "87264e48adc75c4472c4e52e80acd36051ca153f42ee339fb04f5a28.957625f0f7805957c527640abe109ca87bb707b187b135e9e1c4b8236b3aacdf": 20000000
        }
      },
      "datum_hash": null,
      "script_hash": null,
      "created_at": {
        "slot_no": 95524660,
        "header_hash": "49394349d0dbd16276eee0654902fb0eda97fcf6286542feb66b676e39f2e59f"
      }
    }
  ]
}

Content-Type: application/json;charset=utf-8

{
  "success": false,
  "error": "Invalid stake key format"
}

Response Fields:

Field	Type	Description
transaction_id	string	Transaction hash (64 hex characters)
output_index	number	Output index within the transaction
address	string	The Cardano address holding this UTXO
value.lovelace	number	Amount in lovelace
value.assets	object	Native assets as {policy_id.asset_name: quantity}, empty object if none
datum_hash	string | null	Hash of the datum, or null if no datum
script_hash	string | null	Script hash, or null if not a script address
created_at.slot_no	number	Slot number when UTXO was created
created_at.header_hash	string	Block hash when UTXO was created