---
title: "Wallet Identity - Single"
method: GET
path: "/identity/v1/single"
tags: ["Wallet Identity"]
---

# Wallet Identity - Single

`GET /identity/v1/single`

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.

## Query parameters

- `address` string, required

## Response `200`

Successful response

- IdentitySingleResponse
  - `success` boolean, required
  - `data` object, required
    - `address` string — The resolved wallet address.
    - `input_domain` string — Present only when a .sol domain was passed as the input; the domain that resolved to this address.
    - `type` 'wallet' | 'exchange' | 'protocol' | 'token' | 'program' | 'unknown' — Identity class of the address. Drives how a client should render it. `unknown` means no identity is known.
    - `entity` string — The named owner when known (e.g. Binance, Jupiter, Astralane). Absent for anonymous wallets.
    - `label` string — Human-readable display name. For a wallet identified only by a .sol domain, this is its first (shortest) domain.
    - `category` string — Broad grouping behind the type (e.g. Wallet, Exchange, Protocol, Token).
    - `tags` string[] — Extra descriptors attached to the identity (e.g. a KOL's name, deposit). Empty array when none apply.
    - `domains` string[] — The .sol domains a wallet owns — a preview capped at 20, ordered shortest-first then alphabetical. Returned only for type=wallet; use the domains endpoint for the full list.
    - `domains_total` integer — True number of .sol domains the wallet owns (the domains array above is a capped preview).

## Other responses

- `400` — Bad Request
- `401` — Unauthorized. API key is missing or invalid
- `403` — Forbidden. Request is blacklisted or not whitelisted
- `429` — Too Many Requests. Rate limit reached
- `500` — Internal Server Error

---

[API](https://skmtc.net/birdeye/apis/birdeye-data-api.md) · [All operations](https://skmtc.net/birdeye/apis/birdeye-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/birdeye/birdeye-data-api/revisions/fcaba926a089/schema)
