Public docs
WebsiteTAAL PlatformWhatsOnChain
  • Welcome
  • Introduction
    • Get an API Key
  • Core Products
    • WhatsOnChain
      • Health
      • Chain Info
      • Block
      • Transaction
      • Mempool
      • (Un)Spent Transaction Outputs
      • Address
      • Script
      • Exchange Rate
      • Search
      • WoC Widgets
      • WoC Plugins
      • On-Chain Data
      • Output Tags
      • Stats
      • WebSockets
        • WoC Sockets V1 (Deprecated)
        • WoC Sockets V2 (Beta)
      • Tokens
        • 1Sat Ordinals (Beta)
        • BSV-21 (Beta)
        • STAS Tokens (Beta)
      • Change Log
      • Community Libraries
    • Transaction Processing
      • ARC Endpoints
      • Transaction format and fee rate
    • TAAL Wallet
      • Introduction
      • Architecture
      • Terminology
      • UI Elements
      • Tutorial
    • 1Sat Ordinals tokens API
      • Introduction
      • Terminology
      • Flow Diagram
      • Basic Tutorial - Node
      • Basic Tutorial - Postman
      • API
  • Resources
    • FAQ
    • Support
    • Glossary
    • Acronyms and Abbreviations
Powered by GitBook
On this page
  • Get Unspent UTXOs by Address
  • Get Unconfirmed UTXOs by Address
  • Bulk Unconfirmed UTXOs by Address
  • Get Confirmed UTXOs by Address
  • Bulk Confirmed UTXOs by Address
  • Get Unspent UTXOs by Script
  • Get Unconfirmed UTXOs by Script
  • Bulk Unconfirmed UTXOs by Script
  • Get Confirmed UTXOs by Script
  • Bulk Confirmed UTXOs by Script
  • Get Unconfirmed Spent Tx Output
  • Get Confirmed Spent Tx Output
  • Get Spent Transaction Output
  • Bulk Spent Transaction Outputs
  • ElectrumX Wrapper for ElectrumSV (Beta)
  • (Deprecated) Get UTXOs by Address
  • (Deprecated) Bulk UTXOs by Address
  • (Deprecated) Get UTXOs by Script
  • (Deprecated) Bulk UTXOs by Script

Was this helpful?

Export as PDF
  1. Core Products
  2. WhatsOnChain

