# Address

## Get Address Info

This endpoint retrieves various information for a given address.

{% code title="HTTP Request" %}

```
GET https://api.whatsonchain.com/v1/<chain>/<network>/address/<address>/info
```

{% endcode %}

#### Example Request

{% tabs %}
{% tab title="BSV" %}

```sh
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/16ZqP5Tb22KJuvSAbjNkoiZs13mmRmexZA/info"
```

{% endtab %}

{% tab title="BTC" %}

```sh
curl --location --request GET "https://api.whatsonchain.com/v1/btc/main/address/381qVpM6titKUxxsN7cYcZwo5wYN8CMs3J/info"
```

{% endtab %}
{% endtabs %}

#### Example Response

{% tabs %}
{% tab title="BSV" %}

```json
{
    "isvalid": true,
    "address": "16ZqP5Tb22KJuvSAbjNkoiZs13mmRmexZA",
    "scriptPubKey": "76a9143d0e5368bdadddca108a0fe44739919274c726c788ac",
    "ismine": false,
    "iswatchonly": false,
    "isscript": false
}
```

{% endtab %}

{% tab title="BTC" %}

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

{% endtab %}
{% endtabs %}

**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.

{% code title="HTTP Request" %}

```
GET https://api.whatsonchain.com/v1/bsv/<network>/address/<address>/used
```

{% endcode %}

#### Example Request

{% tabs %}
{% tab title="BSV" %}

```sh
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/174XactYXkNJkPYBpsPAuzHkwG5snmLNpC/used"
```

{% endtab %}

{% tab title="BTC" %}

```sh
curl --location --request GET "https://api.whatsonchain.com/v1/btc/main/address/3MqUP6G1daVS5YTD8fz3QgwjZortWwxXFd/used"
```

{% endtab %}
{% endtabs %}

#### Example Response

{% tabs %}
{% tab title="BSV" %}

```
true
```

{% endtab %}

{% tab title="BTC" %}

```
true
```

{% endtab %}
{% endtabs %}

**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.

{% code title="HTTP Request" %}

```
GET https://api.whatsonchain.com/v1/<chain>/<network>/address/<address>/scripts
```

{% endcode %}

#### Example Request

{% tabs %}
{% tab title="BSV" %}

```sh
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX/scripts"
```

{% endtab %}

{% tab title="BTC" %}

```sh
curl --location --request GET "https://api.whatsonchain.com/v1/btc/main/address/bc1q695z03z6kweljcvpwft7vfu6kd0guf24yaaht2/scripts"
```

{% endtab %}
{% endtabs %}

#### Example Response

{% tabs %}
{% tab title="BSV" %}

```json
[{
    "script": "cc0d7111befe9f24f1824c797e837c5cff2f8773901ccb9aca0372a2a6c48d34",
    "type": "pubkey"
}, {
    "script": "55f4cd3dabddd62707b374f69f66b97f5f53dac5b204bd6c09dcad39b54862d1",
    "type": "pubkeyhash"
}]
```

{% endtab %}

{% tab title="BTC" %}

```json
[{
    "script": "cf869569e05c0efe7d40dc0add9b7a52d0193fbb022070cc7b54f96e9eb1cd8f",
    "type": "witness_v0_keyhash"
}]
```

{% endtab %}
{% endtabs %}

**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.

{% code title="HTTP Request" %}

```
GET https://<network>.whatsonchain.com/statement/<address>
```

{% endcode %}

{% code title="cURL" %}

```shell
curl --location --request GET  "https://main.whatsonchain.com/statement/16ZqP5Tb22KJuvSAbjNkoiZs13mmRmexZA"
```

{% endcode %}

**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.

{% code title="HTTP Request" %}

```
GET https://api.whatsonchain.com/v1/bsv/<network>/address/<address>/unconfirmed/balance
```

{% endcode %}

#### Example Request

{% tabs %}
{% tab title="BSV" %}

```sh
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/1QC6bjxvSBdiHqGM48t5RxjTEYW6BX4vu4/unconfirmed/balance"
```

{% endtab %}

{% tab title="BTC" %}

```sh
curl --location --request GET "https://api.whatsonchain.com/v1/btc/main/address/bc1qju8ttjzcucwvums0cxy3gsp0vt52sgyd2glyv6/unconfirmed/balance"
```

{% endtab %}
{% endtabs %}

#### Example Response

{% tabs %}
{% tab title="BSV" %}

```json
{
    "address": "1QC6bjxvSBdiHqGM48t5RxjTEYW6BX4vu4",
    "script": "f80a9ad71e1f2a5e83bfddb639e87e0c0bdeefd6f1b4f760dd0f88ccae3a8441",
    "unconfirmed": 5842074,
    "error": ""
}
```

{% endtab %}

{% tab title="BTC" %}

```json
{
    "address": "bc1qju8ttjzcucwvums0cxy3gsp0vt52sgyd2glyv6",
    "script": "71789d552fae15cc11e9a77599dfe7794884802d0b68c7a9ae6863ae9ca17dac",
    "unconfirmed": 820000,
    "error": ""
}
```

{% endtab %}
{% endtabs %}

