Read the newest snapshot of one of our rankings
curl --request GET \
--url https://api.fomoscan.sh/v3/rankings/{key} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fomoscan.sh/v3/rankings/{key}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.fomoscan.sh/v3/rankings/{key}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"key": "traders_net_flow_24h",
"title": "Traders by net flow, 24 hours",
"category": "spot_trading",
"metric": "net_flow",
"window": "24h",
"order": "best",
"dataAsOf": "2026-11-01T08:35:00.000Z",
"computedAt": "2026-11-01T08:40:00.000Z",
"total": 9420,
"entries": [
{
"rank": 1,
"subject": {
"kind": "trader",
"id": "tdr_01jbst8pvcfp79y0938nkrkayd",
"canonical": {
"display": {
"handle": "nightowl",
"name": "Night Owl",
"avatarUrl": "https://img.example.com/a/9b1f0c7e3d2a4b5c8e6f1a2b3c4d5e6f.webp"
},
"platforms": [
"fomo",
"pump"
],
"mergedFrom": [
"tdr_01jbst8zcefy8b28t5cy4tqkff"
],
"firstSeenAt": "2025-03-14T16:20:05.412Z"
},
"sources": {
"fomo": {
"profile": {
"handle": "nightowl",
"name": "Night Owl",
"bio": "Solana memecoins, small size, long holds.",
"avatarUrl": "https://img.example.com/a/9b1f0c7e3d2a4b5c8e6f1a2b3c4d5e6f.webp",
"xHandle": "nightowl_sol",
"verified": null,
"observedAt": "2026-11-01T08:42:10.250Z"
},
"followGraph": {
"followers": 18450,
"following": 312,
"observedAt": "2026-11-01T08:42:10.250Z"
},
"tradingStats": {
"swapCount": 1840,
"tradeCount": 977,
"volume": {
"value": "482113250000",
"decimals": 6,
"currency": "USD"
},
"avgHoldSeconds": 15120.5,
"observedAt": "2026-11-01T08:42:10.250Z"
}
},
"pump": {
"profile": {
"handle": "nightowl",
"name": null,
"bio": "Solana memecoins, small size, long holds.",
"avatarUrl": "https://img.example.com/a/9b1f0c7e3d2a4b5c8e6f1a2b3c4d5e6f.webp",
"xHandle": "nightowl_sol",
"verified": false,
"observedAt": "2026-11-01T08:42:10.250Z"
},
"followGraph": {
"followers": 2210,
"following": 312,
"observedAt": "2026-11-01T08:42:10.250Z"
}
}
}
},
"value": {
"value": "4210330000",
"decimals": 6,
"currency": "USD"
},
"measures": {
"volume": {
"value": "18050500000",
"decimals": 6,
"currency": "USD"
},
"trade_count": 21,
"roi": 60.84217174
}
},
{
"rank": 2,
"subject": {
"kind": "trader",
"id": "tdr_01jbst8v3xft7t04hmasw9nf6y",
"canonical": {
"display": {
"handle": "tidecaller",
"name": null,
"avatarUrl": null
},
"platforms": [
"fomo"
],
"mergedFrom": [],
"firstSeenAt": "2025-08-19T12:03:44.090Z"
},
"sources": {
"fomo": {
"profile": {
"handle": "tidecaller",
"name": null,
"bio": null,
"avatarUrl": null,
"xHandle": null,
"verified": null,
"observedAt": "2026-10-30T22:10:09.533Z"
}
}
}
},
"value": {
"value": "2877120000",
"decimals": 6,
"currency": "USD"
},
"measures": {
"volume": {
"value": "20977000000",
"decimals": 6,
"currency": "USD"
},
"trade_count": 48,
"roi": 31.79159199
}
}
]
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}Rankings
Read the newest snapshot of one of our rankings
The newest snapshot of one of our rankings.
order=best: rank 1 first, then subject id.order=worst: the bottom entries, lowest value first.- Ties share a rank, 1 plus the number of subjects with a better value, on both orders.
totalcounts every ranked subject;entriesholds at mostsizeof them and is not paged.- Our rankings never mix with the platforms’ boards (
GET /v3/leaderboards/{platform}/{board}).
Price
The price depends on the answer.
| Answer | Credits | Reveals |
|---|---|---|
| A snapshot exists. | 500 | 0 |
| 404: the ranking has no snapshot yet. | 200 | 0 |
404: the key is not in GET /v3/rankings. | 0 | 0 |
Limits
- 600 requests per minute from one address on this operation, beside the per-minute limit of the key.
- A key with less than 200 credits left gets 402
QUOTA_EXCEEDEDbefore any work.
GET
/
v3
/
rankings
/
{key}
Read the newest snapshot of one of our rankings
curl --request GET \
--url https://api.fomoscan.sh/v3/rankings/{key} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fomoscan.sh/v3/rankings/{key}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.fomoscan.sh/v3/rankings/{key}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"key": "traders_net_flow_24h",
"title": "Traders by net flow, 24 hours",
"category": "spot_trading",
"metric": "net_flow",
"window": "24h",
"order": "best",
"dataAsOf": "2026-11-01T08:35:00.000Z",
"computedAt": "2026-11-01T08:40:00.000Z",
"total": 9420,
"entries": [
{
"rank": 1,
"subject": {
"kind": "trader",
"id": "tdr_01jbst8pvcfp79y0938nkrkayd",
"canonical": {
"display": {
"handle": "nightowl",
"name": "Night Owl",
"avatarUrl": "https://img.example.com/a/9b1f0c7e3d2a4b5c8e6f1a2b3c4d5e6f.webp"
},
"platforms": [
"fomo",
"pump"
],
"mergedFrom": [
"tdr_01jbst8zcefy8b28t5cy4tqkff"
],
"firstSeenAt": "2025-03-14T16:20:05.412Z"
},
"sources": {
"fomo": {
"profile": {
"handle": "nightowl",
"name": "Night Owl",
"bio": "Solana memecoins, small size, long holds.",
"avatarUrl": "https://img.example.com/a/9b1f0c7e3d2a4b5c8e6f1a2b3c4d5e6f.webp",
"xHandle": "nightowl_sol",
"verified": null,
"observedAt": "2026-11-01T08:42:10.250Z"
},
"followGraph": {
"followers": 18450,
"following": 312,
"observedAt": "2026-11-01T08:42:10.250Z"
},
"tradingStats": {
"swapCount": 1840,
"tradeCount": 977,
"volume": {
"value": "482113250000",
"decimals": 6,
"currency": "USD"
},
"avgHoldSeconds": 15120.5,
"observedAt": "2026-11-01T08:42:10.250Z"
}
},
"pump": {
"profile": {
"handle": "nightowl",
"name": null,
"bio": "Solana memecoins, small size, long holds.",
"avatarUrl": "https://img.example.com/a/9b1f0c7e3d2a4b5c8e6f1a2b3c4d5e6f.webp",
"xHandle": "nightowl_sol",
"verified": false,
"observedAt": "2026-11-01T08:42:10.250Z"
},
"followGraph": {
"followers": 2210,
"following": 312,
"observedAt": "2026-11-01T08:42:10.250Z"
}
}
}
},
"value": {
"value": "4210330000",
"decimals": 6,
"currency": "USD"
},
"measures": {
"volume": {
"value": "18050500000",
"decimals": 6,
"currency": "USD"
},
"trade_count": 21,
"roi": 60.84217174
}
},
{
"rank": 2,
"subject": {
"kind": "trader",
"id": "tdr_01jbst8v3xft7t04hmasw9nf6y",
"canonical": {
"display": {
"handle": "tidecaller",
"name": null,
"avatarUrl": null
},
"platforms": [
"fomo"
],
"mergedFrom": [],
"firstSeenAt": "2025-08-19T12:03:44.090Z"
},
"sources": {
"fomo": {
"profile": {
"handle": "tidecaller",
"name": null,
"bio": null,
"avatarUrl": null,
"xHandle": null,
"verified": null,
"observedAt": "2026-10-30T22:10:09.533Z"
}
}
}
},
"value": {
"value": "2877120000",
"decimals": 6,
"currency": "USD"
},
"measures": {
"volume": {
"value": "20977000000",
"decimals": 6,
"currency": "USD"
},
"trade_count": 48,
"roi": 31.79159199
}
}
]
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}Authorizations
bearerAuthapiKeyHeader
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
A ranking key, as GET /v3/rankings lists it.
Pattern:
^[a-z][a-z0-9_]{2,63}$Query Parameters
best (the default): rank 1 first. worst: the bottom entries, lowest value first.
Available options:
best, worst Response
OK
The newest snapshot of one of our rankings.
The ranking key, for GET /v3/rankings/{key}.
A title to show.
What the board or ranking ranks.
Available options:
perp_trading, spot_trading, prediction, content, impressions, social, referrals, tokens, groups The metric the ranking orders by.
Available options:
pnl, net_flow, portfolio_value, price, liquidity, roi, volume, trade_count, win_rate, impressions, views, likes, followers, holders, market_cap, members, points, realized_pnl, unrealized_pnl The time window of the metric, or null for no window.
Available options:
24h, 7d, 30d, 90d, all best: the top entries. worst: the bottom entries, lowest value first.
Available options:
best, worst The time of the newest data the snapshot used.
Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d\.\d{3}(?:Z))$When we computed the snapshot.
Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d\.\d{3}(?:Z))$Subjects ranked. entries holds at most size of them.
Required range:
0 <= x <= 9007199254740991The entries in order. Not paged.
Show child attributes
Show child attributes