DCdcspark

POST /asset/mint-burn-history

Changed on

Gets mint and burn events in the provided slot range, optionally filtering by policyId(s). A burn event is a mint with a negative value.

Request

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

Request body

limitnumber double
policyIdsPolicyId[]
untilBlockstring required

block hash - inclusive

Example request

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

Response

blockstring required

Block id of related mint / burn event

txIdstring required

Transaction id of related mint / burn event

metadatastring nullable required

Transaction metadata of related mint / burn event

actionSlotnumber double required

Slot at which the transaction happened

outputAddressesobject required

Output parts indexed by address. This mapping will only contain assets that were minted or burned in this transaction.

inputAddressesobject required

Input parts indexed by address. This mapping will only contain assets that were minted or burned in this transaction.

assetsobject required

Assets changed in a particular transaction

Example response

[
  {
    "block": "4e90f1d14ad742a1c0e094a89ad180b896068f93fc3969614b1c53bac547b374",
    "txId": "28eb069e3e8c13831d431e3b2e35f58525493ab2d77fde83184993e4aa7a0eda",
    "actionSlot": 512345,
    "outputAddresses": {
      "8200581c4b2e7295ac876cfdf70e82c1cb8df3ee5cb23d93949e3322230fc447": [
        {
          "policyId": "b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f",
          "assetName": "42657272794e617679",
          "amount": "1"
        }
      ]
    },
    "inputAddresses": {
      "8200581c4b2e7295ac876cfdf70e82c1cb8df3ee5cb23d93949e3322230fc447": [
        {
          "policyId": "b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f",
          "assetName": "42657272794e617680",
          "amount": "2"
        }
      ]
    },
    "assets": {
      "b863bc7369f46136ac1048adb2fa7dae3af944c3bbb2be2f216a8d4f": {
        "42657272794e617679": "1",
        "42657272794e617680": "-2"
      }
    }
  }
]

Changes

  • 847a83190ffdRevision changes
    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

  • 746a48677a30Revision changes
    • info

      api operation id ProjectedNftRange removed and replaced with MintBurnHistory