Skip to main content
GET
Look up a wallet
Returns every identity attached to a single address. Costs 1 credit. For more than a handful of addresses use batch instead.

Path parameters

string
required
An address as 0x followed by 40 hex characters. Case-insensitive; returned lowercased.

Request

Response

object | null
The record, or null when nothing is attached to the address.
object
All three of these are HTTP 200. A wallet with nothing attached is a successful lookup with a negative answer, not an error.

Staleness headers

When a record is past its freshness window the response adds:
Both are absent on fresh records, so test for presence rather than comparing values.

Errors

INVALID_ADDRESS, plus the standard errors.