(Un)Spent Transaction Outputs

These endpoints cover spent and unspent transaction outputs.

Get Unspent UTXOs by Address

This endpoint retrieves a combined, ordered list of both confirmed and unconfirmed UTXOs for a given address.

• Returns up to 100k unconfirmed results in one request.

• Confirmed results are paginated if more than 1000 are available.

• The rest can be accessed using the provided next-page token.

HTTP Request

GET https://api.whatsonchain.com/v1/bsv/<network>/address/<address>/unspent/all

Example Request

BSV

curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/1L2F8wYxTRagCZLnsm2engg8ngGECSeuE5/unspent/all"

BTC

curl --location --request GET "https://api.whatsonchain.com/v1/btc/main/address/1AR9sWV7ZR2C2ohGSDDKXipCfZ3RLGynHM/unspent/all"

Example Response

BSV

{
    "address": "1L2F8wYxTRagCZLnsm2engg8ngGECSeuE5",
    "script": "b3005d46af31c4b5675b73c17579b7bd366dfe10635b7b43ac111aea5226efb6",
    "result": [{
        "height": 861499,
        "tx_pos": 1,
        "tx_hash": "ab0f76f957662335f98ee430a665f924c28310ec5126c2aede56086f9233326f",
        "value": 154,
        "isSpentInMempoolTx": false,
        "status": "confirmed"
    }, {
        "height": 861925,
        "tx_pos": 99,
        "tx_hash": "54e27d08c371b67746fd3088b78eecb9acef91f497f7e776d11d605635b9dc20",
        "value": 1000,
        "isSpentInMempoolTx": false,
        "status": "confirmed"
    },
    ...
    ],
    "error": ""
}

BTC

{
    "address": "1AR9sWV7ZR2C2ohGSDDKXipCfZ3RLGynHM",
    "script": "7b93a4e57dfc0cfacc47f486caac7f446ae6b366f8b708260962e7ca7d39f4fb",
    "result": [{
        "tx_pos": 0,
        "tx_hash": "891459059f872c18bd27e7cfc9a5f2a8567f6739d4535bd07281de22379dd193",
        "value": 505370,
        "isSpentInMempoolTx": false,
        "hex": "76a914674a8527a29f25613552267d0edfd181212becdc88ac",
        "status": "unconfirmed"
    },
    ...
    {
        "height": 881136,
        "tx_pos": 0,
        "tx_hash": "764da85a1e8a383d5a41e3bb7b7b9303bc99f92e258ed4bfbea3aefed4f617d7",
        "value": 600,
        "isSpentInMempoolTx": false,
        "status": "confirmed"
    },
    ...
    ],
    "error": ""
}

URL Parameters

Parameter	Description
network	Selected network: main or test.
address	Address.

Get Unconfirmed UTXOs by Address

This endpoint retrieves an ordered list of unconfirmed UTXOs for a given address.

Returns up to 100k results in one request.

HTTP Request

GET https://api.whatsonchain.com/v1/bsv/<network>/address/<address>/unconfirmed/unspent

Example Request

BSV

curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/12drYTV2c9nZMrxep9ewpWPdLrV5bNcWF2/unconfirmed/unspent"

BTC

curl --location --request GET "https://api.whatsonchain.com/v1/btc/main/address/bc1qcvltc5pzeq7dt52x0q0yjhlzlmvufusd0vm27a/unconfirmed/unspent"

Example Response

BSV

{
    "address": "12drYTV2c9nZMrxep9ewpWPdLrV5bNcWF2",
    "script": "2d4ec8100056a819943df89efb3ac6a37a44bdf46a307dc390c31f6db31a092f",
    "result": [{
        "tx_pos": 0,
        "tx_hash": "bdcfb99b692a3418f79471ca970a201149d19ba97d0ca5c0b89949bdb627a1c9",
        "value": 85,
        "isSpentInMempoolTx": false,
        "hex": "76a91411f074cf02b2c8070c424384493cb5c8548ae20788ac"
    }, {
        "tx_pos": 0,
        "tx_hash": "575e01c3ef02809308c835308a643199e56c3eb80816a28c1db51f31968c413d",
        "value": 17000,
        "isSpentInMempoolTx": false,
        "hex": "76a91411f074cf02b2c8070c424384493cb5c8548ae20788ac"
    },
    ...
    ],
    "error": ""
}

BTC

{
    "address": "bc1qcvltc5pzeq7dt52x0q0yjhlzlmvufusd0vm27a",
    "script": "d429f1c1970baaa6e8e1367b1e8689aafaefed972c0351a2223ceba047f22fdd",
    "result": [{
        "tx_pos": 0,
        "tx_hash": "a3c6d8dd8c7c777527e9e45803cf2e9efda9d09bcde7830368e1719b292938fd",
        "value": 1382600,
        "isSpentInMempoolTx": false,
        "hex": "0014c33ebc5022c83cd5d146781e495fe2fed9c4f20d"
    }],
    "error": ""
}

