Skip to main content
GET
Wallet Identity - Single

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).

  • type — the identity class: wallet, exchange, protocol, token, program, or unknown. 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) .sol domain, 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 .sol domains a wallet owns. domains is capped at 20 and sorted shortest-first then alphabetical; domains_total is the true count.
  • Put a human-readable name on a single address — exchange, protocol, known entity, or named wallet — instead of raw base58.
  • Resolve a .sol domain to its owning wallet in one call.
  • Enrich a transaction view, address page, or alert with a compact identity.
  • address (required) — a wallet address or a .sol domain (resolves to the owner).
  • Returns one identity object. An address with no label returns an empty object.
  • Trust domains_total, not domains.length — the array is a 20-item preview.
  • Need every domain? Call the domains endpoint and page; don’t infer it from this response.
  • Treat a domain-only wallet’s label as a display convenience (the shortest domain), not a user-chosen primary.
  • Returns at most 20 domains (a preview) — use the domains endpoint 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.

Authorizations

X-API-KEY
string
header
required

API key for authentication

Query Parameters

address
string
required

A Solana wallet address, or a .sol domain that resolves to its owner.

Example:

"DaP44wF8mKmYki1M5zguvXYAW5XF6sLQEzvdmvcizRqD"

Response

Successful response

success
boolean
required
data
object
required