**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.

{% hint style="info" %}
Max 20 addresses per request.
{% endhint %}

{% code title="HTTP Request" %}

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

{% endcode %}

{% code title="Request Data" %}

```json
{
    "addresses": [
        "<addess>",
        "<addess>",
        ...
    ]
}
```

{% endcode %}

#### Example Request

{% tabs %}
{% tab title="BSV" %}

```sh
curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/addresses/unconfirmed/balance" \
  --header "Content-Type: application/json" \
  --data "{\"addresses\" : [\"1QC6bjxvSBdiHqGM48t5RxjTEYW6BX4vu4\", \"1AyWnLhRYqt5VcGvVmXpieCbY3agHk53cJ\"] }"
```

{% endtab %}

{% tab title="BTC" %}

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

{% endtab %}
{% endtabs %}

#### Example Response

{% tabs %}
{% tab title="BSV" %}

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

{% endtab %}

{% tab title="BTC" %}

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

{% endtab %}
{% endtabs %}

**URL Parameters**

| Parameter | Description                         |
| --------- | ----------------------------------- |
| network   | Selected network: `main` or `test`. |

## Get Confirmed Balance

This endpoint retrieves the confirmed balance for a given address.

{% code title="HTTP Request" %}

```
GET https://api.whatsonchain.com/v1/<chain>/<network>/address/<address>/confirmed/balance
```

{% endcode %}

#### Example Request

{% tabs %}
{% tab title="BSV" %}

```sh
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/1Dbj1LUxTqtuZ1U52KZiZChLPHkTAMiD6h/confirmed/balance"
```

{% endtab %}

{% tab title="BTC" %}

```sh
curl --location --request GET "https://api.whatsonchain.com/v1/btc/main/address/3MqUP6G1daVS5YTD8fz3QgwjZortWwxXFd/confirmed/balance"
```

{% endtab %}
{% endtabs %}

#### Example Response

{% tabs %}
{% tab title="BSV" %}

```json
{
    "address": "1Dbj1LUxTqtuZ1U52KZiZChLPHkTAMiD6h",
    "script": "0374d9ee2df8e5d7c5fd8359f33456996f2a1a9c76d9c783d2f8d5ee05ba5832",
    "confirmed": 181827,
    "error": "",
    "associatedScripts": [{
        "script": "0374d9ee2df8e5d7c5fd8359f33456996f2a1a9c76d9c783d2f8d5ee05ba5832",
        "type": "pubkeyhash"
    }]
}
```

{% endtab %}

{% tab title="BTC" %}

```json
{
    "address": "3MqUP6G1daVS5YTD8fz3QgwjZortWwxXFd",
    "script": "d9d46113eb0f3759c0dabf23b87b58a4c76a0633d13add20922cc5f6ede8ddd9",
    "confirmed": 56555981260,
    "error": ""
}
```

{% endtab %}
{% endtabs %}

**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.

{% hint style="info" %}
Max 20 addresses per request.
{% endhint %}

{% code title="HTTP Request" %}

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

{% endcode %}

{% code title="Request Data" %}

```json
{
    "addresses": [
        "<address>",
        "<address>",
        ...
    ]
}
```

{% endcode %}

#### Example Request

{% tabs %}
{% tab title="BSV" %}

```sh
curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/addresses/confirmed/balance" \
  --header "Content-Type: application/json" \
  --data "{\"addresses\" : [\"1KGHhLTQaPr4LErrvbAuGE62yPpDoRwrob\",\"1NQKomMAEPEq6jSdpRNFRjcKPvVvhUL33f\" ] }"
```

{% endtab %}

{% tab title="BTC" %}

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

{% endtab %}
{% endtabs %}

#### Example Response

{% tabs %}
{% tab title="BSV" %}

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

{% endtab %}

{% tab title="BTC" %}

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

{% endtab %}
{% endtabs %}

**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.

{% code title="HTTP Request" %}

```
GET https://api.whatsonchain.com/v1/bsv/<network>/address/<address>/unconfirmed/history
```

{% endcode %}

#### Example Request

{% tabs %}
{% tab title="BSV" %}

```sh
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/1QC6bjxvSBdiHqGM48t5RxjTEYW6BX4vu4/unconfirmed/history"
```

{% endtab %}

{% tab title="BTC" %}

```sh
curl --location --request GET "https://api.whatsonchain.com/v1/btc/main/address/16AvgD6VzCkQaJEgTAJrERt1f9RSuJ9Dg5/unconfirmed/history"
```

{% endtab %}
{% endtabs %}

#### Example Response

{% tabs %}
{% tab title="BSV" %}

```json
{
    "address": "1QC6bjxvSBdiHqGM48t5RxjTEYW6BX4vu4",
    "script": "f80a9ad71e1f2a5e83bfddb639e87e0c0bdeefd6f1b4f760dd0f88ccae3a8441",
    "result": [{
        "tx_hash": "2fde4146ae470efb337395987261b028c38e4e095b44ae3bc800c4073daf4730"
    }, {
        "tx_hash": "3570f77cc006b507b4198370b0f97adbbdf3a83c84fe3b72c1cb0579ec34ca9f"
    },
    ...
    ],
    "error": ""
}
```

