Resolve one address to a compact identity: its type, named entity, display label, category, tags, and — for wallets — the .sol domains it owns (a preview capped at 20, with domains_total for the true count). A .sol domain passed as address resolves to its owner. Non-wallet identities do not return domains.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Resolve one address to a single compact identity — who an address is, not what it did.
Pass a wallet address — or a .sol domain, which resolves to its owner — and get one identity object: a type (wallet / exchange / protocol / token / …), an optional named entity, a display label, a category, tags, and, for wallets, the .sol domains it owns plus domains_total.
For a wallet identified only by a .sol domain, label is set to its first domain (domains[0]). The domains array is a preview capped at 20, ordered shortest-first then alphabetical — read domains_total for the true count and use the domains endpoint to page through them all. Non-wallet identities (exchange / protocol / token) never return domains: a CEX "owning" a .sol domain is SNS spam (anyone can point a domain's owner at any address).
- Lite
- Starter
- Premium
- Business
- Enterprise
Solana
Identity Field Definitions 🏷️
- type — the identity class:
wallet,exchange,protocol,token,program, orunknown. Drives how a client should render the address. - entity — the named owner when known (e.g.
Binance,Jupiter,Astralane). Absent for anonymous wallets. - label — the human-readable display name. For a domain-only wallet this is the first (shortest)
.soldomain, until the owner's favourite domain is available. - category — the broad grouping behind the type (e.g.
Wallet,Exchange,Protocol,Token). - tags — extra descriptors attached to the identity (e.g. a KOL's name,
deposit). Empty array when none apply. - domains / domains_total — the
.soldomains a wallet owns.domainsis capped at 20 and sorted shortest-first then alphabetical;domains_totalis the true count.
Use Cases 💡
- Put a human-readable name on a single address — exchange, protocol, known entity, or named wallet — instead of raw base58.
- Resolve a
.soldomain to its owning wallet in one call. - Enrich a transaction view, address page, or alert with a compact identity.
- Resolve a
How to Use 🛠️
address(required) — a wallet address or a.soldomain (resolves to the owner).- Returns one identity object. An address with no label returns an empty object.
Best Practices ✅
- Trust
domains_total, notdomains.length— the array is a 20-item preview.- Need every domain? Call the
domainsendpoint and page; don't infer it from this response. - Treat a domain-only wallet's
labelas a display convenience (the shortest domain), not a user-chosen primary.
- Need every domain? Call the
Limitations ⚠️
- Returns at most 20 domains (a preview) — use the
domainsendpoint for the full set.- Domains are returned only for
type: wallet; non-wallet identities suppress them (SNS-spam guard). - The domain-only wallet
label= first (shortest) domain until SNS favourite-domain ingest lands. - Solana only.
- Domains are returned only for
