BTbtcpayserver
Groups

Get UTXOs for a group

Changed on

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

get/v1/cryptos/{cryptoCode}/groups/{groupId}/utxos

Request

Path parameters

cryptoCodestring required

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

groupIdstring required

The unique identifier for the group.

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

  • 52231f42c765Revision changes
    • info

      api operation id GetGroupUTXOs was added

  • 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