UTXOs by Address

GET /v1/utxos/address/:address

Retrieve all unspent transaction outputs (UTXOs) for a given address.

Parameters:

Parameter	Type	Description
address	string	The wallet address to query UTXOs for (bech32 format)

Example Request:

curl -X GET "https://api.fireblocks.partners.iagon.com/v1/utxos/address/addr1qy2..." \
  -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 address 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