curl --request GET \
--url https://api.fomoscan.sh/v2/pump/user/wallet/{wallet}/pnl \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fomoscan.sh/v2/pump/user/wallet/{wallet}/pnl', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.fomoscan.sh/v2/pump/user/wallet/{wallet}/pnl"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"wallet": "<string>",
"username": "<string>",
"wallets": {
"solana": "<string>",
"evm": "<string>"
},
"status": "ready",
"retryAfterSeconds": 123,
"updatedAt": 123,
"nextUpdateAt": 123,
"stale": true,
"windows": {
"24h": {
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"totalPnlUsd": 123,
"returnPct": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"trades": 123,
"buys": 123,
"sells": 123,
"tokensTraded": 123,
"winningTokens": 123,
"status": "ready",
"updatedAt": 123,
"approximate": true
},
"7d": {
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"totalPnlUsd": 123,
"returnPct": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"trades": 123,
"buys": 123,
"sells": 123,
"tokensTraded": 123,
"winningTokens": 123,
"status": "ready",
"updatedAt": 123,
"approximate": true
},
"30d": {
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"totalPnlUsd": 123,
"returnPct": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"trades": 123,
"buys": 123,
"sells": 123,
"tokensTraded": 123,
"winningTokens": 123,
"status": "ready",
"updatedAt": 123,
"approximate": true
},
"all": {
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"totalPnlUsd": 123,
"returnPct": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"trades": 123,
"buys": 123,
"sells": 123,
"tokensTraded": 123,
"winningTokens": 123,
"status": "ready",
"updatedAt": 123,
"approximate": true
}
},
"unrealized": {
"unrealizedPnlUsd": 123,
"holdingsUsd": 123,
"positions": 123,
"excludedPositions": 123,
"status": "ready",
"updatedAt": 123
},
"pumpBoard": {
"daily": {
"rank": 123,
"pnlUsd": 123,
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"asOf": 123
},
"weekly": {
"rank": 123,
"pnlUsd": 123,
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"asOf": 123
},
"monthly": {
"rank": 123,
"pnlUsd": 123,
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"asOf": 123
}
}
}{
"error": {
"code": "BAD_REQUEST",
"message": "<string>",
"retryAfter": 123,
"addUrl": "<string>"
}
}One pump.fun account's realized and unrealized profit
Profit and trading activity across the whole wallet, on the same formula as GET /v2/user/handle//pnl.
- The wallet can be the Solana or the EVM wallet of the account. Both wallets pump.fun
links to the account are read and summed;
walletsnames them. 24h,7d,30dandalleach carryrealizedPnlUsd,unrealizedPnlUsdandtotalPnlUsd.allcovers every trade since 1 January 2025.unrealized: profit on what the wallets hold now. It leaves out spam, pools under $10,000 of liquidity and positions larger than their pool.staleis true when a figure is past its refresh age and could not be read again;nextUpdateAtis when the oldest figure falls due.pumpBoard: the Solana wallet’s standing pump.fun itself shows on its PnL boards, for reference.- The first call for a wallet reads it live, up to 8 seconds. A window that does not
finish in time comes back
pendingand is ready on the next call. - Only a
readyanswer is charged the hit price; every other answer is charged the miss price. - 404 when the wallet has no pump.fun user.
Price: 500 CU per call.
curl --request GET \
--url https://api.fomoscan.sh/v2/pump/user/wallet/{wallet}/pnl \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fomoscan.sh/v2/pump/user/wallet/{wallet}/pnl', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.fomoscan.sh/v2/pump/user/wallet/{wallet}/pnl"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"wallet": "<string>",
"username": "<string>",
"wallets": {
"solana": "<string>",
"evm": "<string>"
},
"status": "ready",
"retryAfterSeconds": 123,
"updatedAt": 123,
"nextUpdateAt": 123,
"stale": true,
"windows": {
"24h": {
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"totalPnlUsd": 123,
"returnPct": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"trades": 123,
"buys": 123,
"sells": 123,
"tokensTraded": 123,
"winningTokens": 123,
"status": "ready",
"updatedAt": 123,
"approximate": true
},
"7d": {
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"totalPnlUsd": 123,
"returnPct": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"trades": 123,
"buys": 123,
"sells": 123,
"tokensTraded": 123,
"winningTokens": 123,
"status": "ready",
"updatedAt": 123,
"approximate": true
},
"30d": {
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"totalPnlUsd": 123,
"returnPct": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"trades": 123,
"buys": 123,
"sells": 123,
"tokensTraded": 123,
"winningTokens": 123,
"status": "ready",
"updatedAt": 123,
"approximate": true
},
"all": {
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"totalPnlUsd": 123,
"returnPct": 123,
"volumeUsd": 123,
"buyVolumeUsd": 123,
"sellVolumeUsd": 123,
"trades": 123,
"buys": 123,
"sells": 123,
"tokensTraded": 123,
"winningTokens": 123,
"status": "ready",
"updatedAt": 123,
"approximate": true
}
},
"unrealized": {
"unrealizedPnlUsd": 123,
"holdingsUsd": 123,
"positions": 123,
"excludedPositions": 123,
"status": "ready",
"updatedAt": 123
},
"pumpBoard": {
"daily": {
"rank": 123,
"pnlUsd": 123,
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"asOf": 123
},
"weekly": {
"rank": 123,
"pnlUsd": 123,
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"asOf": 123
},
"monthly": {
"rank": 123,
"pnlUsd": 123,
"realizedPnlUsd": 123,
"unrealizedPnlUsd": 123,
"asOf": 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
pump.fun wallet, Solana or EVM. An EVM address matches case-insensitively.
1 - 128Response
Default Response
The wallet asked for.
The wallets read for this pump.fun account: the one asked for, and the wallet on the other chain that pump.fun links to the same account. Every figure covers both.
Show child attributes
Show child attributes
ready: figures are served; each window carries its own status. pending: nothing could be read within the wait; ask again after retryAfterSeconds. failed: the last reading failed and nothing is held yet. unavailable: whole-wallet reading is switched off or out of capacity. Only ready is charged the hit price.
ready, pending, failed, unavailable Set only when status is pending or failed.
Epoch ms of the oldest figure served. Null unless status is ready.
Epoch ms when the oldest figure served falls due to be read again; the first call after that moment reads it. Earlier than now when stale is true. Null unless status is ready.
True when at least one figure served is past its refresh age and could not be read again on this call, because reading is out of capacity or the read is still running. A later call can carry newer figures; updatedAt says how old the oldest one is.
One formula on every window: realized profit on average cost plus the unrealized profit of positions last traded in the window. 24h, 7d and 30d are UTC calendar days ending today.
Show child attributes
Show child attributes
Profit on what the wallets hold now. It has no window. Null until the positions have been read at least once.
Show child attributes
Show child attributes
The Solana wallet's standing on the latest pump.fun PnL boards, as pump.fun shows it, for reference. pump.fun computes these itself and they need not match the windows above. Null for a board the wallet is not on.
Show child attributes
Show child attributes