URL Parameters

Parameter	Description
network	Selected network: main or test.
address	Address.

Bulk Unconfirmed UTXOs by Address

This endpoint retrieves an ordered list of unconfirmed UTXOs for a given set of addresses

• Max 20 addresses per request.

• Returns up to 100 items in one request.

HTTP Request

GET https://api.whatsonchain.com/v1/bsv/<network>/addresses/unconfirmed/unspent

Request Data

{
    "addresses": [
    	"<address>",
    	"<address>",
        ...
    ]
}

Example Request

BSV

curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/addresses/unconfirmed/unspent" \
  --header "Content-Type: application/json" \
  --data "{\"addresses\" : [\"12drYTV2c9nZMrxep9ewpWPdLrV5bNcWF2\",\"1uEVHTbkzhz6pFfMQEYoimE2bQZNbhRC8\" ] }"

BTC

curl --location --request POST "https://api.whatsonchain.com/v1/btc/main/addresses/unconfirmed/unspent" \
  --header "Content-Type: application/json" \
  --data "{\"addresses\" : [\"bc1qcvltc5pzeq7dt52x0q0yjhlzlmvufusd0vm27a\",\"bc1qvqny32utwemf32rlvk0tghjn6h40wwtn7feq7p\" ] }"

Example Response

BSV

[{
    "address": "12drYTV2c9nZMrxep9ewpWPdLrV5bNcWF2",
    "script": "2d4ec8100056a819943df89efb3ac6a37a44bdf46a307dc390c31f6db31a092f",
    "result": [{
        "tx_pos": 0,
        "tx_hash": "bdcfb99b692a3418f79471ca970a201149d19ba97d0ca5c0b89949bdb627a1c9",
        "value": 85,
        "isSpentInMempoolTx": false,
        "hex": "76a91411f074cf02b2c8070c424384493cb5c8548ae20788ac"
    }, {
        "tx_pos": 0,
        "tx_hash": "575e01c3ef02809308c835308a643199e56c3eb80816a28c1db51f31968c413d",
        "value": 17000,
        "isSpentInMempoolTx": false,
        "hex": "76a91411f074cf02b2c8070c424384493cb5c8548ae20788ac"
    },
    ...
    ],
    "error": ""
}, {
    "address": "1uEVHTbkzhz6pFfMQEYoimE2bQZNbhRC8",
    "script": "b1654010d45195751fd392c13819834726edc87d6508f94cff4e41f643db2e49",
    "result": [{
        "tx_pos": 0,
        "tx_hash": "ee568800fe3c442fc458e2a1471ac0c697d1b6c31d4185e016a58700514c82cc",
        "value": 85,
        "isSpentInMempoolTx": false,
        "hex": "76a91409e0e39164714f25254ac278fc939933b1fe21f888ac"
    }, {
        "tx_pos": 0,
        "tx_hash": "186e0bd354cc0ba6a00a70529b60940a553eef4e468d109c7c8614d04d260ee9",
        "value": 85,
        "isSpentInMempoolTx": false,
        "hex": "76a91409e0e39164714f25254ac278fc939933b1fe21f888ac"
    },
    ...
    ],
    "error": ""
}]

BTC

[{
    "address": "bc1qcvltc5pzeq7dt52x0q0yjhlzlmvufusd0vm27a",
    "script": "d429f1c1970baaa6e8e1367b1e8689aafaefed972c0351a2223ceba047f22fdd",
    "result": [{
        "tx_pos": 0,
        "tx_hash": "a3c6d8dd8c7c777527e9e45803cf2e9efda9d09bcde7830368e1719b292938fd",
        "value": 1382600,
        "isSpentInMempoolTx": false,
        "hex": "0014c33ebc5022c83cd5d146781e495fe2fed9c4f20d"
    }],
    "error": ""
}, {
    "address": "bc1qvqny32utwemf32rlvk0tghjn6h40wwtn7feq7p",
    "script": "d939bd1751111e7cd8fb0d2a6945941e947a4bdcb396acd5635df8292fc3a375",
    "result": [{
        "tx_pos": 1,
        "tx_hash": "a3c6d8dd8c7c777527e9e45803cf2e9efda9d09bcde7830368e1719b292938fd",
        "value": 2010800,
        "isSpentInMempoolTx": false,
        "hex": "0014602648ab8b767698a87f659eb45e53d5eaf73973"
    }],
    "error": ""
}]

URL Parameters

Parameter	Description
network	Selected network: main or test.

Get Confirmed UTXOs by Address

This endpoint retrieves an ordered list of confirmed UTXOs for a given address.

• isSpentInMempoolTx flag enables filtering of spent unconfirmed transactions from this set.

• Pagination is available using the provided next-page token.

HTTP Request

GET https://api.whatsonchain.com/v1/<chain>/<network>/address/<address>/confirmed/unspent

Example Request

BSV

curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/1Dbj1LUxTqtuZ1U52KZiZChLPHkTAMiD6h/confirmed/unspent"

BTC

curl --location --request GET "https://api.whatsonchain.com/v1/btc/main/address/1AR9sWV7ZR2C2ohGSDDKXipCfZ3RLGynHM/confirmed/unspent"

Example Response

BSV

{
    "address": "1Dbj1LUxTqtuZ1U52KZiZChLPHkTAMiD6h",
    "script": "0374d9ee2df8e5d7c5fd8359f33456996f2a1a9c76d9c783d2f8d5ee05ba5832",
    "result": [{
        "height": 797518,
        "tx_pos": 0,
        "tx_hash": "6cc9631ef3dad77eb0141134167f20469d0b4e61405de57fe6a9ac71b943bb9f",
        "value": 181827,
        "isSpentInMempoolTx": false
    }],
    "error": ""
}

BTC

{
    "address": "1AR9sWV7ZR2C2ohGSDDKXipCfZ3RLGynHM",
    "script": "7b93a4e57dfc0cfacc47f486caac7f446ae6b366f8b708260962e7ca7d39f4fb",
    "result": [{
        "height": 881136,
        "tx_pos": 0,
        "tx_hash": "764da85a1e8a383d5a41e3bb7b7b9303bc99f92e258ed4bfbea3aefed4f617d7",
        "value": 600,
        "isSpentInMempoolTx": false
    }, {
        "height": 886287,
        "tx_pos": 1,
        "tx_hash": "12b8cf9dfaed801d448b6a36d4fc534245560108cc0ae067a13073dab7238a12",
        "value": 601,
        "isSpentInMempoolTx": false
    },
    ...
    ],
    "error": ""
}

URL Parameters

Parameter	Description
chain	Desired blockchain: bsv or btc.
network	Selected network: main or test.
address	Address.
limit	Between 1 and 10000 (default).
token	Provided next-page token.

Bulk Confirmed UTXOs by Address

This endpoint retrieves an ordered list of confirmed UTXOs for a given set of addresses

• Max 20 addresses per request.

• Returns up to 20 items in one request.

HTTP Request

GET https://api.whatsonchain.com/v1/<chain>/<network>/addresses/confirmed/unspent

Request Data

{
    "addresses": [
    	"<address>",
    	"<address>",
        ...
    ]
}

Example Request

BSV

curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/addresses/confirmed/unspent" \
  --header "Content-Type: application/json" \
  --data "{\"addresses\" : [\"16ZBEb7pp6mx5EAGrdeKivztd5eRJFuvYP\",\"1KGHhLTQaPr4LErrvbAuGE62yPpDoRwrob\" ] }"

BTC

curl --location --request POST "https://api.whatsonchain.com/v1/btc/main/addresses/confirmed/unspent" \
  --header "Content-Type: application/json" \
  --data "{\"addresses\" : [\"3MqUP6G1daVS5YTD8fz3QgwjZortWwxXFd\",\"382UwmXW5WgrS7kmG3XQLHV1ivVjTJzS94\" ] }"

Example Response

BSV

[{
    "address": "16ZBEb7pp6mx5EAGrdeKivztd5eRJFuvYP",
    "result": [{
        "height": 657540,
        "tx_pos": 1,
        "tx_hash": "d75485c2329a533fd06b5f55a3f21644741c0258f2974d5d989e946a0bb4357f",
        "value": 25000000
    },{
        "height": 657542,
        "tx_pos": 1,
        "tx_hash": "55a656d50327ec3237fa6e821ab62294695cfd508d631dc9b04dc3a395cf0a37",
        "value": 25000000
    }],
    "error": ""
},{
    "address": "1KGHhLTQaPr4LErrvbAuGE62yPpDoRwrob",
    "result": [{
        "height": 658133,
        "tx_pos": 1,
        "tx_hash": "7ae43aac97396bc99616d8273c6cd9b57f017d6d49aca742fbc8c214fee49fa7",
        "value": 25000000
    },{
        "height": 658134,
        "tx_pos": 1,
        "tx_hash": "5b25a56bbb959f9cf4b3e48dbbe412bf5cc85e655d27f87c3bfb07aa6aa01518",
        "value": 25000000
    }],
    "error": ""
}]

BTC

[{
    "address": "3MqUP6G1daVS5YTD8fz3QgwjZortWwxXFd",
    "script": "d9d46113eb0f3759c0dabf23b87b58a4c76a0633d13add20922cc5f6ede8ddd9",
    "result": [{
        "height": 891917,
        "tx_pos": 0,
        "tx_hash": "a367face4189b870b340ba391ef336e756305f65f2e060ae8486d100ab89f33a",
        "value": 546,
        "isSpentInMempoolTx": false
    }, {
        "height": 891978,
        "tx_pos": 0,
        "tx_hash": "608ffca4e1a21fc767f802e37f2c673db7b9ab6076cbbffa82bd090af56eebbf",
        "value": 546,
        "isSpentInMempoolTx": false
    },
    ...
    ],
    "nextPageToken": "000000002f0100004c000000010000004000000064396434363131336562306633373539633064616266323362383762353861346337366130363333643133616464323039323263633566366564653864646439016900000005000000010000000004000000000d9c0d040000000000043a40000000613336376661636534313839623837306233343062613339316566333336653735363330356636356632653036306165383438366431303061623839663333610400000000000000ebffffff8a448b12ab55abccc87bef8c6e82e38301000000390000000119000000140000000100000008000000b3eee3a4f216cea2010119000000140000000100000008000000b3eee3a4f216cea2010101000000164715117e017b366640b372f29546ae010000000000ffffffff000000000002",
    "error": ""
}, {
    "address": "382UwmXW5WgrS7kmG3XQLHV1ivVjTJzS94",
    "script": "f55f33505fe16e01f0e79fde7259d71191c901a6b40833d5297251ce64b5705b",
    "result": null,
    "error": ""
}]

URL Parameters

Parameter	Description
chain	Desired blockchain: bsv or btc.
network	Selected network: main or test.

Get Unspent UTXOs by Script

This endpoint retrieves a combined, ordered list of both confirmed and unconfirmed UTXOs for a given script.

• Returns up to 100k unconfirmed results in one request.

• Confirmed results are paginated if more than 1000 are available.

• The rest can be accessed using the provided next-page token.

HTTP Request

GET https://api.whatsonchain.com/v1/bsv/<network>/script/<scriptHash>/unspent/all

Example Request

BSV

curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/script/b3005d46af31c4b5675b73c17579b7bd366dfe10635b7b43ac111aea5226efb6/unspent/all"

BTC

curl --location --request GET "https://api.whatsonchain.com/v1/btc/main/script/d429f1c1970baaa6e8e1367b1e8689aafaefed972c0351a2223ceba047f22fdd/unspent/all"

Example Response

BSV

{
    "script": "b3005d46af31c4b5675b73c17579b7bd366dfe10635b7b43ac111aea5226efb6",
    "result": [{
        "height": 861499,
        "tx_pos": 1,
        "tx_hash": "ab0f76f957662335f98ee430a665f924c28310ec5126c2aede56086f9233326f",
        "value": 154,
        "isSpentInMempoolTx": false,
        "status": "confirmed"
    }, {
        "height": 861925,
        "tx_pos": 99,
        "tx_hash": "54e27d08c371b67746fd3088b78eecb9acef91f497f7e776d11d605635b9dc20",
        "value": 1000,
        "isSpentInMempoolTx": false,
        "status": "confirmed"
    },
    ...
    ],
    "error": ""
}

BTC

{
    "script": "d429f1c1970baaa6e8e1367b1e8689aafaefed972c0351a2223ceba047f22fdd",
    "result": [{
        "tx_pos": 0,
        "tx_hash": "a3c6d8dd8c7c777527e9e45803cf2e9efda9d09bcde7830368e1719b292938fd",
        "value": 1382600,
        "isSpentInMempoolTx": false,
        "hex": "0014c33ebc5022c83cd5d146781e495fe2fed9c4f20d",
        "status": "unconfirmed"
    }, {
        "height": 904501,
        "tx_pos": 1,
        "tx_hash": "dc625944cd7fc5761c93b337063fff0ed2c127c79b092159a2ede4491e5961db",
        "value": 142777600,
        "isSpentInMempoolTx": false,
        "status": "confirmed"
    },
    ...
    ],
    "error": ""
}

URL Parameters

Parameter	Description
network	Selected network: main or test.
scriptHash	Script hash: Sha256 hash of the binary bytes of the locking script (ScriptPubKey), expressed as a hexadecimal string.

Get Unconfirmed UTXOs by Script

This endpoint retrieves the ordered list of unconfirmed UTXOs for a given script.

Returns up to 100k results in one request.

HTTP Request

GET https://api.whatsonchain.com/v1/bsv/<network>/script/<scriptHash>/unconfirmed/unspent

Example Request

BSV

curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/script/b1654010d45195751fd392c13819834726edc87d6508f94cff4e41f643db2e49/unconfirmed/unspent"

BTC

curl --location --request GET "https://api.whatsonchain.com/v1/btc/main/script/0954dff09a1f76f413f53ff8f92f58f0b36b3abad8ef9dcd98ba55686ea9dad8/unconfirmed/unspent"

Example Response

BSV

{
    "script": "b1654010d45195751fd392c13819834726edc87d6508f94cff4e41f643db2e49",
    "result": [{
        "tx_pos": 0,
        "tx_hash": "ee568800fe3c442fc458e2a1471ac0c697d1b6c31d4185e016a58700514c82cc",
        "value": 85,
        "isSpentInMempoolTx": false,
        "hex": "76a91409e0e39164714f25254ac278fc939933b1fe21f888ac"
    }, {
        "tx_pos": 0,
        "tx_hash": "186e0bd354cc0ba6a00a70529b60940a553eef4e468d109c7c8614d04d260ee9",
        "value": 85,
        "isSpentInMempoolTx": false,
        "hex": "76a91409e0e39164714f25254ac278fc939933b1fe21f888ac"
    },
    ...
    ],
    "error": ""
}

BTC

{
    "script": "0954dff09a1f76f413f53ff8f92f58f0b36b3abad8ef9dcd98ba55686ea9dad8",
    "result": [{
        "tx_pos": 0,
        "tx_hash": "71e1ffb4b435000ad3fce89ed660a1f618787381e10b0b11426def778a9ab6de",
        "value": 47600669,
        "isSpentInMempoolTx": false,
        "hex": "a914424f29a8a84fa867814ff9ded43379c9dc9a681487"
    }, {
        "tx_pos": 0,
        "tx_hash": "bf7f0cb602bdecd290e8a93924e34f915d4e9c9e3b3cec35d0f5c26950066ba0",
        "value": 30202537,
        "isSpentInMempoolTx": false,
        "hex": "a914424f29a8a84fa867814ff9ded43379c9dc9a681487"
    },
    ...
    ],
    "error": ""
}

URL Parameters

Parameter	Description
network	Selected network: main or test.
scriptHash	Script hash: Sha256 hash of the binary bytes of the locking script (ScriptPubKey), expressed as a hexadecimal string.

Bulk Unconfirmed UTXOs by Script

This endpoint retrieves an ordered list of unconfirmed UTXOs for a given set of script hashes.

• Max 20 scripthashes per request.

• Returns up to 20 items in one request.

HTTP Request

GET https://api.whatsonchain.com/v1/bsv/<network>/scripts/unconfirmed/unspent

Request Data

{
    "scripts": [
        "<script>",
        "<script>",
        ...
    ]
}

Example Request

BSV

curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/scripts/unconfirmed/unspent" \
  --header "Content-Type: application/json" \
  --data "{\"scripts\" : [\"b1654010d45195751fd392c13819834726edc87d6508f94cff4e41f643db2e49\",\"2d4ec8100056a819943df89efb3ac6a37a44bdf46a307dc390c31f6db31a092f\" ] }"

BTC

curl --location --request POST "https://api.whatsonchain.com/v1/btc/main/scripts/unconfirmed/unspent" \
  --header "Content-Type: application/json" \
  --data "{\"scripts\" : [\"0954dff09a1f76f413f53ff8f92f58f0b36b3abad8ef9dcd98ba55686ea9dad8\",\"721ab98a12c78293b02278d19c45bb99c83a5289907f2854e3271c1aaf93b0f3\" ] }"

Example Response

BSV

[{
    "script": "b1654010d45195751fd392c13819834726edc87d6508f94cff4e41f643db2e49",
    "result": [{
        "tx_pos": 0,
        "tx_hash": "ee568800fe3c442fc458e2a1471ac0c697d1b6c31d4185e016a58700514c82cc",
        "value": 85,
        "isSpentInMempoolTx": false,
        "hex": "76a91409e0e39164714f25254ac278fc939933b1fe21f888ac"
    }, {
        "tx_pos": 0,
        "tx_hash": "186e0bd354cc0ba6a00a70529b60940a553eef4e468d109c7c8614d04d260ee9",
        "value": 85,
        "isSpentInMempoolTx": false,
        "hex": "76a91409e0e39164714f25254ac278fc939933b1fe21f888ac"
    },
    ...
    ],
    "error": ""
}, {
    "script": "2d4ec8100056a819943df89efb3ac6a37a44bdf46a307dc390c31f6db31a092f",
    "result": [{
        "tx_pos": 0,
        "tx_hash": "bdcfb99b692a3418f79471ca970a201149d19ba97d0ca5c0b89949bdb627a1c9",
        "value": 85,
        "isSpentInMempoolTx": false,
        "hex": "76a91411f074cf02b2c8070c424384493cb5c8548ae20788ac"
    }, {
        "tx_pos": 0,
        "tx_hash": "575e01c3ef02809308c835308a643199e56c3eb80816a28c1db51f31968c413d",
        "value": 17000,
        "isSpentInMempoolTx": false,
        "hex": "76a91411f074cf02b2c8070c424384493cb5c8548ae20788ac"
    },
    ...
    ],
    "error": ""
}]

BTC

[{
    "script": "0954dff09a1f76f413f53ff8f92f58f0b36b3abad8ef9dcd98ba55686ea9dad8",
    "result": [{
        "tx_pos": 0,
        "tx_hash": "64362c322487a25f9f7cab377ab27490256347db06d96da581cc10e9956119ca",
        "value": 5752365,
        "isSpentInMempoolTx": false,
        "hex": "a914424f29a8a84fa867814ff9ded43379c9dc9a681487"
    }, {
        "tx_pos": 1,
        "tx_hash": "a12d907e49794e6c47fefde137bac977065337b8989917bf998ce58892479fc6",
        "value": 46203,
        "isSpentInMempoolTx": false,
        "hex": "a914424f29a8a84fa867814ff9ded43379c9dc9a681487"
    },
    ...
    ],
    "error": ""
}, {
    "script": "721ab98a12c78293b02278d19c45bb99c83a5289907f2854e3271c1aaf93b0f3",
    "result": null,
    "error": ""
}]

URL Parameters

Parameter	Description
network	Selected network: main or test.

Get Confirmed UTXOs by Script

This endpoint retrieves the ordered list of confirmed UTXOs for a given script.

• isSpentInMempoolTx flag enables filtering of spent unconfirmed transactions from this set.

• Pagination is available using the provided next-page token.

HTTP Request

GET https://api.whatsonchain.com/v1/<chain>/<network>/script/<scriptHash>/confirmed/unspent

Example Request

BSV

curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/script/0374d9ee2df8e5d7c5fd8359f33456996f2a1a9c76d9c783d2f8d5ee05ba5832/confirmed/unspent"

BTC

curl --location --request GET "https://api.whatsonchain.com/v1/btc/main/script/aebd9e3018dbb5eed9220f275d3098dad2448fecd1c4c253d8c75a780bb08ce3/confirmed/unspent"

Example Response

BSV

{
    "script": "0374d9ee2df8e5d7c5fd8359f33456996f2a1a9c76d9c783d2f8d5ee05ba5832",
    "result": [{
        "height": 797518,
        "tx_pos": 0,
        "tx_hash": "6cc9631ef3dad77eb0141134167f20469d0b4e61405de57fe6a9ac71b943bb9f",
        "value": 181827,
        "isSpentInMempoolTx": false
    }],
    "error": ""
}

BTC

{
    "script": "aebd9e3018dbb5eed9220f275d3098dad2448fecd1c4c253d8c75a780bb08ce3",
    "result": [{
        "height": 904231,
        "tx_pos": 1,
        "tx_hash": "97b654a463364bf0fa0035dcb315abcdcf6c39ab4e522b3488060ba7098f55f0",
        "value": 2388665,
        "isSpentInMempoolTx": false
    }, {
        "height": 904268,
        "tx_pos": 0,
        "tx_hash": "fe18d4743815e5c152824063d08040d1df9bde0fcbe964288c3035cc16f63f0e",
        "value": 6389114,
        "isSpentInMempoolTx": false
    },
    ...
    ],
    "error": ""
}

URL Parameters

Parameter	Description
chain	Desired blockchain: bsv or btc.
network	Selected network: main or test.
scriptHash	Script hash: Sha256 hash of the binary bytes of the locking script (ScriptPubKey), expressed as a hexadecimal string.
limit	Between 1 and 10000 (default).
token	Provided next-page token.

Bulk Confirmed UTXOs by Script

This endpoint retrieves an ordered list of confirmed UTXOs for a given set of script hashes.

• Max 20 script hashes per request.

• Returns up to 20 items in one request.

HTTP Request

GET https://api.whatsonchain.com/v1/<chain>/<network>/scripts/confirmed/unspent

Request Data

{
    "scripts": [
        "<script>",
        "<script>",
        ...
    ]
}

Example Request

BSV

curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/scripts/confirmed/unspent" \
  --header "Content-Type: application/json" \
  --data "{\"scripts\" : [\"f814a7c3a40164aacc440871e8b7b14eb6a45f0ca7dcbeaea709edc83274c5e7\",\"995ea8d0f752f41cdd99bb9d54cb004709e04c7dc4088bcbbbb9ea5c390a43c3\" ] }"

BTC

curl --location --request POST "https://api.whatsonchain.com/v1/btc/main/scripts/confirmed/unspent" \
  --header "Content-Type: application/json" \
  --data "{\"scripts\" : [\"aebd9e3018dbb5eed9220f275d3098dad2448fecd1c4c253d8c75a780bb08ce3\",\"843bf6ea60946a9ff5cf1d526878177317b88dcba83db33a4036ae9ca9f1f0cf\" ] }"

Example Response

BSV

[{
    "script": "f814a7c3a40164aacc440871e8b7b14eb6a45f0ca7dcbeaea709edc83274c5e7",
    "result": [{
        "height": 620539,
        "tx_pos": 0,
        "tx_hash": "4ec3b63d764558303eda720e8e51f69bbcfe81376075657313fb587306f8a9b0",
        "value": 450000,
        "isSpentInMempoolTx": false
    }],
    "error": ""
}, {
    "script": "995ea8d0f752f41cdd99bb9d54cb004709e04c7dc4088bcbbbb9ea5c390a43c3",
    "result": [],
    "error": ""
}]

BTC

[{
    "script": "aebd9e3018dbb5eed9220f275d3098dad2448fecd1c4c253d8c75a780bb08ce3",
    "result": [{
        "height": 904231,
        "tx_pos": 1,
        "tx_hash": "97b654a463364bf0fa0035dcb315abcdcf6c39ab4e522b3488060ba7098f55f0",
        "value": 2388665,
        "isSpentInMempoolTx": false
    }, {
        "height": 904268,
        "tx_pos": 0,
        "tx_hash": "fe18d4743815e5c152824063d08040d1df9bde0fcbe964288c3035cc16f63f0e",
        "value": 6389114,
        "isSpentInMempoolTx": false
    }, 
    ...
    ],
    "error": ""
}, {
    "script": "843bf6ea60946a9ff5cf1d526878177317b88dcba83db33a4036ae9ca9f1f0cf",
    "result": [{
        "height": 891509,
        "tx_pos": 0,
        "tx_hash": "d38d3c310658daf5bfa5ab65e18509dd1f532de99c12d51373f39abf4c66feb3",
        "value": 1785,
        "isSpentInMempoolTx": false
    }],
    "error": ""
}]

URL Parameters

Parameter	Description
chain	Desired blockchain: bsv or btc.
network	Selected network: main or test.

Get Unconfirmed Spent Tx Output

This endpoint retrieves where the specified unconfirmed transaction output was spent.

HTTP Request

GET https://api.whatsonchain.com/v1/bsv/<network>/tx/<txid>/<voutIndex>/unconfirmed/spent

Example Request

BSV

curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/tx/c6647a562ac6a3cce0f46c2fb2b417cbd5daf1258f2a96d7556e6b9304f2889a/0/unconfirmed/spent"

BTC

curl --location --request GET "https://api.whatsonchain.com/v1/btc/main/tx/f656777a198cc497da4ed2f159f56868508fce40b3d32edeca770aba79afd52a/1/unconfirmed/spent"

Example Response

BSV

{
    "txid": "6fe244e16ea34b30ec2888c41d7e05a36fc1838de6a612008adf71c99678c0c1",
    "vin": 0,
    "status": "unconfirmed"
}

BTC

{
    "txid": "246523804e2fd48cf27314897d3abe8d2737376549c21b162dec64aa741265df",
    "vin": 0,
    "status": "unconfirmed"
}

URL Parameters

Parameter	Description
network	Selected network: main or test.
txid	Transaction ID.
voutIndex	Output index.

Get Confirmed Spent Tx Output

This endpoint retrieves where the specified confirmed transaction output was spent.

HTTP Request

GET https://api.whatsonchain.com/v1/bsv/<network>/tx/<txid>/<voutIndex>/confirmed/spent

Example Request

BSV

curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/tx/17d533c6a215223a62eef389707f77bef1601a18e4e994805a7846c3f3d50870/2/confirmed/spent"

BTC

curl --location --request GET "https://api.whatsonchain.com/v1/btc/main/tx/27e9a5d180186ccd0ff343a11e6595cec753ed9dcc7e62e977112bf8bf426436/0/confirmed/spent"

Example Response

BSV

{
    "txid": "87645a7c4a9a5a9b9cd1468db19cdba44129c35cc487fc57c4d8843141ad2551",
    "vin": 2,
    "status": "confirmed"
}

BTC

{
    "txid": "ad7e7be78c298efdc375c3500d17199b9051825afcc91a6974c615a81f9a0afd",
    "vin": 0,
    "status": "confirmed"
}

URL Parameters

Parameter	Description
chain	Desired blockchain: bsv or btc.
network	Selected network: main or test.
txid	Transaction ID.
voutIndex	Output index.

Get Spent Transaction Output

This endpoint retrieves where the specified transaction output was spent, checking both confirmed and unconfirmed in a single call.

HTTP Request

GET https://api.whatsonchain.com/v1/bsv/<network>/tx/<txid>/<voutIndex>/spent

Example Request

BSV

curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/tx/17d533c6a215223a62eef389707f77bef1601a18e4e994805a7846c3f3d50870/2/spent"

BTC

curl --location --request GET "https://api.whatsonchain.com/v1/btc/main/tx/27e9a5d180186ccd0ff343a11e6595cec753ed9dcc7e62e977112bf8bf426436/0/spent"

Example Response

BSV

{
    "txid": "87645a7c4a9a5a9b9cd1468db19cdba44129c35cc487fc57c4d8843141ad2551",
    "vin": 2,
    "status": "confirmed"
}

BTC

{
    "txid": "ad7e7be78c298efdc375c3500d17199b9051825afcc91a6974c615a81f9a0afd",
    "vin": 0,
    "status": "confirmed"
}

URL Parameters

Parameter	Description
network	Selected network: main or test.
txid	Transaction ID.
voutIndex	Output index.

Errors

Error	Description
400 Bad Request	If UTXO is unknown.
404 Not Found	If UTXO is known but spent details are not found, i.e., it's still unspent.

Bulk Spent Transaction Outputs

This endpoint retrieves where the specified transaction outputs were spent, checking both confirmed and unconfirmed in a single call.

Max 20 transaction outputs per request.

HTTP Request

POST https://api.whatsonchain.com/v1/bsv/<network>/utxos/spent

Request Data

{
    "utxos": [
        {
        "txid": "<txid>",
        "vout": <vout>
        },
        {
        "txid": "<txid>",
        "vout": <vout>
        },
        ...
    ]
}

Example Request

BSV

curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/utxos/spent" \
  --header "Content-Type: application/json" \
  --data "{\"utxos\" :[{ \"txid\" :\"87645a7c4a9a5a9b9cd1468db19cdba44129c35cc487fc57c4d8843141ad2551\", \"vout\" : 2}, {\"txid\" :\"c6647a562ac6a3cce0f46c2fb2b417cbd5daf1258f2a96d7556e6b9304f2889a\", \"vout\" : 0}]}"

BTC

curl --location --request POST "https://api.whatsonchain.com/v1/btc/main/utxos/spent" \
  --header "Content-Type: application/json" \
  --data "{\"utxos\" :[{ \"txid\" :\"27e9a5d180186ccd0ff343a11e6595cec753ed9dcc7e62e977112bf8bf426436\", \"vout\" : 0}, {\"txid\" :\"f656777a198cc497da4ed2f159f56868508fce40b3d32edeca770aba79afd52a\", \"vout\" : 1}]}"

Example Response

BSV

[{
    "utxo": {
        "txid": "87645a7c4a9a5a9b9cd1468db19cdba44129c35cc487fc57c4d8843141ad2551",
        "vout": 2
    },
    "spentIn": {
        "txid": "87645a7c4a9a5a9b9cd1468db19cdba44129c35cc487fc57c4d8843141ad2551",
        "vin": 2,
        "status": "confirmed"
    },
    "error": ""
}, {
    "utxo": {
        "txid": "c6647a562ac6a3cce0f46c2fb2b417cbd5daf1258f2a96d7556e6b9304f2889a",
        "vout": 0
    },
    "spentIn": {
        "txid": "c6647a562ac6a3cce0f46c2fb2b417cbd5daf1258f2a96d7556e6b9304f2889a",
        "vin": 0,
        "status": "unconfirmed"
    },
    "error": ""
}]

BTC

[{
    "utxo": {
        "txid": "27e9a5d180186ccd0ff343a11e6595cec753ed9dcc7e62e977112bf8bf426436",
        "vout": 0
    },
    "spentIn": {
        "txid": "27e9a5d180186ccd0ff343a11e6595cec753ed9dcc7e62e977112bf8bf426436",
        "vin": 0,
        "status": "confirmed"
    },
    "error": ""
}, {
    "utxo": {
        "txid": "f656777a198cc497da4ed2f159f56868508fce40b3d32edeca770aba79afd52a",
        "vout": 1
    },
    "spentIn": {
        "txid": "f656777a198cc497da4ed2f159f56868508fce40b3d32edeca770aba79afd52a",
        "vin": 1,
        "status": "confirmed"
    },
    "error": ""
}]

URL Parameters

Parameter	Description
network	Selected network: main or test.

Errors

Parameter	Description
400 Bad Request	If UTXO is unknown.
404 Not Found	If UTXO is known but spent details are not found, i.e., it's still unspent.

ElectrumX Wrapper for ElectrumSV (Beta)

We've created a wrapper for our UTXO service that acts exactly like an ElectrumX server that you can plug into the ElectrumSV wallet (Network - Server).

Use any of these URLs to try it out and let us know what you think in the Telegram channel:

• URL1: http://electrumx-adapter-1.whatsonchain.com/

• URL2: http://electrumx-adapter-2.whatsonchain.com/

Use either the 50001 ,50002 , or 50003 port.