Address
Get Address Info
This endpoint retrieves various information for a given address.
GET https://api.whatsonchain.com/v1/<chain>/<network>/address/<address>/infoExample Request
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/16ZqP5Tb22KJuvSAbjNkoiZs13mmRmexZA/info"curl --location --request GET "https://api.whatsonchain.com/v1/btc/main/address/381qVpM6titKUxxsN7cYcZwo5wYN8CMs3J/info"Example Response
{
"isvalid": true,
"address": "16ZqP5Tb22KJuvSAbjNkoiZs13mmRmexZA",
"scriptPubKey": "76a9143d0e5368bdadddca108a0fe44739919274c726c788ac",
"ismine": false,
"iswatchonly": false,
"isscript": false
}{
"isvalid": true,
"address": "381qVpM6titKUxxsN7cYcZwo5wYN8CMs3J",
"ismine": false,
"iswatchonly": false,
"isscript": true,
"witness_version": 0,
"iswitness": false,
"witness_program": "",
"scriptPubKey": "a914455ff45b915000add09a1d1a014ec57f6ee38dcb87"
}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.
Example Request
Example Response
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.
Example Request
Example Response
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.
URL Parameters
network
Selected network: main or test.
address
Address.
Get Unconfirmed Balance
This endpoint retrieves the unconfirmed balance for a given address.
Example Request
Example Response
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.
Example Request
Example Response
URL Parameters
network
Selected network: main or test.
Get Confirmed Balance
This endpoint retrieves the confirmed balance for a given address.
Example Request
Example Response
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.
Example Request
Example Response
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.
Example Request
Example Response
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.
Example Request
Example Response
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.
Example Request
Example Response
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.
Example Request
Example Response
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.
Example Request
Example Response
URL Parameters
network
Selected network: main or test.
Last updated