BTbtcpayserver
Derivations

Get UTXOs for a derivation scheme

Changed on

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

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

Request

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

  • dcf3a15489b0Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 5bb4d4de224aRevision changes
    • info

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

    • info

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