curl --request GET \
--url https://api.fomoscan.sh/v2/user/handle/{handle}/pnl \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fomoscan.sh/v2/user/handle/{handle}/pnl', 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}/pnl"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"handle": "<string>",
"wallet": "<string>",
"evmWallet": "<string>",
"status": "ready",
"retryAfterSeconds": 123,
"updatedAt": 123,
"windows": {
"24h": {
"netUsd": 123,
"returnPct": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"trades": 123,
"buys": 123,
"sells": 123,
"tokensTraded": 123,
"winningTokens": 123,
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"totalPnlUsd": 123,
"rank": 123,
"status": "ready",
"updatedAt": 123
},
"7d": {
"netUsd": 123,
"returnPct": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"trades": 123,
"buys": 123,
"sells": 123,
"tokensTraded": 123,
"winningTokens": 123,
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"totalPnlUsd": 123,
"rank": 123,
"status": "ready",
"updatedAt": 123
},
"30d": {
"netUsd": 123,
"returnPct": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"trades": 123,
"buys": 123,
"sells": 123,
"tokensTraded": 123,
"winningTokens": 123,
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"totalPnlUsd": 123,
"rank": 123,
"status": "ready",
"updatedAt": 123
},
"all": {
"netUsd": 123,
"returnPct": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"trades": 123,
"buys": 123,
"sells": 123,
"tokensTraded": 123,
"winningTokens": 123,
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"totalPnlUsd": 123,
"rank": 123,
"status": "ready",
"updatedAt": 123
}
},
"unrealized": {
"unrealizedPnlUsd": 123,
"holdingsUsd": 123,
"positions": 123,
"excludedPositions": 123,
"status": "ready",
"updatedAt": 123
},
"displayName": "<string>",
"avatarUrl": "<string>",
"twitter": "<string>",
"followers": 123
}{
"error": {
"code": "BAD_REQUEST",
"message": "<string>",
"retryAfter": 123,
"addUrl": "<string>"
}
}One trader's realized and unrealized profit across their whole wallet
Profit and trading activity across one account’s whole wallet: every venue, Solana and EVM together.
24h,7dand30d: realized profit (netUsd), return, buy and sell volume, trade counts and tokens traded.all: FOMO trades only, as cash flow (sold minus bought) with itsrank, plus whole-wallet realized and unrealized profit since 1 January 2025.- Every window carries
realizedPnlUsd,unrealizedPnlUsdandtotalPnlUsd, one formula across 24h, 7d, 30d and all: realized profit on average cost plus the unrealized profit of positions last traded in the window. unrealized: profit on what the wallets hold now. It has no window, and it leaves out spam, pools under $10,000 of liquidity and positions larger than their pool.- Each window carries its own
statusandupdatedAt. A window that is due to be read again is read while you wait, up to 8 seconds; if the read does not finish in time, the previous figures are served with their olderupdatedAt. - The first call for an account reads it live. A window that does not finish within
8 seconds comes back
pendingwith null figures and is ready on the next call. statusispendingonly when nothing could be read in time. Only areadyanswer is charged the hit price; every other answer is charged the miss price.- A handle the user renamed to is found through their theses of the last 30 days;
handlein the answer is the handle we hold for them. - 404 when we do not hold the handle.
A response with status ready carries a wallet and counts as one of the plan’s monthly reveals.
Price: 30,000 CU on a hit, 200 CU on any answer that is not ready, and on a 404.
curl --request GET \
--url https://api.fomoscan.sh/v2/user/handle/{handle}/pnl \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fomoscan.sh/v2/user/handle/{handle}/pnl', 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}/pnl"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"handle": "<string>",
"wallet": "<string>",
"evmWallet": "<string>",
"status": "ready",
"retryAfterSeconds": 123,
"updatedAt": 123,
"windows": {
"24h": {
"netUsd": 123,
"returnPct": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"trades": 123,
"buys": 123,
"sells": 123,
"tokensTraded": 123,
"winningTokens": 123,
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"totalPnlUsd": 123,
"rank": 123,
"status": "ready",
"updatedAt": 123
},
"7d": {
"netUsd": 123,
"returnPct": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"trades": 123,
"buys": 123,
"sells": 123,
"tokensTraded": 123,
"winningTokens": 123,
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"totalPnlUsd": 123,
"rank": 123,
"status": "ready",
"updatedAt": 123
},
"30d": {
"netUsd": 123,
"returnPct": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"trades": 123,
"buys": 123,
"sells": 123,
"tokensTraded": 123,
"winningTokens": 123,
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"totalPnlUsd": 123,
"rank": 123,
"status": "ready",
"updatedAt": 123
},
"all": {
"netUsd": 123,
"returnPct": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"trades": 123,
"buys": 123,
"sells": 123,
"tokensTraded": 123,
"winningTokens": 123,
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"totalPnlUsd": 123,
"rank": 123,
"status": "ready",
"updatedAt": 123
}
},
"unrealized": {
"unrealizedPnlUsd": 123,
"holdingsUsd": 123,
"positions": 123,
"excludedPositions": 123,
"status": "ready",
"updatedAt": 123
},
"displayName": "<string>",
"avatarUrl": "<string>",
"twitter": "<string>",
"followers": 123
}{
"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 username (case-insensitive; leading @ is stripped).
1 - 64Response
Default Response
The Solana address these numbers include: the verified Solana wallet of this account, left out when the same address is verified for another account too. Null when there is none.
The EVM address these numbers include, across every EVM chain FOMO runs on: the verified EVM wallet of this account, left out when the same address is verified for another account too. Null when there is none.
ready: whole-wallet figures are served; each window carries its own status and updatedAt, and a window read for the first time can still be pending. pending: nothing could be read within the wait; every field of 24h, 7d and 30d is null and unrealized is null; ask again after retryAfterSeconds. failed: the last reading failed and nothing is held yet; the next attempt starts after retryAfterSeconds. no-wallet: we hold no verified wallet. unavailable: whole-wallet reading is switched off or out of capacity; retrying will not help soon. Only ready is charged the hit price.
ready, pending, failed, no-wallet, unavailable Set only when status is pending or failed: seconds until asking again is worth it.
Epoch ms of the oldest figure served: the oldest window or unrealized reading when status is ready, the FOMO board otherwise. Each window carries its own updatedAt.
One entry per window, with all four keys present. 24h, 7d and 30d are always objects: whole-wallet figures when their own status is ready, every figure null while it is pending (FOMO cash flow is never shown in their place). On all, netUsd, returnPct, volumeUsd, trades and rank are FOMO cash flow with its rank, and realizedPnlUsd, unrealizedPnlUsd and totalPnlUsd are whole-wallet figures since 1 January 2025. all is null for an account with no FOMO trade until its whole-wallet figures have been read.
Show child attributes
Show child attributes
Profit on what the wallets hold now, across the whole wallet, every venue, Solana and EVM. It has no window. Null until the positions have been read at least once.
Show child attributes
Show child attributes
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.
Bare X username.