Cluster → Address

To enable testnet querying on Sepolia, add ?testnet=true to the end of the URL

Get address

GET /v0.1/address/:name

GET /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

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

Response

200

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

404

null

---

Bulk get addresses

POST /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

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.

200

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

500

[]