Cluster → Metadata

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

Get cluster

GET /v0.1/cluster/:name

Get the cluster from a cluster name

Name	Description
name	Name of the cluster

Example

https://api.clusters.xyz/v0.1/cluster/:name

Response

200

{
  "name": "clusters/",
  "profileUrl": "https://clusters.xyz/clusters",
  "imageUrl": "https://cdn.clusters.xyz/profile/clusters",
  "hasCustomImage": false,
  "wallets": [
    {
      "type": "evm",
      "address": "0x5755d1dcea21caa687339c305d143e6e78f96adf",
      "name": "clusters/main",
      "isVerified": true
    }
  ]
}

404

null

---

Bulk get clusters

POST /v0.1/cluster/names

Get the cluster from a cluster name

Name	Description
POST body	Array of cluster names

Example

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

Response

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

200

[
  {
    "name": "clusters/",
    "profileUrl": "https://clusters.xyz/clusters",
    "imageUrl": "https://cdn.clusters.xyz/profile/clusters",
    "hasCustomImage": false,
    "wallets": [
      {
        "name": "clusters/main",
        "type": "evm",
        "address": "0x5755d1dcea21caa687339c305d143e6e78f96adf",
        "isVerified": true
      }
    ]
  },
  {
    "name": "layerzero/",
    "profileUrl": "https://clusters.xyz/layerzero",
    "imageUrl": "https://cdn.clusters.xyz/profile/layerzero",
    "hasCustomImage": true,
    "wallets": [
      {
        "name": "layerzero/main",
        "type": "evm",
        "address": "0xccdead94e8cf17de32044d9701c4f5668ad0bef9",
        "isVerified": true
      }
    ]
  }
]

500

[]