Groups

Get UTXOs for a group

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

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

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

Changed in 4 of the 40 revisions of this API.128

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

      response-optional-property-removed

    • removed the optional property spentUTXOs from the response with the 200 status

      response-optional-property-removed

    • added the optional property confirmed to the response with the 200 status

      response-optional-property-added

    • added the optional property currentHeight to the response with the 200 status

      response-optional-property-added

    • added the optional property spentUnconfirmed to the response with the 200 status

      response-optional-property-added

    • added the optional property trackedSource to the response with the 200 status

      response-optional-property-added

    • added the optional property unconfirmed to the response with the 200 status

      response-optional-property-added

    • added the optional property receivedUTXOs/items/keyIndex to the response with the 200 status

      response-optional-property-added

    • added the optional property spentUTXOs/items/keyIndex to the response with the 200 status

      response-optional-property-added

    • 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