BTbtcpayserver
Addresses

Get UTXOs for an address

Changed on

Retrieves UTXOs associated with a tracked standalone address.

get/v1/cryptos/{cryptoCode}/addresses/{address}/utxos

Request

Path parameters

cryptoCodestring required

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

addressstring required

The address to track or query.

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