Resolve cross-chain identities via the CIP API. Search names across MNS (.snow), ENS (.eth), and other naming providers. Reverse lookup addresses to names. Use when the user asks to resolve a wallet address, look up an identity, find who owns a name, or search naming services.
Resolve cross-chain identities via the CIP (Cross-chain Identity Protocol) API. CIP aggregates naming services — a single search returns results from MNS, ENS, and other providers.
Base URL: https://api.modular.name/partners
Auth: Include x-api-key: <CIP_API_KEY> header on every request.
Search for identities across all supported naming providers:
curl -s "https://api.modular.name/partners/cip/identity/search?query=vitalik" \
-H "x-api-key: $CIP_API_KEY"
With pagination:
curl -s "https://api.modular.name/partners/cip/identity/search?query=alice&page=1&perPage=5" \
-H "x-api-key: $CIP_API_KEY"
| Param | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Name or partial name to search |
page | number | No | Page number (default: 1) |
perPage | number | No | Results per page (default: 10, max: 100) |
{
"data": [
{
"name": "alice.snow",
"provider": "MNS",
"owner": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
"url": "https://modular.name/alice",
"addresses": {
"ethereum": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
"base": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
"solana": "5FHwkrdxRt..."
},
"socials": {
"twitter": "@alice",
"github": "alice"
}
},
{
"name": "alice.eth",
"provider": "ENS",
"owner": "0x1234...",
"url": "https://app.ens.domains/alice.eth",
"addresses": {
"ethereum": "0x1234..."
}
}
],
"pagination": {
"page": 1,
"perPage": 10,
"total": 2
}
}
MNS results appear first, followed by third-party providers.
curl -s "https://api.modular.name/partners/stats" \
-H "x-api-key: $CIP_API_KEY"
Returns your account name, email, credit balance, and usage.
| Provider | Extension | Status |
|---|---|---|
| MNS (Modular Name Service) | .snow | Live |
| ENS (Ethereum Name Service) | .eth | Live |
| More providers | — | Coming soon |
Ethereum, Base, Polygon, Arbitrum, Optimism, Solana, Bitcoin, BSC, Avalanche, Aptos.
"What is the address of X?" — Search for the identity:
curl -s "https://api.modular.name/partners/cip/identity/search?query=X" \
-H "x-api-key: $CIP_API_KEY"
Extract the owner or chain-specific address from the response.
"Who owns 0x...?" — Search with the address:
curl -s "https://api.modular.name/partners/cip/identity/search?query=0x742d35Cc" \
-H "x-api-key: $CIP_API_KEY"
For detailed API field descriptions and edge cases, see api-reference.md.