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
}

{
    "isvalid": true,
    "address": "381qVpM6titKUxxsN7cYcZwo5wYN8CMs3J",
    "ismine": false,
    "iswatchonly": false,
    "isscript": true,
    "witness_version": 0,
    "iswitness": false,
    "witness_program": "",
    "scriptPubKey": "a914455ff45b915000add09a1d1a014ec57f6ee38dcb87"
}

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.

HTTP Request

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

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.

HTTP Request

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

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.

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

Selected network: main or test.

address

Address.

Get Unconfirmed Balance

This endpoint retrieves the unconfirmed balance for a given address.

HTTP Request

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

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.

Max 20 addresses per request.

HTTP Request

POST https://api.whatsonchain.com/v1/bsv/<network>/addresses/unconfirmed/balance

Request Data

{
    "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\"] }"

curl --location --request POST "https://api.whatsonchain.com/v1/btc/main/addresses/unconfirmed/balance" \
  --header "Content-Type: application/json" \
  --data "{\"addresses\" : [\"bc1qju8ttjzcucwvums0cxy3gsp0vt52sgyd2glyv6\", \"bc1qm9cvc9v7yczthvn40jf40hvt3unqd67649ytx7\"] }"

Example Response

[{
    "address": "1QC6bjxvSBdiHqGM48t5RxjTEYW6BX4vu4",
    "script": "f80a9ad71e1f2a5e83bfddb639e87e0c0bdeefd6f1b4f760dd0f88ccae3a8441",
    "unconfirmed": 5836266,
    "error": ""
}, {
    "address": "1AyWnLhRYqt5VcGvVmXpieCbY3agHk53cJ",
    "script": "a6595fcfa6ac7870f3caa04633b5d60dbbb219ecdd75fc09e0f790f35bc161bd",
    "unconfirmed": 605968,
    "error": ""
}]

[{
    "address": "bc1qju8ttjzcucwvums0cxy3gsp0vt52sgyd2glyv6",
    "script": "71789d552fae15cc11e9a77599dfe7794884802d0b68c7a9ae6863ae9ca17dac",
    "unconfirmed": 820000,
    "error": ""
}, {
    "address": "bc1qm9cvc9v7yczthvn40jf40hvt3unqd67649ytx7",
    "script": "c6968cde45ab187c03f2a130858e7f88a14c158867135cb0527b3d622ebb1a7a",
    "unconfirmed": 990000,
    "error": ""
}]

URL Parameters

Parameter

Description

network

Selected network: main or test.

Get Confirmed Balance

This endpoint retrieves the confirmed balance for a given address.

HTTP Request

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

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.

Max 20 addresses per request.

HTTP Request

POST https://api.whatsonchain.com/v1/<chain>/<network>/addresses/confirmed/balance

Request Data

{
    "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\" ] }"

curl --location --request POST "https://api.whatsonchain.com/v1/btc/main/addresses/confirmed/balance" \
  --header "Content-Type: application/json" \
  --data "{\"addresses\" : [\"3MqUP6G1daVS5YTD8fz3QgwjZortWwxXFd\",\"1DPexcq8rkPn5mXV6hPr9mpL3b5j26JG4N\" ] }"

Example Response

[{
    "address": "1KGHhLTQaPr4LErrvbAuGE62yPpDoRwrob",
    "script": "4f8f588fc9bd7304dc73a14c5d3d0813e048986465e22587e3166ce04225a756",
    "confirmed": 0,
    "error": ""
}, {
    "address": "1NQKomMAEPEq6jSdpRNFRjcKPvVvhUL33f",
    "script": "c0f739302655f27531f70206e5f47dcfc22e8bdae6bcb143d62cef90040c2f9e",
    "confirmed": 305718273076,
    "error": ""
}]

[{
    "address": "3MqUP6G1daVS5YTD8fz3QgwjZortWwxXFd",
    "script": "d9d46113eb0f3759c0dabf23b87b58a4c76a0633d13add20922cc5f6ede8ddd9",
    "confirmed": 56555981260,
    "error": ""
}, {
    "address": "1DPexcq8rkPn5mXV6hPr9mpL3b5j26JG4N",
    "script": "8722be669964f355ced09afef9d40cefbc49fe96121c78d1405ce0857d77624e",
    "confirmed": 4382070173,
    "error": ""
}]

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.

HTTP 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": ""
}

{
    "address": "16AvgD6VzCkQaJEgTAJrERt1f9RSuJ9Dg5",
    "script": "02f81194bd8a705cb6edf1da950400e51e65f052f06380133504839d4b5cbc36",
    "result": [{
        "tx_hash": "ac69c967982a0dcd9a3d2ef99b52f5b4dfd0f0d9eb0b44d1744d92cf79ba2308"
    }],
    "error": ""
}

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.

Max 20 addresses per request.
Max 100 items returned per request.

HTTP Request

POST https://api.whatsonchain.com/v1/bsv/<network>/addresses/unconfirmed/history

Request Data

{
    "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\"] }"

curl --location --request POST "https://api.whatsonchain.com/v1/btc/main/addresses/unconfirmed/history" \
  --header "Content-Type: application/json" \
  --data "{\"addresses\" : [ \"16AvgD6VzCkQaJEgTAJrERt1f9RSuJ9Dg5\", \"bc1qww3yxs7cx3hce445azx965se5msk6x6tqqfmq8\"] }"

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": ""
}]

