Links

Script

Get Script Usage Status

This endpoint serves as a usage status flag for a given script.
HTTP Request
GET https://api.whatsonchain.com/v1/bsv/<network>/script/<scriptHash>/used
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/script/3a9b9e2285ae40de7679e48efcef7d029a46a7b3120063a6d24347ce4452e6ee/used"
Response JSON structure
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.

Get Unconfirmed Script History (Beta)

This endpoint retrieves the history of unconfirmed transactions 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/history
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/script/0374d9ee2df8e5d7c5fd8359f33456996f2a1a9c76d9c783d2f8d5ee05ba5832/unconfirmed/history"
Response JSON structure
{
"result": [
{
"tx_hash": "93d8ae93a9e074c555d80e86c130b6cd4d5c7efa2795f91b2aea285c546512c6"
},
{
"tx_hash": "6bcd7708adf5c8c00d299628ef86fa5d982ccd1909254f46ea0f0a70c4c319f7"
},
{
"tx_hash": "cf1f1fd7962aeac56932b0e522d83c163d89873f2e26a1519bcc0d88772d0e78"
},
...
]
}
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 Script History (Beta)

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.
HTTP Request
POST https://api.whatsonchain.com/v1/bsv/<network>/scripts/unconfirmed/history
cURL
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"
]
}
Response JSON structure
[
{
"script": "8ca0d228066cfff2b7f31c7db7737185be9d06ff5c07206b61f06d80a4cdd9a8",
"result": [
{
"tx_hash": "4e6be25adf9b2bdf90a9f88e966f7cb5e9d71a22325c8a1e6d687f32aab340d4"
}
],
"error": ""
}
]
URL Parameters
Parameter
Description
network
The selected network: main or test.

Get Confirmed Script History (Beta)

This endpoint retrieves the history of confirmed transactions for a given script. Pagination is available using the provided next-page token.
HTTP Request
GET https://api.whatsonchain.com/v1/bsv/<network>/script/<scriptHash>/confirmed/history
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/script/0374d9ee2df8e5d7c5fd8359f33456996f2a1a9c76d9c783d2f8d5ee05ba5832/confirmed/history"
Response JSON structure
{
"result": [
{
"tx_hash": "6cc9631ef3dad77eb0141134167f20469d0b4e61405de57fe6a9ac71b943bb9f",
"height": 797518
}
]
}
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.
order
Ordering: asc or desc; default is desc.
limit
Between 1 and 1000; default is 100.
height
Starting block height for history; default is 0.
token
Provided next page token.

Bulk Confirmed Script History (Beta)

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.
HTTP Request
POST https://api.whatsonchain.com/v1/bsv/<network>/scripts/confirmed/history
cURL
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"
]
}
Response JSON structure
[
{
"script": "8ca0d228066cfff2b7f31c7db7737185be9d06ff5c07206b61f06d80a4cdd9a8",
"result": [
{
"tx_hash": "4e6be25adf9b2bdf90a9f88e966f7cb5e9d71a22325c8a1e6d687f32aab340d4"
}
],
"error": ""
}
]
URL Parameters
Parameter
Description
network
The selected network: main or test.

(Planned for deprecation) 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.
HTTP Request
GET https://api.whatsonchain.com/v1/bsv/<network>/script/<scriptHash>/history
cURL
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.
Response JSON structure
[
{
"tx_hash": "52dfceb815ad129a0fd946e3d665f44fa61f068135b9f38b05d3c697e11bad48",
"height": 620539
},
{
"tx_hash": "4ec3b63d764558303eda720e8e51f69bbcfe81376075657313fb587306f8a9b0",
"height": 620539
}
]
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.