Get Script Usage Status
This endpoint serves as a usage status flag for a given script.
GET https://api.whatsonchain.com/v1/bsv/<network>/script/<scriptHash>/used
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/script/3a9b9e2285ae40de7679e48efcef7d029a46a7b3120063a6d24347ce4452e6ee/used"
URL Parameters
The selected network: main or test.
The script hash: Sha256 hash of the binary bytes of the locking script (ScriptPubKey), expressed as a hexadecimal string.
Get Unconfirmed Script History
This endpoint retrieves the history of unconfirmed transactions for a given script. Returns up to 100k results in one request.
GET https://api.whatsonchain.com/v1/bsv/<network>/script/<scriptHash>/unconfirmed/history
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/script/0374d9ee2df8e5d7c5fd8359f33456996f2a1a9c76d9c783d2f8d5ee05ba5832/unconfirmed/history"
{
"result": [
{
"tx_hash": "93d8ae93a9e074c555d80e86c130b6cd4d5c7efa2795f91b2aea285c546512c6"
},
{
"tx_hash": "6bcd7708adf5c8c00d299628ef86fa5d982ccd1909254f46ea0f0a70c4c319f7"
},
{
"tx_hash": "cf1f1fd7962aeac56932b0e522d83c163d89873f2e26a1519bcc0d88772d0e78"
},
...
]
}
URL Parameters
The selected network: main or test.
The script hash: Sha256 hash of the binary bytes of the locking script (ScriptPubKey), expressed as a hexadecimal string.
Bulk Unconfirmed Script History
This endpoint retrieves the history of unconfirmed transactions for a given set of scripts.
Max 20 scripthashes per request.
Max 100 items returned per request.
POST https://api.whatsonchain.com/v1/bsv/<network>/scripts/unconfirmed/history
curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/scripts/unconfirmed/history" \
--header "Content-Type: application/json" \
--data "{\"scripts\" : [ \"8ca0d228066cfff2b7f31c7db7737185be9d06ff5c07206b61f06d80a4cdd9a8\" ] }"
Request body JSON structure
{
"scripts": [
"8ca0d228066cfff2b7f31c7db7737185be9d06ff5c07206b61f06d80a4cdd9a8"
]
}
[
{
"script": "8ca0d228066cfff2b7f31c7db7737185be9d06ff5c07206b61f06d80a4cdd9a8",
"result": [
{
"tx_hash": "4e6be25adf9b2bdf90a9f88e966f7cb5e9d71a22325c8a1e6d687f32aab340d4"
}
],
"error": ""
}
]
URL Parameters
The selected network: main or test.
Get Confirmed Script History
This endpoint retrieves the history of confirmed transactions for a given script. Pagination is available using the provided next-page token.
GET https://api.whatsonchain.com/v1/bsv/<network>/script/<scriptHash>/confirmed/history
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/script/0374d9ee2df8e5d7c5fd8359f33456996f2a1a9c76d9c783d2f8d5ee05ba5832/confirmed/history"
{
"result": [
{
"tx_hash": "6cc9631ef3dad77eb0141134167f20469d0b4e61405de57fe6a9ac71b943bb9f",
"height": 797518
}
]
}
URL Parameters
The selected network: main or test.
The script hash: Sha256 hash of the binary bytes of the locking script (ScriptPubKey), expressed as a hexadecimal string.
Ordering: asc or desc; default is desc.
Between 1 and 1000; default is 100.
Starting block height for history; default is 0.
Provided next page token.
Bulk Confirmed Script History
This endpoint retrieves the history of confirmed transactions for a given set of scripts.
Max 20 scripthashes per request.
Max 20 items returned per request.
POST https://api.whatsonchain.com/v1/bsv/<network>/scripts/confirmed/history
curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/scripts/confirmed/history" \
--header "Content-Type: application/json" \
--data "{\"scripts\" : [ \"8ca0d228066cfff2b7f31c7db7737185be9d06ff5c07206b61f06d80a4cdd9a8\" ] }"
Request body JSON structure
{
"scripts": [
"8ca0d228066cfff2b7f31c7db7737185be9d06ff5c07206b61f06d80a4cdd9a8"
]
}
[
{
"script": "8ca0d228066cfff2b7f31c7db7737185be9d06ff5c07206b61f06d80a4cdd9a8",
"result": [
{
"tx_hash": "4e6be25adf9b2bdf90a9f88e966f7cb5e9d71a22325c8a1e6d687f32aab340d4"
}
],
"error": ""
}
]
URL Parameters
The selected network: main or test.
(Deprecated) Get Script History
This endpoint is powered by ElectrumX and is planned for deprecation in the near future.
This endpoint retrieves both the confirmed and unconfirmed transactions for a given script.
GET https://api.whatsonchain.com/v1/bsv/<network>/script/<scriptHash>/history
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/script/995ea8d0f752f41cdd99bb9d54cb004709e04c7dc4088bcbbbb9ea5c390a43c3/history"
Returns a response as long as the response message is less than 1MB in size.
[
{
"tx_hash": "52dfceb815ad129a0fd946e3d665f44fa61f068135b9f38b05d3c697e11bad48",
"height": 620539
},
{
"tx_hash": "4ec3b63d764558303eda720e8e51f69bbcfe81376075657313fb587306f8a9b0",
"height": 620539
}
]
URL Parameters
The selected network: main or test.
The script hash: Sha256 hash of the binary bytes of the locking script (ScriptPubKey), expressed as a hexadecimal string.
Last updated