[{
    "address": "16AvgD6VzCkQaJEgTAJrERt1f9RSuJ9Dg5",
    "script": "02f81194bd8a705cb6edf1da950400e51e65f052f06380133504839d4b5cbc36",
    "result": [{
        "tx_hash": "ac69c967982a0dcd9a3d2ef99b52f5b4dfd0f0d9eb0b44d1744d92cf79ba2308"
    }],
    "error": ""
}, {
    "address": "bc1qww3yxs7cx3hce445azx965se5msk6x6tqqfmq8",
    "script": "9ed63d5c4771581e454f3343de70e5d7967832dc3de1f8002d3d8a89dc23cec3",
    "result": [{
        "tx_hash": "ac69c967982a0dcd9a3d2ef99b52f5b4dfd0f0d9eb0b44d1744d92cf79ba2308"
    }],
    "error": ""
}]

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.

HTTP Request

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": ""
}

{
    "address": "bc1q6yxjfhj94w5ej79nvuls9fsyt33k8knp8yu594",
    "script": "81e6f015f6ad293f6eb863f76bf2d3b53722974d3b040cb397030164102eb2f0",
    "result": [{
        "tx_hash": "705ecc93d7a9866b5a42b7d67802824d1f901ee782099c46dd7c1c40b2d1a8a7",
        "height": 770399
    }, {
        "tx_hash": "972185013aac0a709c426ec26c1cdf48a5baa34ae386d969e9b83ede7642b644",
        "height": 770679
    },
    ...
    ],
    "error": ""
}

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.

Max 20 addresses per request.
Max 20 items returned per request.
For pagination please use the single address endpoint.

HTTP Request

POST https://api.whatsonchain.com/v1/<chain>/<network>/addresses/confirmed/history

Request Data

{
    "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\" ] }"

curl --location --request POST "https://api.whatsonchain.com/v1/btc/main/addresses/confirmed/history" \
  --header "Content-Type: application/json" \
  --data "{\"addresses\" : [ \"bc1q6yxjfhj94w5ej79nvuls9fsyt33k8knp8yu594\", \"3PWuL3LkpvUwPYQw43h1oAuFkBc2x8EFr6\" ] }"

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": ""
}]

[{
    "address": "bc1q6yxjfhj94w5ej79nvuls9fsyt33k8knp8yu594",
    "script": "81e6f015f6ad293f6eb863f76bf2d3b53722974d3b040cb397030164102eb2f0",
    "result": [{
        "tx_hash": "e5f8afed665da723421226c1d8d7c9e78dffaff0215d09d38041ee951ee5bed0",
        "height": 899701
    }, {
        "tx_hash": "16b6e3a92cc549a7b392f3ce703201b7b4c14621fc1d2629f8ef29c4648a02da",
        "height": 858541
    },
    ...
    ],
    "error": ""
}, {
    "address": "3PWuL3LkpvUwPYQw43h1oAuFkBc2x8EFr6",
    "script": "b57c68f5c74e4c58cce13c93d9c8356f9c23bdcb8cd9e6de07f9e1530db6ae28",
    "result": [{
        "tx_hash": "5eb4cd7446cc5aff11f3154eac6876dd6d9fc7167e1d3d8a48078b07f761f1ad",
        "height": 848507
    }, {
        "tx_hash": "ce1a42ec6ce4ed712f86b518eeb4201af26e16918387d3d0d8ae4ad7f874bbfd",
        "height": 847976
    },
    ...
    ],
    "nextPageToken": "00000000de0000004c00000001000000400000006235376336386635633734653463353863636531336339336439633833353666396332336264636238636439653664653037663965313533306462366165323801180000000200000004000000000cf27b040000000000024bebffffff794de2f3d61b0fda5d1dc1c8398b9390010000003900000001190000001400000001000000080000002890c2ca153d9e520101190000001400000001000000080000002890c2ca153d9e52010101000000164715117e017b366640b372f29546ae010000000000ffffffff000000000002",
    "error": ""
}]

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.

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.

HTTP Request

POST https://api.whatsonchain.com/v1/bsv/<network>/addresses/history/all

Request Data

{
    "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\" ] }"

curl --location --request POST "https://api.whatsonchain.com/v1/btc/main/addresses/history/all" \
  --header "Content-Type: application/json" \
  --data "{\"addresses\" : [ \"16AvgD6VzCkQaJEgTAJrERt1f9RSuJ9Dg5\", \"bc1qww3yxs7cx3hce445azx965se5msk6x6tqqfmq8\" ] }"

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": ""
    }
}]

[{
    "address": "16AvgD6VzCkQaJEgTAJrERt1f9RSuJ9Dg5",
    "script": "02f81194bd8a705cb6edf1da950400e51e65f052f06380133504839d4b5cbc36",
    "unconfirmed": {
        "result": [{
            "tx_hash": "ac69c967982a0dcd9a3d2ef99b52f5b4dfd0f0d9eb0b44d1744d92cf79ba2308"
        }],
        "error": ""
    },
    "confirmed": {
        "result": [{
            "tx_hash": "ac69c967982a0dcd9a3d2ef99b52f5b4dfd0f0d9eb0b44d1744d92cf79ba2308",
            "height": 905522
        }],
        "error": ""
    }
}, {
    "address": "bc1qww3yxs7cx3hce445azx965se5msk6x6tqqfmq8",
    "script": "9ed63d5c4771581e454f3343de70e5d7967832dc3de1f8002d3d8a89dc23cec3",
    "unconfirmed": {
        "result": [{
            "tx_hash": "ac69c967982a0dcd9a3d2ef99b52f5b4dfd0f0d9eb0b44d1744d92cf79ba2308"
        }],
        "error": ""
    },
    "confirmed": {
        "result": [{
            "tx_hash": "ac69c967982a0dcd9a3d2ef99b52f5b4dfd0f0d9eb0b44d1744d92cf79ba2308",
            "height": 905522
        }],
        "error": ""
    }
}]

URL Parameters

Parameter

Description

network

Selected network: main or test.

Last updated 3 months ago

Was this helpful?