Address

Get Address Info

This endpoint retrieves various information for a given address.

HTTP Request
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

Parameter
Description

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

Parameter
Description

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

Parameter
Description

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

Parameter
Description

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

Parameter
Description

network

Selected network: main or test.

address

Address.

Bulk Unconfirmed Balance

This endpoint retrieves the unconfirmed balance for multiple addresses in a single request.

circle-info

Max 20 addresses per request.

Example Request

Example Response

URL Parameters

Parameter
Description

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

Parameter
Description

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.

circle-info

Max 20 addresses per request.

Example Request

Example Response

URL Parameters

Parameter
Description

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

Parameter
Description

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.

circle-info
  • Max 20 addresses per request.

  • Max 100 items returned per request.

Example Request

Example Response

URL Parameters

Parameter
Description

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

Parameter
Description

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.

circle-info
  • Max 20 addresses per request.

  • Max 20 items returned per request.

  • For pagination please use the single address endpoint.

Example Request

Example Response

URL Parameters

Parameter
Description

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.

circle-info
  • Max 20 addresses per request.

  • Max 1000 confirmed and max 1000 unconfirmed history items returned per request.

  • Page tokens provided if address contains more items than above.

  • Call standard individual unconfirmed and confirmed endpoints with page token for more history if required.

Example Request

Example Response

URL Parameters

Parameter
Description

network

Selected network: main or test.

Last updated

Was this helpful?