Address → Cluster Name

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

Get name

GET /v1/names/address/:address

Get the cluster and wallet name based on an address

Name	Description
address	EVM or Solana address

Example

https://api.clusters.xyz/v1/names/address/0x5755d1dcea21caa687339c305d143e6e78f96adf

Response

200

{
    "address": "0x5755d1dcea21caa687339c305d143e6e78f96adf",
    "type": "evm",
    "clusterName": "cluster",
    "walletName": "main",
    "isVerified": true
}

404

{
  "address": "0x5755d1dcea21caa687339c305d143e6e78f96adf",
  "type": "evm",
  "clusterName": null,
  "walletName": null
}

---

Get names by owner

GET /v1/names/owner/address/:address

Get all clusters and wallet names from a single wallet address

address	EVM or Solana address

Example

https://api.clusters.xyz/v1/names/owner/address/0x5755d1dcea21caa687339c305d143e6e78f96adf

Response

200

[
    {
        "name": "cypherpunks/satoshi",
        "owner": "0x5755d1dcea21caa687339c305d143e6e78f96adf",
        "totalWeiAmount": "0",
        "createdAt": "2025-04-28 18:10:05.805+00",
        "updatedAt": "2025-04-28 18:10:05.805+00",
        "updatedBy": "0x5755d1dcea21caa687339c305d143e6e78f96adf",
        "isTestnet": false,
        "clusterId": "0x...",
        "expiresAt": null
    },
    {
        "name": "mclovin",
        "owner": "0x5755d1dcea21caa687339c305d143e6e78f96adf",
        "totalWeiAmount": "0",
        "createdAt": "2025-04-28 18:10:05.805+00",
        "updatedAt": "2025-04-28 18:10:05.805+00",
        "updatedBy": "0x5755d1dcea21caa687339c305d143e6e78f96adf",
        "isTestnet": false,
        "clusterId": "0x...",
        "expiresAt": null
    }
]

---

Bulk get names

POST /v1/names/address

Get the cluster and wallet name based on multiple addresses

Name	Description
POST body	Array of EVM and or Solana addresses

Example

curl -X POST \
  'http://api.clusters.xyz/v1/names/address' \
  --data-raw '[
  "0x5755d1dcea21caa687339c305d143e6e78f96adf",
  "0xccdead94e8cf17de32044d9701c4f5668ad0bef9"
]'

Response

Any addresses not found will have clusterName: null

200

[
  {
    "address": "0x5755d1dcea21caa687339c305d143e6e78f96adf",
    "type": "evm",
    "clusterName": "clusters",
    "walletName": "main",
    "isVerified": true
  },
  {
    "address": "0xccdead94e8cf17de32044d9701c4f5668ad0bef9",
    "type": "evm",
    "clusterName": "layerzero",
    "walletName": "main",
    "isVerified": true
  }
]

500

[]

---