{% endtab %}

{% tab title="BTC" %}

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

{% endtab %}
{% endtabs %}

**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.

{% hint style="info" %}

* Max 20 addresses per request.
* Max 100 items returned per request.
  {% endhint %}

{% code title="HTTP Request" %}

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

{% endcode %}

{% code title="Request Data" %}

```json
{
    "addresses": [
        "<address>",
        "<address>",
        ...
    ]
}
```

{% endcode %}

#### Example Request

{% tabs %}
{% tab title="BSV" %}

```sh
curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/addresses/unconfirmed/history" \
  --header "Content-Type: application/json" \
  --data "{\"addresses\" : [ \"1QC6bjxvSBdiHqGM48t5RxjTEYW6BX4vu4\", \"1AyWnLhRYqt5VcGvVmXpieCbY3agHk53cJ\"] }"
```

{% endtab %}

{% tab title="BTC" %}

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

{% endtab %}
{% endtabs %}

#### Example Response

{% tabs %}
{% tab title="BSV" %}

```json
[{
    "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": ""
}]
```

{% endtab %}

{% tab title="BTC" %}

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

{% endtab %}
{% endtabs %}

**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.

{% code title="HTTP Request" %}

```
GET https://api.whatsonchain.com/v1/<chain>/<network>/address/<address>/confirmed/history
```

{% endcode %}

#### Example Request

{% tabs %}
{% tab title="BSV" %}

```sh
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/address/1Dbj1LUxTqtuZ1U52KZiZChLPHkTAMiD6h/confirmed/history"
```

{% endtab %}

{% tab title="BTC" %}

```sh
curl --location --request GET "https://api.whatsonchain.com/v1/btc/main/address/bc1q6yxjfhj94w5ej79nvuls9fsyt33k8knp8yu594/confirmed/history"
```

{% endtab %}
{% endtabs %}

#### Example Response

{% tabs %}
{% tab title="BSV" %}

```json
{
    "address": "1Dbj1LUxTqtuZ1U52KZiZChLPHkTAMiD6h",
    "script": "0374d9ee2df8e5d7c5fd8359f33456996f2a1a9c76d9c783d2f8d5ee05ba5832",
    "result": [{
        "tx_hash": "6cc9631ef3dad77eb0141134167f20469d0b4e61405de57fe6a9ac71b943bb9f",
        "height": 797518
    }],
    "error": ""
}
```

{% endtab %}

{% tab title="BTC" %}

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

{% endtab %}
{% endtabs %}

**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.

{% hint style="info" %}

* Max 20 addresses per request.
* Max 20 items returned per request.
* For pagination please use the single address endpoint.
  {% endhint %}

{% code title="HTTP Request" %}

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

{% endcode %}

{% code title="Request Data" %}

```json
{
    "addresses": [
        "<address>",
        "<address>",
        ...
    ]
}
```

{% endcode %}

#### Example Request

{% tabs %}
{% tab title="BSV" %}

```sh
curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/addresses/confirmed/history" \
  --header "Content-Type: application/json" \
  --data "{\"addresses\" : [ \"16ZBEb7pp6mx5EAGrdeKivztd5eRJFuvYP\", \"1CQuHnTR1HExx9KBvwuzeERx7CZmVkFtPs\" ] }"
```

{% endtab %}

{% tab title="BTC" %}

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

{% endtab %}
{% endtabs %}

#### Example Response

{% tabs %}
{% tab title="BSV" %}

```json
[{
    "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": ""
}]
```

{% endtab %}

{% tab title="BTC" %}

```json
[{
    "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": ""
}]
```

{% endtab %}
{% endtabs %}

**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.

{% hint style="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](#get-unconfirmed-history-beta) and [confirmed](#get-confirmed-history-beta) endpoints with page token for more history if required.
  {% endhint %}

{% code title="HTTP Request" %}

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

{% endcode %}

{% code title="Request Data" %}

```json
{
    "addresses": [
        "<address>",
        "<address>",
        ..
    ]
}
```

{% endcode %}

#### Example Request

{% tabs %}
{% tab title="BSV" %}

```sh
curl --location --request POST "https://api.whatsonchain.com/v1/bsv/main/addresses/history/all" \
  --header "Content-Type: application/json" \
  --data "{\"addresses\" : [ \"16ZBEb7pp6mx5EAGrdeKivztd5eRJFuvYP\", \"19SsDUJ29XM2VDCkZKnTXJ9Zjt3gMtnrwC\" ] }"
```

{% endtab %}

{% tab title="BTC" %}

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

{% endtab %}
{% endtabs %}

#### Example Response

{% tabs %}
{% tab title="BSV" %}

```json
[{
    "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": ""
    }
}]
```

{% endtab %}

{% tab title="BTC" %}

```json
[{
    "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": ""
    }
}]
```

{% endtab %}
{% endtabs %}

**URL Parameters**

| Parameter | Description                         |
| --------- | ----------------------------------- |
| network   | Selected network: `main` or `test`. |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.taal.com/core-products/whatsonchain/address.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.