# Cluster → Address

{% hint style="info" %}
To enable testnet querying on Sepolia, add `?testnet=true` to the end of the URL
{% endhint %}

## Get address

<mark style="color:green;">`GET`</mark> `/v0.1/address/:name`

<mark style="color:green;">`GET`</mark> `/v0.1/address/:name/:addressName`

Get the wallet associated to a cluster name. You can pass just the cluster name or also include the address name as shown in the 2 examples.

| Name                       | Description                 |
| -------------------------- | --------------------------- |
| `name`                     | Name of the cluster         |
| `addressName` *(optional)* | Address name of the cluster |

**Example**

```http
https://api.clusters.xyz/v0.1/address/clusters
https://api.clusters.xyz/v0.1/address/clusters/main
```

**Response**

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

```json
{
  "type": "evm",
  "address": "0x5755d1dcea21caa687339c305d143e6e78f96adf",
  "name": "clusters/main",
  "isVerified": true
}
```

{% endtab %}

{% tab title="404" %}

```json
null
```

{% endtab %}
{% endtabs %}

***

## Bulk get addresses

<mark style="color:green;">`POST`</mark> `/v0.1/address/names`

Get the wallets associated to a cluster name. You can pass just the cluster name or also include the address name.

| Name        | Description                                           |
| ----------- | ----------------------------------------------------- |
| POST `body` | Array of cluster names (with or without address name) |

**Example**

```bash
curl  -X POST \
  'https://api.clusters.xyz/v0.1/address/names' \
  --data-raw '[
  "clusters/",
  "clusters/main",
  "layerzero/",
  "layerzero/main"
]'
```

**Response**

> Any names in the array that are not found will be omitted from the response.

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

```json
[
  {
    "name": "clusters/",
    "type": "evm",
    "address": "0x5755d1dcea21caa687339c305d143e6e78f96adf",
    "isVerified": true
  },
  {
    "name": "clusters/main",
    "type": "evm",
    "address": "0x5755d1dcea21caa687339c305d143e6e78f96adf",
    "isVerified": true
  },
  {
    "name": "layerzero/",
    "type": "evm",
    "address": "0xccdead94e8cf17de32044d9701c4f5668ad0bef9",
    "isVerified": true
  },
  {
    "name": "layerzero/main",
    "type": "evm",
    "address": "0xccdead94e8cf17de32044d9701c4f5668ad0bef9",
    "isVerified": true
  }
]
```

{% endtab %}

{% tab title="500" %}

```json
[]
```

{% endtab %}
{% endtabs %}