# 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`. |