DCdcspark

POST /asset/utxos

Changed on

Returns utxo entries filtered either by cip 14 fingerprint or by policy id.

This is useful to keep track of the utxo set of a particular asset.

Request

  • Base URL
    / (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /asset/utxos
  • Auth
    none required

Request body

limitnumber double
policyIdsPolicyId[]
fingerprintsCip14Fingerprint[]
untilBlockstring required

block hash - inclusive

Example request

{
  "policyIds": [
    "b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f"
  ],
  "fingerprints": [
    "asset1c43p68zwjezc7f6w4w9qkhkwv9ppwz0f7c3amw"
  ],
  "after": {
    "tx": "336d520af58ff440b2f20210ddb5ef5b2c035e0ec7ec258bae4b519a87fa1696",
    "block": "2548ad5d0d9d33d50ab43151f574474454017a733e307229fa509c4987ca9782"
  },
  "untilBlock": "cf8c63a909d91776e27f7d05457e823a9dba606a7ab499ac435e7904ee70d7c8"
}

Response

blockstring required
txIdstring required

Example response

[
  {
    "payload": [
      {
        "assetName": "42657272794e617679"
      }
    ]
  }
]

Changes

  • 75bcd2b9384eRevision changes
    • breaking

      added subschema #1 to the request body allOf list

    • breaking

      the request's body type changed from object to no type

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the optional property / from the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

  • 58e046e362f3Revision changes
    • breaking

      the / response's property type changed from number to string, and format from double to no format for status

    • warning

      removed the request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status