{"openapi":"3.0.3","info":{"title":"Graded read API","version":"1","description":"Read-only receipts for fomo.family and pump.fun traders. A pump.fun trader is a Solana wallet; pass platform=pump to list them. Optional x-api-key header when API_KEY is set. Not affiliated with FOMO Labs or pump.fun."},"servers":[{"url":"/"}],"paths":{"/api/v1/leaderboard":{"get":{"summary":"Current leaderboard snapshot","parameters":[{"name":"window","in":"query","schema":{"type":"string","enum":["all-time","30d","7d","24h"]}},{"name":"type","in":"query","schema":{"type":"string","enum":["both","spot","perp"]}},{"name":"limit","in":"query","schema":{"type":"integer","maximum":200}}]}},"/api/v1/traders":{"get":{"summary":"Traders ranked by score","parameters":[{"name":"platform","in":"query","schema":{"type":"string","enum":["fomo","pump"],"default":"fomo"}}]}},"/api/v1/traders/{handle}":{"get":{"summary":"Trader profile, stats, positions and recent fills: a fomo handle or a pump.fun wallet, with their callouts record over 90 days","parameters":[{"name":"handle","in":"path","required":true,"schema":{"type":"string"}}]}},"/api/v1/trades":{"get":{"summary":"Recent fills across tracked traders","parameters":[{"name":"platform","in":"query","schema":{"type":"string","enum":["fomo","pump"],"default":"fomo"}}]}},"/api/v1/alerts":{"get":{"summary":"Live tape events","parameters":[{"name":"platform","in":"query","schema":{"type":"string","enum":["fomo","pump"],"default":"fomo"}}]}},"/api/v1/tokens":{"get":{"summary":"Token universe with last price"}},"/api/v1/receipts":{"get":{"summary":"Trader scorecards (early rate, hit rates, exit quality, 30-day PnL)","parameters":[{"name":"platform","in":"query","schema":{"type":"string","enum":["fomo","pump"],"default":"fomo"}}]}},"/api/v1/fade":{"get":{"summary":"Traders whose buys most often arrive after the move","parameters":[{"name":"platform","in":"query","schema":{"type":"string","enum":["fomo","pump"],"default":"fomo"}}]}},"/api/v1/token/{pair}":{"get":{"summary":"Holders and deployer positions for address:networkId, with its callouts","parameters":[{"name":"pair","in":"path","required":true,"schema":{"type":"string"}}]}},"/api/v1/subscriptions":{"get":{"summary":"List alert subscriptions for this key"},"post":{"summary":"Create a webhook or Telegram alert subscription","requestBody":{"required":true}},"delete":{"summary":"Deactivate a subscription by id"}},"/api/v1/consensus":{"get":{"summary":"Tokens several high-receipts traders bought in a window","parameters":[{"name":"platform","in":"query","schema":{"type":"string","enum":["fomo","pump"],"default":"fomo"}}]}},"/api/v1/copy-sim":{"post":{"summary":"Simulate copying a trader (fomo handle or pump.fun wallet) with size, filters, stop and target","requestBody":{"required":true}}},"/api/v1/health":{"get":{"summary":"Row counts (free)"}},"/api/v1/callouts":{"get":{"summary":"Graded callouts on fomo, newest first: what a trader said about a coin, when, at what market cap, and the result 1h, 24h and 7d later (result1h, result24h, result7d, as fractions), with the caller's trader record (traderRecord). Answers rec, count, total (every call the filters hold) and next, the cursor for the page before (null on the last page).","parameters":[{"name":"trader","in":"query","description":"a fomo handle","schema":{"type":"string"}},{"name":"coin","in":"query","description":"address:networkId","schema":{"type":"string"}},{"name":"rec","in":"query","description":"callers by their trader record: top (Established and Proven, the default), proven or all. A trader's calls are all theirs unless rec is given","schema":{"type":"string","enum":["top","proven","all"],"default":"top"}},{"name":"since","in":"query","description":"calls at or after this time","schema":{"type":"string","format":"date-time"}},{"name":"before","in":"query","description":"calls older than this: an ISO time, or the next cursor of the page before","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}]}},"/api/v1/callers":{"get":{"summary":"fomo's callers ranked by how their calls did: trader record, call score, hit rates and median results at 1h, 24h and 7d, and the best call with its horizon. rank is the place by call score on the whole board, whatever the sort or rec; total is the callers rec holds, rankedOf the whole board.","parameters":[{"name":"window","in":"query","description":"days","schema":{"type":"integer","enum":[7,30,90],"default":90}},{"name":"sort","in":"query","description":"call score, up an hour later, up a day later, up a week later, most graded calls, or most coins","schema":{"type":"string","enum":["score","up1h","up24h","up7d","calls","coins"],"default":"score"}},{"name":"rec","in":"query","description":"callers by their trader record: top (Established and Proven, the default), proven or all","schema":{"type":"string","enum":["top","proven","all"],"default":"top"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}]}}}}