Skip to main content
GET
Resolve a FOMO handle to the user and their verified wallet

Authorizations

Authorization
string
header
required

B2B API key (fsk_live_… / fsk_test_…), issued by FomoScan. Also accepted via X-Api-Key.

Path Parameters

handle
string
required

FOMO username (case-insensitive; leading @ is stripped).

Required string length: 1 - 64

Response

Default Response

id
string<uuid>
required

Stable FOMO user id. Unlike handle it never changes, so it is the key to store.

handle
string
required

The canonical handle. Users rename — do not key on it.

name
null | string
required

Display name.

bio
null | string
required

Profile blurb as written by the user, or null if they have none.

banner
null | string
required

Cover photo URL on our image host, or null. The path is /a/<key>.webp. A new picture gets a new URL. A picture added in the last few minutes can show a neutral placeholder until it is ready.

profilePicture
null | string
required

Avatar URL on our image host, or null. The path is /a/<key>.webp. A new picture gets a new URL. A picture added in the last few minutes can show a neutral placeholder until it is ready.

twitter
null | string
required

Canonical X profile link, https://x.com/<handle>, or null. Normalised from whatever the user typed on FOMO; null when that could not be reduced to a plausible handle. Self-declared and NOT verified by us — a claim, not a proof.

Example:

"https://x.com/tradername"

solanaAddress
null | string
required

Verified Solana address (base58), or null.

evmAddress
null | string
required

Verified EVM address, 0x-prefixed, or null.

socials
object[]

Verified social account links. Present only when social account links are enabled on the API. Absent, not null, when they are not.