Address UTXOs of a given asset

GET /addresses/:address/utxos/:asset

UTXOs of the address.

Request

Path Parameters

address string required
Bech32 address.
Example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz
asset string required
Concatenation of the policy_id and hex-encoded asset_name
Example: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e

Query Parameters

count integer

Possible values: >= 1 and <= 100

Default value: 100

The number of results displayed on one page.

page integer

Possible values: >= 1 and <= 21474836

Default value: 1

The page number for listing the results.

order string

Possible values: [asc, desc]

Default value: asc

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.

Responses

• 200
• 400
• 403
• 404
• 418
• 429
• 500

---

Return the address content

application/json

Schema

Example (from schema)

---

Schema

• Array [
address string required

Bech32 encoded addresses - useful when querying by payment_cred

tx_hash string required

Transaction hash of the UTXO

tx_index integer deprecated

UTXO index in the transaction

output_index integer required

UTXO index in the transaction

amount object[]required
Array [
unit Lovelace or concatenation of asset policy_id and hex-encoded asset_name required
The unit of the value
quantity string required
The quantity of the unit
]
block string required

Block hash of the UTXO

data_hash string nullable required

The hash of the transaction output datum

inline_datum string nullable required

CBOR encoded inline datum

reference_script_hash string nullable required

The hash of the reference script of the output

• ]

[
  {
    "address": "addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz",
    "tx_hash": "39a7a284c2a0948189dc45dec670211cd4d72f7b66c5726c08d9b3df11e44d58",
    "output_index": 0,
    "amount": [
      {
        "unit": "lovelace",
        "quantity": "42000000"
      }
    ],
    "block": "7eb8e27d18686c7db9a18f8bbcfe34e3fed6e047afaa2d969904d15e934847e6",
    "data_hash": "9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710",
    "inline_datum": null,
    "reference_script_hash": null
  },
  {
    "address": "addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz",
    "tx_hash": "4c4e67bafa15e742c13c592b65c8f74c769cd7d9af04c848099672d1ba391b49",
    "output_index": 0,
    "amount": [
      {
        "unit": "lovelace",
        "quantity": "729235000"
      }
    ],
    "block": "953f1b80eb7c11a7ffcd67cbd4fde66e824a451aca5a4065725e5174b81685b7",
    "data_hash": null,
    "inline_datum": null,
    "reference_script_hash": null
  },
  {
    "address": "addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz",
    "tx_hash": "768c63e27a1c816a83dc7b07e78af673b2400de8849ea7e7b734ae1333d100d2",
    "output_index": 1,
    "amount": [
      {
        "unit": "lovelace",
        "quantity": "42000000"
      },
      {
        "unit": "b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e",
        "quantity": "12"
      }
    ],
    "block": "5c571f83fe6c784d3fbc223792627ccf0eea96773100f9aedecf8b1eda4544d7",
    "data_hash": null,
    "inline_datum": null,
    "reference_script_hash": null
  }
]

Bad request

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 400,
  "error": "Bad Request",
  "message": "Backend did not understand your request."
}

Authentication secret is missing or invalid

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 403,
  "error": "Forbidden",
  "message": "Invalid project token."
}

Component not found

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 404,
  "error": "Not Found",
  "message": "The requested component has not been found."
}

IP has been auto-banned for extensive sending of requests after usage limit has been reached

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 418,
  "error": "Requested Banned",
  "message": "IP has been auto-banned for flooding."
}

Usage limit reached

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 429,
  "error": "Project Over Limit",
  "message": "Usage is over limit."
}

Internal Server Error

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 500,
  "error": "Internal Server Error",
  "message": "An unexpected response was received from the backend."
}

Loading...