Derivations

Get UTXOs for a derivation scheme

Retrieves the list of unspent transaction outputs (UTXOs) associated with the specified derivation scheme.

get/v1/cryptos/{cryptoCode}/derivations/{derivationScheme}/utxos

Path parameters

cryptoCodestring required

The cryptocurrency code to track (e.g., 'BTC' for Bitcoin, 'LTC' for Litecoin).

derivationSchemestring required

The derivation scheme (See documentation)

Response

UTXOs retrieved successfully.

trackedSourcestring

The tracked source identifier, which can be a group or a derivation scheme.

currentHeightinteger

The current height of the blockchain.

spentUnconfirmedstring[]

List of still unconfirmed outpoints that were spent. For a transaction chain A->B->C where B spends A and C spends B, outpoints A and B will appear here since they remain unconfirmed until the entire chain confirms.

Example response

{
  "trackedSource": "DERIVATIONSCHEME:tpubD6NzVbkrYhZ4W...",
  "currentHeight": 104,
  "unconfirmed": {
    "utxOs": [
      {
        "feature": "Deposit",
        "outpoint": "8ac84044e85644486ec07eb8251b870f91a9aec70b8bd91b0b1303ddca4bba10-1",
        "index": 1,
        "transactionHash": "8ac84044e85644486ec07eb8251b870f91a9aec70b8bd91b0b1303ddca4bba10",
        "scriptPubKey": "00149681ae465a045e2068460b9d281cf97dede87cd8",
        "address": "bcrt1qj6q6u3j6q30zq6zxpwwjs88e0hk7slxcunru7u",
        "value": 100000000,
        "keyPath": "0/123",
        "keyIndex": "123",
        "timestamp": 1540376171
      }
    ],
    "spentOutpoints": [
      "f3e34c3ae29c79ddf807de0ab3b40da7862adb1b175b7421d89ec78446a52b13-1",
      "fd97fb1de63fcdb9fa1614a74775e84818b2dbd79fe36aef9e0c18f9fad03742-2"
    ]
  },
  "confirmed": {
    "utxOs": [
      {
        "feature": "Deposit",
        "outpoint": "8ac84044e85644486ec07eb8251b870f91a9aec70b8bd91b0b1303ddca4bba10-1",
        "index": 1,
        "transactionHash": "8ac84044e85644486ec07eb8251b870f91a9aec70b8bd91b0b1303ddca4bba10",
        "scriptPubKey": "00149681ae465a045e2068460b9d281cf97dede87cd8",
        "address": "bcrt1qj6q6u3j6q30zq6zxpwwjs88e0hk7slxcunru7u",
        "value": 100000000,
        "keyPath": "0/123",
        "keyIndex": "123",
        "timestamp": 1540376171
      }
    ],
    "spentOutpoints": [
      "f3e34c3ae29c79ddf807de0ab3b40da7862adb1b175b7421d89ec78446a52b13-1",
      "fd97fb1de63fcdb9fa1614a74775e84818b2dbd79fe36aef9e0c18f9fad03742-2"
    ]
  },
  "spentUnconfirmed": [
    "b1ceb33c783788d7c9d4c1417ffe3490eb0c83abd9267d470eaa06a1d3be0475-1",
    "8224f00a3c12f19b89155b6e4a5ed2320f6407d37d1a6ca7da8def0953fecc3e-2"
  ]
}

Changes

Changed in 6 of the 40 revisions of this API.1210

  • dcf3a15489b025See the full diff
    • removed the optional property from the response with the status

      response-optional-property-removed

    • removed the optional property from the response with the status

      response-optional-property-removed

    • added the optional property to the response with the status

      response-optional-property-added

    • added the optional property to the response with the status

      response-optional-property-added

    • added the optional property to the response with the status

      response-optional-property-added

    • added the optional property to the response with the status

      response-optional-property-added

    • added the optional property to the response with the status

      response-optional-property-added

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

      response-optional-property-added

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

      response-optional-property-added

    • api operation id ListUTXOsDerivationScheme was added

      api-operation-id-added

    • api tag UTXOs removed

      api-tag-removed

    • endpoint added

      endpoint-added

    • api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 14 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog