Address
Get Address Info
This endpoint retrieves various information for a given address.
GET https://api.whatsonchain.com/v1/<chain>/<network>/address/<address>/info
Example Request
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/16ZqP5Tb22KJuvSAbjNkoiZs13mmRmexZA/info"
Example Response
{
"isvalid": true,
"address": "16ZqP5Tb22KJuvSAbjNkoiZs13mmRmexZA",
"scriptPubKey": "76a9143d0e5368bdadddca108a0fe44739919274c726c788ac",
"ismine": false,
"iswatchonly": false,
"isscript": false
}
URL Parameters
chain
Desired blockchain: bsv
or btc
.
network
Selected network: main
or test
.
address
Address.
Get Address Usage Status
This endpoint serves as a usage status flag for a given address.
GET https://api.whatsonchain.com/v1/bsv/<network>/address/<address>/used
Example Request
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/174XactYXkNJkPYBpsPAuzHkwG5snmLNpC/used"
Example Response
true
URL Parameters
chain
Desired blockchain: bsv
or btc
.
network
Selected network: main
or test
.
address
Address.
Get Associated Script Hashes
There are some addresses that are associated with multiple script types. This endpoint returns a list of script hashes associated to the given address, and their types.
GET https://api.whatsonchain.com/v1/<chain>/<network>/address/<address>/scripts
Example Request
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX/scripts"
Example Response
[{
"script": "cc0d7111befe9f24f1824c797e837c5cff2f8773901ccb9aca0372a2a6c48d34",
"type": "pubkey"
}, {
"script": "55f4cd3dabddd62707b374f69f66b97f5f53dac5b204bd6c09dcad39b54862d1",
"type": "pubkeyhash"
}]
URL Parameters
chain
Desired blockchain: bsv
or btc
.
network
Selected network: main
or test
.
address
Address.
Download Statement (BSV-only)
You can download the statement (in PDF
) for a given address.
GET https://<network>.whatsonchain.com/statement/<address>
curl --location --request GET "https://main.whatsonchain.com/statement/16ZqP5Tb22KJuvSAbjNkoiZs13mmRmexZA"
URL Parameters
network
Selected network: main
or test
.
address
Address.
Get Unconfirmed Balance
This endpoint retrieves the unconfirmed balance for a given address.
GET https://api.whatsonchain.com/v1/bsv/<network>/address/<address>/unconfirmed/balance
Example Request
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/1QC6bjxvSBdiHqGM48t5RxjTEYW6BX4vu4/unconfirmed/balance"
Example Response
{
"address": "1QC6bjxvSBdiHqGM48t5RxjTEYW6BX4vu4",
"script": "f80a9ad71e1f2a5e83bfddb639e87e0c0bdeefd6f1b4f760dd0f88ccae3a8441",
"unconfirmed": 5842074,
"error": ""
}
URL Parameters
network
Selected network: main
or test
.
address
Address.
Bulk Unconfirmed Balance
This endpoint retrieves the unconfirmed balance for multiple addresses in a single request.
POST https://api.whatsonchain.com/v1/bsv/<network>/addresses/unconfirmed/balance
{
"addresses": [
"<addess>",
"<addess>",
...
]
}
Example Request
curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/addresses/unconfirmed/balance" \
--header "Content-Type: application/json" \
--data "{\"addresses\" : [\"1QC6bjxvSBdiHqGM48t5RxjTEYW6BX4vu4\", \"1AyWnLhRYqt5VcGvVmXpieCbY3agHk53cJ\"] }"
Example Response
[{
"address": "1QC6bjxvSBdiHqGM48t5RxjTEYW6BX4vu4",
"script": "f80a9ad71e1f2a5e83bfddb639e87e0c0bdeefd6f1b4f760dd0f88ccae3a8441",
"unconfirmed": 5836266,
"error": ""
}, {
"address": "1AyWnLhRYqt5VcGvVmXpieCbY3agHk53cJ",
"script": "a6595fcfa6ac7870f3caa04633b5d60dbbb219ecdd75fc09e0f790f35bc161bd",
"unconfirmed": 605968,
"error": ""
}]
URL Parameters
network
Selected network: main
or test
.
Get Confirmed Balance
This endpoint retrieves the confirmed balance for a given address.
GET https://api.whatsonchain.com/v1/<chain>/<network>/address/<address>/confirmed/balance
Example Request
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/1Dbj1LUxTqtuZ1U52KZiZChLPHkTAMiD6h/confirmed/balance"
Example Response
{
"address": "1Dbj1LUxTqtuZ1U52KZiZChLPHkTAMiD6h",
"script": "0374d9ee2df8e5d7c5fd8359f33456996f2a1a9c76d9c783d2f8d5ee05ba5832",
"confirmed": 181827,
"error": "",
"associatedScripts": [{
"script": "0374d9ee2df8e5d7c5fd8359f33456996f2a1a9c76d9c783d2f8d5ee05ba5832",
"type": "pubkeyhash"
}]
}
URL Parameters
chain
Desired blockchain: bsv
or btc
.
network
Selected network: main
or test
.
address
Address.
Bulk Confirmed Balance
This endpoint retrieves the confirmed balance for multiple addresses in a single request.
POST https://api.whatsonchain.com/v1/<chain>/<network>/addresses/confirmed/balance
{
"addresses": [
"<address>",
"<address>",
...
]
}
Example Request
curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/addresses/confirmed/balance" \
--header "Content-Type: application/json" \
--data "{\"addresses\" : [\"1KGHhLTQaPr4LErrvbAuGE62yPpDoRwrob\",\"1NQKomMAEPEq6jSdpRNFRjcKPvVvhUL33f\" ] }"
Example Response
[{
"address": "1KGHhLTQaPr4LErrvbAuGE62yPpDoRwrob",
"script": "4f8f588fc9bd7304dc73a14c5d3d0813e048986465e22587e3166ce04225a756",
"confirmed": 0,
"error": ""
}, {
"address": "1NQKomMAEPEq6jSdpRNFRjcKPvVvhUL33f",
"script": "c0f739302655f27531f70206e5f47dcfc22e8bdae6bcb143d62cef90040c2f9e",
"confirmed": 305718273076,
"error": ""
}]
URL Parameters
chain
Desired blockchain: bsv
or btc
.
network
Selected network: main
or test
.
Get Unconfirmed History
This endpoint retrieves unconfirmed transactions for a given address. Returns up to 100k results in one request.
GET https://api.whatsonchain.com/v1/bsv/<network>/address/<address>/unconfirmed/history
Example Request
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/1QC6bjxvSBdiHqGM48t5RxjTEYW6BX4vu4/unconfirmed/history"
Example Response
{
"address": "1QC6bjxvSBdiHqGM48t5RxjTEYW6BX4vu4",
"script": "f80a9ad71e1f2a5e83bfddb639e87e0c0bdeefd6f1b4f760dd0f88ccae3a8441",
"result": [{
"tx_hash": "2fde4146ae470efb337395987261b028c38e4e095b44ae3bc800c4073daf4730"
}, {
"tx_hash": "3570f77cc006b507b4198370b0f97adbbdf3a83c84fe3b72c1cb0579ec34ca9f"
},
...
],
"error": ""
}
URL Parameters
network
Selected network: main
or test
.
address
Address.
Bulk Unconfirmed History
This endpoint retrieves the history of unconfirmed transactions for a given set of addresses.
POST https://api.whatsonchain.com/v1/bsv/<network>/addresses/unconfirmed/history
{
"addresses": [
"<address>",
"<address>",
...
]
}
Example Request
curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/addresses/unconfirmed/history" \
--header "Content-Type: application/json" \
--data "{\"addresses\" : [ \"1QC6bjxvSBdiHqGM48t5RxjTEYW6BX4vu4\", \"1AyWnLhRYqt5VcGvVmXpieCbY3agHk53cJ\"] }"
Example Response
[{
"address": "1QC6bjxvSBdiHqGM48t5RxjTEYW6BX4vu4",
"script": "f80a9ad71e1f2a5e83bfddb639e87e0c0bdeefd6f1b4f760dd0f88ccae3a8441",
"result": [{
"tx_hash": "36f1ed66752c78c6d1e8e73a060002b056015ef646e01508e8802bd8cb180b2d"
}, {
"tx_hash": "2cd3963137335c982005fae40846c269cf022061cae0a28f7bccf6d53a0252c6"
},
...
],
"nextPageToken": "890dc80865d1259528b1ec07e82d02efb77f1bcd9dbd714874bf1d00a54106f5",
"error": ""
}, {
"address": "1AyWnLhRYqt5VcGvVmXpieCbY3agHk53cJ",
"script": "a6595fcfa6ac7870f3caa04633b5d60dbbb219ecdd75fc09e0f790f35bc161bd",
"result": [{
"tx_hash": "2fde4146ae470efb337395987261b028c38e4e095b44ae3bc800c4073daf4730"
}, {
"tx_hash": "3570f77cc006b507b4198370b0f97adbbdf3a83c84fe3b72c1cb0579ec34ca9f"
},
...
],
"error": ""
}]
URL Parameters
network
Selected network: main
or test
.
Get Confirmed History
This endpoint retrieves confirmed transactions for a given address. Pagination is available using the provided next-page
token.
GET https://api.whatsonchain.com/v1/<chain>/<network>/address/<address>/confirmed/history
Example Request
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/1Dbj1LUxTqtuZ1U52KZiZChLPHkTAMiD6h/confirmed/history"
Example Response
{
"address": "1Dbj1LUxTqtuZ1U52KZiZChLPHkTAMiD6h",
"script": "0374d9ee2df8e5d7c5fd8359f33456996f2a1a9c76d9c783d2f8d5ee05ba5832",
"result": [{
"tx_hash": "6cc9631ef3dad77eb0141134167f20469d0b4e61405de57fe6a9ac71b943bb9f",
"height": 797518
}],
"error": ""
}
URL Parameters
chain
Desired blockchain: bsv
or btc
.
network
Selected network: main
or test
.
address
Address.
order
Ordering: asc
or desc
(default).
limit (optional)
Between 1
and 1000
; default is 100
.
height (optional)
Starting block height for history; default is 0
.
token
Provided next-page
token.
Bulk Confirmed History
This endpoint retrieves the history of confirmed transactions for a given set of addresses.
POST https://api.whatsonchain.com/v1/<chain>/<network>/addresses/confirmed/history
{
"addresses": [
"<address>",
"<address>",
...
]
}
Example Request
curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/addresses/confirmed/history" \
--header "Content-Type: application/json" \
--data "{\"addresses\" : [ \"16ZBEb7pp6mx5EAGrdeKivztd5eRJFuvYP\", \"1CQuHnTR1HExx9KBvwuzeERx7CZmVkFtPs\" ] }"
Example Response
[{
"address": "16ZBEb7pp6mx5EAGrdeKivztd5eRJFuvYP",
"script": "c7713679ea48e31aec663612f5cbaeb86f9241677c0397b42d957545b47ca2fe",
"result": [{
"tx_hash": "6216506e2b5ef029595e1b29a20c279889873a9da4e98bcb5c619a4756ab6932",
"height": 658093
}, {
"tx_hash": "df860638d1530d2ba1f25d167fa24bbef3b1387e94207ee5e11fa535413aff39",
"height": 658093
}],
"error": ""
}, {
"address": "1CQuHnTR1HExx9KBvwuzeERx7CZmVkFtPs",
"script": "6b854b53cdea2cca701bb62d792b1dbbbf9e84f6049f93afe17734b5bc4ab08f",
"result": [{
"tx_hash": "817bc35394ce8ad598d7dfe37efc01f719bc1caa079d7f83ea3c51254af40277",
"height": 666566
}, {
"tx_hash": "b781592ecb45b7587729e7e7b764e6e369f0259b3323470292c004410a4e0ddb",
"height": 666566
},
...
],
"nextPageToken": "00000000de0000004c00000001000000400000003662383534623533636465613263636137303162623632643739326231646262626639653834663630343966393361666531373733346235626334616230386601180000000200000004000000000a2bc60400000000005f4cebffffff4b40922badad1114d77dbb7f48be9882010000003900000001190000001400000001000000080000009923897a084cde8f0101190000001400000001000000080000009923897a084cde8f010101000000ed4bed6135c0ae12f382dd544c57ef9a010000000000ffffffff000000000002",
"error": ""
}]
URL Parameters
chain
Desired blockchain: bsv
or btc
.
network
Selected network: main
or test
.
Bulk History
This endpoint retrieves the history of both confirmed and unconfirmed transactions for a given set of addresses.
POST https://api.whatsonchain.com/v1/bsv/<network>/addresses/history/all
{
"addresses": [
"<address>",
"<address>",
..
]
}
Example Request
curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/addresses/history/all" \
--header "Content-Type: application/json" \
--data "{\"addresses\" : [ \"16ZBEb7pp6mx5EAGrdeKivztd5eRJFuvYP\", \"19SsDUJ29XM2VDCkZKnTXJ9Zjt3gMtnrwC\" ] }"
Example Response
[{
"address": "16ZBEb7pp6mx5EAGrdeKivztd5eRJFuvYP",
"script": "c7713679ea48e31aec663612f5cbaeb86f9241677c0397b42d957545b47ca2fe",
"unconfirmed": {
"result": [],
"error": ""
},
"confirmed": {
"result": [{
"tx_hash": "6216506e2b5ef029595e1b29a20c279889873a9da4e98bcb5c619a4756ab6932",
"height": 658093
}, {
"tx_hash": "df860638d1530d2ba1f25d167fa24bbef3b1387e94207ee5e11fa535413aff39",
"height": 658093
}],
"error": ""
}
}, {
"address": "19SsDUJ29XM2VDCkZKnTXJ9Zjt3gMtnrwC",
"script": "9ad0daaac33264199ce40596970c5ccf0096eb05b9b020002a3f1c2202841ef9",
"unconfirmed": {
"result": [],
"error": ""
},
"confirmed": {
"result": [{
"tx_hash": "06f978c8758b45aa298e74d2951123811da06d9b22ad433fcaeceb90fb3db6cd",
"height": 825487
}, {
"tx_hash": "064cad8a9ff3caad45579ee514d6a352f402ab02ed355bc9d4f9fce3eac07813",
"height": 825488
}],
"error": ""
}
}]
URL Parameters
network
Selected network: main
or test
.
Last updated
Was this helpful?