Links

Address

Get Address Info

This endpoint retrieves various information for a given address.
HTTP Request
GET https://api.whatsonchain.com/v1/bsv/<network>/address/<address>/info
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/16ZqP5Tb22KJuvSAbjNkoiZs13mmRmexZA/info"
Response JSON structure
{
"address": "16ZqP5Tb22KJuvSAbjNkoiZs13mmRmexZA",
"ismine": false,
"isscript": false,
"isvalid": true,
"iswatchonly": false,
"scriptPubKey": "76a9143d0e5368bdadddca108a0fe44739919274c726c788ac"
}
URL Parameters
Parameter
Description
network
The selected network: main or test.
address
The address

Get Address Usage Status

This endpoint serves as a usage status flag for a given address.
HTTP Request
GET https://api.whatsonchain.com/v1/bsv/<network>/address/<address>/used
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/174XactYXkNJkPYBpsPAuzHkwG5snmLNpC/used"
Response JSON structure
true
URL Parameters
Parameter
Description
network
The selected network: main or test.
address
The address

Get Balance

This endpoint retrieves both the confirmed and unconfirmed balance for a given address.
HTTP Request
GET https://api.whatsonchain.com/v1/bsv/<network>/address/<address>/balance
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/1GJ3x5bcEnKMnzNFPPELDfXUCwKEaLHM5H/balance"
Response JSON structure
{
"confirmed":533134093647,
"unconfirmed":0
}
URL Parameters
Parameter
Description
network
The selected network: main or test.
address
The address

Get Mempool Balance (Beta)

This endpoint retrieves the unconfirmed balance for a given address.
HTTP Request
GET https://api.whatsonchain.com/v1/bsv/<network>/address/<address>/unconfirmed/balance
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/1Dbj1LUxTqtuZ1U52KZiZChLPHkTAMiD6h/unconfirmed/balance"
Response JSON structure
{
"unconfirmed": 103
}
URL Parameters
Parameter
Description
network
The selected network: main or test.
address
The address

Bulk Balance

This endpoint retrieves both the confirmed and unconfirmed balance for multiple addresses in a single request.
  • Max 20 addresses per request.
HTTP Request
POST https://api.whatsonchain.com/v1/bsv/<network>/addresses/balance
cURL
curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/addresses/balance" \
--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",
"balance": {
"confirmed": 450000,
"unconfirmed": 0
},
"error": ""
},
{
"address": "1KGHhLTQaPr4LErrvbAuGE62yPpDoRwrob",
"balance": {
"confirmed": 0,
"unconfirmed": 0
},
"error": ""
}
]
URL Parameters
Parameter
Description
network
The selected network: main, test, or stn.

Get History

This endpoint retrieves both confirmed and unconfirmed transactions for a given address.
HTTP Request
GET https://api.whatsonchain.com/v1/bsv/<network>/address/<address>/history
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/1GJ3x5bcEnKMnzNFPPELDfXUCwKEaLHM5H/history"
Returns a response as long as the response message is less than 1MB in size.
Response JSON structure
[
{
"tx_hash": "2b5ccedd76ba0d524d95ecce1c8a76e5888e0f13591734be0169ba0220c69208",
"height": 573216
},
{
"tx_hash": "7fe815e14b32aaaecc2cca7ed605ed612b532765710917cb711ea71cf55e36b5",
"height": 573229
},
{
"tx_hash": "b28dd1723d0d1fa6e4b2875f7419028c1c1441fc02469aebc444c0a42d0bac3f",
"height": 573230
},
...
]
URL Parameters
Parameter
Description
network
The selected network: main or test.
address
The address

Get Mempool History (Beta)

This endpoint retrieves unconfirmed transactions 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/history
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/1Dbj1LUxTqtuZ1U52KZiZChLPHkTAMiD6h/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.
address
The address

Get Unspent Transactions

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

Get Unspent Mempool Transactions (Beta)

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 Unspent Transactions

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, test, or stn.

Download Statement

You can download the statement (in PDF) for a given address.
HTTP Request
GET https://<network>.whatsonchain.com/statement/<address>
cURL
curl --location --request GET "https://main.whatsonchain.com/statement/16ZqP5Tb22KJuvSAbjNkoiZs13mmRmexZA"
URL Parameters
Parameter
Description
network
The selected network: main or test.
address
The address
Last modified 2mo ago