Resolve ENS, Farcaster, Lens, and Basename social identities for any Ethereum address.
What it does
The Zapper Account Identity endpoint resolves social identity data for a given 0x wallet address. It returns associated ENS names, Farcaster profiles (username and FID), Lens handles, Basenames, display names, and account descriptions. The data is sourced from Zapper's onchain data infrastructure covering 60+ chains.
This is one of 17 paid tools in the Zapper x402 API suite. It accepts a POST request with a JSON body containing a single `address` field (a 0x wallet address). The endpoint is live and returns an x402 payment challenge. Payment is settled via x402 on Base using USDC at a fixed price of $0.001125 per call (1125 base units of USDC on Base, 6 decimals). The response includes structured identity fields: displayName (with source attribution), ensRecord, basename, farcasterProfile, and lensProfile.
The broader Zapper API also offers token prices, portfolio balances, NFT metadata, transaction history, DeFi positions, token/NFT rankings, swap feeds, and search — all accessible via the same x402 payment pattern at the `/x402/{tool}` path convention.
Capabilities
Use cases
- —Resolve a wallet address to its ENS name, Farcaster username, and Lens handle for display in a dApp
- —Enrich transaction data with human-readable identity labels
- —Build social graphs by mapping addresses to their onchain social profiles
- —Verify whether an address has claimed a Basename on Base
- —Power agent workflows that need to identify wallet owners before taking action
Fit
Best for
- —Agents and dApps that need to display human-readable names for Ethereum addresses
- —Social-layer enrichment of onchain data pipelines
- —Identity resolution across ENS, Farcaster, Lens, and Basenames in a single call
Not for
- —Resolving identities on non-EVM chains (e.g., Solana, Bitcoin)
- —Bulk batch resolution of thousands of addresses in one request (single address per call)
- —Free-tier usage — every call requires x402 USDC payment
Quick start
curl -X POST https://public.zapper.xyz/x402/account-identity \
-H "Content-Type: application/json" \
-H "X-Payment: <x402-payment-token>" \
-d '{"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"}'Example
Request
{
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
}Response
{
"data": {
"account": {
"basename": null,
"ensRecord": {
"name": "vitalik.eth"
},
"description": {
"value": "Ethereum co-founder",
"source": "ENS"
},
"displayName": {
"value": "vitalik.eth",
"source": "ENS"
},
"lensProfile": {
"handle": "vitalik"
},
"farcasterProfile": {
"fid": 5650,
"username": "vitalik.eth"
}
}
}
}Endpoint
Quality
Full OpenAPI schema with input/output descriptions, live 402 challenge confirming the endpoint works, clear pricing, and example body. Docked slightly because there are no actual response examples from a paid call (output schema is illustrative), and the crawled docs pages returned 404s. The response example above is inferred from the output schema.
Warnings
- —The /docs and /pricing pages on public.zapper.xyz return 404; documentation may have moved to build.zapper.xyz.
- —The example response is inferred from the output schema in the OpenAPI spec, not from an actual API response.
- —The legacy v2 API at /api is marked as deprecated in favor of build.zapper.xyz.
Citations
- —The endpoint returns social identity including ENS, Farcaster, Lens, and Basenames for a given address.https://public.zapper.xyz/x402/account-identity
- —Fixed price of 1125 base units of USDC on Base (eip155:8453) per call, which equals $0.001125.https://public.zapper.xyz/x402/account-identity
- —Zapper API provides enterprise grade onchain data across 60+ chains.https://public.zapper.xyz/x402/account-identity
- —The legacy Zapper API at /api is deprecated; users are directed to build.zapper.xyz.https://public.zapper.xyz/api