curl --request POST \
--url https://api.fomoscan.sh/v2/user/handle/{handle}/resolve \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fomoscan.sh/v2/user/handle/{handle}/resolve', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.fomoscan.sh/v2/user/handle/{handle}/resolve"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"handle": "<string>",
"name": "<string>",
"bio": "<string>",
"banner": "<string>",
"profilePicture": "<string>",
"twitter": "https://x.com/tradername",
"solanaAddress": "<string>",
"evmAddress": "<string>",
"socials": [
{
"provider": "<string>",
"subject": "<string>",
"handle": "<string>"
}
]
}{
"pending": true,
"reason": "queued",
"message": "<string>",
"retryable": true,
"retryAfterSeconds": 123,
"position": 123
}{
"error": {
"code": "BAD_REQUEST",
"message": "<string>",
"retryAfter": 123,
"addUrl": "<string>"
}
}{
"error": {
"code": "BAD_REQUEST",
"message": "<string>",
"retryAfter": 123,
"addUrl": "<string>"
}
}Resolve a handle to its wallets (temporarily unavailable)
Temporarily unavailable. Live resolution is paused.
- A handle we already hold a wallet for is answered from our data: 200 with the
ordinary user record and
x-fomoscan-resolve: cached, at the usual hit price. - A request for a handle we do not already hold answers 202
{ pending: true, reason: "unavailable", retryable: false }and is not charged. - This paused response includes a
messageexplaining that no job was queued and cached wallet lookups remain available.
When live resolution runs, it returns the wallet we hold for this handle, and looks for one when we hold none:
- 200 returns the ordinary user record.
- 202
{ pending: true, reason }means the answer is not ready, not that the call failed.retryAfterSecondssays when to ask again. Asking again does not start a second resolve, it joins the one already running. - 404 when no such FOMO user exists, as opposed to a 202, which means we could not answer yet.
- A live answer can take several seconds, so allow for it in your client timeout.
x-fomoscan-resolve: cachedon a response answered from a wallet we already held,livewhen we went and looked.- Refused with 402 before any work starts when the key cannot pay for a hit.
- Rate limited to 10/minute per IP, separately from your plan rate.
A response that carries a wallet counts as one of the plan’s monthly reveals.
Price: 30,000 CU on a hit, 200 CU on a 202 or a 404. A paused lookup (202 with reason unavailable and retryable false) is not charged.
curl --request POST \
--url https://api.fomoscan.sh/v2/user/handle/{handle}/resolve \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fomoscan.sh/v2/user/handle/{handle}/resolve', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.fomoscan.sh/v2/user/handle/{handle}/resolve"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"handle": "<string>",
"name": "<string>",
"bio": "<string>",
"banner": "<string>",
"profilePicture": "<string>",
"twitter": "https://x.com/tradername",
"solanaAddress": "<string>",
"evmAddress": "<string>",
"socials": [
{
"provider": "<string>",
"subject": "<string>",
"handle": "<string>"
}
]
}{
"pending": true,
"reason": "queued",
"message": "<string>",
"retryable": true,
"retryAfterSeconds": 123,
"position": 123
}{
"error": {
"code": "BAD_REQUEST",
"message": "<string>",
"retryAfter": 123,
"addUrl": "<string>"
}
}{
"error": {
"code": "BAD_REQUEST",
"message": "<string>",
"retryAfter": 123,
"addUrl": "<string>"
}
}Authorizations
B2B API key (fsk_live_… / fsk_test_…), issued by FomoScan. Also accepted via X-Api-Key.
Path Parameters
FOMO handle (case-insensitive; leading @ is stripped).
1 - 64Response
Default Response
Stable FOMO user id. Unlike handle it never changes, so it is the key to store.
The canonical handle. Users rename — do not key on it.
Display name.
Profile blurb as written by the user, or null if they have none.
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.
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.
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.
"https://x.com/tradername"
Verified Solana address (base58), or null.
Verified EVM address, 0x-prefixed, or null.
Verified social account links. Present only when social account links are enabled on the API. Absent, not null, when they are not.
Show child attributes
Show child attributes