(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
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/1L2F8wYxTRagCZLnsm2engg8ngGECSeuE5/unspent/all"
Response JSON structure
{
    "address": "1L2F8wYxTRagCZLnsm2engg8ngGECSeuE5",
    "script": "b3005d46af31c4b5675b73c17579b7bd366dfe10635b7b43ac111aea5226efb6",
    "result": [
                {
                    "tx_pos": 1,
                    "tx_hash": "9c3801270d353066ed0553efb243bccc296d16e8ba589797934717c3f1ac030d",
                    "value": 98,
                    "isSpentInMempoolTx": false,
                    "hex": "76a914d0a69b53d9a1e229b51a60cc24814f8750b7446188ac",
                    "status": "unconfirmed"
                },
                ...
                {
                    "height": 861936,
                    "tx_pos": 0,
                    "tx_hash": "46b080bf212f3b355cffe7956db3adb53840ac550e51110577317df030039d7f",
                    "value": 100,
                    "isSpentInMempoolTx": true,
                    "status": "confirmed"
                }
            ],
    "error": ""
}

URL Parameters

Parameter
Description

network

The selected network: main or test.

address

The 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
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/1Dbj1LUxTqtuZ1U52KZiZChLPHkTAMiD6h/unconfirmed/unspent"
Response JSON structure
{
    "result": [
        {
            "tx_pos": 1,
            "tx_hash": "93d8ae93a9e074c555d80e86c130b6cd4d5c7efa2795f91b2aea285c546512c6",
            "value": 181724,
            "hex": "76a9148a32b77e8f9bce47179fe03b6894e3d37003099888ac"
        }
    ]
}

URL Parameters

Parameter
Description

network

The selected network: main or test.

address

The 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
cURL
curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/addresses/unconfirmed/unspent" \
  --header "Content-Type: application/json" \
  --data "{\"addresses\" : [\"16ZBEb7pp6mx5EAGrdeKivztd5eRJFuvYP\",\"1KGHhLTQaPr4LErrvbAuGE62yPpDoRwrob\" ] }"
Request body JSON structure
{
    "addresses": 
    [
    	"16ZBEb7pp6mx5EAGrdeKivztd5eRJFuvYP",
    	"1KGHhLTQaPr4LErrvbAuGE62yPpDoRwrob"
    ]
}
Response JSON structure
[
    {
        "address": "16ZBEb7pp6mx5EAGrdeKivztd5eRJFuvYP",
        "unspent": [
            {
                "height": 657540,
                "tx_pos": 1,
                "tx_hash": "d75485c2329a533fd06b5f55a3f21644741c0258f2974d5d989e946a0bb4357f",
                "value": 25000000
            },
            {
                "height": 657542,
                "tx_pos": 1,
                "tx_hash": "55a656d50327ec3237fa6e821ab62294695cfd508d631dc9b04dc3a395cf0a37",
                "value": 25000000
            }
        ],
        "error": ""
    },
    {
        "address": "1KGHhLTQaPr4LErrvbAuGE62yPpDoRwrob",
        "unspent": [
                {
                "height": 658133,
                "tx_pos": 1,
                "tx_hash": "7ae43aac97396bc99616d8273c6cd9b57f017d6d49aca742fbc8c214fee49fa7",
                "value": 25000000
            },
            {
                "height": 658134,
                "tx_pos": 1,
                "tx_hash": "5b25a56bbb959f9cf4b3e48dbbe412bf5cc85e655d27f87c3bfb07aa6aa01518",
                "value": 25000000
            }
        ],
        "error": ""
    }
]

URL Parameters

Parameter
Description

network

The selected network: main or test.

Get Confirmed UTXOs by Address

This endpoint retrieves an ordered list of confirmed UTXOs for a given address. Pagination is available using the provided next-page token.

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

HTTP Request
GET https://api.whatsonchain.com/v1/bsv/<network>/address/<address>/confirmed/unspent
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/1Dbj1LUxTqtuZ1U52KZiZChLPHkTAMiD6h/confirmed/unspent"
Response JSON structure
{
    "result": [
        {
            "height": 797518,
            "tx_pos": 0,
            "tx_hash": "6cc9631ef3dad77eb0141134167f20469d0b4e61405de57fe6a9ac71b943bb9f",
            "value": 181827,
            "isSpentInMempoolTx": false
        }
    ]
}

URL Parameters

Parameter
Description

network

The selected network: main or test.

address

The address

limit

Between 1 and 10000; default is 10000.

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/bsv/<network>/addresses/confirmed/unspent
cURL
curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/addresses/
confirmed/unspent" \
  --header "Content-Type: application/json" \
  --data "{\"addresses\" : [\"16ZBEb7pp6mx5EAGrdeKivztd5eRJFuvYP\",\"1KGHhLTQaPr4LErrvbAuGE62yPpDoRwrob\" ] }"
Request body JSON structure
{
    "addresses": 
    [
    	"16ZBEb7pp6mx5EAGrdeKivztd5eRJFuvYP",
    	"1KGHhLTQaPr4LErrvbAuGE62yPpDoRwrob"
    ]
}
Response JSON structure
[
    {
        "address": "16ZBEb7pp6mx5EAGrdeKivztd5eRJFuvYP",
        "unspent": [
            {
                "height": 657540,
                "tx_pos": 1,
                "tx_hash": "d75485c2329a533fd06b5f55a3f21644741c0258f2974d5d989e946a0bb4357f",
                "value": 25000000
            },
            {
                "height": 657542,
                "tx_pos": 1,
                "tx_hash": "55a656d50327ec3237fa6e821ab62294695cfd508d631dc9b04dc3a395cf0a37",
                "value": 25000000
            }
        ],
        "error": ""
    },
    {
        "address": "1KGHhLTQaPr4LErrvbAuGE62yPpDoRwrob",
        "unspent": [
                {
                "height": 658133,
                "tx_pos": 1,
                "tx_hash": "7ae43aac97396bc99616d8273c6cd9b57f017d6d49aca742fbc8c214fee49fa7",
                "value": 25000000
            },
            {
                "height": 658134,
                "tx_pos": 1,
                "tx_hash": "5b25a56bbb959f9cf4b3e48dbbe412bf5cc85e655d27f87c3bfb07aa6aa01518",
                "value": 25000000
            }
        ],
        "error": ""
    }
]

URL Parameters

Parameter
Description

network

The 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
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/script/b3005d46af31c4b5675b73c17579b7bd366dfe10635b7b43ac111aea5226efb6/unspent/all"
Response JSON structure
{
    "script": "b3005d46af31c4b5675b73c17579b7bd366dfe10635b7b43ac111aea5226efb6",
    "result": [
                {
                    "tx_pos": 1,
                    "tx_hash": "9c3801270d353066ed0553efb243bccc296d16e8ba589797934717c3f1ac030d",
                    "value": 98,
                    "isSpentInMempoolTx": false,
                    "hex": "76a914d0a69b53d9a1e229b51a60cc24814f8750b7446188ac",
                    "status": "unconfirmed"
                },
                ...
                {
                    "height": 861936,
                    "tx_pos": 0,
                    "tx_hash": "46b080bf212f3b355cffe7956db3adb53840ac550e51110577317df030039d7f",
                    "value": 100,
                    "isSpentInMempoolTx": true,
                    "status": "confirmed"
                }
            ],
    "error": ""
}

URL Parameters

Parameter
Description

network

The selected network: main or test.

scriptHash

The 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
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/script/0374d9ee2df8e5d7c5fd8359f33456996f2a1a9c76d9c783d2f8d5ee05ba5832/unconfirmed/unspent"
Response JSON structure
{
    "result": [
        {
            "tx_pos": 1,
            "tx_hash": "93d8ae93a9e074c555d80e86c130b6cd4d5c7efa2795f91b2aea285c546512c6",
            "value": 181724,
            "hex": "76a9148a32b77e8f9bce47179fe03b6894e3d37003099888ac"
        }
    ]
}

URL Parameters

Parameter
Description

network

The selected network: main or test.

scriptHash

The 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 scripthashes - 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
cURL
curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/scripts/unconfirmed/unspent" \
  --header "Content-Type: application/json" \
  --data "{\"scripts\" : [\"f814a7c3a40164aacc440871e8b7b14eb6a45f0ca7dcbeaea709edc83274c5e7\",\"995ea8d0f752f41cdd99bb9d54cb004709e04c7dc4088bcbbbb9ea5c390a43c3\" ] }"
Request body JSON structure
{
    "scripts": [
        "f814a7c3a40164aacc440871e8b7b14eb6a45f0ca7dcbeaea709edc83274c5e7",
        "995ea8d0f752f41cdd99bb9d54cb004709e04c7dc4088bcbbbb9ea5c390a43c3"
    ]
}
Response JSON structure
[
    {
        "script": "f814a7c3a40164aacc440871e8b7b14eb6a45f0ca7dcbeaea709edc83274c5e7",
        "unspent": [
            {
                "height": 620539,
                "tx_pos": 0,
                "tx_hash": "4ec3b63d764558303eda720e8e51f69bbcfe81376075657313fb587306f8a9b0",
                "value": 450000
            }
        ],
        "error": ""
    },
    {
        "script": "995ea8d0f752f41cdd99bb9d54cb004709e04c7dc4088bcbbbb9ea5c390a43c3",
        "unspent": [],
        "error": ""
    }
]

URL Parameters

Parameter
Description

network

The selected network: main or test.

Get Confirmed UTXOs by Script

This endpoint retrieves the ordered list of confirmed UTXOs for a given script. Pagination is available using the provided next-page token.

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

HTTP Request
GET https://api.whatsonchain.com/v1/bsv/<network>/script/<scriptHash>/confirmed/unspent
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/script/0374d9ee2df8e5d7c5fd8359f33456996f2a1a9c76d9c783d2f8d5ee05ba5832/confirmed/unspent"
Response JSON structure
{
    "result": [
        {
            "height": 797518,
            "tx_pos": 0,
            "tx_hash": "6cc9631ef3dad77eb0141134167f20469d0b4e61405de57fe6a9ac71b943bb9f",
            "value": 181827,
            "isSpentInMempoolTx": false
        }
    ]
}

URL Parameters

Parameter
Description

network

The selected network: main or test.

scriptHash

The script hash: Sha256 hash of the binary bytes of the locking script (ScriptPubKey), expressed as a hexadecimal string.

limit

Between 1 and 10000; default is 10000.

token

Provided next page token.

Bulk Confirmed UTXOs by Script

This endpoint retrieves an ordered list of confirmed UTXOs for a given set of scripthashes - max 20 scripthashes per request. Returns up to 20 items in one request.

HTTP Request
GET https://api.whatsonchain.com/v1/bsv/<network>/scripts/confirmed/unspent
cURL
curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/scripts/confirmed/unspent" \
  --header "Content-Type: application/json" \
  --data "{\"scripts\" : [\"f814a7c3a40164aacc440871e8b7b14eb6a45f0ca7dcbeaea709edc83274c5e7\",\"995ea8d0f752f41cdd99bb9d54cb004709e04c7dc4088bcbbbb9ea5c390a43c3\" ] }"
Request body JSON structure
{
    "scripts": [
        "f814a7c3a40164aacc440871e8b7b14eb6a45f0ca7dcbeaea709edc83274c5e7",
        "995ea8d0f752f41cdd99bb9d54cb004709e04c7dc4088bcbbbb9ea5c390a43c3"
    ]
}
Response JSON structure
[
    {
        "script": "f814a7c3a40164aacc440871e8b7b14eb6a45f0ca7dcbeaea709edc83274c5e7",
        "unspent": [
            {
                "height": 620539,
                "tx_pos": 0,
                "tx_hash": "4ec3b63d764558303eda720e8e51f69bbcfe81376075657313fb587306f8a9b0",
                "value": 450000
            }
        ],
        "error": ""
    },
    {
        "script": "995ea8d0f752f41cdd99bb9d54cb004709e04c7dc4088bcbbbb9ea5c390a43c3",
        "unspent": [],
        "error": ""
    }
]

URL Parameters

Parameter
Description

network

The 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
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/tx/d2d9231b0d3cc19f1b9cfe798b8e68eaf8db3cd803128779c8aabaaea9cba4ea/1/unconfirmed/spent"
Response JSON structure
{
    "txid": "b905857a36586e68b8186be1e7b1ac56de196f5257536f019d7071cbdb0608a7",
    "vin": 0
}

URL Parameters

Parameter
Description

network

The selected network: main or test.

txid

The transaction ID.

voutIndex

The specific 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
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/tx/17d533c6a215223a62eef389707f77bef1601a18e4e994805a7846c3f3d50870/2/confirmed/spent"
Response JSON structure
{
    "txid": "87645a7c4a9a5a9b9cd1468db19cdba44129c35cc487fc57c4d8843141ad2551",
    "vin": 2
}

URL Parameters

Parameter
Description

network

The selected network: main or test.

txid

The transaction ID.

voutIndex

The specific 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
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/tx/17d533c6a215223a62eef389707f77bef1601a18e4e994805a7846c3f3d50870/2/spent"
Response JSON structure
{
    "txid": "87645a7c4a9a5a9b9cd1468db19cdba44129c35cc487fc57c4d8843141ad2551",
    "vin": 2
}

URL Parameters

Parameter
Description

network

The selected network: main or test.

txid

The transaction ID.

voutIndex

The specific 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
cURL
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\" :\"e05de19075bc8205d702036a53d3e21ff6a2964f1e9941b913921e1e83d82c91\", \"vout\" : 0}]}"
Request body JSON structure
{
    "utxos":
    [
        {
        "txid": "87645a7c4a9a5a9b9cd1468db19cdba44129c35cc487fc57c4d8843141ad2551",
        "vout": 2
        },
        {
        "txid": "e05de19075bc8205d702036a53d3e21ff6a2964f1e9941b913921e1e83d82c91",
        "vout": 0
        }
    ]
}
Response JSON structure
[
    {
        "utxo": {
            "txid": "87645a7c4a9a5a9b9cd1468db19cdba44129c35cc487fc57c4d8843141ad2551",
            "vout": 2
        },
        "spentIn": {
            "txid": "88d8ce011179fac0dc466a1c5fcb734a91b076d15354aee4f7186ea3f5921533",
            "vin": 93,
            "status": "confirmed"
        },
        "error": ""
    },
    {
        "utxo": {
            "txid": "e05de19075bc8205d702036a53d3e21ff6a2964f1e9941b913921e1e83d82c91",
            "vout": 0
        },
        "spentIn": {
            "txid": "81f4ffcdc8ac15a9f360196f95f8e4e32c2e2c4fb78fdca64e52856820d3ed3d",
            "vin": 0,
            "status": "unconfirmed"
        },
        "error": ""
    }
]

URL Parameters

Parameter
Description

network

The 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)

Use either the 50001 ,50002 , or 50003 port.

(Deprecated) Get UTXOs by Address

This endpoint is powered by ElectrumX and is planned for removal in the near future.

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

HTTP Request
GET https://api.whatsonchain.com/v1/bsv/<network>/address/<address>/unspent
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/1GJ3x5bcEnKMnzNFPPELDfXUCwKEaLHM5H/unspent"

Returns a response as long as the response message is less than 1MB in size.

Response JSON structure
[
    {
        "height": 578325,
        "tx_pos": 0,
        "tx_hash": "62824e3af3d01113e9bce8b73576b833990d231357bd718385958c21d50bbddd",
        "value": 1250020815
    },
    {
        "height": 578326,
        "tx_pos": 0,
        "tx_hash": "4b008a10eebcf70f384442e4e3147bc76c6e4f764b516b208e148d700b965deb",
        "value": 1251827826
    },
    ...
]

URL Parameters

Parameter
Description

network

The selected network: main or test.

address

The address

(Deprecated) Bulk UTXOs by Address

This endpoint is powered by ElectrumX and is planned for removal in the near future.

This endpoint retrieves a list of UTXOs for multiple addresses in a single request.

  • Max 20 addresses per request.

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

The JSON structure for the above post request:

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

URL Parameters

Parameter
Description

network

The selected network: main or test.

(Deprecated) Get UTXOs by Script

This endpoint is powered by ElectrumX and is planned for removal in the near future.

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

HTTP Request
GET https://api.whatsonchain.com/v1/bsv/<network>/script/<scriptHash>/unspent
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/script/995ea8d0f752f41cdd99bb9d54cb004709e04c7dc4088bcbbbb9ea5c390a43c3/unspent"

Returns a response as long as the response message is less than 1MB in size.

Response JSON structure
[
    {
        "height": 578325,
        "tx_pos": 0,
        "tx_hash": "62824e3af3d01113e9bce8b73576b833990d231357bd718385958c21d50bbddd",
        "value": 1250020815
    },
    {
        "height": 578326,
        "tx_pos": 0,
        "tx_hash": "4b008a10eebcf70f384442e4e3147bc76c6e4f764b516b208e148d700b965deb",
        "value": 1251827826
    },
    ...
]    

URL Parameters

Parameter
Description

network

The selected network: main or test.

scriptHash

The script hash: Sha256 hash of the binary bytes of the locking script (ScriptPubKey), expressed as a hexadecimal string.

(Deprecated) Bulk UTXOs by Script

This endpoint is powered by ElectrumX and is planned for removal in the near future.

This endpoint retrieves a list of UTXOs for multiple scripts in a single request.

  • Max 20 scripts per request.

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

The JSON structure for the above post request:

JSON structure
{
    "scripts": [
        "f814a7c3a40164aacc440871e8b7b14eb6a45f0ca7dcbeaea709edc83274c5e7",
        "995ea8d0f752f41cdd99bb9d54cb004709e04c7dc4088bcbbbb9ea5c390a43c3"
    ]
}
Response JSON structure
[
    {
        "script": "f814a7c3a40164aacc440871e8b7b14eb6a45f0ca7dcbeaea709edc83274c5e7",
        "unspent": [
            {
                "height": 620539,
                "tx_pos": 0,
                "tx_hash": "4ec3b63d764558303eda720e8e51f69bbcfe81376075657313fb587306f8a9b0",
                "value": 450000
            }
        ],
        "error": ""
    },
    {
        "script": "995ea8d0f752f41cdd99bb9d54cb004709e04c7dc4088bcbbbb9ea5c390a43c3",
        "unspent": [],
        "error": ""
    }
]

URL Parameters

Parameter
Description

network

The selected network: main or test.

PreviousMempoolNextAddress

Last updated 1 month ago

Was this helpful?

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

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

URL1:

URL2:

ElectrumSV
Telegram channel
http://electrumx-adapter-1.whatsonchain.com/
http://electrumx-adapter-2.whatsonchain.com/