Skip to main content
GET
Lookup
Given just an address, this finds out whether CabalSpy tracks it and, if so, returns its profile plus which chain and category (kol, smart, whale) it belongs to. Use it to label an arbitrary address in your UI, for example to show a name and avatar next to a wallet that appears in a transaction feed.
You do not pass a blockchain or type. The lookup searches all chains and types for you and returns the first match. Always check the found field, it is false when the address is not tracked.

Query Parameters

string
required
The wallet address to look up. Searched across every tracked chain and wallet type.
string
required
Your API key. Alternatively pass it as an Authorization Bearer header.

Usage Example

Response

boolean
True on success. The request worked, regardless of whether the wallet was found.
object

Errors

A wallet not found is not an error, you get 200 with found false. The errors below concern the request itself.