# pumpfomo API The data API for pump.fun and fomo.family: traders, wallets, coins, PnL, leaderboards, callouts and live trades on Solana and 11 EVM chains, over REST and one WebSocket. Read-only: nothing here trades, signs or holds funds. pumpfomo is independent, not pump.fun or fomo.family. - Base URL: `https://api.pumpfomo.com` - Stream: `wss://api.pumpfomo.com/v1/stream` - Keys: https://pumpfomo.com/dashboard/keys?ref=ai-docs (sign in with a wallet or Telegram; the Free plan has 2,500 credits a month) - Every endpoint: https://pumpfomo.com/llms.txt ## Authentication Send the API key as Authorization: Bearer or X-API-Key: . Keys start with pf_live_. Each key holds scopes: read:pump, read:fomo, read:wallet, stream. Keep keys on a server and read them from the environment (for example `PUMPFOMO_API_KEY`). A key in browser code is a key anyone can use. `GET /v1/ping` (free) checks a key. ## Answers Success: `{"data": , "meta": {"source": "pump.fun|fomo.family", "cache": "cache|stale|live|shared", "fetchedAt": ""}}. The wallet routes use their own meta (see them).` `meta.cache`: live when the data was read for this request; otherwise a copy a few seconds old. fetchedAt says when the data was read. Errors: `{"error": {"code": "", "message": "", "requestId": "req_…"}}`. Branch on `code`, not on `message`. Field names follow pump.fun's and fomo.family's own answers: snake_case and camelCase both occur. ## Headers | Header | Meaning | |---|---| | `X-Credits-Cost` | What this call cost (0 for errors, 1 for a miss). Not sent on free routes. | | `X-Credits-Remaining` | Credits left on the account after this call. | | `X-Reveals-Remaining` | On wallet lookups: the plan's wallet reveals left this period. Not sent when the plan has no cap. | | `RateLimit-Limit` | The key's burst size (requests). | | `RateLimit-Remaining` | Requests left in the bucket now. | | `RateLimit-Reset` | Seconds until the bucket is full again. | | `Retry-After` | On 429: seconds to wait. | | `X-Request-Id` | Our id for the request; quote it to support. | ## Credits - Every call costs the credits listed on its endpoint; a list costs per page, whatever the page size asked. - A miss (404 not_found) costs 1 credit. Lists are different: for an input with nothing in it (a wallet that never traded, an unknown user's followers) pump.fun and fomo.family answer an empty list, and an empty page costs the page's price. - Errors are free: 400, 401, 402, 403 and 429, and any call that fails (5xx, refunded automatically). - Wallet reveals: a wallet lookup that finds someone (500 credits; 250 each in POST /v1/wallets/batch, 50 when none is). Each plan allows a number a month (Free 10, Starter 300, Builder 1,000, Growth 3,000, Scale 8,000); past it a lookup answers 402 reveal_limit_reached and isn't charged. Packs add credits, not reveals. - Other batch routes cost a flat price per call. In every batch a repeated item is asked once and doesn't count toward the limit. - A live stream costs 10 credits a minute while it is open, charged as each minute starts, with nothing by the message. The plan sets how many may be open at once (Builder 1, Growth 5, Scale 15). A period bought before 12 November 2026, when streams were included, keeps them free until it renews. - Account, key and plan routes are free. Plans: Free 2,500 credits a month (2 requests a second, burst 10), Starter 100,000 (10/s), Builder 500,000 (25/s, 1 stream), Growth 2,000,000 (60/s, 5 streams), Scale 7,500,000 (150/s, 15 streams), monthly or yearly. Prices: https://pumpfomo.com/#pricing ## Retries - 429 `rate_limited`: wait `Retry-After` seconds, then retry. - 503 (`upstream_busy`, `upstream_unavailable`) and other 5xx: retry with backoff (1 s, 2 s, 4 s…). Not charged. - 400, 401, 402 and 403 won't change on retry: fix the request, the key, the scope or the plan. ## Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | a path or query value is out of its allowed shape or range (free) | | 400 | `bad_request` | the JSON body is not valid for the endpoint (free) | | 401 | `missing_key` | no API key sent | | 401 | `invalid_key` | the key was revoked, expired or never existed | | 402 | `credits_exhausted` | no credits left: top up or change plan | | 402 | `reveal_limit_reached` | a wallet lookup past the plan's wallet reveals for the period (free) | | 403 | `scope_missing` | the key lacks the endpoint's scope | | 403 | `ip_not_allowed` | the key is limited to other IP addresses | | 403 | `free_plan_in_use` | a free account's key, from an address another free account's keys called from in the last 24 hours (the free plan is one per person; paid plans aren't limited) | | 404 | `not_found` | nothing found for it (1 credit), or no such endpoint (free) | | 429 | `rate_limited` | over the plan's rate; see Retry-After (free) | | 500 | `internal` | something failed on our side (free) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (free) | | 503 | `upstream_unavailable` | pump.fun or fomo.family did not answer (free) | # Live stream (WebSocket) `wss://api.pumpfomo.com/v1/stream` Authentication: An API key with the stream scope: Authorization: Bearer or X-API-Key: on the upgrade request, or ?key= from a browser. Cost: 10 credits a minute while open, charged as each minute starts; nothing by the message. The plan sets how many connections may be open at once. A period bought before 12 November 2026 keeps streams free until it renews. Open one connection and send JSON ops on it; it carries every channel you subscribe to. Reconnect with backoff when it closes, then subscribe again. Don't reconnect in a loop on 4003: the plan's connections are all in use, or it has none. ## Ops - `{"op":"subscribe","channel":"trades","minUsd":1000}`: Subscribe to a channel; a new subscribe to the same channel replaces its filter. - `{"op":"unsubscribe","channel":"coins"}`: Stop a channel; answered with an unsubscribed message. - `{"op":"ping"}`: Answered with {"type":"pong","ts":}. ## Channel `trades` pump.fun trades on Solana and 11 EVM chains, as they happen. Filter by coins, by wallets, or take every trade of $1,000 or more (minUsd >= 1000 with no coins or wallets). Each trade carries the trader's profile when the wallet is known. ```json {"op":"subscribe","channel":"trades","mints":["Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh"],"wallets":["Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14"],"chains":["solana"],"side":"buy","minUsd":100} ``` | Filter | Type | Notes | |---|---|---| | `mints` | array | Coin addresses (up to 1,000). | | `wallets` | array | Wallet addresses (up to 1,000). | | `chains` | array | solana, base, bnb, ethereum, robinhood, monad, arc, xlayer, megaeth, polygon, ink, hyperevm (empty: all). | | `side` | string | buy or sell (empty: both). | | `minUsd` | number | Smallest trade in USD; must be at least 1000 when no mints or wallets are given. | Messages: `subscribed`, `trade` ## Channel `traders` The trades of chosen people: pump.fun traders by user id or wallet (all of their known wallets are followed) and fomo.family traders by handle (their trades and theses come as fomo_trade). It has its own filter: subscribing or unsubscribing traders leaves the trades and fomo channels as they are, and the other way round. ```json {"op":"subscribe","channel":"traders","pump":["400bfe0b-a8e9-4d4f-aac0-46408e7b6127"],"fomo":["rez404"]} ``` | Filter | Type | Notes | |---|---|---| | `pump` | array | pump.fun user ids or wallets (up to 1,000); unknown ones are listed in pumpNotFound. (an empty list when all were found). | | `fomo` | array | fomo.family handles (up to 100); unknown ones are listed in fomoNotFound. (an empty list when all were found). | | `chains` | array | As on trades. | | `side` | string | buy or sell. | | `alerts` | boolean | Also send fomo_alert (the global feed). | | `replay` | boolean | false: no replay (default true). | Messages: `subscribed`, `trade`, `fomo_trade`, `replay` ## Channel `coins` Coins as they are created on pump.fun. ```json {"op":"subscribe","channel":"coins"} ``` | Filter | Type | Notes | |---|---|---| | `replay` | boolean | false: no replay of recent launches (default true). | Messages: `subscribed`, `coin`, `replay` ## Channel `callouts` pump.fun callouts as they are posted, with author, thesis and market cap at the call. Optionally only for chosen coins. ```json {"op":"subscribe","channel":"callouts","mints":[]} ``` | Filter | Type | Notes | |---|---|---| | `mints` | array | Only callouts on these coins (empty: all). | | `replay` | boolean | false: no replay (default true). | Messages: `subscribed`, `callout`, `replay` ## Channel `fomo` Trades and theses of fomo.family traders (by default every tracked trader; or the handles given), and with alerts: true fomo.family's global activity feed (large buys and sells, theses, listings…). Optionally only for chosen tokens. ```json {"op":"subscribe","channel":"fomo","fomo":["rez404"],"tokens":[],"alerts":true} ``` | Filter | Type | Notes | |---|---|---| | `fomo` | array | fomo.family handles (up to 100; empty: every tracked trader). | | `tokens` | array | Only events on these token addresses. | | `alerts` | boolean | Also send fomo_alert (default false). | | `replay` | boolean | false: no replay (default true). | Messages: `subscribed`, `fomo_trade`, `fomo_alert`, `replay` ## Messages ### `welcome` First message: the connection id, how many streams the plan allows, the cost per minute and the channels (trades, traders, coins, callouts, fomo). ```json { "channels": [ "trades", "traders", "coins" ], "connectionId": "str_c0mvog05pdy69k0lncxheh4db", "costPerMinute": 10, "streams": 1, "type": "welcome" } ``` ### `subscribed` A subscribe took effect; echoes the channel and what the filter resolved to (counts of mints and wallets, minUsd; for traders pumpWallets, pumpNotFound, fomoTraders, fomoNotFound; for fomo traders, notFound, tokens, alerts). Lists of not-found entries are null when empty. ```json { "channel": "trades", "minUsd": 1000, "mints": 0, "type": "subscribed", "wallets": 0 } ``` ### `unsubscribed` An unsubscribe took effect. ```json { "channel": "coins", "type": "unsubscribed" } ``` ### `trade` A pump.fun trade: platform, chain (by name), mint, tx, side, wallet, amountUsd, amountNative, baseAmount, priceUsd, and when known marketCapUsd, protocol, pool and trader {platform, userId, handle, displayName, avatar}. ts is unix ms. EVM addresses are lower-case. ```json { "type": "trade", "platform": "pump", "chain": "robinhood", "mint": "0x898588e7d2b77527476bbc877fc73bc49fcec188", "tx": "0xbd9acdda89c8ee40e887a90d35093757804e97ad191f8a4dc706187a92320f1a", "side": "buy", "wallet": "0x204faca1764b154221e35c0d20abb3c525710498", "amountUsd": 1063.2445387171012, "amountNative": 0.4550595082298041, "baseAmount": 1149437.3791096797, "priceUsd": 0.0009464076594104132, "marketCapUsd": 946407.6594104132, "protocol": "UNISWAP_V4", "pool": "0x722fb6eac3ec7bd0f27bbd7f99ccb0ed886840c749b30377863c5f75b25569ae", "ts": 1792969931000 } ``` ### `coin` A new pump.fun coin: mint, name, symbol, creator, bonding curve, metadata URI, market cap (SOL, as a string), program, chain and flags. launchpad is where the coin was made (pump, bags, dbc, raydium_launchpad…): pump.fun's feed carries other launchpads' coins too. ```json { "bonding_curve": "p5MNjTFoXkWny4WwC2o4JYPwMQe8imzVMwZA76T3uz6", "chain": "solana", "created_timestamp": "2026-10-25T23:12:21+00:00", "creator": "2jNfWH2KQGpGoxe4RoMquZW81H7XokmAbF6LM8AhH423", "market_cap": "9855.039016761142984178100000", "metadata_uri": "https://41df0601-1b06-4ee4-b50f-06309c657341-00-3rseyie81h6oc.janeway.replit.dev/api/metadata/1792969928252-72aodr3xygs", "mint": "3gTjbf3mQJu1BHgKedtmnN7KmZdvhgVpeBM59Rga11Wk", "name": "Blueprint", "program": "meteora_dbc", "symbol": "BLUEPRINT", "ts": 1792969941000, "type": "coin", "platform": "pump", "launchpad": "pump" } ``` ### `callout` A new pump.fun callout: calloutId, mint, chain, calledOutAtMcap, costBasisUsd, flagged, and pump.fun's full callout record under callout.callout (thesis, author name and image, prices). ```json { "calledOutAtMcap": 107958, "callout": { "callout": { "calloutId": "a1dedbd9-16ed-4999-8906-cdfc96ca99bf", "userId": "7973a8ys7B64sGgqHmXcNrcARCHSSYps9gH3psjVjJXd", "coinMint": "ERXyWGqsEhfxSCuZrpgH3tm16moY47uXtcBknS29kmch", "marketCap": 107958, "calloutPrice": 0.0000010870629728495544, "calloutPriceUsd": 0.000110307363382, "multiple": 1, "createdAt": 1792969932794, "maxPriceSol": 0.0000010870629728495544, "maxPriceUsd": 0.000110307363382, "thesis": "Kimchi flies first class", "user_uuid": "9065b05e-1062-4162-8d8f-0e641c96ba40", "likes": 0, "hasLiked": null, "hasReposted": null, "repostCount": 0, "quoteCount": 0, "updates": [], "updateCount": 0, "commentCount": 0, "replyCount": 0, "maxMultiplier": 1, "maxMultiplierAt": null, "mediaUrl": null, "quotedCalloutId": null, "quotedCallout": null, "chain": null, "perp": null, "userName": "oddstarfish5554", "profileImage": "https://socialimages.pump.fun/profile-images/9065b05e-1062-4162-8d8f-0e641c96ba40/200699a5-87e5-4736-88af-9f8b37108e13", "isVer … (cut) ``` ### `fomo_trade` A buy, sell or thesis of a followed fomo.family trader: kind, amountUsd, priceUsd, marketCapUsd, token {address, chain, networkId, ticker, image}, trader {userId, handle, displayName, avatar}, tradeId and a link to the profile. ```json { "amountUsd": 100, "id": "9bde7890-de43-4f97-88d3-a125264cfddb", "isDev": false, "kind": "buy", "links": { "trader": "https://fomo.family/profile/mugiwaranomoney" }, "marketCapUsd": 25122.7, "platform": "fomo", "priceUsd": 0.0000255375, "token": { "address": "3NVMMPAYA84Sj1s5ACgazozvusm1PXE1LkXcAaQLpump", "chain": "solana", "image": "https://…/image.png", "networkId": 1399811149, "ticker": "CRIME" }, "tradeId": "43e5679b-c984-487f-a21e-0e350d563fe2", "trader": { "platform": "fomo", "userId": "0fa6d697-009f-522f-a86e-c5a4d4604a66", "handle": "mugiwaranomoney", "displayName": "lefou", "avatar": "https://…/image.png" }, "ts": 1792966780000, "type": "fomo_trade" } ``` ### `fomo_alert` An item of fomo.family's global feed: alert (the feed type, e.g. large_buy), body (type-specific: who, token, sizes, PnL), token, userId, tradeId. ```json { "alert": "large_buy", "body": { "avgCost": 0.00894456, "currentSizeUsd": 1498.3, "displayName": "hboring20", "fdv": 8781140, "humanTokenAmount": 167509.41, "inHumanAmount": 1505.74, "inTokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "isFirstBuy": true, "marketCap": "8781140", "numSwaps": 1, "outHumanAmount": 167509.41, "outTokenAddress": "nxPqZ4F7ux8Vph5NFu25rEP6Kx9Gr1U6Fmj36Rjpump", "percentPnl": 0, "price": 0.00886498180428, "realizedPnlUsd": 0, "tag": null, "ticker": "Dacity", "tokenImageUrl": "https://…/image.png", "userHandle": "hboring20", "userId": "a5e8d003-6ac3-5400-bef3-9bc885ca95fe", "userImageUrl": null }, "id": "30c36c34-f51a-58fc-bbba-a869564a58e9", "platform": "fomo", "token": { "address": "nxPqZ4F7ux8Vph5NFu25rEP6Kx9Gr1U6Fmj36Rjpump", "chain": "solana", "networkId": 1399811149 }, "tradeId": "765ab489-3fc7-4693-b299-d20c30b8d37c", "ts": 1792969925000, "type": "fomo_alert", "userId": "a5e8d003-6ac3-5400-bef3-9bc885ca95fe" } ``` ### `replay` Sent right after a subscribe: {kind, events} with up to 50 of the latest matching events of that kind, oldest first. ```json { "events": [ { "bonding_curve": "6MC2yY2fgZZ71H63r8sPowKHVFaJ85Leyi6eovrgnYS4", "chain": "solana", "created_timestamp": "2026-10-25T23:10:25+00:00", "creator": "BBCWwenKpyoBKRuqwDP9QkJm4777y961AC697kGvotnR", "is_cashback_enabled": false, "is_holder_reward": false, "market_cap": "27.958993476234855545200372787", "metadata_uri": "https://ipfs.io/ipfs/bafkreiggssto3svgkejuzmluwy2gs74vcasv6jrui3dq3uegqfcmyxwbcq", "mint": "7z4bohDhURhoFY8dJwrePvFJCwFScd4PKJAkUSetpump", "name": "squeeze.fund", "platform": "pump", "program": "pump", "symbol": "Squeeze", "ts": 1792969825000, "type": "coin" } ], "kind": "coin", "type": "replay" } ``` ### `pong` The answer to {"op":"ping"}, with the server time in ms. ```json { "ts": 1792969932006, "type": "pong" } ``` ### `error` A message was refused: code bad_request (unknown op or channel, a bad filter) or too_fast (over 10 messages a second), the channel and a message. The connection stays open. ```json { "channel": "nope", "code": "bad_request", "message": "channel is trades, traders, coins, callouts or fomo", "type": "error" } ``` ## Limits - connectionsAtOnce: set by the plan: Free 0, Starter 0, Builder 1, Growth 5, Scale 15 (plans bought before 28 October 2026 keep theirs) - clientMessages: at most 10 a second (bursts of 20); more get an error "too_fast" - maxMessageBytes: 65536 - maxMints: 1000 - maxWallets: 1000 - maxPumpTraders: 1000 - maxFomoTraders: 100 - firehoseMinUsd: 1000 - replay: on subscribe, up to 50 of the latest matching events of coins, callouts and fomo (and the fomo traders of traders) come in one replay message; send "replay": false to skip it - serverQueue: 4096 messages; a client that falls behind, or stops reading (no pong within 10 s), is closed with 4008 - keepAlive: the server sends WebSocket pings every 25 s; {"op":"ping"} gets a pong message ## Reconnecting We update the server from time to time. Open streams are then closed with 1012, and the server is back within a few seconds. Reconnect with a growing wait (1 s, 2 s, 4 s and so on, up to 30 s), send your subscribe messages again, and let the replay fill what you missed. A connection can also drop for network reasons with no close code (1006): handle it the same way. Don't reconnect on 4002 or 4003: fix the credits or the plan first. ## Close codes | Code | Meaning | |---|---| | 1000 | normal close | | 1012 | the server is restarting for an update: reconnect in a few seconds and subscribe again | | 4000 | a message that is not a JSON object with an op | | 4002 | credits used up | | 4003 | the plan has no streams, or all of its streams are already open | | 4008 | too slow: messages were dropped; subscribe to less or read faster | # General ## Ping `GET https://api.pumpfomo.com/v1/ping` Checks an API key and says which key, account and scopes it speaks for. A free key test: any valid key works, whatever its scopes. Use it to check a new key, or that a key still works from a server whose IP allow-list you set. - Cost: free - Access: any valid API key - Reference: https://pumpfomo.com/docs/ping ### Example ```bash curl -s "https://api.pumpfomo.com/v1/ping" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "accountId": "acc_c0mvoayambrnxm7m8vlfaxsci", "keyId": "key_c0mvoayamqaunqm1fxa53o3m8", "ok": true, "scopes": [ "read:fomo", "read:pump", "read:wallet" ] } ``` ### Errors | Status | Code | When | |---|---|---| | 401 | `missing_key` | no key sent | | 401 | `invalid_key` | the key was revoked, expired or never existed | | 403 | `ip_not_allowed` | the key is limited to other IP addresses | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | # Wallets ## Who is this wallet `GET https://api.pumpfomo.com/v1/wallets/{address}` Reverse lookup: the fomo.family and pump.fun people behind a wallet. The fomo.family and pump.fun people a wallet belongs to, with all of their known wallets. meta.fomo is "not_indexed" when the wallet isn't known as a fomo.family wallet yet; that doesn't prove it isn't one. The meta object here is {fomo}, not the usual source/cache. Each wallet has a role: trading (the wallet a fomo.family trader's trades are made from; matches says how many of their trades confirm it), main (on the profile), signer (signs their swaps), recipient (receives their cross-chain swaps) or receive (got a transfer addressed to them). - Cost: 500 credits (500 per answer, each a wallet reveal (capped a month by the plan); 1 when nobody is known for the wallet (404)) - Access: read:wallet - Reference: https://pumpfomo.com/docs/wallet ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `address` | path | string | yes | Wallet address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/wallets/FgactYhd2nkUxWfBgY435reoWq2HYsw3AqyRnfaRDfbF" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "address": "FgactYhd2nkUxWfBgY435reoWq2HYsw3AqyRnfaRDfbF", "chainKind": "svm", "fomo": [ { "platform": "fomo", "userId": "6d8c0bf3-5d42-506c-a0ea-9e1e75ff38af", "handle": "pointfarmcap", "displayName": "point farm capital", "avatarUrl": "https://…/image.png", "wallets": [ { "address": "0x2c56846e43eb73d39c5d3791f8ff1e02f10ba596", "chainKind": "evm", "role": "main", "source": "fomo", "firstSeen": "2026-10-25T21:44:26.011117Z", "lastSeen": "2026-10-25T23:19:39.483824Z" }, { "address": "6cerGpSGzCrA1NeHUNtyoNm4rWQx5SnK3DSAXb4e615t", "chainKind": "svm", "role": "main", "source": "fomo", "firstSeen": "2026-10-25T21:44:26.011117Z", "lastSeen": "2026-10-25T23:19:39.483824Z" }, { "address": "0xa94c44a872931873252899347729ac780cb9ede5", "chainKind": "evm", "role": "signer", "source": "fomo", "firstSeen": "2026-10-25T22:38:14.959762Z", "lastSeen": "2026-10-25T23:19:20.48388Z" } ], "lastSeen": "2026-10-25T23:19:39.483824Z" } ], "pump": [] }, "meta": { "fomo": "indexed" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | address is not a Solana or EVM address | | 402 | `reveal_limit_reached` | the plan's wallet reveals for the period are used up (not charged; they renew with the next period) | | 404 | `not_found` | no fomo.family or pump.fun person known for the wallet yet (costs 1 credit) | | 403 | `scope_missing` | the key lacks read:wallet | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Who are these wallets (batch) `POST https://api.pumpfomo.com/v1/wallets/batch` Reverse lookup for up to 100 wallets in one call. The batch form of GET /v1/wallets/{address}. Results are keyed by the (EVM lower-cased) address; wallets nobody is known for are listed in data.notFound. You pay only for wallets answered. Past the period's wallet reveals, the rest are listed in data.limited, unanswered and free. Each wallet has a role, as in GET /v1/wallets/{address}. - Cost: 250 per wallet answered, each a wallet reveal (capped a month by the plan); 50 when none is - Access: read:wallet - Reference: https://pumpfomo.com/docs/wallets-batch ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `addresses` | body | array | yes | Wallet addresses (Solana or EVM), 1 to 100; duplicates are merged. Unknown body fields are refused. Range 1 to 100. Example `["Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14"]`. | ### Request body ```json { "addresses": [ "Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14", "DXiruTAJsq2WrTZmS7n5i8WeBy7RthbQ85fyhNBekhJ4", "9gbYLSYhHqXrTWbGZxrohXCGvoceGZCW9kaLYqksi917" ] } ``` ### Example ```bash curl -s -X POST "https://api.pumpfomo.com/v1/wallets/batch" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"addresses":["Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14","DXiruTAJsq2WrTZmS7n5i8WeBy7RthbQ85fyhNBekhJ4","9gbYLSYhHqXrTWbGZxrohXCGvoceGZCW9kaLYqksi917"]}' ``` Answer (200), shortened: ```json { "data": { "notFound": [ "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU" ], "results": { "0x3d4be0094091914fb44cffe2385768f85a9d31c1": { "fomo": [ { "platform": "fomo", "userId": "a81e1b97-4342-577c-9283-bb977aeb0c43", "handle": "rez404", "displayName": "rez404", "avatarUrl": "https://…/image.png", "wallets": [ { "address": "0x3d4be0094091914fb44cffe2385768f85a9d31c1", "chainKind": "evm", "role": "signer", "source": "fomo", "firstSeen": "2026-10-25T21:56:52.84199Z", "lastSeen": "2026-10-25T23:19:17.480861Z" } ], "lastSeen": "2026-10-25T23:19:17.480861Z" } ], "fomoState": "indexed", "pump": [] }, "4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR": { "fomo": [], "fomoState": "not_indexed", "pump": [ { "platform": "pump", "userId": "1e2df2f0-4720-4edb-a6d2-dd2833300de9", "handle": "J777Crypto", "avatarUrl": "https://socialimages.pump.fun/profile-images/1e2df2f0-4720-4edb-a6d2-dd2833300de9/312a5881-7336-4891-a58a-d05e762a9e60", "wallets": [ { "address": "4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR", "chainKind": "svm", "role" … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | addresses is empty, has more than 100 wallets, or one is not an address | | 400 | `bad_request` | the body is not JSON {"addresses": [...]} (unknown fields are refused) | | 402 | `credits_exhausted` | no credits left | | 402 | `reveal_limit_reached` | the plan's wallet reveals for the period are used up (not charged; they renew with the next period) | | 403 | `scope_missing` | the key lacks read:wallet | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | # pump.fun users ## pump.fun profile `GET https://api.pumpfomo.com/v1/pump/users/{id}` A pump.fun profile by wallet or user id: name, avatar, bio, follower counts, wallets. The pump.fun profile behind a wallet (Solana or EVM) or a user id: username, images, bio, follower and following counts, the canonical Solana and EVM wallets and group badges. Use it to turn a wallet into a person or to get the userId that the follow, activity and stream routes take. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `id` | path | string | yes | A wallet address (Solana or EVM) or a pump.fun user id (UUID). Example `Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/users/4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "address": "4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR", "userId": "1e2df2f0-4720-4edb-a6d2-dd2833300de9", "is_pump_user": true, "is_banned": false, "username": "J777Crypto", "profile_image": "https://socialimages.pump.fun/profile-images/1e2df2f0-4720-4edb-a6d2-dd2833300de9/312a5881-7336-4891-a58a-d05e762a9e60", "header_image_url": "https://socialimages.pump.fun/profile-images/1e2df2f0-4720-4edb-a6d2-dd2833300de9/c1fd4392-a257-4e5d-b26c-d4d5967edbbe", "avatar_decoration": "achievement:views-1m", "resolved_avatar_decoration": "achievement:views-1m", "kind": "person", "member_count": 0, "active_competition_entry": null, "last_username_update_timestamp": 1787071472270, "following": 89, "followers": 226955, "bio": "We Win ", "x_username": "J777Crypto", "canonical_svm_wallet": "4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR", "canonical_evm_wallet": "0xe48b6e0e9900d68ba93ac417d9e2ce911c52f753", "group_badges": [ { "group_id": "cc8091d7-d628-4abd-93b1-ada1e6ef23fa", "username": "Dabal", "profile_image_url": "https://socialimages.pump.fun/profile-images/d94bd517-1cbe-4ec5-88e8-96232986d487/c5c93a8a-8013-4d2c-a91c-329f93dc8733", "role": "MEMBER" } ] }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:10:25.405Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | id is neither an address nor a UUID | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## A trader's trades `GET https://api.pumpfomo.com/v1/pump/users/{id}/trades` A pump.fun trader's trades and/or transfers, newest first, 100 a page. Every trade (and optionally token transfer) of a pump.fun user or wallet, newest first, with the coins and traders referenced in side lists. Filter to one coin with mint; for an EVM coin also pass chain. Page with nextCursor. - Cost: 2 credits (2 a page (100 rows)) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user-trades ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `id` | path | string | yes | A wallet address (Solana or EVM) or a pump.fun user id (UUID). Example `Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14`. | | `types` | query | string | no | What to list: trades, transfers, or all (both). One of `trades`, `transfers`, `all`. Default `trades`. Example `all`. | | `mint` | query | string | no | Only this coin. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh`. | | `chain` | query | string | no | EVM chain id, used only when the coin is an EVM address (ignored for Solana): 8453 (Base), 56 (BNB Chain), 1 (Ethereum), 4663 (Robinhood Chain), 143 (Monad), 5042 (Arc), 196 (X Layer). Only read when mint is an EVM address. One of `8453`, `56`, `1`, `4663`, `143`, `5042`, `196`. Default `8453`. Example `4663`. | | `cursor` | query | string | no | The nextCursor of the last page (it looks like 1792722260000000:). | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/users/4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR/trades?types=trades" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "trades": [ { "tx": "qRVCaGrdumdrsJQprNAwPCqFKAYqScmCWyDwTc2hYvTcjfvCKEtNtG1rKJsnCSc4o1of452u6uMbykD5t2vhLwk", "isBuy": false, "timestamp": "2026-10-25T08:19:15.000Z", "amountUsd": 1620.73094, "baseAmount": 10967488.654647, "priceUsd": 0.00014777593950947787, "mint": "9jBBwEK6UZgLv5vm7F1KsULgYAy5dHo9LEYmCfLWKPDj", "chainId": 1399811149, "walletAddress": "4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR", "userId": "1e2df2f0-4720-4edb-a6d2-dd2833300de9", "slotIndexId": "00046118689600008800000203", "amountSol": 15.991414295, "kind": "trade" } ], "traders": [ { "userId": "1e2df2f0-4720-4edb-a6d2-dd2833300de9", "userName": "J777Crypto", "profileImage": "https://socialimages.pump.fun/profile-images/1e2df2f0-4720-4edb-a6d2-dd2833300de9/312a5881-7336-4891-a58a-d05e762a9e60", "walletAddress": "4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR", "isVerified": true, "verifiedBadgeVisible": false } ], "coins": [ { "mint": "9jBBwEK6UZgLv5vm7F1KsULgYAy5dHo9LEYmCfLWKPDj", "chainId": 1399811149, "name": "The White Whale", "symbol": "WHITEWHALE", "image": "https://…/image.png" } ], "nextCursor": "1791525491000000:00000000-0000-09a1-5c8b-7a74e691e265" }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:19:06.002Z", … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | id is not an address or UUID; types not trades\|transfers\|all; mint not an address; chain not one of the EVM ids; bad cursor | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit); an input with nothing in it is an empty page at full price, not a 404 | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Who they follow `GET https://api.pumpfomo.com/v1/pump/users/{id}/following` The pump.fun accounts a user follows (up to 1,000). Everyone a pump.fun user follows, with username, avatar, main wallet, user id and follower count — up to 1,000 in one answer. Takes a user id only (look it up with GET /v1/pump/users/{wallet}). - Cost: 2 credits (2 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user-following ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `id` | path | string | yes | pump.fun user id (a UUID, e.g. the userId of GET /v1/pump/users/{id}). Wallets are not accepted here. Example `400bfe0b-a8e9-4d4f-aac0-46408e7b6127`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/users/1e2df2f0-4720-4edb-a6d2-dd2833300de9/following" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": [ { "username": "gr3gor14n", "profile_image": "https://socialimages.pump.fun/profile-images/8267c7fe-e0a9-4613-b450-3632f7ee5399/095a7e98-d805-4e17-8f8e-bb6686b2de74", "resolved_avatar_decoration": "achievement:views-1m", "address": "J23qr98GjGJJqKq9CBEnyRhHbmkaVxtTJNNxKu597wsA", "userId": "8267c7fe-e0a9-4613-b450-3632f7ee5399", "user_id": "8267c7fe-e0a9-4613-b450-3632f7ee5399", "kind": "person", "timestamp": null, "followers": 196710 }, { "username": "marcell", "profile_image": "https://socialimages.pump.fun/profile-images/6vbrTLsWy76TxDQAUKLqZrPohQuq6EVaJgfGzR82paFa/eafbf02c-3309-479c-bdf1-dc00483c6ec3", "resolved_avatar_decoration": "achievement:multiple-100x", "address": "6vbrTLsWy76TxDQAUKLqZrPohQuq6EVaJgfGzR82paFa", "userId": "240b8242-5715-492e-828c-1622aac53376", "user_id": "240b8242-5715-492e-828c-1622aac53376", "kind": "person", "timestamp": null, "followers": 174989 } ], "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:10:27.909Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | id is not a UUID | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Who follows them `GET https://api.pumpfomo.com/v1/pump/users/{id}/followers` The pump.fun accounts following a user, roughly the most followed first (up to 1,999). The people who follow a pump.fun user, roughly the most followed first, with username, avatar, main wallet, user id and their own follower count; a follower who is a ranked pump.fun trader also has pnlRanked and pnlUsd. Up to 1,000 in one answer; page with offset. pump.fun shows a user's first 1,999 followers and no more (offset stops at 999), so an account with fewer followers than that can be read whole, and a bigger one only its most followed 1,999. GET /v1/pump/users/{id}/followers/count gives the full count and how many of them are traders. Takes a user id only (look it up with GET /v1/pump/users/{wallet}). - Cost: 2 credits (2 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user-followers ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `id` | path | string | yes | pump.fun user id (a UUID, e.g. the userId of GET /v1/pump/users/{id}). Wallets are not accepted here. Example `400bfe0b-a8e9-4d4f-aac0-46408e7b6127`. | | `limit` | query | integer | no | Followers in one answer. Default `100`. Range 1 to 1000. Example `100`. | | `offset` | query | integer | no | Followers to skip. pump.fun goes no further than 999, so offset=999&limit=1000 reaches the 1,999th follower. Default `0`. Range 0 to 999. Example `0`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/users/1e2df2f0-4720-4edb-a6d2-dd2833300de9/followers?limit=20" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": [ { "username": "ansemconzimp", "profile_image": "https://pump.mypinata.cloud/ipfs/bafybeifpcatpregf42pytesq5wep6yi6wmzojeea5ohrmuj2va65f2nrzm", "resolved_avatar_decoration": "epic", "address": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52", "userId": "084d7890-9843-4487-ac01-8e96a0c9912c", "user_id": "084d7890-9843-4487-ac01-8e96a0c9912c", "kind": "person", "timestamp": null, "followers": 233856, "pnlRanked": true, "pnlUsd": -857329.8313695653 }, { "username": "cupsey", "profile_image": "https://pump.mypinata.cloud/ipfs/bafkreifiv64plfih4es675aarfgggdriwrdebsqsdccanh7k4kbgdosany", "resolved_avatar_decoration": "legendary", "address": "6DQAGJT7VZPVBsuG4kn3AvpyHCEi7B2RFFvMZdbqQqqP", "userId": "fe663bab-febd-42a4-8342-1c666b75409f", "user_id": "fe663bab-febd-42a4-8342-1c666b75409f", "kind": "person", "timestamp": null, "followers": 187487, "pnlRanked": true, "pnlUsd": 4467.422663413091 } ], "meta": { "cache": "live", "fetchedAt": "2026-11-14T16:10:17.465Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | id is not a UUID, limit is not 1–1000, or offset is not 0–999 | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Follower count `GET https://api.pumpfomo.com/v1/pump/users/{id}/followers/count` How many pump.fun accounts follow a user. The follower count of a pump.fun user, by user id. Cheaper than the full profile when the count is all you need. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user-followers-count ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `id` | path | string | yes | pump.fun user id (a UUID, e.g. the userId of GET /v1/pump/users/{id}). Wallets are not accepted here. Example `400bfe0b-a8e9-4d4f-aac0-46408e7b6127`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/users/1e2df2f0-4720-4edb-a6d2-dd2833300de9/followers/count" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "count": 226955 }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:10:29.077Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | id is not a UUID | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Coins created and fees claimed `GET https://api.pumpfomo.com/v1/pump/users/{id}/activity` A user's coin launches and creator-fee claims, newest first, 20 a page. The creator side of a pump.fun user: coins they launched and the creator fees (and holder rewards) they claimed, with the coins referenced in data.coins. Takes a user id. Caveat: pump.fun's nextCursor contains a "#", which this endpoint's cursor check currently refuses, so only the first page can be read. - Cost: 2 credits (2 a page (20 rows)) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user-activity ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `id` | path | string | yes | pump.fun user id (a UUID, e.g. the userId of GET /v1/pump/users/{id}). Wallets are not accepted here. Example `400bfe0b-a8e9-4d4f-aac0-46408e7b6127`. | | `types` | query | string | no | create (launches), fee_claim (claims) or all. One of `all`, `create`, `fee_claim`. Default `all`. Example `all`. | | `cursor` | query | string | no | The nextCursor of the last page (it looks like 1792941845#). | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/users/54a07465-e267-4d19-9c3f-6a6d86664c62/activity?types=all" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "rows": [ { "kind": "create", "tx": "5f6VAf1bPZhS2BoFqqcxMAAnZA9zu2ZbnkMQ8yBe1L4iC5Up5FuKbWE44L8GCNbbsF4pUNF8dgUL1ekV54uQnZND", "timestamp": "2026-10-25T22:22:57.000Z", "chainId": 1399811149, "walletAddress": "29yFzeBZgxf5zqrAkKXwgZtQehRf4pL8WbV2nRJikbw8", "mint": "CtUyUABVAFRNQbRvSrsz2vxGsugUNvUj2qqeQYBCpump", "amount": "88939827.235752", "solValue": null, "feeKind": null, "counterparty": "29yFzeBZgxf5zqrAkKXwgZtQehRf4pL8WbV2nRJikbw8" } ], "coins": [ { "mint": "CtUyUABVAFRNQbRvSrsz2vxGsugUNvUj2qqeQYBCpump", "chainId": 1399811149, "name": null, "symbol": null, "image": null } ], "nextCursor": "1792941738#pEAGAvz9xzpoQjiSEPntuxd9SdP5fLmzWH5tX1bb8HbGnMmaSKJcA18nu6tZeW4C1qMoHUBqj9fVkoD37PfZQmr", "scannedThrough": "2026-10-25T15:22:18.000Z" }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:23:08.335Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | id is not a UUID; types not all\|create\|fee_claim; cursor has characters outside A-Z a-z 0-9 _ . - | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit); an input with nothing in it is an empty page at full price, not a 404 | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Wallet PnL `GET https://api.pumpfomo.com/v1/pump/users/{wallet}/pnl` A wallet's realized and unrealized PnL over a period, in SOL and USD, with holdings. pump.fun's portfolio summary for one wallet over 1 day, 1 week, 1 month or all time: total, realized and unrealized PnL (SOL and USD), percentage, buy spend, capital deployed, current value and the holdings behind it. - Cost: 5 credits (5 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user-pnl ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `wallet` | path | string | yes | Wallet address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14`. | | `period` | query | string | no | The window. One of `1d`, `1w`, `1m`, `all`. Default `1d`. Example `1w`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/users/4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR/pnl?period=1w" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "wallet": "4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR", "from": 1792364400, "to": 1792969830, "pnl": { "sol": 3215.277449182762, "usd": 306995.2796335165 }, "realizedPnl": { "sol": 21.680498422722785, "usd": 5362.138765104572 }, "unrealizedPnl": { "sol": 3193.5969507600394, "usd": 299883.43880041206 }, "percentage": { "sol": 31.832729963147926, "usd": 20.895476551882048 }, "totalBuySpend": { "sol": 21.688357536540135, "usd": 51396.6292409159 }, "heldOpenValue": { "sol": 10100.539453904898, "usd": 1402137.0152357067 }, "maxCapitalDeployed": { "sol": 10100.539453904898, "usd": 1434256.2131540517 }, "equityAtWindowStart": { "sol": null, "usd": null }, "missingPriceMints": [ "AD2jReKiurm1nv5ZTyQB8WVJPamANRTfawu9c5RZpump" ], "tokenCount": 121, "tradePercentage": { "sol": 31.832729963147926, "usd": 21.282499930347555 }, "totalValueUsd": 1775922.1602745028, "solPriceUsd": 101.45288555415773, "nativeBalanceSol": 5.560202675, "cache": { "filledAtMs": 1792969831782, "ttlSeconds": 60 }, "computedAt": 1792969831782, "evmAddress": "0xe48b6e0e9900d68ba93ac417d9e2ce911c52f753", "holdings": [ { "chain": "solana", "mint": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "amount": 9576542.881249025, … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | wallet is not an address; period not 1d\|1w\|1m\|all | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Wallet PnL chart `GET https://api.pumpfomo.com/v1/pump/users/{wallet}/pnl/chart` A wallet's equity curve over a period. The points behind pump.fun's portfolio chart: time (unix seconds) and value (USD), at the resolution given in resolutionSec, plus the value now. - Cost: 5 credits (5 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user-pnl-chart ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `wallet` | path | string | yes | Wallet address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14`. | | `period` | query | string | no | The window. One of `1d`, `1w`, `1m`, `all`. Default `1d`. Example `1w`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/users/4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR/pnl/chart?period=1m" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "period": "1m", "range": "30D", "currency": "USD", "points": [ { "time": 1790668800, "value": 3258331.4601388727 }, { "time": 1790697600, "value": 3588354.677258626 }, { "time": 1790726400, "value": 3576767.727864544 } ], "equityFrom": 1790352000, "resolutionSec": 28800, "valueNow": 1772542.5417059916, "meta": { "walletsRequested": 1, "walletsAnswered": 1, "walletsUnanswered": [], "walletsDegraded": [], "coverageFrom": 1782864000 } }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:19:07.471Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | wallet is not an address; period not 1d\|1w\|1m\|all | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Wallet PnL in one coin `GET https://api.pumpfomo.com/v1/pump/users/{wallet}/pnl/{mint}` Cost basis, realized and unrealized PnL and fees paid by a wallet in one coin. One wallet in one coin: amount held, cost basis, realized and unrealized PnL in SOL and USD, total bought, and every fee paid (base, priority, tip, UI, protocol, rent). The pump.fun answer is wrapped as {success, data}. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user-pnl-coin ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `wallet` | path | string | yes | Wallet address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14`. | | `mint` | path | string | yes | Coin address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/users/4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR/pnl/6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "success": true, "data": { "mint": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "cost_basis_usd": 248151.55056263407, "cost_basis_sol": 2196.387826618035, "unrealized_pnl_usd": 1017776.8155444036, "unrealized_pnl_sol": 10290.922185973195, "percentage_usd": 410.1432424003791, "percentage_sol": 468.53848219597, "realized_pnl_usd": 85384.95519513555, "realized_pnl_sol": 820.2052602245689, "last_slot_index_id": "00046118576700006900000007", "amount_held": 9576542.881249007, "cost_basis_amount": 9576542.881249007, "total_buy_spend_usd": 259379.1037392835, "total_buy_spend_sol": 2308.920186220773, "total_buy_amount": 2232313.861480191, "has_transfers": true, "has_untrusted_basis": true, "has_untrusted_usd_basis": false, "has_untrusted_sol_basis": false, "fee_sol": 0.0007333806621396527, "fee_usd": 0.08011645021459037, "base_fee_sol": 0.00003, "base_fee_usd": 0.0031362147545399995, "priority_fee_sol": 0.000075768, "priority_fee_usd": 0.00791423546005038, "tip_fee_sol": null, "tip_fee_usd": null, "ui_fee_sol": 0.0006276126621396527, "ui_fee_usd": 0.06906599999999997, "ata_rent_sol": null, "ata_rent_usd": null, "protocol_fee_sol": null, "protocol_fee_usd": null, "cashback_sol": null, "cashback_usd": null } }, "meta": { "cache": "live", "f … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | wallet or mint is not an address | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Positions in chosen coins `GET https://api.pumpfomo.com/v1/pump/users/{wallet}/positions` A wallet's position in each of up to 50 coins. For each coin asked: amount held, cost basis, PnL and percentage, whether the position is closed, and the wallet's callout on the coin if it made one. Use GET /portfolio to list every position instead. - Cost: 2 credits (2 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user-positions ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `wallet` | path | string | yes | Wallet address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14`. | | `mints` | query | string | yes | 1 to 50 coin addresses, comma-separated. Range 1 to 50. Example `Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/users/4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR/positions?mints=6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx,0xe8ffd7e24187F72afB08d75B1bb13088A989a791,0x80fa4c67C805F262F6028E3706F183c0DD875a55,HuAXPyDWDaMYFKuwQHpqL1oPnj93zdzWmtvFGzCeCUa7,7KEPApdbBMByrmqihz3bht2uMhFQcatjfSFQCKq66kH3,9jBBwEK6UZgLv5vm7F1KsULgYAy5dHo9LEYmCfLWKPDj,CARDSccUMFKoPRZxt5vt3ksUbxEFEcnZ3H2pd3dKxYjp,0xB2000000000000000000004c27f6523082f41D01" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "positions": [ { "coinMint": "0x80fa4c67C805F262F6028E3706F183c0DD875a55", "chainId": 4663, "isExited": false, "walletAddress": "4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR", "amountHeld": 50090759.97522236, "pnlUsd": 154747.04227802504, "pnlPercentage": 177.14922838563643, "costBasisAmount": 50090759.97522236, "costBasisUsd": 87354.05944933384, "amountBoughtUsd": 0, "amountBought": 0, "callout": null, "hasTransfers": true, "likelyLost": false, "hasUntrustedUsdBasis": false, "hasUntrustedSolBasis": false, "valueUsd": 242101.10172735888, "tokenPriceUsd": 0.0048332487238587594, "realizedPnlUsd": 0, "updatedAt": "2026-09-03T05:41:21.000Z", "tradeCount": 0, "lastSlotIndexId": "00005317848600000600000013" } ] }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:22:19.671Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | mints missing, more than 50, or one is not an address | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Portfolio `GET https://api.pumpfomo.com/v1/pump/users/{wallet}/portfolio` Every position of a wallet — open, closed or all — by PnL or size, 100 a page. All of a wallet's pump.fun positions with amount held, cost basis, PnL and percentage, and any callout it made on the coin. Sort by PnL or by position size; pages start at 0. - Cost: 2 credits (2 a page (100 rows)) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user-portfolio ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `wallet` | path | string | yes | Wallet address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14`. | | `filter` | query | string | no | Which positions. One of `all`, `open`, `closed`. Default `all`. Example `all`. | | `sort` | query | string | no | pnl (by PnL) or size (by position size). One of `pnl`, `size`. Default `pnl`. Example `pnl`. | | `page` | query | integer | no | Page number, from 0. Default `0`. Range 0 to 1000. Example `0`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/users/4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR/portfolio?filter=all&sort=pnl" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "positions": [ { "coinMint": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "chainId": 1399811149, "isExited": false, "walletAddress": "4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR", "amountHeld": 9576542.881249024, "pnlUsd": 1103284.1572601506, "pnlPercentage": 425.35583682528386, "costBasisAmount": 9576542.881249007, "costBasisUsd": 248029.16404202284, "amountBoughtUsd": 259379.1037392835, "amountBought": 2232313.861480191, "callout": { "calloutId": "0f696ba7-2f4e-4920-af58-d9f7f9bb33a3", "chain": null, "assetClass": "ASSET_CLASS_TOKEN", "perp": null, "calledOutAtMcap": 6591462, "multiple": 18.331900811731504, "thesis": "Again and again I will repeat stonk is a free layup here \n\nbasically Solana’s will do all they can to make this work to fight for market sha…", "mediaUrl": null, "calloutTimestamp": "2026-08-21T21:27:39.286Z", "likes": 258, "hasLiked": null, "updates": [ { "id": "415ec8d7-2cc9-4584-b448-45e653554a8d", "content": "Some times the good stuff are left unnoticed till it’s too late \n\nTake a chance", "createdAt": "2026-10-25T02:10:32.730Z", "likeCount": 4, "mediaUrl": null, "parentMessageId": null, "repostCount": 1, … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | filter not all\|open\|closed; sort not pnl\|size; page not 0-1000 | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit); an input with nothing in it is an empty page at full price, not a 404 | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Balance summary `GET https://api.pumpfomo.com/v1/pump/users/{wallet}/balance` A wallet's total value and PnL across every chain pump.fun knows. Total value in USD, SOL balance, token, dust and hidden counts, portfolio PnL, and a per-chain breakdown (Solana, Ethereum, BSC, Base and the other EVM chains), for a Solana wallet and its linked EVM wallet. Wrapped as {success, data}. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user-balance ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `wallet` | path | string | yes | Wallet address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/users/4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR/balance" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "success": true, "data": { "total_value": 1724852.5003953157, "native_balance": 5.560202675, "native_lamports": 5560202675, "wrapped_sol_balance": 0, "sol_price": 101.40431469654634, "token_count": 186, "dust_count": 1449, "dust_value_usd": 11.743523540547965, "hidden_count": 374, "hidden_value_usd": 4631457.224079837, "last_update_ts": 1792969722, "portfolioPnL": { "total_cost_basis_usd": 1208832.0295425712, "total_unrealized_usd": 205656.07826668234, "total_percentage": 17.012791954602967 }, "multi_chain_breakdown": { "solana": { "wallet_address": "4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR", "total_value": 1414488.1078092535, "token_count": 158, "hidden_count": 73, "hidden_value_usd": 473.72507107368295, "dust_count": 1257, "dust_value_usd": 11.02449293852127 }, "ethereum": { "wallet_address": "0xe48b6e0e9900d68ba93ac417d9e2ce911c52f753", "total_value": 3.400839604646898, "token_count": 2, "hidden_count": 1, "hidden_value_usd": 0.6656350496956074, "dust_count": 2, "dust_value_usd": 0.0006361780563165979 }, "bsc": { "wallet_address": "0xe48b6e0e9900d68ba93ac417d9e2ce911c52f753", "total_value": 28981.013469724712, "token_count": 4, … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | wallet is not an address | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Token balances `GET https://api.pumpfomo.com/v1/pump/users/{wallet}/balances` Every token a wallet holds on every chain, with price, value and PnL, 200 a page. The token list behind the balance summary: name, symbol, image, balance, price (USD and SOL), value and per-token PnL, on all chains. Pages start at 1; data.pagination says how many there are. - Cost: 2 credits (2 a page (200 rows)) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user-balances ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `wallet` | path | string | yes | Wallet address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14`. | | `page` | query | integer | no | Page number, from 1. Default `1`. Range 1 to 1000. Example `1`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/users/4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR/balances?page=1" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "success": true, "data": { "tokens": [ { "token_mint": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "token_name": "STONK", "token_symbol": "STONK", "token_image": "https://gateway.irys.xyz/em5twmyoeTJw9eZDj25xoKbBjHYhbeXYCcZ55o23Ztg", "program": "stonkfun", "token_price": 0.13158301086031032, "priceSol": 0.0012972232836764885, "decimals": 9, "balance": 9576542.881249025, "value": 1260110.3459476181, "chain": "solana", "network_id": "1399811149", "tokenPnL": { "cost_basis_usd": 249296.06032241532, "unrealized_usd": 1016632.3057846224, "percentage_usd": 407.8011920725137, "cost_basis_sol": 2207.458313495695, "unrealized_sol": 10279.851699095534, "percentage_sol": 465.6872402186625, "percentage": 407.8011920725137, "realized_pnl_sol": 819.086315780086, "realized_pnl_usd": 85271.62281872067 }, "dust_floor_filtered": false } ], "last_update_ts": 1792969837, "hidden_count": 374 }, "pagination": { "page": 1, "size": 200, "total": 1634, "totalPages": 9 } }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:10:39.959Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | page not 1-1000 | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit); an input with nothing in it is an empty page at full price, not a 404 | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Coins created `GET https://api.pumpfomo.com/v1/pump/users/{wallet}/created-coins` The coins a wallet launched on pump.fun, 50 a page. Coins created by a wallet, newest first, with pump.fun coin fields. Page with offset (rows to skip). - Cost: 2 credits (2 a page (50 rows)) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user-created-coins ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `wallet` | path | string | yes | Wallet address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14`. | | `offset` | query | integer | no | Rows to skip. Default `0`. Range 0 to 10000. Example `0`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/users/C6AymPcvVyftsFKwts93j9S2X8EVPnvrWZf36CmN3etS/created-coins" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "limit": 50, "offset": 0, "count": 4, "coins": [ { "mint": "g22PMViZFFRBHMrrPyf1S2CYSQ16QXnBibzWqWCpump", "initialized": true, "name": "TRUTH COIN🔥", "symbol": "TRUTH", "description": "DTJ launched Truth Social in February 2022 after he was banned from mainstream platforms like Twitter (now X), Facebook, and YouTube. Now $T…", "image_uri": "https://gateway.irys.xyz/1Bg2671OJwK-kFZ0SGV8xz_gJP1bOqjHqYyIXTEQfLA", "metadata_uri": "https://ipfs.io/ipfs/QmR2n8uNyMuarVfTwLMTtHHsagPqAhdYD4d9rQBnkuVGL5", "twitter": "", "telegram": "", "bonding_curve": "6fBogehZLjTzQ85cj8WXstGnHqhL3H7RWH1WzEpZnpRC", "associated_bonding_curve": "9kdC4VC9vBzwTYsmE5BaQnnJwGbFqeZvAtHQhv4J6FMz", "creator": "C6AymPcvVyftsFKwts93j9S2X8EVPnvrWZf36CmN3etS", "created_timestamp": 1792669066000, "complete": true, "hidden": false, "total_supply": 1000000000000000, "website": "", "show_name": true, "last_trade_timestamp": 1792970402000, "market_cap": 3557830.979764524, "nsfw": false, "is_banned": false, "pump_swap_pool": "6a3vvWsBzBh5jCYEgPdZLusoZEGhZ96pTtWa1pknRQo4", "livestream_ban_expiry": 0, "is_currently_live": false, "ath_market_cap": 361395844.23638237, "ath_market_cap_timestamp": 1792970038000, "hide_banner": false, "program": "pump", " … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | offset not 0-10000 | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit); an input with nothing in it is an empty page at full price, not a 404 | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Creator fees `GET https://api.pumpfomo.com/v1/pump/users/{wallet}/fees` Creator fees a wallet earned, day by day, over 7, 30, 90 days or all time. pump.fun creator fees for a creator wallet: what was earned per day (series), totals by quote asset (earned) and whether there is something to claim. - Cost: 2 credits (2 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user-fees ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `wallet` | path | string | yes | Wallet address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14`. | | `period` | query | string | no | The window (daily points). One of `1d`, `7d`, `30d`. Default `30d`. Example `30d`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/users/29yFzeBZgxf5zqrAkKXwgZtQehRf4pL8WbV2nRJikbw8/fees?period=30d" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "creator": "29yFzeBZgxf5zqrAkKXwgZtQehRf4pL8WbV2nRJikbw8", "interval": "1d", "period": "30d", "earned": [ { "quote": { "chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "address": "So11111111111111111111111111111111111111112" }, "amount": { "raw": "111308721522", "decimals": 9 }, "usd": "10295.625343344997" } ], "isClaimable": true, "series": [ { "bucketStart": 1792886400000, "earned": { "usd": "169.50628023617406", "native": "1.34038802", "nativeAsset": { "chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "address": "", "symbol": "SOL" } }, "byQuote": [ { "quote": { "chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "address": "So11111111111111111111111111111111111111112" }, "amount": { "raw": "1340388020", "decimals": 9 }, "usd": "136.52641165103864" } ] } ], "claimable": { "usd": "19.34034243527803", "native": "0.18884285", "nativeAsset": { "chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "address": "", "symbol": "SOL" } } }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:22:36.755Z", … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | period not 7d\|30d\|90d\|all | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Fee shares `GET https://api.pumpfomo.com/v1/pump/users/{wallet}/fees/shares` The coins whose creator fees a wallet has a share of, with earned, claimed and unclaimed totals. For a shareholder wallet (pump.fun lets creators split fees): each coin it shares in and its totals earned, claimed and still unclaimed. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user-fees-shares ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `wallet` | path | string | yes | Wallet address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/users/4ugDhHJ8XDXAeABmrNmGffFaLbJb9BkPyiFGVSV9ocwo/fees/shares" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "coins": [ { "coin": { "chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "address": "7GGy8P6HSbNQwU2796DBMgq2Vu8m7Lk6GGjofwgMpump" }, "configAddress": "adydSPcRw2CogZzk5aFBGTXaNgzWeZVpDdJggMEPmwp", "totalEarned": [ { "quote": { "chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "address": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" }, "amount": { "raw": "48255030752", "decimals": 6 }, "usd": "193.1154062755172" } ], "totalClaimed": [ { "quote": { "chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "address": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" }, "amount": { "raw": "48254998612", "decimals": 6 } } ], "totalUnclaimed": [ { "quote": { "chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "address": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" }, "amount": { "raw": "32140", "decimals": 6 } } ], "shareholderEarned": [ { "quote": { "chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "address": "pumpCmXqMfrsAkQ … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | wallet is not an address | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Trader stats `GET https://api.pumpfomo.com/v1/pump/users/{wallet}/trader-stats` Volume, trade count and biggest trade over 1, 7 and 30 days and all time, by platform. How active a trader is: all-time volume and trade count, biggest trade, the same per 1d/7d/30d window (with the previous window and a percentile bucket), and split by platform (app, web, …). It can be briefly unavailable (503, not charged): retry shortly. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user-trader-stats ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `wallet` | path | string | yes | Wallet address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/users/4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR/trader-stats" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "allTimeVolumeUsd": 3372218.4448140017, "allTimeTrades": 920, "biggestTradeUsd": 42186.221875880176, "window1d": { "volumeUsd": 51265.688304890646, "trades": 10, "previousVolumeUsd": 16192.285643714882, "previousTrades": 9, "biggestTradeUsd": 11883.429684974499, "percentileBucket": 1 }, "window7d": { "volumeUsd": 124615.5105770467, "trades": 60, "previousVolumeUsd": 206281.58458214492, "previousTrades": 88, "biggestTradeUsd": 11883.429684974499, "percentileBucket": 1 }, "window30d": { "volumeUsd": 1093108.133688439, "trades": 354, "previousVolumeUsd": 2248467.6111911694, "previousTrades": 542, "biggestTradeUsd": 22320.78965635605, "percentileBucket": 1 }, "window30dVolumeUsd": 1093108.133688439, "percentileBucket": 1, "allTimePercentileBucket": 1, "statsUpdatedAt": 1792905707462, "byPlatform": [ { "platform": "app", "allTimeVolumeUsd": 2466701.4478149107, "allTimeTrades": 682, "biggestTradeUsd": 42186.221875880176, "window1d": { "volumeUsd": 51265.688304890646, "trades": 10, "previousVolumeUsd": 16192.285643714882, "previousTrades": 9, "biggestTradeUsd": 11883.429684974499, "percentileBucket": 1 }, "window7d": { "volumeUsd": 124615.5105770467, "trades": 60, … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | wallet is not an address | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Trading streak `GET https://api.pumpfomo.com/v1/pump/users/{wallet}/streak` A wallet's current and longest daily trading streak, with day-by-day history. Active and longest streak of consecutive trading days, the wallet's rank on the streak leaderboard, and one row per day (traded or not) between from and to. Defaults to the last 90 days. May briefly answer 503 (not charged): retry shortly. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user-streak ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `wallet` | path | string | yes | Wallet address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14`. | | `from` | query | string | no | Start date, YYYY-MM-DD (UTC). Default `today - 90 days`. Example `2026-08-01`. | | `to` | query | string | no | End date, YYYY-MM-DD; at most 400 days after from. Default `today`. Example `2026-10-25`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/users/4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR/streak" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "activeStreak": 65, "longestStreak": 65, "leaderboardRank": 337, "rankedTotal": 65458, "history": [ { "date": "2026-10-25", "traded": true }, { "date": "2026-10-24", "traded": true }, { "date": "2026-10-23", "traded": true } ], "computedAt": "2026-10-25T23:19:11.793Z" }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:19:11.898Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | from/to not YYYY-MM-DD, to before from, or more than 400 days apart | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Search pump.fun users `GET https://api.pumpfomo.com/v1/pump/search/users` pump.fun users by name or wallet (top 20, labelled wallets included). pump.fun's user search: matches usernames and wallets and includes labelled wallets. Returns up to 20 profiles. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-search-users ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `q` | query | string | yes | Search term, 1 to 64 characters (trimmed). Range 1 to 64. Example `MispriceDegen`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/search/users?q=degen" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": [ { "address": "8NYJvb4qC62HN7tNW9Gni21euvF6SqNbGTmzZUHLf5Rj", "userId": "c24be0a6-4e9f-43d4-9964-3bcc1b1bdd3b", "is_pump_user": true, "is_banned": false, "username": "DEGEN4LIFECHUDS", "profile_image": "https://socialimages.pump.fun/profile-images/8NYJvb4qC62HN7tNW9Gni21euvF6SqNbGTmzZUHLf5Rj/50452ab3-b721-473f-8fdc-69749770ceba", "avatar_decoration": null, "resolved_avatar_decoration": "epic", "bio": "WAGMI", "followers": 10172, "following": 7, "x_username": null, "canonical_svm_wallet": "8NYJvb4qC62HN7tNW9Gni21euvF6SqNbGTmzZUHLf5Rj", "group_badges": [], "active_competition_entry": null, "kind": "person" } ], "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:23:32.748Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | q missing or longer than 64 characters | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Resolve an address `GET https://api.pumpfomo.com/v1/pump/resolve` Says whether an address is a pump.fun user, a coin or neither, with the match. Give any address and pump.fun says what it is: a user (with the profile) or a coin (with the coin), and how it was resolved. Handy when you do not know whether a pasted address is a wallet or a mint. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-resolve ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `address` | query | string | yes | A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/resolve?address=4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "results": [ { "identifier": "4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR", "kind": "user", "chain": "solana", "coin": null, "user": { "address": "4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR", "userId": "1e2df2f0-4720-4edb-a6d2-dd2833300de9", "is_pump_user": true, "is_banned": false, "username": "J777Crypto", "profile_image": "https://socialimages.pump.fun/profile-images/1e2df2f0-4720-4edb-a6d2-dd2833300de9/312a5881-7336-4891-a58a-d05e762a9e60", "header_image_url": "https://socialimages.pump.fun/profile-images/1e2df2f0-4720-4edb-a6d2-dd2833300de9/c1fd4392-a257-4e5d-b26c-d4d5967edbbe", "avatar_decoration": "achievement:views-1m", "resolved_avatar_decoration": "achievement:views-1m", "kind": "person", "member_count": 0, "active_competition_entry": null, "last_username_update_timestamp": 1787071472270, "following": 89, "followers": 226961, "bio": "We Win ", "x_username": "J777Crypto", "canonical_svm_wallet": "4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR", "canonical_evm_wallet": "0xe48b6e0e9900d68ba93ac417d9e2ce911c52f753", "group_badges": [ { "group_id": "cc8091d7-d628-4abd-93b1-ada1e6ef23fa", "username": "Dabal", "profile_image_url": "https://socialimages.pump.fu … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | address missing or not an address | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | # pump.fun coins ## Coin `GET https://api.pumpfomo.com/v1/pump/coins/{mint}` One coin: name, symbol, images, socials, creator, supply, price and market cap. pump.fun's coin record for a mint, including coins not launched on pump.fun (program "non_launchpad", from a data vendor). Price and market cap in USD. Caveat: for an unknown mint pump.fun may answer {"data": null} with a 200 (charged as a hit) rather than a 404. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-coin ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `mint` | path | string | yes | Coin address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/coins/C5xph2yL6gMdxmuLGxJBkGpmuDFfyi5fqkBNhvL6pump" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "mint": "C5xph2yL6gMdxmuLGxJBkGpmuDFfyi5fqkBNhvL6pump", "initialized": true, "name": "Big Titty Coin", "symbol": "BTC", "image_uri": "https://…/image.png", "metadata_uri": "https://metadata.j7tracker.io/m/242XrCUu6u", "twitter": "https://x.com/DaliGambol/status/2099222909688434881", "bonding_curve": "9nzxFL6UXZiMhPSyCqNDTXmPNdCUhtY3jwKoh7FTdeEP", "associated_bonding_curve": "4g7LMtJSqNVFdWFf8CaCAdsep52mwotW2RzMeAbeUDCo", "creator": "7jQwHdK771P286Vsn44v7dFVfCH8CzZcL3PZGidbShch", "created_timestamp": 1789328718000, "complete": true, "virtual_sol_reserves": 20957406, "virtual_token_reserves": 279900000000000, "total_supply": 1000000000000000, "website": "", "show_name": true, "last_trade_timestamp": 1792969853000, "market_cap": 91240.72634811257, "nsfw": false, "inverted": true, "is_banned": false, "pump_swap_pool": "3M9sVgL4u6ATKaiExf3XhQqNfMB6ijvzk3meMcQaen1w", "real_sol_reserves": 0, "real_token_reserves": 0, "updated_at": 1792969853, "livestream_ban_expiry": 0, "reply_count": 0, "is_currently_live": false, "ath_market_cap": 21942623.00493637, "ath_market_cap_timestamp": 1792925498000, "hide_banner": false, "program": "pump", "token_program": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", "quote_mint": "3NZ9JMVBmGAqocybic2c7LQCJScmgsAZ6vQqTDzcqmJh", "base_decimals": 6, "quote_decimals": 8, "pool_address": "3M9sV … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | mint is not an address | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Holder count `GET https://api.pumpfomo.com/v1/pump/coins/{mint}/holders/count` How many wallets hold a coin. The number of holders of a coin, with its chain and network id. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-coin-holders-count ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `mint` | path | string | yes | Coin address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/coins/C5xph2yL6gMdxmuLGxJBkGpmuDFfyi5fqkBNhvL6pump/holders/count" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "mint": "C5xph2yL6gMdxmuLGxJBkGpmuDFfyi5fqkBNhvL6pump", "chain": "solana", "networkId": 1399811149, "holderCount": 15879 }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:10:55.338Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | mint is not an address | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## pump.fun traders in a coin `GET https://api.pumpfomo.com/v1/pump/coins/{mint}/traders` The pump.fun users with a position in a coin, 50 at a time, by size, recency, rank or closed PnL. Positions of pump.fun users in one coin: who they are (username, avatar, wallet, verified), what they hold, cost basis and PnL, and their callout thesis when asked. data.totalCount says how many there are. For EVM coins pass chain. - Cost: 2 credits (2 a page (50 rows)) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-coin-traders ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `mint` | path | string | yes | Coin address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh`. | | `sort` | query | string | no | TOP (largest), LATEST, RANKED or CLOSED_PNL (the last two always include theses). One of `TOP`, `LATEST`, `RANKED`, `CLOSED_PNL`. Default `TOP`. Example `TOP`. | | `withThesis` | query | boolean | no | true: include each trader's callout thesis on the coin. true or false. Default `false`. Example `false`. | | `chain` | query | string | no | EVM chain id, used only when the coin is an EVM address (ignored for Solana): 8453 (Base), 56 (BNB Chain), 1 (Ethereum), 4663 (Robinhood Chain), 143 (Monad), 5042 (Arc), 196 (X Layer). One of `8453`, `56`, `1`, `4663`, `143`, `5042`, `196`. Default `8453`. Example `4663`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/coins/C5xph2yL6gMdxmuLGxJBkGpmuDFfyi5fqkBNhvL6pump/traders?sort=TOP" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "positions": [ { "coinMint": "C5xph2yL6gMdxmuLGxJBkGpmuDFfyi5fqkBNhvL6pump", "chainId": 1399811149, "userId": "2aa1dd90-aa5b-459d-9945-7dc72ec5bd2a", "userName": "slingoor", "profileImage": "https://socialimages.pump.fun/profile-images/2aa1dd90-aa5b-459d-9945-7dc72ec5bd2a/5e6fbb79-dd5f-42a2-b257-094a295b6a50", "walletAddress": "5YRgrP3mjGzrzirYYN5HAQH19cTYREYwGxW6XRJQUzij", "isVerified": true, "verifiedBadgeVisible": false, "resolvedAvatarDecoration": "achievement:volume-10m", "xUsername": "slingoorio", "accountKind": "person", "amountHeld": 573221070.287841, "pnlUsd": 5179244.894258352, "pnlPercentage": 4538.70122434714, "realizedPnlUsd": 3990.7317039395366, "costBasisAmount": 562686675.7209002, "costBasisUsd": 64927.05139690111, "amountBoughtUsd": 114112.92874876004, "amountBought": 822106210.2503985, "callout": { "calloutId": "86cf1898-9d30-43d1-a688-14f15ce15991", "chain": null, "assetClass": "ASSET_CLASS_TOKEN", "perp": null, "calledOutAtMcap": 199881, "multiple": 46.50935773332746, "thesis": "please pay dex and make this project a 100M runner. \n\nthe stage is yours.", "mediaUrl": null, "calloutTimestamp": "2026-09-13T20:11:24.754Z", "likes": 727, "hasLiked": null, "updat … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | sort not TOP\|LATEST\|RANKED\|CLOSED_PNL; chain not an allowed EVM id | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit); an input with nothing in it is an empty page at full price, not a 404 | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Leaderboard traders in a coin `GET https://api.pumpfomo.com/v1/pump/coins/{mint}/top-traders` PnL-leaderboard traders who traded a coin, and their trades in it. Which pump.fun PnL-leaderboard traders traded this coin (with their best rank, periods and trading wallets) and their trades in it (side, USD, price, time, tx). For EVM coins pass chain (only Base, BNB Chain, Ethereum and Robinhood Chain here). - Cost: 2 credits (2 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-coin-top-traders ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `mint` | path | string | yes | Coin address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh`. | | `chain` | query | string | no | EVM chain id, used only when the coin is an EVM address (ignored for Solana): 8453 (Base), 56 (BNB Chain), 1 (Ethereum), 4663 (Robinhood Chain). One of `8453`, `56`, `1`, `4663`, `143`, `5042`, `196`. Default `8453`. Example `4663`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/coins/C5xph2yL6gMdxmuLGxJBkGpmuDFfyi5fqkBNhvL6pump/top-traders" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "mint": "C5xph2yL6gMdxmuLGxJBkGpmuDFfyi5fqkBNhvL6pump", "traders": [ { "userId": "54a07465-e267-4d19-9c3f-6a6d86664c62", "walletAddress": "29yFzeBZgxf5zqrAkKXwgZtQehRf4pL8WbV2nRJikbw8", "username": "throatycrab1008", "profileImage": "https://…/image.png", "isVerified": true, "verifiedBadgeVisible": false, "bestRank": 1, "periods": [ "daily" ], "tradingWallets": [ "29yFzeBZgxf5zqrAkKXwgZtQehRf4pL8WbV2nRJikbw8" ], "tradeCount": 1 } ], "trades": [ { "tx": "2rVbiNT9q3qXVLmPFQJVxxgKpAygGSAr7A3WVzqB76LePw8U5VEMzA6NZKh2ZwnKB3dErFHBs4UPKw14KW9HMNHR", "isBuy": true, "timestamp": "2026-10-25T22:41:24.000Z", "amountUsd": 100, "baseAmount": 10943.027108, "priceUsd": 0.009138239265339486, "mint": "C5xph2yL6gMdxmuLGxJBkGpmuDFfyi5fqkBNhvL6pump", "chainId": 1399811149, "walletAddress": "8whS3YkNkFi84yRUpb1anp9QESUDg7p7dLML1PVno5LR", "userId": "c1bfe690-3d56-42c2-a2c7-3f87d15636a4", "slotIndexId": "00046143052900009900000302", "amountSol": 0.9845912958483132 } ], "boardsBuiltAtMs": 1792969841939, "generatedAtMs": 1792969857766, "page": { "nextCursor": "1792386495000|00045871135800098400000205|5YRgrP3mjGzrzirYYN5HAQH19cTYREYwGxW6XRJQUzij", "to": null, "limit": 500 } }, "meta": { "cache": … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | chain not 8453\|56\|1\|4663 | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## All-time-high market cap `GET https://api.pumpfomo.com/v1/pump/coins/{mint}/ath` A coin's all-time-high market cap in USD. The highest market cap a coin has reached, in USD. For many coins at once use POST /v1/pump/coins/ath/batch. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-coin-ath ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `mint` | path | string | yes | Coin address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/coins/C5xph2yL6gMdxmuLGxJBkGpmuDFfyi5fqkBNhvL6pump/ath" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "athMarketCap": 21942623.004936367 }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:10:59.116Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | mint is not an address | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Candles `GET https://api.pumpfomo.com/v1/pump/coins/{mint}/candles` OHLCV candles in USD, from 1-second to 1-day bars, up to 500. Price candles (open, high, low, close as decimal strings, volume in USD, trade count), oldest first. Go back in time with to. For EVM coins pass chain and optionally the pool. - Cost: 2 credits (2 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-coin-candles ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `mint` | path | string | yes | Coin address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh`. | | `interval` | query | string | no | Bar size. One of `1s`, `15s`, `30s`, `1m`, `5m`, `1h`, `4h`, `1d`. Default `1m`. Example `5m`. | | `count` | query | integer | no | Bars to return. Default `300`. Range 1 to 300. Example `60`. | | `to` | query | integer | no | Last bar at or before this unix time in milliseconds (default: now). | | `chain` | query | string | no | EVM chain id, used only when the coin is an EVM address (ignored for Solana): 8453 (Base), 56 (BNB Chain), 1 (Ethereum), 4663 (Robinhood Chain). One of `8453`, `56`, `1`, `4663`, `143`, `5042`, `196`. Default `8453`. Example `4663`. | | `pool` | query | string | no | EVM only: the pool address to read. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/coins/CSocnzcRpgSCr1naKcNTieWZUxb6rABe45j844m7pump/candles?interval=5m&count=120" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "candles": [ { "openTimeMs": 1792934400000, "open": "0.007045767540737689", "high": "0.007246172913599851", "low": "0.007014164330111363", "close": "0.00722223974078447", "volumeUsd": "6468.832923470305459242", "trades": 78, "final": true, "isCorrection": false, "pool": { "chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "address": "6DNxwecbtdNNstpB5tdnxZsfGe3HmsNgEUZhdue4b1PH" } }, { "openTimeMs": 1792934700000, "open": "0.00722223974078447", "high": "0.00722223974078447", "low": "0.006963348890419859", "close": "0.00704241873186749", "volumeUsd": "5813.672109479953188053", "trades": 52, "final": true, "isCorrection": false, "pool": { "chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "address": "6DNxwecbtdNNstpB5tdnxZsfGe3HmsNgEUZhdue4b1PH" } } ], "hasOlder": true, "source": "indexed", "served": { "res": "5m", "measure": "price_usd" }, "graduatedAt": "459404795-1092-4-1792537216000", "supplyUsed": "1000000000", "createdMs": 1792537215000 }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:19:25.877Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | interval not allowed; count not 1-500; to not a positive integer; chain not 8453\|56\|1\|4663; pool not an address | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Sparkline `GET https://api.pumpfomo.com/v1/pump/coins/{mint}/sparkline` A small price line for lists: at most 120 points. A downsampled USD price line (time in ms, price as a string) — what you draw next to a coin in a list. For EVM coins pass chain. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-coin-sparkline ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `mint` | path | string | yes | Coin address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh`. | | `interval` | query | string | no | Bar size the line is sampled from. One of `15s`, `5m`, `15m`, `1h`. Default `1h`. Example `1h`. | | `count` | query | integer | no | Bars to cover. Default `168`. Range 1 to 300. Example `168`. | | `points` | query | integer | no | Points to return at most. Default `72`. Range 8 to 120. Example `24`. | | `chain` | query | string | no | EVM chain id, used only when the coin is an EVM address (ignored for Solana): 8453 (Base), 56 (BNB Chain), 1 (Ethereum), 4663 (Robinhood Chain), 143 (Monad), 5042 (Arc), 196 (X Layer). One of `8453`, `56`, `1`, `4663`, `143`, `5042`, `196`. Default `8453`. Example `4663`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/coins/CSocnzcRpgSCr1naKcNTieWZUxb6rABe45j844m7pump/sparkline?interval=15m&points=96" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "points": [ { "time": 1792819800000, "price": "0.007800893739148283" }, { "time": 1792820700000, "price": "0.007831181146293583" }, { "time": 1792821600000, "price": "0.007789611766946385" } ], "served": { "res": "15m", "measure": "price_usd" }, "source": "indexed", "createdMs": 1792537215000 }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:19:28.838Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | interval not 15s\|5m\|15m\|1h; count not 1-500; points not 8-120 | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Coin trade tape `GET https://api.pumpfomo.com/v1/pump/coins/{mint}/trades` Every trade in a coin, newest first, 100 a page, with buy/sell aggregates. The trade tape of one coin from every trader: side, venue, trader address, amounts (raw with decimals), price and value in USD, block time; plus buy/sell counts and volumes for the page. Page with cursor. For EVM coins pass chain; pump.fun answers 503 for the EVM tape at times (not charged). - Cost: 2 credits (2 a page (100 rows)) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-coin-trades ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `mint` | path | string | yes | Coin address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh`. | | `minUsd` | query | integer | no | Only trades worth at least this many USD. pump.fun scans a recent window: when it finds no trades this large the answer is 404 not_found (1 credit). Default `1`. Range 0 to 10000000. Example `1`. | | `cursor` | query | string | no | data.cursor of the previous page (1-256 of A-Z a-z 0-9 _ . : = + / -). | | `chain` | query | string | no | EVM chain id, used only when the coin is an EVM address (ignored for Solana): 8453 (Base), 56 (BNB Chain), 1 (Ethereum), 4663 (Robinhood Chain), 143 (Monad), 5042 (Arc), 196 (X Layer). One of `8453`, `56`, `1`, `4663`, `143`, `5042`, `196`. Default `8453`. Example `4663`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/coins/CSocnzcRpgSCr1naKcNTieWZUxb6rABe45j844m7pump/trades?minUsd=25" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "trades": [ { "ordinalKey": "461441674-220-401-1792970446000", "blockId": "461441674", "txIndex": 220, "eventIndex": 401, "blockTimeMs": 1792970446000, "txId": "pWbR6uKF7r8jYJLwv26XXdqhAeGZthLN87hm7zn8q3Dd8T1BMTDdR3ZZWYsAZ2sVarJDhSxwYLXmDttJPi3PuxP", "legIndex": 0, "late": false, "isBackfill": false, "side": "sell", "kind": "swap", "venue": "pump_amm", "pool": { "chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "address": "6DNxwecbtdNNstpB5tdnxZsfGe3HmsNgEUZhdue4b1PH" }, "trader": { "address": "2YNRXW6tL69NbrGNLnhWhy1JHcgFTWCFpETyiGZe41Z2" }, "baseAmount": { "raw": "8428769578", "decimals": 6 }, "quoteAmount": { "raw": "839022693", "decimals": 9 }, "quote": { "id": "So11111111111111111111111111111111111111112" }, "priceUsd": "0.010120781621341364", "priceQuote": "0.000099794668392787", "quotePriceUsd": "101.41605543", "valueUsd": "85.09037194031587299", "valueNative": "0.839022693" } ], "aggregates": { "buys": 41, "sells": 59, "buyVolumeUsd": "5824.60449530565", "sellVolumeUsd": "7005.476518534353", "netBase": { "raw": "-118168815181", "decimals": 6 }, "asOf": "461441674-220-401-17929704 … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | minUsd not 0-10,000,000; bad cursor; chain not an allowed EVM id | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit); an input with nothing in it is an empty page at full price, not a 404 | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 404 | `not_found` | no trade at or above minUsd in pump.fun's recent window (1 credit); an input with nothing in it is an empty page at full price, not a 404 | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Live coin stats `GET https://api.pumpfomo.com/v1/pump/coins/{mint}/live` Live stats of a coin: snipers, KOLs who traded, buys and sells, fees and tips, curve progress. pump.fun's in-memory view of an active coin: market cap and ATH, volume, bonding-curve progress, sniper and KOL counts, buy/sell/tx counts, priority fees, builder tips and trading-app fees, flags (cashback, holder reward, mayhem mode, live stream). Best for recently created coins; older coins may be a 404. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-coin-live ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `mint` | path | string | yes | Coin address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/coins/CSocnzcRpgSCr1naKcNTieWZUxb6rABe45j844m7pump/live" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "mint": "CSocnzcRpgSCr1naKcNTieWZUxb6rABe45j844m7pump", "chain": "solana:mainnet", "name": "Aura Final Boss", "ticker": "Kimchi", "dev": "EFSr396A6Jh7bNCSujGRLMkyXspbWitEvjNVatGD56oF", "program": "pump", "platform": "", "creationTime": 1792537215000, "quoteMint": "11111111111111111111111111111111", "pair": "SOL", "marketCapUsd": 9995208.663904918, "volumeSol": 648774.9389599047, "volumeUsd": 68606633.67890336, "progress": 100, "graduationDate": 1792537216000, "athMarketCapUsd": 48274447.80619645, "currentMarketPrice": 0, "sniperCount": 13, "numKolsTraded": 177, "txCount": 632434, "buyCount": 345073, "sellCount": 287361, "priorityFeeSol": 110.96575442103448, "priorityFeeUsd": 11690.491354904252, "builderTipSol": 0, "builderTipUsd": 0, "tradingAppFeeSol": 0, "tradingAppFeeUsd": 0, "builderTipSolV2": 469.93680561884537, "builderTipUsdV2": 49741.204324500075, "tradingAppFeeSolV2": 2600.823763736149, "tradingAppFeeUsdV2": 275086.3557292958, "txFeeSolV2": 276.53128061838436, "txFeeUsdV2": 29243.80020786176, "feeSeedSol": 0, "feeSeedUsd": 0, "isMayhemMode": false, "mayhemState": null, "mayhemMode": null, "isMultiplayer": false, "mayhemBotCoinSupplied": 0, "isCashbackEnabled": false, "isHolderReward": false, "isCurrentlyLive": false, "numLiveParticipants": 0, "isCharity": false, "isNsf … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | mint is not an address | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Market activity `GET https://api.pumpfomo.com/v1/pump/coins/{mint}/market-activity` Trades, volume, buyers, sellers and price change over 5m, 1h, 6h and 24h. Per window (5m, 1h, 6h, 24h): transactions, volume in USD, unique users, buys and sells, buy and sell volume, buyers, sellers and price change in percent. Works for Solana and EVM coins; for EVM pass chain. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-coin-market-activity ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `mint` | path | string | yes | Coin address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `0xD5f1afEA47b1A9eab414D2ee740cF1d6d039E725`. | | `chain` | query | string | no | EVM chain id, used only when the coin is an EVM address (ignored for Solana): 8453 (Base), 56 (BNB Chain), 1 (Ethereum), 4663 (Robinhood Chain). One of `8453`, `56`, `1`, `4663`, `143`, `5042`, `196`. Default `8453`. Example `4663`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/coins/CSocnzcRpgSCr1naKcNTieWZUxb6rABe45j844m7pump/market-activity" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "5m": { "numTxs": 419, "volumeUSD": 27020.643075000105, "numUsers": 200, "numBuys": 231, "numSells": 188, "buyVolumeUSD": 13190.661500210235, "sellVolumeUSD": 13829.98157478987, "numBuyers": 156, "numSellers": 154, "priceChangePercent": -0.8501630768436539 }, "1h": { "numTxs": 2933, "volumeUSD": 284164.1319433059, "numUsers": 1113, "numBuys": 1585, "numSells": 1348, "buyVolumeUSD": 138418.10440766756, "sellVolumeUSD": 145746.0275356383, "numBuyers": 726, "numSellers": 753, "priceChangePercent": -8.36613521926468 }, "6h": { "numTxs": 21382, "volumeUSD": 2695052.617403404, "numUsers": 5370, "numBuys": 11783, "numSells": 9599, "buyVolumeUSD": 1364919.3939721542, "sellVolumeUSD": 1330133.2234312494, "numBuyers": 4424, "numSellers": 3764, "priceChangePercent": 48.946214206113794 }, "24h": { "numTxs": 26545, "volumeUSD": 3190768.42138433, "numUsers": 6832, "numBuys": 14388, "numSells": 12157, "buyVolumeUSD": 1616800.6262806894, "sellVolumeUSD": 1573967.7951036408, "numBuyers": 5243, "numSellers": 4841, "priceChangePercent": 66.07789303796677 } }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:19:33.793Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | chain not 8453\|56\|1\|4663 | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Coins `GET https://api.pumpfomo.com/v1/pump/coins` pump.fun coins by newest, last trade or market cap, 60 a page (NSFW excluded). pump.fun's coin list with full coin records (curve reserves, creator, market cap, ATH, pool). Sort by creation, last trade or market cap, ascending or descending; page with offset. - Cost: 1 credit (1 a page (60 rows)) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-coins-list ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `sort` | query | string | no | Order by. One of `created`, `last_trade`, `market_cap`. Default `created`. Example `market_cap`. | | `order` | query | string | no | Direction. One of `desc`, `asc`. Default `desc`. Example `desc`. | | `offset` | query | integer | no | Rows to skip. Default `0`. Range 0 to 10000. Example `0`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/coins?sort=market_cap&order=desc" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": [ { "mint": "biMBtbQ6rrbYwFkUSYoWLWdN7UboDSu6S35wFrWpump", "initialized": true, "name": "XTO", "symbol": "XTO", "description": "The first coin in history that pays you $USO. Oil investing, open to every American.", "image_uri": "https://…/image.png", "metadata_uri": "https://ipfs.io/ipfs/QmRXsyysb9J33KQGg8cqBmKH7NH38mHwqTgPjVbh7Hy2cf", "twitter": "", "telegram": "", "bonding_curve": "EK2QM7LzdxY1sdFUzsY2z6s6BhCJwbNC8opBaNHDGi3P", "associated_bonding_curve": "8gJRvBmz7sBHkLC5cu1izNrhAt2YyGyGt1N1pW6kmqNs", "creator": "6SUZCqkSU1T4JK3MYQ7jRFwuk7PgyVmzDHv1QEGtLCo4", "created_timestamp": 1792969266000, "complete": true, "virtual_sol_reserves": 115005359057, "virtual_token_reserves": 279900000000000, "total_supply": 1000000000000000, "website": "", "show_name": true, "last_trade_timestamp": 1792969815000, "market_cap": 6633137.068719591, "nsfw": false, "inverted": true, "is_banned": false, "pump_swap_pool": "2u6AhzYF3NGv6dKUtGfwrwdNrjB5A6t4eMHaMLmAT7aJ", "real_sol_reserves": 85005359057, "real_token_reserves": 0, "updated_at": 1792969816, "livestream_ban_expiry": 0, "reply_count": 0, "is_currently_live": false, "ath_market_cap": 672923352.3954247, "ath_market_cap_timestamp": 1792969815000, "hide_banner": false, "program": "pump", "token_program": "Tokenz … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | sort, order or offset outside the allowed values | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Search coins `GET https://api.pumpfomo.com/v1/pump/search/coins` pump.fun coins by name, symbol or address (top 50, NSFW excluded). pump.fun's coin search, most relevant first, up to 50 coins with full coin records. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-search-coins ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `q` | query | string | yes | Search term, 1 to 64 characters (trimmed). Range 1 to 64. Example `pepe`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/search/coins?q=pepe" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": [ { "mint": "33jENUQnjoitkMFpvNJcSHyLAHFWJuHwT6E3E8CNpump", "initialized": true, "name": "Doge Pepe", "symbol": "DOPE", "image_uri": "https://…/image.png", "metadata_uri": "https://metadata.j7tracker.io/metadata/7vUE25Ttsd.json", "twitter": "https://x.com/essencepnl/status/2109274831673807308", "bonding_curve": "BkBSznBTytJfRxXfZ9gfqLpgsVuXHJ1TGQmsT7eyFwNc", "associated_bonding_curve": "4djrtFtP98B6sXRutJ9ZhUtsnQSLNbAzmUyd8T1Jb7Fh", "creator": "CZutgB7w4WbkeCEwFv1qxhkeGyjVGn9XXPYxjwQo3NaM", "created_timestamp": 1791725329000, "complete": true, "hidden": false, "total_supply": 1000000000000000, "website": "https://otcdesks.cash/coin/33jENUQnjoitkMFpvNJcSHyLAHFWJuHwT6E3E8CNpump", "show_name": true, "last_trade_timestamp": 1792969861000, "market_cap": 23345.081367444167, "nsfw": false, "is_banned": false, "pump_swap_pool": "6iep3EgqksbZwgzMBCyAJtiVtVYkCgL9BnPBEwLR8AGQ", "livestream_ban_expiry": 0, "is_currently_live": false, "ath_market_cap": 7282107.747239394, "ath_market_cap_timestamp": 1792088314000, "hide_banner": false, "program": "pump", "token_program": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", "quote_mint": "11111111111111111111111111111111", "base_decimals": 6, "quote_decimals": 9, "pool_address": "6iep3EgqksbZwgzMBCyAJtiVtVYkCgL9BnPBEwLR8AGQ", "is_cashba … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | q missing or longer than 64 characters | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | # pump.fun boards ## Explore boards `GET https://api.pumpfomo.com/v1/pump/boards/{board}` pump.fun's movers or trending board (up to 150 coins), on chosen chains. The coins pump.fun features right now. Keys are pump.fun's short names: m mint, c chain, n name, t ticker, i image, mc market cap (USD), vUsd/vUsd5/vUsd1h/vUsd24h volume, tx5 trades in 5 min, age (s), kol KOLs, sn snipers, nh holders, t10 top-10 share, ath, dw dev wallet. movers ranks by recent volume; trending by social activity over the last hour. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-board ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `board` | path | string | yes | Which board. One of `movers`, `trending`. Example `movers`. | | `chains` | query | string | no | Comma-separated chain names: solana, base, bnb, ethereum, robinhood, monad, arc, xlayer, megaeth (case-insensitive). Empty: all of them. Default `all`. Example `solana`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/boards/trending?chains=solana" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "board": "movers", "version": 0, "serverTs": 1792970375148, "rid": "7d344418-7e51-49c8-8970-4f6b0da005bf", "entries": [ { "m": "C5xph2yL6gMdxmuLGxJBkGpmuDFfyi5fqkBNhvL6pump", "c": "solana:mainnet", "n": "Big Titty Coin", "t": "BTC", "i": "https://images.pump.fun/coin-image/C5xph2yL6gMdxmuLGxJBkGpmuDFfyi5fqkBNhvL6pump", "mc": 9311544.106843702, "v": 172959.37245702112, "vUsd": 17697454.834108982, "p": 100, "v5": 228.83159144067264, "v15": 1347.4655335683376, "v1h": 3816.1664711965495, "v24h": 90414.14412880411, "vUsd5": 23217.165452734567, "vUsd15": 136645.69573350763, "vUsd1h": 387333.79094841063, "vUsd24h": 9173258.755467774, "tx5": 693, "age": 3641657, "kol": 91, "sn": 4, "mh": false, "hs": true, "pg": "pump", "pl": "", "lp": "pump", "gd": 1789330218000, "ath": 21942623.00493637, "bc": 200699, "sc": 147233, "txc": 347932, "nh": 15421, "t10": 75.0418, "dh": 0, "tw": true, "ws": false, "tg": false, "cb": false, "hr": true, "dw": "7jQwHdK771P286Vsn44v7dFVfCH8CzZcL3PZGidbShch", "lv": false, "np": 0, "ic": false, "so": 0, "bo": 0, "pa": "BTC", "ih": true, "tf": 5 … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | board not movers\|trending; an unknown chain name | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## PnL leaderboard `GET https://api.pumpfomo.com/v1/pump/leaderboard` pump.fun's top 100 traders by PnL, daily, weekly or monthly. The traders with the best PnL in the window: rank, wallet, PnL in SOL and USD (realized and unrealized), buy spend, positions count and top positions, username and avatar. Sort by combined, realized or unrealized PnL. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-leaderboard ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `period` | query | string | no | Window. One of `daily`, `weekly`, `monthly`. Default `weekly`. Example `weekly`. | | `sort` | query | string | no | Rank by. One of `combined`, `realized`, `unrealized`. Default `combined`. Example `combined`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/leaderboard?period=weekly&sort=combined" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "entries": [ { "rank": 1, "walletAddress": "4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR", "pnlSol": 2842.922008149725, "pnlUsd": 288290.6267491025, "pnlPercent": 25.684631225772225, "buySpendSol": 45.38016143390251, "lastRefreshedAtMs": 1792969473684, "realizedPnlSol": 20.482600297150288, "realizedPnlUsd": 2077.067770480259, "unrealizedPnlSol": 2822.439407852575, "unrealizedPnlUsd": 286213.55897862226, "positionsCount": 18, "topPositions": [ { "mint": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "chainId": 1399811149, "symbol": "STONK", "name": "STONK", "imageUri": "https://gateway.irys.xyz/em5twmyoeTJw9eZDj25xoKbBjHYhbeXYCcZ55o23Ztg" } ], "username": "J777Crypto", "profileImage": "https://socialimages.pump.fun/profile-images/1e2df2f0-4720-4edb-a6d2-dd2833300de9/312a5881-7336-4891-a58a-d05e762a9e60", "xUsername": "J777Crypto", "isVerified": true, "verifiedBadgeVisible": false, "userId": "1e2df2f0-4720-4edb-a6d2-dd2833300de9" } ], "periodType": 1, "periodLabel": "7d", "windowStartSec": 1792364400 }, "meta": { "cache": "stale", "fetchedAt": "2026-10-25T23:09:10.798Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | period not daily\|weekly\|monthly; sort not combined\|realized\|unrealized | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Streak leaderboard `GET https://api.pumpfomo.com/v1/pump/leaderboard/streaks` The wallets with the longest current daily trading streaks. Rank, wallet and streak length in days. May briefly answer 503 (not charged): retry shortly. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-leaderboard-streaks ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `limit` | query | integer | no | Rows. Default `100`. Range 1 to 100. Example `10`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/leaderboard/streaks?limit=10" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "entries": [ { "address": "GKMUxpHS5uoW1dqjxzyJP66bHC3GbsKaQKU1tzXmzReb", "streak": 326, "rank": 1, "subjectType": "wallet" }, { "address": "6G8Cu53PRgm5aPHxMaZRguYHJfaNxmnmgoR129cKMvJk", "streak": 310, "rank": 2, "subjectType": "wallet" }, { "address": "9awhNmqQYwNHGhEZjuwNdNRCoxaTp6jd6vY17H8e68PF", "streak": 267, "rank": 3, "subjectType": "wallet" } ] }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:11:09.096Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | limit not 1-100 | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Leaderboard positions `GET https://api.pumpfomo.com/v1/pump/leaderboard/positions` The best single positions behind the PnL leaderboard. The top positions of the window: wallet, coin, PnL and percentage, amounts, cost basis, average entry market cap, and the callout behind it if any. - Cost: 2 credits (2 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-leaderboard-positions ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `period` | query | string | no | Window. One of `daily`, `weekly`. Default `daily`. Example `daily`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/leaderboard/positions?period=daily" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "entries": [ { "rank": 1, "walletAddress": "5YRgrP3mjGzrzirYYN5HAQH19cTYREYwGxW6XRJQUzij", "coinMint": "C5xph2yL6gMdxmuLGxJBkGpmuDFfyi5fqkBNhvL6pump", "pnlUsd": 5183990.802955288, "pnlPercentage": 4542.860182275024, "amountHeld": 573220212.099966, "isExited": false, "costBasisAmount": 562685817.5330251, "costBasisUsd": 64925.02920486823, "amountBoughtUsd": 114112.92874876004, "amountBought": 822106210.2503985, "realizedPnlUsd": 3990.7317039395366, "avgEntryMcapUsd": 115384.15787609159, "callout": { "calloutId": "86cf1898-9d30-43d1-a688-14f15ce15991", "chain": null, "assetClass": "ASSET_CLASS_TOKEN", "perp": null, "calledOutAtMcap": 199881, "multiple": 46.55153321370956, "thesis": "please pay dex and make this project a 100M runner. \n\nthe stage is yours.", "mediaUrl": null, "calloutTimestamp": "2026-09-13T20:11:24.754Z", "likes": 727, "hasLiked": null, "updates": [], "updateCount": 0, "commentCount": 1283, "replyCount": 1487, "maxMultiplier": 109.58451988529629, "maxMultiplierAt": "2026-10-25T10:51:44.681Z", "calloutPrice": 0.000200234695812, "repostCount": 91, "quoteCount": 8, "hasReposted": null, "viewCount": 410511, … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | period not daily\|weekly\|monthly | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Payouts leaderboard `GET https://api.pumpfomo.com/v1/pump/leaderboard/payouts` Who pump.fun paid the most USDC to in the last day, 50 a page. pump.fun's USDC payouts (rewards) ranked: user, wallets, total paid, number of payouts and when last paid. The only window pump.fun takes is 1d. Pages start at 0. - Cost: 1 credit (1 a page (50 rows)) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-leaderboard-payouts ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `period` | query | string | no | Window (pump.fun only takes 1d). One of `1d`. Default `1d`. Example `1d`. | | `page` | query | integer | no | Page, from 0. Default `0`. Range 0 to 1000. Example `0`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/leaderboard/payouts?period=1d" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "entries": [ { "rank": 1, "userId": "e971fd33-a4ef-407a-aa21-0144302f4e3c", "username": "chairman", "profileImageUrl": "https://socialimages.pump.fun/profile-images/e971fd33-a4ef-407a-aa21-0144302f4e3c/8c4bc745-777c-47b2-8190-7d299bd6bbd9", "isVerified": true, "verifiedBadgeVisible": false, "twitterId": "1180963377406853121", "twitterUrl": "https://x.com/i/user/1180963377406853121", "wallets": [ "Be24Gbf5KisDk1LcWWZsBn8dvB816By7YzYF5zWZnRR6" ], "walletAddress": "Be24Gbf5KisDk1LcWWZsBn8dvB816By7YzYF5zWZnRR6", "totalPaidUsdc": 31049.576891, "payoutCount": 1, "lastPaidAt": "2026-10-25T15:15:10.399Z" } ], "totalEarners": 3327, "generatedAt": "2026-10-25T23:07:12.227Z" }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:11:11.637Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | period not 1d; page not 0-1000 | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Competitions `GET https://api.pumpfomo.com/v1/pump/competitions` pump.fun trading competitions: upcoming, live and past, with prizes and winners. Every pump.fun trading competition grouped as upcoming, live and past: title, kind (person or group), prizes, registration and run dates, entries, phase, and for finished ones the winners with PnL and prize. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-competitions ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/competitions" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "upcoming": [], "live": [ { "id": "f0f80f25-3b5c-4996-8750-7940f6950965", "slug": "squad-invitiational", "kind": "group", "title": "Squad Invitiational", "description": "Welcome to the largest squad competition ever! Scoring: ranked by total profit (realized plus unrealized) on positions opened through pump.f…", "prizeCopy": "2500000", "imageUrl": "https://socialimages.pump.fun/competition-images/847b48ee-209e-4bb5-a5f1-a0ee4608b052/09fb20d9-5bb1-44e5-9200-9cfcc7451859", "prizes": [ { "rankFrom": 1, "rankTo": 1, "amount": "1500000" } ], "registrationOpensAt": "2026-10-23T14:00:00.000Z", "registrationClosesAt": "2026-10-26T14:00:00.000Z", "startsAt": "2026-10-26T14:00:00.000Z", "endsAt": "2026-11-09T14:00:00.000Z", "minMembers": 2, "maxMembers": 20, "maxEntries": 0, "entriesCount": 207, "participants": 207, "joinable": true, "phase": "registration", "isFinal": false, "top": [], "winners": [] } ], "past": [ { "id": "2b6237ac-5c76-4a40-a669-d1a1d29d2dae", "slug": "solo-cuptober", "kind": "person", "title": "Solo Cuptober", "description": "Welcome to the first solo trading competition of Q4 2026!", "prizeCopy": "100000", "imageUrl": "https:// … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Competition `GET https://api.pumpfomo.com/v1/pump/competitions/{id}` One competition with its live leaderboard. The competition record and its leaderboard (entries ranked by PnL, when built). Get ids from GET /v1/pump/competitions. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-competition ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `id` | path | string | yes | Competition id (UUID). Example `f0f80f25-3b5c-4996-8750-7940f6950965`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/competitions/f0f80f25-3b5c-4996-8750-7940f6950965" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "competition": { "id": "f0f80f25-3b5c-4996-8750-7940f6950965", "slug": "squad-invitiational", "kind": "group", "title": "Squad Invitiational", "description": "Welcome to the largest squad competition ever! Scoring: ranked by total profit (realized plus unrealized) on positions opened through pump.f…", "prizeCopy": "2500000", "imageUrl": "https://socialimages.pump.fun/competition-images/847b48ee-209e-4bb5-a5f1-a0ee4608b052/09fb20d9-5bb1-44e5-9200-9cfcc7451859", "prizes": [ { "rankFrom": 1, "rankTo": 1, "amount": "1500000" }, { "rankFrom": 2, "rankTo": 2, "amount": "750000" } ], "registrationOpensAt": "2026-10-23T14:00:00.000Z", "registrationClosesAt": "2026-10-26T14:00:00.000Z", "startsAt": "2026-10-26T14:00:00.000Z", "endsAt": "2026-11-09T14:00:00.000Z", "minMembers": 2, "maxMembers": 20, "maxEntries": 0, "entriesCount": 207, "participants": 207, "joinable": true, "phase": "registration", "isFinal": false, "top": [], "winners": [] }, "leaderboard": { "builtAtMs": 0, "startSec": 1793023200, "endSec": 0, "totalRanked": 0, "isFinal": false, "entries": [] } }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:11:14.096Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | id is not a UUID | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Competition entry highlights `GET https://api.pumpfomo.com/v1/pump/competitions/{id}/entries/{entry}` A competition entry's 10 best tokens and each member's PnL in them. For one entry (a solo trader or a squad): its best tokens by PnL with realized and unrealized split, and per member. Entry ids are in the competition's winners and leaderboard. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-competition-entry ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `id` | path | string | yes | Competition id (UUID). Example `2b6237ac-5c76-4a40-a669-d1a1d29d2dae`. | | `entry` | path | string | yes | Entry id (UUID). Example `354283d3-2b09-4636-8e9d-86c51a22baf3`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/competitions/2b6237ac-5c76-4a40-a669-d1a1d29d2dae/entries/354283d3-2b09-4636-8e9d-86c51a22baf3" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "entryId": "354283d3-2b09-4636-8e9d-86c51a22baf3", "tokens": [ { "mint": "Hg5Ja55T5wESq4vyFoiVCMeHXtGyVA69X2UHq8hgpump", "chainId": 1399811149, "pnlUsd": 278243.7844662089, "realizedPnlUsd": 0, "unrealizedPnlUsd": 278243.7844662089, "buySpendUsd": 0, "members": [ { "userId": "ecd87de4-52cc-4c70-a965-13903b4c5760", "walletAddress": "4y2T1ghykCTq4EddoXjptZamk4qAsqcZw6eKxS8jdvE1", "pnlUsd": 278243.7844662089, "realizedPnlUsd": 0, "unrealizedPnlUsd": 278243.7844662089, "buySpendUsd": 0 } ], "symbol": "baton", "name": "baton", "imageUri": "https://…/image.png" } ] }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:11:15.457Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | id or entry is not a UUID | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## SOL price `GET https://api.pumpfomo.com/v1/pump/sol-price` pump.fun's SOL/USD price. The SOL price pump.fun uses, with its timestamp. Free. - Cost: free - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-sol-price ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/sol-price" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "solPrice": 101.433245893, "asOfTimestamp": 1792969874795, "stale": false }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:11:16.631Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | # pump.fun callouts ## A trader's callouts `GET https://api.pumpfomo.com/v1/pump/users/{wallet}/callouts` A pump.fun trader's callouts, newest first (100): thesis, call market cap, multiple, and how followers did. Each callout: coin, market cap and price when called, the best multiple since, thesis, likes, replies, views, and "tail" stats — how many people bought after it and their PnL at 1h, 4h and 24h, with histograms. Takes a wallet or a pump.fun user id. - Cost: 2 credits (2 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user-callouts ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `wallet` | path | string | yes | A wallet address (Solana or EVM) or a pump.fun user id (UUID). Example `Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/users/4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR/callouts" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "callouts": [ { "calloutId": "24f30f64-c76b-4874-acbd-959b5faff047", "userId": "4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR", "coinMint": "9jBBwEK6UZgLv5vm7F1KsULgYAy5dHo9LEYmCfLWKPDj", "marketCap": 62359, "calloutPrice": 6.14760698688627e-7, "calloutPriceUsd": 0.00006235862887, "multiple": 0.5795672318128364, "createdAt": 1792909733231, "maxPriceSol": 0.0000063977108831412905, "maxPriceUsd": 0.0006489557309541594, "thesis": "whitewhale but on STONK", "user_uuid": "", "likes": 58, "hasLiked": null, "hasReposted": null, "repostCount": 5, "quoteCount": 0, "updates": [], "updateCount": 0, "commentCount": 10, "replyCount": 14, "maxMultiplier": 10.406831303283584, "maxMultiplierAt": "2026-10-25T07:08:24.481Z", "viewCount": 14680, "mediaUrl": null, "quotedCalloutId": null, "quotedCallout": null, "chain": null, "perp": null, "tailBuyers": 150, "tailCohort1h": 123, "tailPnl1hUsd": 11347.311283609455, "tailCohort4h": 148, "tailPnl4hUsd": 3119.432020299378, "tailCohort24h": null, "tailPnl24hUsd": null, "tailPnlHist1h": { "buckets": [ { "min": null, "max": -500, "tailers": 0, "pnlUsd": 0 … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | wallet is neither an address nor a UUID | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Callout stats `GET https://api.pumpfomo.com/v1/pump/users/{wallet}/callout-stats` How a trader's callouts did: hit rates, multiples, and the PnL of those who followed them. Daily, weekly, monthly and all-time: number of callouts, the share that reached 1.2x, 1.5x and 2x, average and median multiple, time to peak, a multiple distribution, and follower ("tail") PnL at 1h, 4h and 24h. - Cost: 2 credits (2 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user-callout-stats ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `wallet` | path | string | yes | Wallet address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/users/4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR/callout-stats" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "daily": { "totalCallouts": 0, "calloutsWithMultiple": 0, "twoXPercent": 0, "onePointFiveXPercent": 0, "onePointTwoXPercent": 0, "averageMultiple": 0, "medianMultiple": 0, "averageTimeToPeakMs": null, "tailBuyers": null, "tailCallouts": null, "tailCallouts1h": null, "tailCohort1h": null, "tailPnl1hUsd": null, "tailCallouts4h": null, "tailCohort4h": null, "tailPnl4hUsd": null, "tailCallouts24h": null, "tailCohort24h": null, "tailPnl24hUsd": null, "tailUniqueBuyers": null, "tailVolumeUsd": null, "tailPnlHist1h": null, "tailPnlHist4h": null, "tailPnlHist24h": null, "tailAth1hUsd": null, "tailAth4hUsd": null, "tailAth24hUsd": null, "tailAthHist1h": null, "tailAthHist4h": null, "tailAthHist24h": null, "distribution": [ { "min": 1, "max": 1.1, "count": 0 } ], "ranks": null }, "weekly": { "totalCallouts": 6, "calloutsWithMultiple": 6, "twoXPercent": 50, "onePointFiveXPercent": 83.33333333333334, "onePointTwoXPercent": 83.33333333333334, "averageMultiple": 3.2225854710967496, "medianMultiple": 1.9353488158945082, "averageTimeToPeakMs": 43037874, "tailBuyers": 218, "tailCallouts": 6, "tailCallouts1h": 6, "tailCohort1h": 166, "tailPnl1hUsd": 11 … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | wallet is not an address | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Callout `GET https://api.pumpfomo.com/v1/pump/callouts/{id}` One pump.fun callout with its author. A callout by id: coin, market cap and price when called, best multiple, thesis, updates, engagement, and the author's name, avatar and verification. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-callout ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `id` | path | string | yes | Callout id (UUID; calloutId in callout lists and the callouts stream). Example `0ea8d52d-bc1a-4bb9-a9a5-229449d079fe`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/callouts/aea920b9-ba5d-4c96-9d32-991aa09be823" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "callout": { "calloutId": "aea920b9-ba5d-4c96-9d32-991aa09be823", "userId": "Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14", "coinMint": "6FhVPctYg363pQbs4iSvqyHe2cJzfsvFD96gePy6pump", "marketCap": 25254, "calloutPrice": 2.490481186799783e-7, "calloutPriceUsd": 0.0000252538349045, "multiple": 151.70115274332576, "createdAt": 1790975315246, "maxPriceSol": 0.00005607958283470471, "maxPriceUsd": 0.005686549787756816, "thesis": "$EXFIL is interesting because it gives a micro cap something most memes don’t have: \n☝🏽an actual reason to come back to the site.\n\nexfil.fu…", "user_uuid": "400bfe0b-a8e9-4d4f-aac0-46408e7b6127", "likes": 12, "hasLiked": null, "hasReposted": null, "repostCount": 3, "quoteCount": 0, "updates": [], "updateCount": 0, "commentCount": 6, "replyCount": 47, "maxMultiplier": 225.1756934842211, "maxMultiplierAt": "2026-10-22T13:23:22.041Z", "viewCount": 2509, "mediaUrl": null, "quotedCalloutId": null, "quotedCallout": null, "chain": null, "perp": null, "userName": "MispriceDegen", "profileImage": "https://socialimages.pump.fun/profile-images/400bfe0b-a8e9-4d4f-aac0-46408e7b6127/020255ef-8351-4c38-aacf-1f8385d0e1c2", "isVerified": false, "verifiedBadgeVisible": true, "xUsername": null, "xFollowerCount": 0, "accountKind": "person" … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | id is not a UUID | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Callout replies `GET https://api.pumpfomo.com/v1/pump/callouts/{id}/replies` The replies under a callout (up to 200), or only the author's own updates. Each reply with its author, text, likes and views, and the replier's position in the coin (held, value, PnL). authorOnly=true keeps only the caller's own follow-ups. - Cost: 1 credit (1 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-callout-replies ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `id` | path | string | yes | Callout id (UUID). Example `0ea8d52d-bc1a-4bb9-a9a5-229449d079fe`. | | `authorOnly` | query | boolean | no | true: only the author's updates. true or false. Default `false`. Example `false`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/pump/callouts/aea920b9-ba5d-4c96-9d32-991aa09be823/replies" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "replies": [ { "id": "e25151b7-e077-40aa-b9ba-2bff0dfec9c0", "content": "EXFIL at 3.3M MC. I think people are overlooking the bigger picture. 🐀\n\nMost memecoins launch first and promise utility later. EXFIL alread…", "createdAt": "2026-10-25T12:32:46.574Z", "likeCount": 2, "userId": "400bfe0b-a8e9-4d4f-aac0-46408e7b6127", "walletAddress": "Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14", "userName": "MispriceDegen", "profileImage": "https://socialimages.pump.fun/profile-images/400bfe0b-a8e9-4d4f-aac0-46408e7b6127/020255ef-8351-4c38-aacf-1f8385d0e1c2", "accountKind": "person", "mediaUrl": "https://socialimages.pump.fun/community-media/400bfe0b-a8e9-4d4f-aac0-46408e7b6127/2784faf7-4e37-4913-b89c-2fa44c5dd4a8", "parentMessageId": null, "rootMessageId": null, "directReplyCount": 0, "threadReplyCount": 0, "previewReplies": [], "authorReply": null, "tombstone": false, "hasLiked": null, "viewerFollowsAuthor": null, "repostCount": 2, "positionAmountHeld": 16831988.300974984, "positionValueUsd": 64501.47127080877, "positionPnlUsd": 63780.002796196204, "positionPnlPercentage": null, "positionCostBasisAmount": 16831988.300974984, "positionCostBasisUsd": 1724.3719836094192, "positionAmountBoughtUsd": 3580.3371892929267, "positionAmountBought": … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | id is not a UUID | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | # pump.fun batch ## Profiles of many wallets `POST https://api.pumpfomo.com/v1/pump/users/batch` pump.fun profiles of up to 50 wallets; only matched wallets come back. The profile of each wallet that belongs to a pump.fun user (wallets without one are left out). Same fields as GET /v1/pump/users/{id}. - Cost: 5 credits (5 per call, whatever the count) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-users-batch ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `addresses` | body | array | yes | 1 to 50 wallets (Solana or EVM); duplicates are merged. Range 1 to 50. Example `["Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14"]`. | ### Request body ```json { "addresses": [ "Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14", "9gbYLSYhHqXrTWbGZxrohXCGvoceGZCW9kaLYqksi917" ] } ``` ### Example ```bash curl -s -X POST "https://api.pumpfomo.com/v1/pump/users/batch" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"addresses":["Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14","9gbYLSYhHqXrTWbGZxrohXCGvoceGZCW9kaLYqksi917"]}' ``` Answer (200), shortened: ```json { "data": [ { "address": "4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR", "userId": "1e2df2f0-4720-4edb-a6d2-dd2833300de9", "is_pump_user": true, "is_banned": false, "username": "J777Crypto", "profile_image": "https://socialimages.pump.fun/profile-images/1e2df2f0-4720-4edb-a6d2-dd2833300de9/312a5881-7336-4891-a58a-d05e762a9e60", "avatar_decoration": "achievement:views-1m", "resolved_avatar_decoration": "achievement:views-1m", "bio": "We Win ", "followers": 227026, "following": 89, "x_username": "J777Crypto", "canonical_svm_wallet": "4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR", "canonical_evm_wallet": "0xe48b6e0e9900d68ba93ac417d9e2ce911c52f753", "group_badges": [ { "group_id": "cc8091d7-d628-4abd-93b1-ada1e6ef23fa", "username": "Dabal", "profile_image_url": "https://socialimages.pump.fun/profile-images/d94bd517-1cbe-4ec5-88e8-96232986d487/c5c93a8a-8013-4d2c-a91c-329f93dc8733", "role": "MEMBER" } ], "active_competition_entry": null } ], "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:20:20.857Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | the body is not {"addresses": [...]}, has 0 or more than 50 entries, or one is not an address | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Wallet overview (batch) `POST https://api.pumpfomo.com/v1/pump/wallets/overview` Total value, SOL balance and first-trade time of up to 20 wallets. A one-line summary per wallet, keyed by address: total value in USD, SOL balance and price, chains that could not be read, and the first transaction time. - Cost: 5 credits (5 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-wallets-overview ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `wallets` | body | array | yes | 1 to 20 wallets (Solana or EVM); duplicates are merged. Range 1 to 20. Example `["Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14"]`. | ### Request body ```json { "wallets": [ "Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14", "9gbYLSYhHqXrTWbGZxrohXCGvoceGZCW9kaLYqksi917" ] } ``` ### Example ```bash curl -s -X POST "https://api.pumpfomo.com/v1/pump/wallets/overview" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"wallets":["Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14","9gbYLSYhHqXrTWbGZxrohXCGvoceGZCW9kaLYqksi917"]}' ``` Answer (200), shortened: ```json { "data": { "wallets": { "4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR": { "total_value_usd": 1726410.6084433808, "sol_price_usd": 101.37603496210923, "native_balance_sol": 5.560202675, "unavailable_chains": [], "truncated": false, "first_tx_timestamp": 1787306819 }, "4ugDhHJ8XDXAeABmrNmGffFaLbJb9BkPyiFGVSV9ocwo": { "total_value_usd": 2739538.5931807286, "sol_price_usd": 101.37834599791037, "native_balance_sol": 0.093489229, "unavailable_chains": [], "truncated": false, "first_tx_timestamp": 1776393482 }, "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU": { "total_value_usd": 7777.639325867566, "sol_price_usd": 101.42711059601675, "native_balance_sol": 71.7366408, "unavailable_chains": [], "truncated": false, "first_tx_timestamp": 1618951432 }, "9gbYLSYhHqXrTWbGZxrohXCGvoceGZCW9kaLYqksi917": { "total_value_usd": 0, "sol_price_usd": 0, "native_balance_sol": 0, "unavailable_chains": [], "truncated": false, "first_tx_timestamp": null }, "Bmi9zf27MNN5pjCtyv2Y15TDQoYgcbcmPTxvEoQ6UwWs": { "total_value_usd": 1043956.881381738, "sol_price_usd": 101.42711059601675, "native_balance_sol": 7.909050596, "unavailable_chains": [], "truncated": false, "first_tx_timestamp": 1621387825 }, " … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | the body is not {"wallets": [...]}, has 0 or more than 20 entries, or one is not an address | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Coins (batch) `POST https://api.pumpfomo.com/v1/pump/coins/batch` Full coin records of up to 50 mints. pump.fun's enriched coin rows for many mints at once: curve, creator, market cap, ATH, pool and flags. - Cost: 5 credits (5 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-coins-batch ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `mints` | body | array | yes | 1 to 50 coin addresses (Solana or EVM); duplicates are merged. Range 1 to 50. Example `["Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh"]`. | ### Request body ```json { "mints": [ "Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh", "F7UzsCL67EWYPbiuTC9fq7nprZrSJ86wBMijG8D3pump" ] } ``` ### Example ```bash curl -s -X POST "https://api.pumpfomo.com/v1/pump/coins/batch" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"mints":["Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh","F7UzsCL67EWYPbiuTC9fq7nprZrSJ86wBMijG8D3pump"]}' ``` Answer (200), shortened: ```json { "data": [ { "mint": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "initialized": true, "name": "STONK", "symbol": "STONK", "description": "STONK was launched on StonkFun.", "image_uri": "https://gateway.irys.xyz/em5twmyoeTJw9eZDj25xoKbBjHYhbeXYCcZ55o23Ztg", "metadata_uri": "https://gateway.irys.xyz/7HzAyVbL19x2RsKPwFD2NdESBDS1ZhawFojcVLvsFr5N", "bonding_curve": "7a8xxAJBELDo6P9dikSYctdw6ce8F4mWr3ahcAD8Ao49", "associated_bonding_curve": "EstAnCrduC4n3Tvmw8veFaEGYLHuDxxtn1F1o4kmgQt5", "creator": "5CEbueQnq1Ym2uSSx2xXds3jQAqT1BDnkA59RZobSPAG", "created_timestamp": 1784833617000, "complete": false, "hidden": false, "total_supply": 911861845728572800, "show_name": true, "last_trade_timestamp": 1792970121000, "nsfw": false, "is_banned": false, "livestream_ban_expiry": 0, "is_currently_live": false, "ath_market_cap": 364611586.7719417, "ath_market_cap_timestamp": 1790019917000, "hide_banner": false, "program": "stonkfun", "platform": "stonkfun", "token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA", "quote_mint": "XsoCS1TfEyfFhfvj8EtZ528L3CaKBDBRqRapnBbDF2W", "base_decimals": 9, "quote_decimals": 8, "pool_address": "7a8xxAJBELDo6P9dikSYctdw6ce8F4mWr3ahcAD8Ao49", "is_cashback_enabled": false, "indexed_by_pump": false, "tokenized_agent": false, "chain_id": "solana:5 … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | the body is not {"mints": [...]}, has 0 or more than 50 entries, or one is not an address | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Wallet PnL in many coins `POST https://api.pumpfomo.com/v1/pump/users/{wallet}/pnl/coins` One wallet's PnL in each of up to 50 coins. Per coin: unrealized (cost basis, PnL, percentage, held), realized (PnL, average buy and sell price, sold, in/out), total buy spend and fees, in SOL and USD. Wrapped as {success, data}. - Cost: 5 credits (5 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-user-pnl-coins ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `wallet` | path | string | yes | Wallet address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14`. | | `mints` | body | array | yes | 1 to 50 coin addresses (Solana or EVM); duplicates are merged. Range 1 to 50. Example `["Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh"]`. | ### Request body ```json { "mints": [ "6FhVPctYg363pQbs4iSvqyHe2cJzfsvFD96gePy6pump", "Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh" ] } ``` ### Example ```bash curl -s -X POST "https://api.pumpfomo.com/v1/pump/users/4UrFSCrGxgoCtCUBAEZq7ZmPK3Pczkxx7PwYnkBMi1KR/pnl/coins" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"mints":["6FhVPctYg363pQbs4iSvqyHe2cJzfsvFD96gePy6pump","Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh"]}' ``` Answer (200), shortened: ```json { "data": { "success": true, "data": [ { "mint": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "unrealized": { "cost_basis": { "sol": 2196.387826618035, "usd": 248151.55056263407 }, "pnl": { "sol": 10272.327732210273, "usd": 1017880.5352277404 }, "percentage": { "sol": 467.69188973458523, "usd": 410.1850393116221 }, "amount_held": 9576542.881249007 }, "realized": { "pnl": { "sol": 820.2052602245689, "usd": 85384.95519513555 }, "percentage": { "sol": 5404.125304806895, "usd": 5527.840816237808 }, "avg_buy_price": { "sol": 0.000005864803507525466, "usd": 0.0005968733013904795 }, "avg_sell_price": { "sol": 0.00032280613393491153, "usd": 0.03359107927687951 }, "amount_sold": 2587877.2551328233, "total_in": { "sol": 15.177391602948356, "usd": 1544.6348408644603 }, "total_out": { "sol": 835.3826518275173, "usd": 86929.59003600001 } }, "total_buy_spend": { "sol": 2308.920186220773, "usd": 259379.1037392835 }, "total_buy_amount": 2232313.861480191, "last_slot_index_id … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | wallet is not an address | | 400 | `invalid_param` | the body is not {"mints": [...]}, has 0 or more than 50 entries, or one is not an address | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Creator fees chart (batch) `POST https://api.pumpfomo.com/v1/pump/creators/fees/chart` Creator fees earned by up to 20 creator wallets over time. Fee charts for creator wallets: daily points for a year (granularity=1d, 365 points) or 30-minute points for a day (granularity=30m, 48 points). - Cost: 5 credits (5 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-creators-fees-chart ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `granularity` | query | string | no | 1d (365 points) or 30m (48 points). One of `1d`, `30m`. Default `1d`. Example `1d`. | | `wallets` | body | array | yes | 1 to 20 creator wallets (Solana or EVM); duplicates are merged. Range 1 to 20. Example `["Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14"]`. | ### Request body ```json { "wallets": [ "AcoWyav6xXwysjWwKaEXP7ER1CxqNoAdGbrK8SY4CV7c" ] } ``` ### Example ```bash curl -s -X POST "https://api.pumpfomo.com/v1/pump/creators/fees/chart?granularity=1d" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"wallets":["AcoWyav6xXwysjWwKaEXP7ER1CxqNoAdGbrK8SY4CV7c"]}' ``` Answer (200), shortened: ```json { "data": { "items": [ { "timestamp": "2026-10-25T00:00:00.000Z", "totalEarnedByQuoteMint": [ { "quoteMintAddress": "11111111111111111111111111111111", "totalEarnedAtomic": "443241", "totalEarnedQuote": "0.000443241", "totalEarnedUSD": "0.044962003581050277" } ] }, { "timestamp": "2026-10-24T00:00:00.000Z", "totalEarnedByQuoteMint": [ { "quoteMintAddress": "11111111111111111111111111111111", "totalEarnedAtomic": "12808718", "totalEarnedQuote": "0.012808718", "totalEarnedUSD": "1.299305850732813846" } ] }, { "timestamp": "2026-10-23T00:00:00.000Z", "totalEarnedByQuoteMint": [ { "quoteMintAddress": "11111111111111111111111111111111", "totalEarnedAtomic": "35050296", "totalEarnedQuote": "0.035050296", "totalEarnedUSD": "3.555473284892129112" } ] } ] }, "meta": { "cache": "cache", "fetchedAt": "2026-10-25T23:22:26.427Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | granularity not 1d\|30m | | 400 | `invalid_param` | the body is not {"wallets": [...]}, has 0 or more than 20 entries, or one is not an address | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## ATH market cap (batch) `POST https://api.pumpfomo.com/v1/pump/coins/ath/batch` All-time-high market cap of up to 60 coins. Keyed by mint: {athMarketCap} in USD, or null when pump.fun has none for the coin. - Cost: 3 credits (3 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-coins-ath-batch ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `mints` | body | array | yes | 1 to 60 coin addresses (Solana or EVM); duplicates are merged. Range 1 to 60. Example `["Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh"]`. | ### Request body ```json { "mints": [ "Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh", "F7UzsCL67EWYPbiuTC9fq7nprZrSJ86wBMijG8D3pump" ] } ``` ### Example ```bash curl -s -X POST "https://api.pumpfomo.com/v1/pump/coins/ath/batch" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"mints":["Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh","F7UzsCL67EWYPbiuTC9fq7nprZrSJ86wBMijG8D3pump"]}' ``` Answer (200), shortened: ```json { "data": { "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx": { "athMarketCap": 399853978.40680456 }, "7ttfwuBSnbNTgf32gUAT7v9bjdDWsn6pYpp7nmGmpump": { "athMarketCap": 252205.7916702093 }, "AYX3LQeZajagnjYkqz4HUsh3mXeUSEzsXyEWfxULpump": { "athMarketCap": 94990990.25073747 }, "C5xph2yL6gMdxmuLGxJBkGpmuDFfyi5fqkBNhvL6pump": { "athMarketCap": 21942623.004936367 }, "CSocnzcRpgSCr1naKcNTieWZUxb6rABe45j844m7pump": { "athMarketCap": 48268252.174102135 }, "DffdPtAKvnP91k9Ct6QvZ8TwVvWbJ6CxRtGNGNh9pump": { "athMarketCap": 9419726.989548806 } }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:20:47.404Z", "source": "pump.fun" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | the body is not {"mints": [...]}, has 0 or more than 60 entries, or one is not an address | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Market activity (batch) `POST https://api.pumpfomo.com/v1/pump/coins/market-activity/batch` Trades, volume, traders and price change over 5m, 1h, 6h and 24h of up to 50 coins. Keyed by mint, then by window (5m, 1h, 6h, 24h): numTxs, volumeUSD, numUsers and priceChangePercent. Ideal for refreshing a whole coin list at once. - Cost: 3 credits (3 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-coins-market-activity-batch ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `mints` | body | array | yes | 1 to 50 coin addresses (Solana or EVM); duplicates are merged. Range 1 to 50. Example `["Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh"]`. | ### Request body ```json { "mints": [ "Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh", "F7UzsCL67EWYPbiuTC9fq7nprZrSJ86wBMijG8D3pump" ] } ``` ### Example ```bash curl -s -X POST "https://api.pumpfomo.com/v1/pump/coins/market-activity/batch" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"mints":["Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh","F7UzsCL67EWYPbiuTC9fq7nprZrSJ86wBMijG8D3pump"]}' ``` Answer (200), shortened: ```json { "data": { "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx": { "5m": null, "1h": { "numTxs": 92, "volumeUSD": 2873.5384865802703, "numUsers": 33, "priceChangePercent": 0.4112548617413974 }, "6h": { "numTxs": 925, "volumeUSD": 62925.90924151058, "numUsers": 443, "priceChangePercent": 3.6429949976262974 }, "24h": { "numTxs": 3338, "volumeUSD": 202847.24208509616, "numUsers": 1407, "priceChangePercent": 23.41491777993339 } }, "7ttfwuBSnbNTgf32gUAT7v9bjdDWsn6pYpp7nmGmpump": { "5m": { "numTxs": 5, "volumeUSD": 418.10609572740213, "numUsers": 5, "priceChangePercent": -0.342658716824448 }, "1h": { "numTxs": 89, "volumeUSD": 6863.307544186847, "numUsers": 59, "priceChangePercent": 1.402043428138949 }, "6h": { "numTxs": 634, "volumeUSD": 53131.167519569484, "numUsers": 178, "priceChangePercent": -12.843628650185401 }, "24h": { "numTxs": 2762, "volumeUSD": 214306.10240477405, "numUsers": 250, "priceChangePercent": 27.14929937887116 } }, "AYX3LQeZajagnjYkqz4HUsh3mXeUSEzsXyEWfxULpump": { "5m": { "numTxs": 150, "volumeUSD": 1799.7626006050016, "numUsers": 31, "priceChangePercent": -0.094046322140304 }, "1h": { … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | the body is not {"mints": [...]}, has 0 or more than 50 entries, or one is not an address | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Holders' PnL in a coin `POST https://api.pumpfomo.com/v1/pump/coins/{mint}/holders/pnl` Each of up to 50 wallets' PnL in one Solana coin. For one coin, each wallet's unrealized and realized PnL, buy spend and fees (null fields when the wallet never traded it). Solana coins only. Wrapped as {success, data, errors}. - Cost: 5 credits (5 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-coin-holders-pnl ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `mint` | path | string | yes | Coin address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Solana only. Example `Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh`. | | `wallets` | body | array | yes | 1 to 50 wallets (Solana or EVM); duplicates are merged. Range 1 to 50. Example `["Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14"]`. | ### Request body ```json { "wallets": [ "C2b24xye9puNDiAptjqJGsPgVbZzQvm5GeeUjRHok3NR", "BkEfebdkvLCvscesgJomDaNp3ChZXbQ5c62nrgtD8QXf" ] } ``` ### Example ```bash curl -s -X POST "https://api.pumpfomo.com/v1/pump/coins/C5xph2yL6gMdxmuLGxJBkGpmuDFfyi5fqkBNhvL6pump/holders/pnl" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"wallets":["C2b24xye9puNDiAptjqJGsPgVbZzQvm5GeeUjRHok3NR","BkEfebdkvLCvscesgJomDaNp3ChZXbQ5c62nrgtD8QXf"]}' ``` Answer (200), shortened: ```json { "data": { "success": true, "data": [ { "wallet": "29yFzeBZgxf5zqrAkKXwgZtQehRf4pL8WbV2nRJikbw8", "mint": "C5xph2yL6gMdxmuLGxJBkGpmuDFfyi5fqkBNhvL6pump", "unrealized": { "cost_basis": { "sol": 0, "usd": 0 }, "pnl": { "sol": null, "usd": null }, "percentage": { "sol": null, "usd": null }, "amount_held": 0 }, "realized": { "pnl": { "sol": -0.004127772568359681, "usd": -0.42249052788791525 }, "percentage": { "sol": -4.819971265368704, "usd": -4.816650502902713 }, "avg_buy_price": { "sol": 0.00009981458497899239, "usd": 0.01022338075180839 }, "avg_sell_price": { "sol": 0.00009500355066435793, "usd": 0.009730956231412752 }, "amount_sold": 857.98028, "total_in": { "sol": 0.08563894556835969, "usd": 8.771459079983174 }, "total_out": { "sol": 0.081511173, "usd": 8.348968552095258 } }, "total_buy_spend": { "sol": 0, "usd": 0 }, "total_buy_amount": 0, "last_slot_index_id": "00046113713200025500000401", "has_transfers": true, "has_untrusted_basis": … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | mint is an EVM address ("holder PnL is for Solana coins") | | 400 | `invalid_param` | the body is not {"wallets": [...]}, has 0 or more than 50 entries, or one is not an address | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | ## Trades of chosen wallets in a coin `POST https://api.pumpfomo.com/v1/pump/coins/{mint}/trades/by-wallets` The trades of up to 50 wallets in one coin. Keyed by wallet: that wallet's trades in the coin (an empty list when it has none). Use it to see what a set of known wallets did in a coin. - Cost: 5 credits (5 per call) - Access: read:pump - Reference: https://pumpfomo.com/docs/pump-coin-trades-by-wallets ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `mint` | path | string | yes | Coin address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh`. | | `wallets` | body | array | yes | 1 to 50 wallets (Solana or EVM); duplicates are merged. Range 1 to 50. Example `["Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14"]`. | ### Request body ```json { "wallets": [ "C2b24xye9puNDiAptjqJGsPgVbZzQvm5GeeUjRHok3NR", "BkEfebdkvLCvscesgJomDaNp3ChZXbQ5c62nrgtD8QXf" ] } ``` ### Example ```bash curl -s -X POST "https://api.pumpfomo.com/v1/pump/coins/C5xph2yL6gMdxmuLGxJBkGpmuDFfyi5fqkBNhvL6pump/trades/by-wallets" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"wallets":["C2b24xye9puNDiAptjqJGsPgVbZzQvm5GeeUjRHok3NR","BkEfebdkvLCvscesgJomDaNp3ChZXbQ5c62nrgtD8QXf"]}' ``` Answer (200), shortened: ```json { "data": { "29yFzeBZgxf5zqrAkKXwgZtQehRf4pL8WbV2nRJikbw8": [ { "slotIndexId": "0004611186830002260001", "tx": "5dauDLzdmjoSvWxGEFQhF6cDnnpzkYzcvpLdTJJjn9uFrGSqQk1nQkzd5KRPUA6H9gBSve6CauYthhrdex4brsAL", "timestamp": "2026-10-25T04:17:41.000Z", "userAddress": "29yFzeBZgxf5zqrAkKXwgZtQehRf4pL8WbV2nRJikbw8", "type": "sell", "isBondingCurve": false, "priceUSD": "0.009967932186744858616881218156907713615357", "priceSOL": "0.00009732723697513143133309337928327157472951", "amountUSD": "104.179305810722106", "amountSOL": "1.017210369672067452259987376231697524944", "baseAmount": "10450902490", "quoteAmount": "129091" } ], "2VpmFNarKqGyRrzkXxNQmh4yTFkdr7ojcM7F7squa11H": [ { "slotIndexId": "0004614419200000720001", "tx": "4uutwYkspuPVXRtBVkzSD4mpeh1LFAo5PaSqHy1N2KNLR9er6iXPwQjDzpVivrTKYEiHnx5NbUfZo5CTfGeicE6f", "timestamp": "2026-10-25T23:21:39.000Z", "userAddress": "2VpmFNarKqGyRrzkXxNQmh4yTFkdr7ojcM7F7squa11H", "type": "sell", "isBondingCurve": false, "priceUSD": "0.009317175514867130359835151631805070983114", "priceSOL": "0.00009188840862202640132819697618066586765742", "amountUSD": "98.38310573051136", "amountSOL": "0.9702797812968081487039057489450540097004", "baseAmount": "10558968465", "quoteAmount": "122688" } ], "3vXNqvraYSMQmyu4m3FskT3hYAXbCn … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | the body is not {"wallets": [...]}, has 0 or more than 50 entries, or one is not an address | | 404 | `not_found` | pump.fun has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | pump.fun did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:pump | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | | 400 | `invalid_param` | pump.fun refused the parameters, e.g. a cursor that isn't the last page's nextCursor (not charged) | # fomo.family users ## fomo.family profile `GET https://api.pumpfomo.com/v1/fomo/users/{handle}` A fomo.family trader by handle: wallets, bio, counts, volume, clan. The profile: user id, Solana and EVM wallets, display name, picture, bio, followers and following, swap and trade counts, total volume, average hold time and clan. The user id is what the stream's fomo filters match. - Cost: 2 credits (2 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-user ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `handle` | path | string | yes | fomo.family handle: 1-32 of A-Z a-z 0-9 _ . with an optional leading @ (case-insensitive). Example `rez404`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/users/pointfarmcap" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "id": "6d8c0bf3-5d42-506c-a0ea-9e1e75ff38af", "address": "6cerGpSGzCrA1NeHUNtyoNm4rWQx5SnK3DSAXb4e615t", "evmAddress": "0x2c56846e43eb73d39c5d3791f8ff1e02f10ba596", "createdAt": "2025-10-03T01:49:40.755Z", "displayName": "point farm capital", "userHandle": "pointfarmcap", "profilePictureLink": "https://…/image.png", "description": "be the change you want to see onchain", "following": 0, "followers": 462266, "activated": false, "verified": false, "isReferred": false, "isRestricted": false, "swapCount": 31520, "numTrades": 3672, "totalVolume": 20725526.063845, "private": false, "thumbhash": "EQgKBwAKcZpmuWh1h7dnmGiKiJcHC0UC", "coverPhotoLink": "https://…/image.png", "coverPhotoThumbhash": "GQgGAoBwZ5dyeZd1AAAAAAA=", "twitter": null, "clan": null, "followsCurrentUser": false, "numFriendsFollowing": 1, "friendsFollowing": [ { "id": "43248737-c308-5ff3-b23f-01f67f990b02", "address": "HvKc8FTWki3tjh7arhpsPpiER1qkvjDw27xQ4wHk4v2j", "evmAddress": "0x5e55a985e8e91f62432ff5ba2608eb9b5b6b624a", "createdAt": "2026-10-06T01:54:14.091Z", "displayName": "MaleBlindKiwi", "userHandle": "MaleBlindKiwi", "profilePictureLink": null, "description": null, "following": 250, "followers": 15, "activated": false, "verified": false, "isReferred": false, "isRestricted": f … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | handle is not a fomo.family handle | | 404 | `not_found` | fomo.family has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Holdings `GET https://api.pumpfomo.com/v1/fomo/users/{handle}/balances` What a fomo.family trader holds now, with market data and PnL per token. Each holding: the balance, the token's live market data (price, market cap, 24h change and volume), the trader's entry, cost basis and realized PnL, and the open trade. Also other/perp PnL and native balances. - Cost: 2 credits (2 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-user-balances ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `handle` | path | string | yes | fomo.family handle: 1-32 of A-Z a-z 0-9 _ . with an optional leading @ (case-insensitive). Example `rez404`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/users/pointfarmcap/balances" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "balances": [ { "balance": { "tokenAddress": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "balance": "41426700000000000", "tokenId": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx:1399811149", "shiftedBalance": 41426653.05 }, "tokenFilterResult": { "change24": "0.166518054022767", "createdAt": 1785902285, "marketCap": "103520191.37757273", "priceUSD": "0.131960654144596", "volume1": "764953.9830987945", "volume24": "17083777.847590175", "token": { "address": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "decimals": 9, "networkId": 1399811149, "name": "STONK", "symbol": "STONK", "info": { "circulatingSupply": "784477707", "id": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx:1399811149", "imageLargeUrl": null, "imageSmallUrl": null, "imageThumbUrl": null, "name": "STONK", "symbol": "STONK", "totalSupply": "784477707" }, "launchpad": { "launchpadIconUrl": null, "graduationPercent": 0 } } }, "userToken": { "id": "18d2282a-e6a2-4e4d-b52d-ca6c76205c20", "tokenAddress": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "networkI … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | handle is not a fomo.family handle | | 404 | `not_found` | fomo.family has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Swaps `GET https://api.pumpfomo.com/v1/fomo/users/{handle}/positions` A fomo.family trader's swaps, newest first. Each swap: tokens in and out with amounts, USD value, price, provider and time. data.hasNextPage says whether there is more; pass the last swap's id as cursor. - Cost: 2 credits (2 a page) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-user-positions ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `handle` | path | string | yes | fomo.family handle: 1-32 of A-Z a-z 0-9 _ . with an optional leading @ (case-insensitive). Example `rez404`. | | `cursor` | query | string | no | Next page: the id of the last swap of the previous page. 1-128 of A-Z a-z 0-9 _ . - | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/users/pointfarmcap/positions" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "swaps": [ { "id": "bcfe7683-8673-4d91-9cb8-0e208c2051eb", "address": "FgactYhd2nkUxWfBgY435reoWq2HYsw3AqyRnfaRDfbF", "networkId": 1399811149, "inTokenAddress": "UVXY4ojmAMTaPwUmrRmcuxWHjMHCbz3BxX2RBMzjYKx", "inAmount": 13308300, "inHumanAmount": 13.3083, "outTokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "outAmount": 220302000, "outHumanAmount": 220.302, "humanUsdAmountIn": 220.302, "humanUsdAmountOut": 220.302, "createdAt": "2026-10-21T18:14:40.000Z", "inTradeId": "21520d8c-7d63-45b8-adb5-2b6232a1a6a6", "outTradeId": null, "isOffPlatform": true, "isCrossmint": false, "provider": "OKX", "inNetworkId": 1399811149, "outNetworkId": 1399811149, "recipient": null, "displayPriceUsd": 16.8293, "display": { "side": "sell" } } ], "hasNextPage": true }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:11:34.065Z", "source": "fomo.family" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | handle is not a fomo.family handle | | 400 | `invalid_param` | cursor has characters outside A-Z a-z 0-9 _ . - | | 404 | `not_found` | fomo.family has nothing for it (costs 1 credit); an input with nothing in it is an empty page at full price, not a 404 | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Trades (positions) `GET https://api.pumpfomo.com/v1/fomo/users/{handle}/trades` A trader's positions, open and closed, with the wallet each was traded from and any thesis. fomo.family "trades" are positions: activeTrades (open) and closedTrades, each with entry and exit prices, amounts, realized and unrealized PnL, cost basis, the token, the trading wallet and the thesis (comment) if one was posted. Sort by recent or by realized PnL; filter to one token. - Cost: 2 credits (2 a page) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-user-trades ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `handle` | path | string | yes | fomo.family handle: 1-32 of A-Z a-z 0-9 _ . with an optional leading @ (case-insensitive). Example `rez404`. | | `sort` | query | string | no | recent (by close time) or pnl (by realized PnL). One of `recent`, `pnl`. Default `recent`. Example `recent`. | | `token` | query | string | no | Only this token. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). | | `cursor` | query | string | no | Next page: the id of the last trade of the previous page. 1-128 of A-Z a-z 0-9 _ . - | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/users/pointfarmcap/trades?sort=recent" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "activeTrades": [ { "trade": { "userAddress": "0xa94c44a872931873252899347729ac780cb9ede5", "tokenAddress": "0x13be49f113131e08a228198b4f24753d9f9182ec", "createdAt": "2026-10-25T15:36:20.000Z", "updatedAt": "2026-10-25T15:53:10.000Z", "closedAt": null, "humanTokenAmount": 1308154.05, "avgEntryPrice": null, "avgExitPrice": null, "displayAvgEntryPriceUsd": null, "displayAvgExitPriceUsd": null, "sumSwapOpen": 0, "sumSwapClosed": 0, "sumTransferIn": 1308154.05, "sumTransferOut": 0, "avgTransferInPrice": 0.000079451, "avgTransferOutPrice": null, "realizedPnlUsd": 0, "networkId": 4663, "commentId": null, "id": "96f7d1c5-ad13-4df9-96f7-6601c06ebce0", "isExternallyReceived": true, "tokenMetadata": { "symbol": "GME", "networkId": 4663, "imageLargeUrl": null, "liquidity": 44545.48149863297, "currentPrice": 0.00030630557825113707 }, "unrealizedPnlUsd": 296.761, "totalCostBasis": 103.934 }, "swaps": [], "transfers": [], "verified": false, "comment": null, "type": "spot" } ], "closedTrades": [ { "trade": { "userAddress": "FgactYhd2nkUxWfBgY435reoWq2HYsw3AqyRnfaRDfbF", … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | handle is not a fomo.family handle | | 400 | `invalid_param` | sort not recent\|pnl; token not an address; bad cursor | | 404 | `not_found` | fomo.family has nothing for it (costs 1 credit); an input with nothing in it is an empty page at full price, not a 404 | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Who they follow `GET https://api.pumpfomo.com/v1/fomo/users/{handle}/following` The fomo.family traders a user follows, with their 24h PnL. Profiles of the traders followed (wallets, counts, volume, pnl24h). Pass the last user's id as cursor for the next page. - Cost: 2 credits (2 a page) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-user-following ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `handle` | path | string | yes | fomo.family handle: 1-32 of A-Z a-z 0-9 _ . with an optional leading @ (case-insensitive). Example `rez404`. | | `cursor` | query | string | no | Next page: the id of the last user of the previous page. 1-128 of A-Z a-z 0-9 _ . - | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/users/The__Solstice/following" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "users": [ { "id": "eae924d1-d7b9-55cc-8fb8-a995461ec527", "address": "9tmpze3mmPcxDR1CLmDD2x5R4RhRtFKHfSw44QNPGQNv", "evmAddress": "0x0679726da632647994aa2585b06d5013a8c88e64", "createdAt": "2026-08-13T18:32:58.800Z", "displayName": "Pumponomics", "userHandle": "ThePumponomics", "profilePictureLink": "https://…/image.png", "description": "@ThePumponomics on X", "following": 22, "followers": 56000, "activated": false, "verified": false, "isReferred": true, "isRestricted": false, "swapCount": 487, "numTrades": 274, "totalVolume": 7188577.973273, "private": false, "thumbhash": "z/MJVwL4l3d8hYeJdqhoiHeHdTBYB4MF", "coverPhotoLink": null, "coverPhotoThumbhash": null, "twitter": null, "pnl24h": 61440.74811520963 } ] }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:20:09.789Z", "source": "fomo.family" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | handle is not a fomo.family handle | | 400 | `invalid_param` | bad cursor | | 404 | `not_found` | fomo.family has nothing for it (costs 1 credit); an input with nothing in it is an empty page at full price, not a 404 | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Followers `GET https://api.pumpfomo.com/v1/fomo/users/{handle}/followers` A fomo.family trader's followers (first page), with their 24h PnL. Profiles of the followers (wallets, counts, volume, pnl24h). Only the first page is available. - Cost: 2 credits (2 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-user-followers ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `handle` | path | string | yes | fomo.family handle: 1-32 of A-Z a-z 0-9 _ . with an optional leading @ (case-insensitive). Example `rez404`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/users/pointfarmcap/followers" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "users": [ { "id": "5578ec2a-f836-50d5-aa2f-e98f682820e8", "address": "9k5n4S7koJXHL4jEs3kf254eJJD8QZytmzWHFhd4DymQ", "evmAddress": "0x649e4bd2e9f4617d3c629c486022086e1d1886d2", "createdAt": "2026-08-29T21:48:31.766Z", "displayName": "max2812", "userHandle": "max2812", "profilePictureLink": null, "description": null, "following": 10, "followers": 21, "activated": false, "verified": false, "isReferred": false, "isRestricted": false, "swapCount": 98, "numTrades": 58, "totalVolume": 80031.79539, "private": false, "thumbhash": null, "coverPhotoLink": null, "coverPhotoThumbhash": null, "twitter": null, "pnl24h": 1342.7784351214686 } ] }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:11:37.824Z", "source": "fomo.family" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | handle is not a fomo.family handle | | 404 | `not_found` | fomo.family has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Rank `GET https://api.pumpfomo.com/v1/fomo/users/{handle}/rank` A trader's leaderboard rank and PnL, all time and over 24h, 7d and 30d. The profile plus rank and PnL per window: rank (all time), rank24h, rank7d, rank30d. - Cost: 2 credits (2 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-user-rank ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `handle` | path | string | yes | fomo.family handle: 1-32 of A-Z a-z 0-9 _ . with an optional leading @ (case-insensitive). Example `rez404`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/users/pointfarmcap/rank" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "id": "6d8c0bf3-5d42-506c-a0ea-9e1e75ff38af", "address": "6cerGpSGzCrA1NeHUNtyoNm4rWQx5SnK3DSAXb4e615t", "evmAddress": "0x2c56846e43eb73d39c5d3791f8ff1e02f10ba596", "createdAt": "2025-10-03T01:49:40.755Z", "displayName": "point farm capital", "userHandle": "pointfarmcap", "profilePictureLink": "https://…/image.png", "description": "be the change you want to see onchain", "following": 0, "followers": 462266, "activated": false, "verified": false, "isReferred": false, "isRestricted": false, "swapCount": 31520, "numTrades": 5638, "totalVolume": 20725526.063845, "private": false, "thumbhash": "EQgKBwAKcZpmuWh1h7dnmGiKiJcHC0UC", "coverPhotoLink": "https://…/image.png", "coverPhotoThumbhash": "GQgGAoBwZ5dyeZd1AAAAAAA=", "twitter": null, "rank": { "rank": 2, "pnl": 3085598.308599112 }, "rank24h": { "rank": 1, "pnl": 1063901.4177805465 }, "rank7d": { "rank": 1, "pnl": 1351639.731325566 }, "rank30d": { "rank": 910157, "pnl": -9202043.053341025 }, "rankCampaigns": {}, "badge": { "type": "top_100_badge", "title": "Top 2", "text": "Awarded to traders who have reached all-time top 100 on the leaderboard", "image": null, "metadata": { "rank": 2, "totalPnL": 3085598.308599112 } } }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23: … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | handle is not a fomo.family handle | | 404 | `not_found` | fomo.family has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## PnL chart `GET https://api.pumpfomo.com/v1/fomo/users/{handle}/pnl-chart` A trader's PnL and equity curve over 1, 7 or 30 days. Points of {snapshotId (unix seconds), pnl, equity} in USD from the start of the window (rounded to the hour); daily points for 30d. - Cost: 5 credits (5 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-user-pnl-chart ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `handle` | path | string | yes | fomo.family handle: 1-32 of A-Z a-z 0-9 _ . with an optional leading @ (case-insensitive). Example `rez404`. | | `window` | query | string | no | The window. One of `1d`, `7d`, `30d`. Default `7d`. Example `7d`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/users/pointfarmcap/pnl-chart?window=7d" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": [ { "snapshotId": 1792364400, "pnl": 1733958.577274, "equity": 4272986.249414 }, { "snapshotId": 1792378800, "pnl": 2073319.725576, "equity": 4644582.7644 }, { "snapshotId": 1792393200, "pnl": 2191727.282987, "equity": 4790953.049553 } ], "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:11:40.286Z", "source": "fomo.family" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | handle is not a fomo.family handle | | 400 | `invalid_param` | window not 1d\|7d\|30d | | 404 | `not_found` | fomo.family has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Spotlight `GET https://api.pumpfomo.com/v1/fomo/users/{handle}/spotlight` A trader's best trades and best theses. What fomo.family shows on a profile's spotlight: bestTrades and bestComments, each a position with its token, PnL and thesis. - Cost: 2 credits (2 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-user-spotlight ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `handle` | path | string | yes | fomo.family handle: 1-32 of A-Z a-z 0-9 _ . with an optional leading @ (case-insensitive). Example `rez404`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/users/pointfarmcap/spotlight" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "bestTrades": [ { "trade": { "userAddress": "FgactYhd2nkUxWfBgY435reoWq2HYsw3AqyRnfaRDfbF", "tokenAddress": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "createdAt": "2026-08-22T20:55:15.000Z", "updatedAt": "2026-10-25T19:15:05.000Z", "closedAt": null, "humanTokenAmount": 41426653.05, "avgEntryPrice": 0.0402553, "avgExitPrice": 0.021502, "displayAvgEntryPriceUsd": 0.0402553, "displayAvgExitPriceUsd": 0.021502, "sumSwapOpen": 43899975.93, "sumSwapClosed": 2497111.05, "sumTransferIn": 203237.73, "sumTransferOut": 179476.03, "avgTransferInPrice": 0.250029, "avgTransferOutPrice": 0.216775, "realizedPnlUsd": -17735.47, "networkId": 1399811149, "commentId": "t2-17a10032194b4ecff470f4fc161f83828332be3c10fe0f4ac36bfa11a2648d0c-7a8e60b1", "id": "094dd0b3-22ff-41ba-b676-f093c8293f01", "isExternallyReceived": false, "tokenMetadata": { "symbol": "STONK", "networkId": 1399811149, "imageLargeUrl": null, "liquidity": 2152211.7987402314, "currentPrice": 0.1319210227920473 }, "unrealizedPnlUsd": 3757356.33, "totalCostBasis": 1818023.33 }, "swaps": [], "transfers": [], "displayName": "point farm capital", "userHandl … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | handle is not a fomo.family handle | | 404 | `not_found` | fomo.family has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Search fomo.family traders `GET https://api.pumpfomo.com/v1/fomo/search` fomo.family traders by name or handle. Matching traders with profile fields, follower counts, volume, 24h PnL and clan badge. - Cost: 2 credits (2 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-search ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `q` | query | string | yes | Search term, 1 to 30 characters (trimmed). fomo.family handles and names are at most 30. Range 1 to 30. Example `rez`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/search?q=rez" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "users": [ { "id": "6d9a3e82-2ec4-5557-8f70-3cb386bab7f1", "address": "EPi2uGDEgKYfgVPX2TaoeKveiJ9YyUZtUJmWpFX4uLgf", "evmAddress": "0x6e939ca341be874c8ccae99520b2daaa0815387a", "createdAt": "2026-06-29T14:47:49.375Z", "displayName": "Brez", "userHandle": "brezscales", "profilePictureLink": "https://…/image.png", "description": "learning the ropes of this", "following": 38, "followers": 197341, "activated": false, "verified": false, "isReferred": true, "isRestricted": false, "swapCount": 913, "numTrades": 649, "totalVolume": 3134636.165993, "private": false, "thumbhash": "DAgKDwA5iWlZh2ZgmSepd2mXqWMHaXcA", "coverPhotoLink": null, "coverPhotoThumbhash": null, "twitter": null, "pnl24h": -11549.516600884905, "clanBadge": { "type": "clan", "title": "$", "text": "Awarded for being in a clan", "image": "https://…/image.png", "metadata": { "clanId": "2a60ea17-139f-486b-b85e-03b7e61c7ded", "memberType": "member" } } } ] }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:11:43.624Z", "source": "fomo.family" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | q missing or longer than 30 characters | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | # fomo.family tokens ## fomo.family holders `GET https://api.pumpfomo.com/v1/fomo/tokens/{chain}/{address}/holders` The fomo.family traders holding a token, with value, PnL and thesis. Top fomo.family holders of the token: the trader, amount, price, value, realized and unrealized PnL, cost basis, average entry and their thesis on it. Only fomo.family users, not every on-chain holder. - Cost: 2 credits (2 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-token-holders ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `chain` | path | string | yes | Chain, by name or id: solana (sol, 1399811149), base (8453), bnb (bsc, 56), ethereum (eth, 1), robinhood (4663), monad (143), arc (5042). One of `8453`, `56`, `1`, `4663`, `143`, `5042`, `196`. Example `solana`. | | `address` | path | string | yes | Token address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `7ttfwuBSnbNTgf32gUAT7v9bjdDWsn6pYpp7nmGmpump`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/tokens/solana/6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx/holders" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": [ { "tokenAddress": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "networkId": 1399811149, "topHolders": [ { "user": { "id": "6d8c0bf3-5d42-506c-a0ea-9e1e75ff38af", "address": "6cerGpSGzCrA1NeHUNtyoNm4rWQx5SnK3DSAXb4e615t", "evmAddress": "0x2c56846e43eb73d39c5d3791f8ff1e02f10ba596", "createdAt": "2025-10-03T01:49:40.755Z", "displayName": "point farm capital", "userHandle": "pointfarmcap", "profilePictureLink": "https://…/image.png", "description": "be the change you want to see onchain", "following": 0, "followers": 462266, "activated": false, "verified": false, "isReferred": false, "isRestricted": false, "swapCount": 31520, "numTrades": 5638, "totalVolume": 20725526.063845, "private": false, "thumbhash": "EQgKBwAKcZpmuWh1h7dnmGiKiJcHC0UC", "coverPhotoLink": "https://…/image.png", "coverPhotoThumbhash": "GQgGAoBwZ5dyeZd1AAAAAAA=", "twitter": null, "clan": null, "badge": { "type": "top_100_badge", "title": "Top 2", "text": "Awarded to traders who have reached all-time top 100 on the leaderboard", "image": null, "metadata": { "rank": 2, "tota … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | chain not a known chain name or id; address not an address | | 404 | `not_found` | fomo.family has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Dev holdings `GET https://api.pumpfomo.com/v1/fomo/tokens/{chain}/{address}/devs` What the token's developer wallets hold. fomo.family's view of the deployer and dev wallets' holdings in the token (an empty list when none hold any). - Cost: 2 credits (2 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-token-devs ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `chain` | path | string | yes | Chain, by name or id: solana (sol, 1399811149), base (8453), bnb (bsc, 56), ethereum (eth, 1), robinhood (4663), monad (143), arc (5042). One of `8453`, `56`, `1`, `4663`, `143`, `5042`, `196`. Example `solana`. | | `address` | path | string | yes | Token address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `7ttfwuBSnbNTgf32gUAT7v9bjdDWsn6pYpp7nmGmpump`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/tokens/solana/6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx/devs" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "tokenAddress": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "networkId": 1399811149, "devHoldings": [ { "user": { "id": "26191f56-19e9-5cad-a3fe-4854bde4cc42", "address": "Eb2r3GQMH3YDTYWZegsWVAwVhp3TGYDiMN3wpdR5DB8t", "evmAddress": "0x84b2cdc672aa7d97f784b4c4a7f3fa1a8ad7beaa", "createdAt": "2026-08-15T00:54:36.049Z", "displayName": "StonkFun", "userHandle": "stonkfun", "profilePictureLink": "https://…/image.png", "description": "", "following": 0, "followers": 1356, "activated": false, "verified": false, "isReferred": false, "isRestricted": false, "swapCount": 0, "numTrades": 15, "totalVolume": 0, "private": false, "thumbhash": "iecJBwAImJdop3hxfHaKVId3jX/p+JgO", "coverPhotoLink": null, "coverPhotoThumbhash": null, "twitter": null, "clan": null }, "tradeId": "f2647c6d-ee30-4a64-87ac-b60b63eceacc", "sumSwapOpen": 0, "sumTransferIn": 100069.77, "isExternallyReceived": true, "humanAmount": 100085.78, "price": 0.13192971330883702, "value": 13204.29, "pnl": -4958.57, "unrealizedPnl": -4958.57, "realizedPnl": 0, "costBasis": 18159.96, "averageEntryPrice": 0.181473, "comment": { "id": "t2-b78a … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | chain not a known chain name or id; address not an address | | 404 | `not_found` | fomo.family has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Token stats `GET https://api.pumpfomo.com/v1/fomo/tokens/{chain}/{address}/stats` Buys, sells, volumes and unique traders over 5m, 1h, 4h and 24h; holders and top-10 share. fomo.family's market stats: buy and sell counts and volumes (USD, as strings) and unique buyers and sellers per window (5m, 1 = 1h, 4 = 4h, 24 = 24h), holder count, top-10 holders' share and whether the token has low fees. - Cost: 2 credits (2 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-token-stats ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `chain` | path | string | yes | Chain, by name or id: solana (sol, 1399811149), base (8453), bnb (bsc, 56), ethereum (eth, 1), robinhood (4663), monad (143), arc (5042). One of `8453`, `56`, `1`, `4663`, `143`, `5042`, `196`. Example `solana`. | | `address` | path | string | yes | Token address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `7ttfwuBSnbNTgf32gUAT7v9bjdDWsn6pYpp7nmGmpump`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/tokens/solana/6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx/stats" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "buyCount5m": 1024, "buyCount1": 6040, "buyCount4": 16355, "buyCount24": 112757, "buyVolume5m": "59239.2749279563", "buyVolume1": "407134.89002900483", "buyVolume4": "1374040.0136764161", "buyVolume24": "9014945.987189239", "sellCount5m": 1204, "sellCount1": 5512, "sellCount4": 16150, "sellCount24": 98586, "sellVolume5m": "75190.55409847703", "sellVolume1": "363063.0238456322", "sellVolume4": "1505565.6097031091", "sellVolume24": "8074075.7911767755", "uniqueBuys5m": 365, "uniqueBuys1": 2199, "uniqueBuys4": 6560, "uniqueBuys24": 46085, "uniqueSells5m": 486, "uniqueSells1": 2271, "uniqueSells4": 7386, "uniqueSells24": 46430, "holders": 114561, "top10HoldersPercent": 18.358092911287073, "isLowFees": false }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:11:47.081Z", "source": "fomo.family" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | chain not a known chain name or id; address not an address | | 404 | `not_found` | fomo.family has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Token warnings `GET https://api.pumpfomo.com/v1/fomo/tokens/{chain}/{address}/warnings` fomo.family's risk warnings for a token, and whether buying or selling is disabled. The warnings fomo.family shows before a trade (type, severity, name, description), and whether it blocks buying or selling the token. - Cost: 2 credits (2 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-token-warnings ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `chain` | path | string | yes | Chain, by name or id: solana (sol, 1399811149), base (8453), bnb (bsc, 56), ethereum (eth, 1), robinhood (4663), monad (143), arc (5042). One of `8453`, `56`, `1`, `4663`, `143`, `5042`, `196`. Example `solana`. | | `address` | path | string | yes | Token address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `7ttfwuBSnbNTgf32gUAT7v9bjdDWsn6pYpp7nmGmpump`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/tokens/solana/6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx/warnings" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "disableBuying": false, "disableSelling": false, "warnings": [] }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:11:48.298Z", "source": "fomo.family" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | chain not a known chain name or id; address not an address | | 404 | `not_found` | fomo.family has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Candles (fomo.family) `GET https://api.pumpfomo.com/v1/fomo/tokens/{chain}/{address}/candles` OHLCV candles from fomo.family's market data, 1-minute to 1-week bars, up to 2,000. Candles as {t (ms), o, h, l, c, v (USD volume)}, oldest first. Covers any token fomo.family trades on its chains, including tokens that aren't on pump.fun. - Cost: 2 credits (2 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-token-candles ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `chain` | path | string | yes | Chain, by name or id: solana (sol, 1399811149), base (8453), bnb (bsc, 56), ethereum (eth, 1), robinhood (4663), monad (143), arc (5042). One of `8453`, `56`, `1`, `4663`, `143`, `5042`, `196`. Example `solana`. | | `address` | path | string | yes | Token address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `7ttfwuBSnbNTgf32gUAT7v9bjdDWsn6pYpp7nmGmpump`. | | `interval` | query | string | no | Bar size. One of `1m`, `5m`, `15m`, `30m`, `1h`, `4h`, `6h`, `12h`, `1d`, `1w`. Default `5m`. Example `1h`. | | `count` | query | integer | no | Bars to return. Default `300`. Range 1 to 2000. Example `48`. | | `to` | query | integer | no | Last bar at or before this unix time in milliseconds (default: now). | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/tokens/solana/6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx/candles?interval=1h&count=96" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "data": [ { "v": 5866.0051649336565, "o": 0.1299899107248646, "h": 0.1311232601011024, "l": 0.12879415801183383, "c": 0.12897759611066434, "t": 1792627200000 }, { "v": 9562.448502937177, "o": 0.12897759611066434, "h": 0.129928546030036, "l": 0.12622741086938596, "c": 0.12653034722222223, "t": 1792630800000 }, { "v": 23261.053638601465, "o": 0.12653034722222223, "h": 0.12692038348082077, "l": 0.1248599286854736, "c": 0.12674832312267897, "t": 1792634400000 } ] }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:20:12.457Z", "source": "fomo.family" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | chain not a known chain name or id; address not an address | | 400 | `invalid_param` | interval not allowed; count not 1-2000; to not a positive integer | | 404 | `not_found` | fomo.family has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Theses on a token `GET https://api.pumpfomo.com/v1/fomo/tokens/{chain}/{address}/theses` fomo.family traders' theses on a token, 100 a page, optionally only from positions above a size. Each thesis with its author, text, market cap at posting, replies, and the author's position (value, PnL). minUsd keeps theses whose author's position is at least that big. Pass the last item's id as cursor. - Cost: 2 credits (2 a page (100 rows)) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-token-theses ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `chain` | path | string | yes | Chain, by name or id: solana (sol, 1399811149), base (8453), bnb (bsc, 56), ethereum (eth, 1), robinhood (4663), monad (143), arc (5042). One of `8453`, `56`, `1`, `4663`, `143`, `5042`, `196`. Example `solana`. | | `address` | path | string | yes | Token address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `7ttfwuBSnbNTgf32gUAT7v9bjdDWsn6pYpp7nmGmpump`. | | `minUsd` | query | integer | no | Smallest author position, in USD. Default `0`. Range 0 to 10000000. Example `0`. | | `cursor` | query | string | no | Next page: the id of the last thesis of the previous page. 1-128 of A-Z a-z 0-9 _ . - | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/tokens/solana/6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx/theses" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "items": [ { "type": "thesis", "id": "t2-f2a9c7e6a186f20249239fc5e3dd0a97e6db3c46ee798c2ad6f852fa6eb4620e-fe589db2", "tradeId": "dc7bc0d8-74ec-48b1-92cb-98786b6dacbd", "createdAt": "2026-10-25T23:06:11.177Z", "userId": "71393668-cc31-5426-aad0-7c7ff4c2a2a3", "displayName": "‎ ‎", "userHandle": "turban", "profilePictureLink": "https://…/image.png", "verified": false, "twitter": null, "comment": { "id": "t2-f2a9c7e6a186f20249239fc5e3dd0a97e6db3c46ee798c2ad6f852fa6eb4620e-fe589db2", "userId": "71393668-cc31-5426-aad0-7c7ff4c2a2a3", "tradeId": "dc7bc0d8-74ec-48b1-92cb-98786b6dacbd", "comment": "Big week loading", "priceUsdAtCreation": 0.133816263181, "marketCapAtCreation": 105089093.81789784, "fdvAtCreation": 105089093.81789784, "createdAt": "2026-10-25T23:06:11.177Z", "parentId": null, "numLikes": 0, "tokenAddress": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "networkId": 1399811149, "shortCommentSegments": [ { "text": "Big week loading", "link": null, "provider": null } ], "reactions": { "counts": { "likeCount": 0 }, "reactions": { "like": false } }, "olderT … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | chain not a known chain name or id; address not an address | | 400 | `invalid_param` | minUsd not 0-10,000,000; bad cursor | | 404 | `not_found` | fomo.family has nothing for it (costs 1 credit); an input with nothing in it is an empty page at full price, not a 404 | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## fomo.family trades in a token `GET https://api.pumpfomo.com/v1/fomo/tokens/{chain}/{address}/trades` The buys and sells of fomo.family users in one token, newest first. Each swap by a fomo.family user in the token: type (swap_buy, swap_sell…), trader, USD amount, market cap, price and whether the trader is the dev. Filter by size with minUsd; data.hasNextPage and the last item's id page it. - Cost: 2 credits (2 a page) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-token-trades ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `chain` | path | string | yes | Chain, by name or id: solana (sol, 1399811149), base (8453), bnb (bsc, 56), ethereum (eth, 1), robinhood (4663), monad (143), arc (5042). One of `8453`, `56`, `1`, `4663`, `143`, `5042`, `196`. Example `solana`. | | `address` | path | string | yes | Token address. A Solana address (base58, 32 bytes) or an EVM address (0x + 40 hex; matched case-insensitively). Example `7ttfwuBSnbNTgf32gUAT7v9bjdDWsn6pYpp7nmGmpump`. | | `minUsd` | query | integer | no | Smallest trade, in USD. Default `0`. Range 0 to 10000000. Example `0`. | | `cursor` | query | string | no | Next page: the id of the last item of the previous page. 1-128 of A-Z a-z 0-9 _ . - | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/tokens/solana/6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx/trades" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "items": [ { "type": "swap_sell", "id": "260d5355-1dfa-4678-b591-9dba58f15e36", "tradeId": "f0885db1-12c3-4ac3-8ee0-49614954cde9", "createdAt": "2026-10-25T23:09:00.000Z", "userId": "47c68070-62fd-5085-bc3a-37ee8252f9dc", "displayName": "EVT5", "userHandle": "EVT27", "profilePictureLink": null, "verified": false, "twitter": null, "usdAmount": 11.05, "marketCap": 103437000, "fdv": 103437000, "price": 0.131855, "displayPriceUsd": 0.131855, "isDev": false }, { "type": "swap_sell", "id": "f7a014cc-1319-43a9-a1f2-4718133e1179", "tradeId": "8430c82e-4b04-40ee-969f-6eaeb71eeaaa", "createdAt": "2026-10-25T23:08:25.000Z", "userId": "81b3ce9b-6798-5677-a02c-ca4cfd7bdf96", "displayName": "limpyy", "userHandle": "limpyy", "profilePictureLink": "https://…/image.png", "verified": false, "twitter": null, "usdAmount": 270.19, "marketCap": 103423000, "fdv": 103423000, "price": 0.131837, "displayPriceUsd": 0.131837, "isDev": false } ], "hasNextPage": true }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:11:52.057Z", "source": "fomo.family" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | chain not a known chain name or id; address not an address | | 400 | `invalid_param` | minUsd not 0-10,000,000; bad cursor | | 404 | `not_found` | fomo.family has nothing for it (costs 1 credit); an input with nothing in it is an empty page at full price, not a 404 | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Token market data (batch) `GET https://api.pumpfomo.com/v1/fomo/tokens/batch` Market data for up to 50 tokens on any of fomo.family's chains. Price, market cap, liquidity, holders, changes over 5m/1h/4h/12h/24h, buy and sell counts, exchanges and pair, for each token (numbers as strings). A GET with the list in the query. - Cost: 5 credits (5 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-tokens-batch ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `tokens` | query | string | yes | 1 to 50 of chain:address, comma-separated; chain by name or id as in the token routes (e.g. solana:,base:0x…). Range 1 to 50. Example `solana:7ttfwuBSnbNTgf32gUAT7v9bjdDWsn6pYpp7nmGmpump,solana:Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/tokens/batch?tokens=solana:6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx,solana:C5xph2yL6gMdxmuLGxJBkGpmuDFfyi5fqkBNhvL6pump" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": [ { "isHiddenFromDiscovery": false, "basePair": { "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "logo": null }, "buyCount1": null, "buyCount4": null, "buyCount12": null, "buyCount24": null, "change5m": "0.00600076420805757", "change1": "0.01094694372117571", "change4": "-0.021611324714508176", "change12": "0.13243873404383538", "change24": "0.2395379638776637", "createdAt": 1785902285, "exchanges": [ { "name": "Orca" } ], "holders": 114559, "top10HoldersPercent": null, "liquidity": "2152725.036242538", "marketCap": "103519422.39208324", "pair": { "protocol": "Meteora" }, "priceUSD": "0.13195967389304442", "sellCount1": null, "sellCount4": null, "sellCount12": null, "sellCount24": null, "token": { "address": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "decimals": 9, "networkId": 1399811149, "createdAt": 1785902285, "name": "STONK", "symbol": "STONK", "freezable": null, "mintable": null, "isScam": null, "i18n": null, "info": { "address": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "circulatingSupply": "784477707", "cmcId": null, "description": "", "id": "6GmAFSYs4gk3FDao5F … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | tokens missing or more than 50; an entry is not chain:address; unknown chain | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Search tokens (fomo.family) `GET https://api.pumpfomo.com/v1/fomo/search/tokens` Tokens by name or symbol, or one token by address. fomo.family's token search across its chains: price, market cap, liquidity, 24h change and volume, holders and token info (images, socials, launchpad). A q that is an address looks that token up directly. - Cost: 2 credits (2 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-search-tokens ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `q` | query | string | yes | Search term, 1 to 64 characters (trimmed). An address searches by address. Range 1 to 64. Example `bonk`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/search/tokens?q=bonk" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": [ { "change24": "-0.02138751728330333", "createdAt": 1671980424, "holders": 1026849, "liquidity": "148182.137014524", "marketCap": "264663847.60428205", "priceUSD": "0.0000030081344237697375", "volume24": "1096676.47308594", "token": { "address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263", "decimals": 5, "networkId": 1399811149, "name": "Bonk", "symbol": "BONK", "info": { "circulatingSupply": "87982719626143", "id": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263:1399811149", "imageLargeUrl": null, "imageSmallUrl": null, "imageThumbUrl": null, "name": "Bonk", "symbol": "BONK", "totalSupply": "88511814578197" }, "socialLinks": { "discord": null, "telegram": "", "twitter": "https://twitter.com/bonk_inu", "website": "https://www.bonkcoin.com/" }, "launchpad": { "launchpadName": null, "launchpadIconUrl": null, "graduationPercent": 0 } } } ], "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:11:54.803Z", "source": "fomo.family" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | q missing or longer than 64 characters | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | # fomo.family boards ## fomo.family leaderboard `GET https://api.pumpfomo.com/v1/fomo/leaderboard/{window}` fomo.family's top traders by PnL over 24h, 7d, 30d or all time. The leaderboard with each trader's profile (wallets, counts, volume), top holdings and PnL for the window. The PnL field is named after the window (pnl7d for 7d). - Cost: 1 credit (1 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-leaderboard ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `window` | path | string | yes | The window. One of `24h`, `7d`, `30d`, `all`. Example `7d`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/leaderboard/7d" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "leaderboard": [ { "id": "6d8c0bf3-5d42-506c-a0ea-9e1e75ff38af", "address": "6cerGpSGzCrA1NeHUNtyoNm4rWQx5SnK3DSAXb4e615t", "evmAddress": "0x2c56846e43eb73d39c5d3791f8ff1e02f10ba596", "createdAt": "2025-10-03T01:49:40.755Z", "displayName": "point farm capital", "userHandle": "pointfarmcap", "profilePictureLink": "https://…/image.png", "description": "be the change you want to see onchain", "following": 0, "followers": 462266, "activated": false, "verified": false, "isReferred": false, "isRestricted": false, "swapCount": 31520, "numTrades": 5638, "totalVolume": 20725526.063845, "private": false, "thumbhash": "EQgKBwAKcZpmuWh1h7dnmGiKiJcHC0UC", "coverPhotoLink": "https://…/image.png", "coverPhotoThumbhash": "GQgGAoBwZ5dyeZd1AAAAAAA=", "twitter": null, "pnl7d": 1351639.731325566, "clan": null, "totalHoldings": 27, "topHoldings": [ { "imageUrl": null, "tokenAddress": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "networkId": 1399811149, "humanAmount": 41426653.049452856, "price": 0.131960654144596, "value": 5466688.235427022, "pnl": 3741262.65342388 } ], "badge": { "type": "top_100_badge", "title": "Top 2", … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | window not 24h\|7d\|30d\|all | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Trending tokens `GET https://api.pumpfomo.com/v1/fomo/tokens/trending` The tokens trending on fomo.family now. fomo.family's trending list with price, market cap, liquidity, 24h change and volume, holders and token info. - Cost: 1 credit (1 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-tokens-trending ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/tokens/trending" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": [ { "change24": "138.21984964431775", "createdAt": 1792962260, "holders": 2822, "liquidity": "68938.18465389311", "marketCap": "423964.10227407934", "priceUSD": "0.00046384364278635574", "volume24": "1836977.3708913196", "token": { "address": "3LPTanzycRAjguU6VAXE7T2Fd12LePQLpHATXXs9pump", "decimals": 6, "networkId": 1399811149, "name": "US PRESIDENT 2028", "symbol": "PRESIDENT", "info": { "circulatingSupply": "914023742.413034", "id": "3LPTanzycRAjguU6VAXE7T2Fd12LePQLpHATXXs9pump:1399811149", "imageLargeUrl": null, "imageSmallUrl": null, "imageThumbUrl": null, "name": "US PRESIDENT 2028", "symbol": "PRESIDENT", "totalSupply": "914023742.413034" }, "socialLinks": null, "launchpad": { "launchpadName": "Pump.fun", "launchpadIconUrl": null, "graduationPercent": 0 } } } ], "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:11:57.057Z", "source": "fomo.family" } } ``` ### Errors | Status | Code | When | |---|---|---| | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Most-held tokens `GET https://api.pumpfomo.com/v1/fomo/tokens/most-held` The tokens most fomo.family traders hold. Same shape as trending: the tokens held by the most fomo.family users, with market data. - Cost: 1 credit (1 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-tokens-most-held ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/tokens/most-held" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": [ { "change24": "0.04640474809985337", "createdAt": 1785083564, "holders": 144677, "liquidity": "1390249.0320222243", "marketCap": "49583464.192814186", "priceUSD": "0.05142735784843388", "volume24": "1449311.4479941", "token": { "address": "Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump", "decimals": 6, "networkId": 1399811149, "name": "Cate", "symbol": "CATE", "info": { "circulatingSupply": "964145666.183085", "id": "Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump:1399811149", "imageLargeUrl": null, "imageSmallUrl": null, "imageThumbUrl": null, "name": "Cate", "symbol": "CATE", "totalSupply": "964145666.183085" }, "socialLinks": { "discord": null, "telegram": "https://t.me/catecoin_telegram", "twitter": "https://x.com/i/communities/2004330768022004131", "website": "https://cate.meme/" }, "launchpad": { "launchpadName": "Pump.fun", "launchpadIconUrl": "https://…/image.png", "graduationPercent": 100 } } } ], "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:11:58.302Z", "source": "fomo.family" } } ``` ### Errors | Status | Code | When | |---|---|---| | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | # fomo.family clans ## Clan leaderboard `GET https://api.pumpfomo.com/v1/fomo/leaderboard/clans/{window}` fomo.family's top 50 clans by PnL over 24h, 7d, 30d or all time. Each clan: name, icon, description, links, rank, PnL, member count and its top members with their PnL and role. - Cost: 1 credit (1 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-clans-leaderboard ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `window` | path | string | yes | The window. One of `24h`, `7d`, `30d`, `all`. Example `7d`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/leaderboard/clans/7d" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "leaderboard": [ { "id": "5d9783d2-28c3-4207-ab83-9a5de2474dba", "name": "Control The Narrative", "iconLink": "https://…/image.png", "iconThumbhash": "nDgKHwZReodNeIaCZ4iIB5mJBsC0U48O", "description": "A conglomerate of conciliatory congressional constituents", "website": null, "xLink": null, "instagramLink": null, "telegramLink": null, "discordLink": null, "coverPhotoLink": "https://…/image.png", "coverPhotoThumbhash": "SBgGC4IJqnhweFlnOnCXBYc=", "createdAt": "2026-09-20T22:51:06.979Z", "rank": 1, "pnl": 201457.65697535465, "memberCount": 19, "topMembers": [ { "user": { "id": "888d8a2c-a25d-5543-86b2-1dbd03cf4479", "address": "GmfY52CC5BKt43xt9GSmZWNzsAv4ywE6qgguRM5fvAtN", "evmAddress": "0xb3e029765eaa69123a5f0ad5294c746464b742ba", "createdAt": "2026-03-10T03:10:23.127Z", "displayName": "TheS◎Lstice", "userHandle": "The__Solstice", "profilePictureLink": "https://…/image.png", "description": "holder in a trader’s world", "following": 99, "followers": 384692, "activated": false, "verified": false, "isReferred": true, "isRestricted": false, "swapCount": 2472, "numTrades": 4002, … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | window not 24h\|7d\|30d\|all | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Search clans `GET https://api.pumpfomo.com/v1/fomo/clans/search` fomo.family clans by name. Matching clans in the leaderboard shape (rank, PnL, members, top members). - Cost: 2 credits (2 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-clans-search ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `q` | query | string | yes | Search term, 1 to 64 characters (trimmed). Range 1 to 64. Example `control`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/clans/search?q=Control" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "leaderboard": [ { "id": "5d9783d2-28c3-4207-ab83-9a5de2474dba", "name": "Control The Narrative", "iconLink": "https://…/image.png", "iconThumbhash": "nDgKHwZReodNeIaCZ4iIB5mJBsC0U48O", "description": "A conglomerate of conciliatory congressional constituents", "website": null, "xLink": null, "instagramLink": null, "telegramLink": null, "discordLink": null, "coverPhotoLink": "https://…/image.png", "coverPhotoThumbhash": "SBgGC4IJqnhweFlnOnCXBYc=", "createdAt": "2026-09-20T22:51:06.979Z", "rank": 1, "pnl": 627819.2212979244, "memberCount": 19, "topMembers": [ { "user": { "id": "888d8a2c-a25d-5543-86b2-1dbd03cf4479", "address": "GmfY52CC5BKt43xt9GSmZWNzsAv4ywE6qgguRM5fvAtN", "evmAddress": "0xb3e029765eaa69123a5f0ad5294c746464b742ba", "createdAt": "2026-03-10T03:10:23.127Z", "displayName": "TheS◎Lstice", "userHandle": "The__Solstice", "profilePictureLink": "https://…/image.png", "description": "holder in a trader’s world", "following": 99, "followers": 384692, "activated": false, "verified": false, "isReferred": true, "isRestricted": false, "swapCount": 2472, "numTrades": 4002, … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | q missing or longer than 64 characters | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Clan `GET https://api.pumpfomo.com/v1/fomo/clans/{id}` One clan: profile, rank and PnL for a window, top tokens and members. A clan by id with its rank, PnL and trade count in the window, its best tokens by PnL and its members (profile, PnL, role). - Cost: 2 credits (2 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-clan ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `id` | path | string | yes | Clan id (from the clan leaderboard or search; 1-128 of A-Z a-z 0-9 _ . -). Example `5d9783d2-28c3-4207-ab83-9a5de2474dba`. | | `window` | query | string | no | The window for rank and PnL. One of `24h`, `7d`, `30d`, `all`. Default `24h`. Example `7d`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/clans/5d9783d2-28c3-4207-ab83-9a5de2474dba?window=7d" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "id": "5d9783d2-28c3-4207-ab83-9a5de2474dba", "name": "Control The Narrative", "iconLink": "https://…/image.png", "iconThumbhash": "nDgKHwZReodNeIaCZ4iIB5mJBsC0U48O", "description": "A conglomerate of conciliatory congressional constituents", "website": null, "xLink": null, "instagramLink": null, "telegramLink": null, "discordLink": null, "coverPhotoLink": "https://…/image.png", "coverPhotoThumbhash": "SBgGC4IJqnhweFlnOnCXBYc=", "createdAt": "2026-09-20T22:51:06.979Z", "rank": 1, "pnl": 201457.65697535465, "memberCount": 19, "tradeCount": 21232, "topTokens": [ { "tokenAddress": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "networkId": 1399811149, "symbol": "STONK", "imageUrl": null, "imageThumbhash": null, "pnl": 2759062.240841563 } ], "members": [ { "user": { "id": "888d8a2c-a25d-5543-86b2-1dbd03cf4479", "address": "GmfY52CC5BKt43xt9GSmZWNzsAv4ywE6qgguRM5fvAtN", "evmAddress": "0xb3e029765eaa69123a5f0ad5294c746464b742ba", "createdAt": "2026-03-10T03:10:23.127Z", "displayName": "TheS◎Lstice", "userHandle": "The__Solstice", "profilePictureLink": "https://…/image.png", "description": "holder in a trader’s world", "following": 99, "followers": 384692, "activated": false, "verified": false, … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | id has characters outside A-Z a-z 0-9 _ . -; window not 24h\|7d\|30d\|all | | 404 | `not_found` | fomo.family has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Clan holdings `GET https://api.pumpfomo.com/v1/fomo/clans/{id}/holdings` What a clan's members hold together, 20 tokens a page. The clan's combined holdings by token: amount, value, PnL and percentage, how many members hold it and who. Page with cursor = the last holding's tokenAddress:networkId. - Cost: 2 credits (2 a page (20 rows)) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-clan-holdings ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `id` | path | string | yes | Clan id. Example `5d9783d2-28c3-4207-ab83-9a5de2474dba`. | | `cursor` | query | string | no | The last holding of the previous page as tokenAddress:networkId. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/clans/5d9783d2-28c3-4207-ab83-9a5de2474dba/holdings" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "holdings": [ { "tokenAddress": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "networkId": 1399811149, "symbol": "STONK", "name": "STONK", "imageUrl": null, "imageThumbhash": null, "humanAmount": 22386331.90038511, "value": 2966116.169084584, "pnl": 539225.7972909142, "percentagePnl": 20.828009325031584, "memberCount": 6, "topMembers": [ { "id": "888d8a2c-a25d-5543-86b2-1dbd03cf4479", "address": "GmfY52CC5BKt43xt9GSmZWNzsAv4ywE6qgguRM5fvAtN", "evmAddress": "0xb3e029765eaa69123a5f0ad5294c746464b742ba", "createdAt": "2026-03-10T03:10:23.127Z", "displayName": "TheS◎Lstice", "userHandle": "The__Solstice", "profilePictureLink": "https://…/image.png", "description": "holder in a trader’s world", "following": 99, "followers": 384692, "activated": false, "verified": false, "isReferred": true, "isRestricted": false, "swapCount": 2472, "numTrades": 4002, "totalVolume": 3583580.031946, "private": false, "thumbhash": "2VgKDwYkr9hzjJeSeLd7unh4aQoU9mQF", "coverPhotoLink": null, "coverPhotoThumbhash": null, "twitter": null, "badge": { "type": "top_100_badge", "ti … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | bad id; cursor not address:networkId | | 404 | `not_found` | fomo.family has nothing for it (costs 1 credit); an input with nothing in it is an empty page at full price, not a 404 | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | # fomo.family feed and trades ## Activity feed `GET https://api.pumpfomo.com/v1/fomo/feed` fomo.family's global activity feed: large buys and sells, theses, listings, milestones, 50 a page. The same feed fomo.family shows everyone (not tied to who reads it). Each item has a type, the user, trade, token and network it is about, and a body that depends on the type. Filter by types; pass the last item's id as cursor. Live, the same events come on the stream's fomo channel with alerts: true. - Cost: 2 credits (2 a page (50 rows)) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-feed ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `types` | query | string | no | Comma-separated feed types to keep (default: every type). One of `large_buy`, `large_sell`, `single_user_sell`, `thesis_created`, `multi_user_buy`, `multi_user_sell`, `new_token_listing`, `price_since_listing`, `user_trade_profit_milestone`, `large_transfer_in`, `large_transfer_out`. Default `all`. Example `large_buy,large_sell`. | | `cursor` | query | string | no | Next page: the id of the last item of the previous page. 1-128 of A-Z a-z 0-9 _ . - | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/feed" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "feed": [ { "id": "f57174fe-65a3-4130-8b26-2d526795d804", "userId": null, "tradeId": null, "swapId": null, "transferId": null, "tokenAddress": null, "networkId": null, "createdAt": "2026-10-25T18:42:35.000Z", "body": { "link": null, "title": "Recap: October 24th, 2026", "anchorText": null, "description": "• The broader market’s weekend consolidation continues as we head into a week packed with macro news.\n\n• Next week’s schedule: on Wednesday,…", "displayName": "fomo" }, "verified": false, "likes": 47, "views": 0, "type": "manual", "pinned": true, "twitter": null, "reacted": false } ] }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:20:21.171Z", "source": "fomo.family" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | an unknown type; bad cursor | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Trade (position) `GET https://api.pumpfomo.com/v1/fomo/trades/{id}` One fomo.family position with its swaps, transfers and thesis. A position by id: entry and exit prices, amounts, PnL, cost basis and token, the swaps and transfers that make it, and the thesis. Trade ids come from a trader's trades, the token routes and the stream. - Cost: 2 credits (2 per call) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-trade ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `id` | path | string | yes | Trade id (UUID). Example `c7a4ac5a-f0de-48cf-a2b0-deda82e94057`. | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/trades/094dd0b3-22ff-41ba-b676-f093c8293f01" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "trade": { "userAddress": "FgactYhd2nkUxWfBgY435reoWq2HYsw3AqyRnfaRDfbF", "tokenAddress": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "createdAt": "2026-08-22T20:55:15.000Z", "updatedAt": "2026-10-25T19:15:05.000Z", "closedAt": null, "humanTokenAmount": 41426653.05, "avgEntryPrice": 0.0402553, "avgExitPrice": 0.021502, "displayAvgEntryPriceUsd": 0.0402553, "displayAvgExitPriceUsd": 0.021502, "sumSwapOpen": 43899975.93, "sumSwapClosed": 2497111.05, "sumTransferIn": 203237.73, "sumTransferOut": 179476.03, "avgTransferInPrice": 0.250029, "avgTransferOutPrice": 0.216775, "realizedPnlUsd": -17735.47, "networkId": 1399811149, "commentId": "t2-17a10032194b4ecff470f4fc161f83828332be3c10fe0f4ac36bfa11a2648d0c-7a8e60b1", "id": "094dd0b3-22ff-41ba-b676-f093c8293f01", "isExternallyReceived": false, "tokenMetadata": { "symbol": "STONK", "networkId": 1399811149, "imageLargeUrl": null, "liquidity": 2143432.3091920656, "currentPrice": 0.13213665484060544 }, "unrealizedPnlUsd": 3766289.24, "totalCostBasis": 1818023.33 }, "swaps": [ { "id": "fdc195a0-14d5-4840-b256-ae972f570b0e", "address": "FgactYhd2nkUxWfBgY435reoWq2HYsw3AqyRnfaRDfbF", "networkId": 1399811149, "inTokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "inAm … (cut) ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | id is not a UUID | | 404 | `not_found` | fomo.family has nothing for it (costs 1 credit) | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | ## Trade comments `GET https://api.pumpfomo.com/v1/fomo/trades/{id}/comments` The thesis and comments on a fomo.family position. Comments with text, market cap and price when posted, likes and reactions; data.hasNextPage and the last comment's id page them. - Cost: 2 credits (2 a page) - Access: read:fomo - Reference: https://pumpfomo.com/docs/fomo-trade-comments ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `id` | path | string | yes | Trade id (UUID). Example `c7a4ac5a-f0de-48cf-a2b0-deda82e94057`. | | `cursor` | query | string | no | Next page: the id of the last comment of the previous page. 1-128 of A-Z a-z 0-9 _ . - | ### Example ```bash curl -s "https://api.pumpfomo.com/v1/fomo/trades/094dd0b3-22ff-41ba-b676-f093c8293f01/comments" \ -H "Authorization: Bearer $PUMPFOMO_API_KEY" ``` Answer (200), shortened: ```json { "data": { "comments": [ { "id": "t2-17a10032194b4ecff470f4fc161f83828332be3c10fe0f4ac36bfa11a2648d0c-7a8e60b1", "userId": "6d8c0bf3-5d42-506c-a0ea-9e1e75ff38af", "tradeId": "094dd0b3-22ff-41ba-b676-f093c8293f01", "comment": "🔥🔥 21% of the total $STONK supply has now been burned 🔥🔥", "priceUsdAtCreation": 0.0927021026849, "marketCapAtCreation": 73268452.02449997, "fdvAtCreation": 73268452.02449997, "createdAt": "2026-10-18T19:41:55.000Z", "parentId": null, "numLikes": 348, "tokenAddress": "6GmAFSYs4gk3FDao5FzzySQpPZaWsa4rUJHacpMpUNgx", "networkId": 1399811149, "commentSegments": [ { "text": "🔥🔥 21% of the total $STONK supply has now been burned 🔥🔥", "link": null, "provider": null } ], "reactions": { "counts": { "likeCount": 348 }, "reactions": { "like": false } }, "olderThesis": 61, "newerThesis": 0, "translation": null } ], "hasNextPage": true, "pinnedComment": null }, "meta": { "cache": "live", "fetchedAt": "2026-10-25T23:12:07.09Z", "source": "fomo.family" } } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `invalid_param` | id is not a UUID; bad cursor | | 404 | `not_found` | fomo.family has nothing for it (costs 1 credit); an input with nothing in it is an empty page at full price, not a 404 | | 503 | `upstream_busy` | the data is busy right now; retry in a few seconds (not charged) | | 503 | `upstream_unavailable` | fomo.family did not answer (not charged) | | 403 | `scope_missing` | the key lacks read:fomo | | 429 | `rate_limited` | over the plan's rate (see Retry-After; not charged) | # Account ## Wallet sign-in: challenge `POST https://api.pumpfomo.com/v1/auth/wallet/challenge` Starts a wallet sign-in: returns the message to sign. Send the wallet kind and address; sign the returned message with the wallet and send it to /verify. Limited to 30 a minute per IP. No key or session needed. - Cost: free - Access: public: no key or session - Reference: https://pumpfomo.com/docs/auth-wallet-challenge ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `kind` | body | string | yes | Wallet kind. One of `solana`, `evm`. Example `solana`. | | `address` | body | string | yes | The wallet address. Example `Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14`. | ### Request body ```json { "kind": "solana", "address": "Dtvoyzz9cQdJE1ztSrbZDJoxfY2b9JvBcu9Ki8assa14" } ``` ### Errors | Status | Code | When | |---|---|---| | 400 | `bad_address` | kind not solana\|evm or the address is invalid | | 400 | `bad_request` | body is not JSON for this endpoint | | 429 | `rate_limited` | more than 30 a minute from this IP | ## Wallet sign-in: verify `POST https://api.pumpfomo.com/v1/auth/wallet/verify` Finishes a wallet sign-in with the signature; returns a session token. Send the challenge's nonce and the signature of its message. Answers {session, accountId, new}; send the session as Authorization: Bearer to the account routes. A new wallet makes a new account. - Cost: free - Access: public: no key or session - Reference: https://pumpfomo.com/docs/auth-wallet-verify ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `nonce` | body | string | yes | From the challenge. | | `signature` | body | string | yes | Signature of the challenge message (base58 for Solana, hex for EVM). | ### Request body ```json { "nonce": "", "signature": "" } ``` ### Errors | Status | Code | When | |---|---|---| | 401 | `challenge_expired` | the nonce expired or was used | | 401 | `bad_signature` | the signature does not match the wallet | | 403 | `suspended` | the account is suspended | | 429 | `rate_limited` | more than 30 a minute from this IP | ## Telegram sign-in: start `POST https://api.pumpfomo.com/v1/auth/telegram` Starts a Telegram sign-in: a bot link to open and a secret to poll with. Answers {id, secret, botUrl}. Open botUrl in Telegram and confirm; meanwhile poll GET /v1/auth/telegram/{id} with the secret. Limited to 30 a minute per IP. - Cost: free - Access: public: no key or session - Reference: https://pumpfomo.com/docs/auth-telegram ### Errors | Status | Code | When | |---|---|---| | 503 | `telegram_off` | Telegram sign-in is not configured | | 429 | `rate_limited` | more than 30 a minute from this IP | ## Telegram sign-in: poll `GET https://api.pumpfomo.com/v1/auth/telegram/{id}` Polls a Telegram sign-in; returns the session once the bot confirms. Send the secret in the X-Login-Secret header. Answers {status} (e.g. "pending") until approved, then once {session, accountId, new}. Limited to 120 a minute per IP. - Cost: free - Access: public: no key or session - Reference: https://pumpfomo.com/docs/auth-telegram-poll ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `id` | path | string | yes | The sign-in request id. | ### Errors | Status | Code | When | |---|---|---| | 404 | `not_found` | no such request, expired, or already used | | 429 | `rate_limited` | more than 120 a minute from this IP | ## Sign out `POST https://api.pumpfomo.com/v1/auth/logout` Ends the current session (204). Ends the session in the Authorization header. Answers 204 with no body. - Cost: free - Access: session - Reference: https://pumpfomo.com/docs/auth-logout ### Errors | Status | Code | When | |---|---|---| | 401 | `unauthorized` | no session token, an API key instead of a session, or an ended session | ## Account `GET https://api.pumpfomo.com/v1/account` The signed-in account. The account record of the session (id, status, sign-in identities, creation time). - Cost: free - Access: session - Reference: https://pumpfomo.com/docs/account ### Errors | Status | Code | When | |---|---|---| | 401 | `unauthorized` | no session token, an API key instead of a session, or an ended session | ## List API keys `GET https://api.pumpfomo.com/v1/account/keys` The account's API keys (hints only, never the secret). Every key with id, name, hint, scopes, allowed IPs, expiry, revocation, rotation link, creation and last use. Answers {keys: [...]}. - Cost: free - Access: session - Reference: https://pumpfomo.com/docs/account-keys-list ### Errors | Status | Code | When | |---|---|---| | 401 | `unauthorized` | no session token, an API key instead of a session, or an ended session | ## Create an API key `POST https://api.pumpfomo.com/v1/account/keys` Makes a key; the secret (field "key") is shown once. Optional name, scopes (read:fomo, read:pump, read:wallet, stream; default all), allowed IPs or CIDR ranges, and expiry. Answers 201 with the key record plus "key", the secret, which is never shown again. The plan caps how many keys an account has. - Cost: free - Access: session - Reference: https://pumpfomo.com/docs/account-keys-create ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `name` | body | string | no | A label. Example `prod server`. | | `scopes` | body | array | no | Scopes (default: all four). One of `read:fomo`, `read:pump`, `read:wallet`, `stream`. Example `["read:pump"]`. | | `allowedIps` | body | array | no | IP addresses or CIDR ranges the key may be used from (default: anywhere). Example `["203.0.113.7"]`. | | `expiresAt` | body | string | no | RFC 3339 time in the future. | ### Request body ```json { "name": "prod server", "scopes": [ "read:pump", "read:fomo" ], "allowedIps": [ "203.0.113.7" ] } ``` ### Errors | Status | Code | When | |---|---|---| | 401 | `unauthorized` | no session token, an API key instead of a session, or an ended session | | 400 | `bad_scope` | an unknown scope | | 400 | `bad_ip` | an allowedIps entry is neither an address nor a CIDR | | 400 | `bad_expiry` | expiresAt is not in the future | | 409 | `too_many_keys` | the plan's key limit is reached | ## Update an API key `PATCH https://api.pumpfomo.com/v1/account/keys/{id}` Changes a key's name, scopes, allowed IPs or expiry. Send only the fields to change; expiresAt: null removes the expiry. Answers the key record. - Cost: free - Access: session - Reference: https://pumpfomo.com/docs/account-keys-update ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `id` | path | string | yes | Key id. | ### Request body ```json { "scopes": [ "read:pump" ] } ``` ### Errors | Status | Code | When | |---|---|---| | 401 | `unauthorized` | no session token, an API key instead of a session, or an ended session | | 404 | `not_found` | no such key on this account | | 400 | `bad_scope` | an unknown scope | | 400 | `bad_ip` | a bad allowedIps entry | ## Revoke an API key `DELETE https://api.pumpfomo.com/v1/account/keys/{id}` Revokes a key at once (204). The key stops working immediately. - Cost: free - Access: session - Reference: https://pumpfomo.com/docs/account-keys-revoke ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `id` | path | string | yes | Key id. | ### Errors | Status | Code | When | |---|---|---| | 401 | `unauthorized` | no session token, an API key instead of a session, or an ended session | | 404 | `not_found` | no such key on this account | ## Rotate an API key `POST https://api.pumpfomo.com/v1/account/keys/{id}/rotate` Makes a replacement key; the old one keeps working for a grace period. Optional body {graceSeconds}. Answers 201 with the new key (secret in "key", shown once); the old key is retired after the grace period. - Cost: free - Access: session - Reference: https://pumpfomo.com/docs/account-keys-rotate ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `id` | path | string | yes | Key id. | | `graceSeconds` | body | integer | no | How long the old key keeps working. Example `3600`. | ### Request body ```json { "graceSeconds": 3600 } ``` ### Errors | Status | Code | When | |---|---|---| | 401 | `unauthorized` | no session token, an API key instead of a session, or an ended session | | 404 | `not_found` | no such key on this account | | 400 | `bad_request` | a bad grace period | ## Deposit wallets `GET https://api.pumpfomo.com/v1/account/wallets` The account's USDC deposit addresses (Solana and EVM), made on first ask. Answers {wallets: {solana, evm}, accepted: {chain: [symbols]}}: where to send USDC to fund the balance, and what is accepted on which chain. - Cost: free - Access: session - Reference: https://pumpfomo.com/docs/account-wallets ### Errors | Status | Code | When | |---|---|---| | 401 | `unauthorized` | no session token, an API key instead of a session, or an ended session | | 503 | `wallets_off` | deposits are not available | ## Balance and plan `GET https://api.pumpfomo.com/v1/account/balance` USD balance, live plan and pack credits, and the current subscription and plan. Answers {balance, subscription, plan}; credits include spending not yet flushed to the ledger. - Cost: free - Access: session - Reference: https://pumpfomo.com/docs/account-balance ### Errors | Status | Code | When | |---|---|---| | 401 | `unauthorized` | no session token, an API key instead of a session, or an ended session | ## Deposits `GET https://api.pumpfomo.com/v1/account/deposits` The account's last 100 deposits. Answers {deposits: [{id, chainId, txHash, symbol, amount, usdCents, status, seenAt}]}, newest first. - Cost: free - Access: session - Reference: https://pumpfomo.com/docs/account-deposits ### Errors | Status | Code | When | |---|---|---| | 401 | `unauthorized` | no session token, an API key instead of a session, or an ended session | ## Usage `GET https://api.pumpfomo.com/v1/account/usage` Calls and credits by day (and by hour for the last 48 hours), by endpoint and by key, up to a minute behind. Answers {days, byDay: [{day, calls, credits}], byHour: [{hour, calls, credits}] (the last 48 hours), byEndpoint: [{name, calls, credits}], byKey: [{name (a key id), calls, credits}]}. - Cost: free - Access: session - Reference: https://pumpfomo.com/docs/account-usage ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `days` | query | integer | no | How many days back. Default `30`. Range 1 to 90. | ### Errors | Status | Code | When | |---|---|---| | 401 | `unauthorized` | no session token, an API key instead of a session, or an ended session | ## Recent requests `GET https://api.pumpfomo.com/v1/account/requests` The last 200 calls made with the account's keys, newest first, kept a week: status, error code and message, credits charged, latency, key and request id (the X-Request-Id of the answer). Answers {requests: [{at, method, path, endpoint, status, code?, message?, cost, ms, keyId, requestId}], kept}, newest first. - Cost: free - Access: session - Reference: https://pumpfomo.com/docs/account-requests ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `errors` | query | boolean | no | true: only the calls that failed (status 400 or more). | | `key` | query | string | no | Only this key's calls (a key id). | ### Errors | Status | Code | When | |---|---|---| | 401 | `unauthorized` | no session token, an API key instead of a session, or an ended session | ## Subscribe to a plan `POST https://api.pumpfomo.com/v1/account/subscribe` Buys or changes the plan from the USDC balance (needs an Idempotency-Key header). Body {plan}. An upgrade starts a new period at once; a downgrade applies at the end of the period. Send any unique Idempotency-Key so a retry buys once. - Cost: free - Access: session - Reference: https://pumpfomo.com/docs/account-subscribe ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `plan` | body | string | yes | Plan id (GET /v1/plans). One of `starter`, `builder`, `growth`, `scale`. Example `starter`. | ### Request body ```json { "plan": "starter" } ``` ### Errors | Status | Code | When | |---|---|---| | 401 | `unauthorized` | no session token, an API key instead of a session, or an ended session | | 400 | `idempotency_key` | no Idempotency-Key header | | 402 | `insufficient_funds` | the balance is too low | | 404 | `not_found` | no such plan | ## Buy a credit pack `POST https://api.pumpfomo.com/v1/account/packs` Buys credits that never expire from the USDC balance (needs an Idempotency-Key header). Body {pack}. Answers {credits}: the pack credits now on the account. - Cost: free - Access: session - Reference: https://pumpfomo.com/docs/account-packs ### Parameters | Name | In | Type | Required | Notes | |---|---|---|---|---| | `pack` | body | string | yes | Pack id (GET /v1/plans). One of `1m`, `5m`, `20m`, `75m`. Example `1m`. | ### Request body ```json { "pack": "1m" } ``` ### Errors | Status | Code | When | |---|---|---| | 401 | `unauthorized` | no session token, an API key instead of a session, or an ended session | | 400 | `idempotency_key` | no Idempotency-Key header | | 402 | `insufficient_funds` | the balance is too low | | 404 | `not_found` | no such pack | ## Plans and packs `GET https://api.pumpfomo.com/v1/plans` The public plans (price, credits, rate, streams, keys) and credit packs. Public, no key or session needed. Prices in US cents; ratePerSecond and burst are the per-key rate limit; streams is how many WebSockets may be open at once. - Cost: free - Access: public: no key or session - Reference: https://pumpfomo.com/docs/plans ### Example ```bash curl -s "https://api.pumpfomo.com/v1/plans" ``` Answer (200), shortened: ```json { "packs": [ { "id": "1m", "credits": 1000000, "priceCents": 1600 }, { "id": "5m", "credits": 5000000, "priceCents": 5500 }, { "id": "20m", "credits": 20000000, "priceCents": 14900 } ], "plans": [ { "id": "free", "name": "Free", "priceCents": 0, "periodDays": 30, "credits": 25000, "ratePerSecond": 2, "burst": 10, "streams": 0, "maxKeys": 2 }, { "id": "starter", "name": "Starter", "priceCents": 2900, "periodDays": 30, "credits": 2000000, "ratePerSecond": 10, "burst": 40, "streams": 1, "maxKeys": 10 }, { "id": "builder", "name": "Builder", "priceCents": 7900, "periodDays": 30, "credits": 8000000, "ratePerSecond": 25, "burst": 100, "streams": 3, "maxKeys": 25 } ] } ``` ### Errors | Status | Code | When | |---|---|---| | 500 | `internal` | something failed on our side; retry (not charged) |