DCdcspark

POST /transaction/history

Changed on

Ordered by <block.height, transaction.tx_index>

Note: this endpoint only returns txs that are in a block. Use another tool to see mempool for txs not in a block

Request

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

Request body

withInputContextboolean

If this is set to true, the result includes the input addresses (which are not part of the tx), and the metadata (if any)

limitnumber double

Defaults to ADDRESS_LIMIT.RESPONSE

relationFilternumber double

Filter which uses of the address are considered relevant for the query.

This is a bitmask, so you can combine multiple options ex: RelationFilterType.Input | RelationFilterType.Output

Note: relations only apply to credentials and not to full bech32 addresses

untilBlockstring required

block hash - inclusive

Example request

{
  "relationFilter": 255,
  "addresses": [
    "8200581c8baf48931c5187cd59fde553f4e7da2e1a2aa9202ec6e67815cb3f8a"
  ],
  "after": {
    "tx": "336d520af58ff440b2f20210ddb5ef5b2c035e0ec7ec258bae4b519a87fa1696",
    "block": "2548ad5d0d9d33d50ab43151f574474454017a733e307229fa509c4987ca9782"
  },
  "untilBlock": "cf8c63a909d91776e27f7d05457e823a9dba606a7ab499ac435e7904ee70d7c8"
}

Response

Example response

{
  "transactions": [
    {
      "transaction": {
        "payload": "84a500818258209cb4f8c2eecccc9f1e13768046f37ef56dcb5a4dc44f58907fe4ae21d7cf621d020181825839019cb581f4337a6142e477af6e00fe41b1fc4a5944a575681b8499a3c0bd07ce733b5911eb657e7aff5d35f8b0682fe0380f7621af2bbcb2f71b0000000586321393021a0002a389031a004b418c048183028200581cbd07ce733b5911eb657e7aff5d35f8b0682fe0380f7621af2bbcb2f7581c53215c471b7ac752e3ddf8f2c4c1e6ed111857bfaa675d5e31ce8bcea1008282582073e584cda9fe483fbefb81c251e616018a2b493ef56820f0095b63adede54ff758404f13df42ef1684a3fd55255d8368c9ecbd15b55e2761a2991cc4f401a753c16d6da1da158e84b87b4de9715af7d9adc0d79a7c1f2c3097228e02b20be4616a0c82582066c606974819f457ceface78ee3c4d181a84ca9927a3cfc92ef8c0b6dd4576e8584014ae9ee9ed5eb5700b6c5ac270543671f5d4f943d4726f4614dc061174ee29db44b9e7fc58e6c98c13fad8594f2633c5ec70a9a87f5cbf130308a42edb553001f5f6",
        "hash": "011b86557367525891331b4bb985545120efc335b606d6a1c0d5a35fb330f421"
      },
      "block": {
        "slot": 4924800,
        "epoch": 209,
        "height": 4512067,
        "hash": "cf8c63a909d91776e27f7d05457e823a9dba606a7ab499ac435e7904ee70d7c8",
        "era": 1
      }
    }
  ]
}

Changes

  • 2f08aec7590aRevision changes
    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

  • bfb1cc42bf41Revision changes
    • info

      the /////// response's property pattern [0-9a-fA-F]{64} was added for the status