> For the complete documentation index, see [llms.txt](https://docs.clusters.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.clusters.xyz/getting-started/api/v0.1-deprecated/address-cluster.md).

# Address → Cluster

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

## Get name

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

Get the cluster and wallet name based on an address

| Name      | Description           |
| --------- | --------------------- |
| `address` | EVM or Solana address |

**Example**

```http
https://api.clusters.xyz/v0.1/name/0x5755d1dcea21caa687339c305d143e6e78f96adf
```

**Response**

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

```json
clusters/main
```

{% endtab %}

{% tab title="404" %}

```json
null
```

{% endtab %}
{% endtabs %}

***

## Bulk get names

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

Get the cluster and wallet name based on multiple addresses

| Name        | Description                          |
| ----------- | ------------------------------------ |
| POST `body` | Array of EVM and or Solana addresses |

**Example**

```bash
curl -X POST \
  'http://api.clusters.xyz/v0.1/name/addresses' \
  --data-raw '[
  "0x5755d1dcea21caa687339c305d143e6e78f96adf",
  "0xccdead94e8cf17de32044d9701c4f5668ad0bef9"
]'
```

**Response**

> Any addresses not found will have `name: null`

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

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

{% endtab %}

{% tab title="500" %}

```json
[]
```

{% endtab %}
{% endtabs %}

***
