# pumpfomo > The data API for pump.fun and fomo.family: traders, wallets, coins, PnL, leaderboards, callouts and wallet lookups over REST, and every trade live over one WebSocket, on Solana and 11 EVM chains. Read-only and independent (not pump.fun or fomo.family). - Base URL: https://api.pumpfomo.com. Send the key as `Authorization: Bearer ` (keys start with `pf_live_`); make one at https://pumpfomo.com/dashboard/keys?ref=ai-docs. The Free plan has 2,500 credits a month. - Answers are `{"data": …, "meta": {…}}`; errors are `{"error": {"code", "message", "requestId"}}`. Each endpoint costs the credits listed below; errors cost nothing. `X-Credits-Cost` and `X-Credits-Remaining` come back on every paid call. - On 429 wait `Retry-After` seconds; retry 5xx with backoff. Field names in `data` follow pump.fun's and fomo.family's own (camelCase and snake_case both occur): read an endpoint's example answer before writing types. - Live trades, new coins, callouts and chosen traders: wss://api.pumpfomo.com/v1/stream (Builder plan and up). ## Start here - [Overview: keys, answers, credits, limits, errors](https://pumpfomo.com/docs.md) - [Live stream: channels, filters, messages](https://pumpfomo.com/docs/streams.md) - [Build with AI: the Claude skill and these files](https://pumpfomo.com/docs/ai) ## General - [GET /v1/ping](https://pumpfomo.com/docs/ping.md): Checks an API key and says which key, account and scopes it speaks for. Free. ## Wallets - [GET /v1/wallets/{address}](https://pumpfomo.com/docs/wallet.md): Reverse lookup: the fomo.family and pump.fun people behind a wallet. 500 credits. - [POST /v1/wallets/batch](https://pumpfomo.com/docs/wallets-batch.md): Reverse lookup for up to 100 wallets in one call. 250 per wallet answered, each a wallet reveal (capped a month by the plan); 50 when none is. ## pump.fun users - [GET /v1/pump/users/{id}](https://pumpfomo.com/docs/pump-user.md): A pump.fun profile by wallet or user id: name, avatar, bio, follower counts, wallets. 1 credit. - [GET /v1/pump/users/{id}/trades](https://pumpfomo.com/docs/pump-user-trades.md): A pump.fun trader's trades and/or transfers, newest first, 100 a page. 2 credits. - [GET /v1/pump/users/{id}/following](https://pumpfomo.com/docs/pump-user-following.md): The pump.fun accounts a user follows (up to 1,000). 2 credits. - [GET /v1/pump/users/{id}/followers](https://pumpfomo.com/docs/pump-user-followers.md): The pump.fun accounts following a user, roughly the most followed first (up to 1,999). 2 credits. - [GET /v1/pump/users/{id}/followers/count](https://pumpfomo.com/docs/pump-user-followers-count.md): How many pump.fun accounts follow a user. 1 credit. - [GET /v1/pump/users/{id}/activity](https://pumpfomo.com/docs/pump-user-activity.md): A user's coin launches and creator-fee claims, newest first, 20 a page. 2 credits. - [GET /v1/pump/users/{wallet}/pnl](https://pumpfomo.com/docs/pump-user-pnl.md): A wallet's realized and unrealized PnL over a period, in SOL and USD, with holdings. 5 credits. - [GET /v1/pump/users/{wallet}/pnl/chart](https://pumpfomo.com/docs/pump-user-pnl-chart.md): A wallet's equity curve over a period. 5 credits. - [GET /v1/pump/users/{wallet}/pnl/{mint}](https://pumpfomo.com/docs/pump-user-pnl-coin.md): Cost basis, realized and unrealized PnL and fees paid by a wallet in one coin. 1 credit. - [GET /v1/pump/users/{wallet}/positions](https://pumpfomo.com/docs/pump-user-positions.md): A wallet's position in each of up to 50 coins. 2 credits. - [GET /v1/pump/users/{wallet}/portfolio](https://pumpfomo.com/docs/pump-user-portfolio.md): Every position of a wallet — open, closed or all — by PnL or size, 100 a page. 2 credits. - [GET /v1/pump/users/{wallet}/balance](https://pumpfomo.com/docs/pump-user-balance.md): A wallet's total value and PnL across every chain pump.fun knows. 1 credit. - [GET /v1/pump/users/{wallet}/balances](https://pumpfomo.com/docs/pump-user-balances.md): Every token a wallet holds on every chain, with price, value and PnL, 200 a page. 2 credits. - [GET /v1/pump/users/{wallet}/created-coins](https://pumpfomo.com/docs/pump-user-created-coins.md): The coins a wallet launched on pump.fun, 50 a page. 2 credits. - [GET /v1/pump/users/{wallet}/fees](https://pumpfomo.com/docs/pump-user-fees.md): Creator fees a wallet earned, day by day, over 7, 30, 90 days or all time. 2 credits. - [GET /v1/pump/users/{wallet}/fees/shares](https://pumpfomo.com/docs/pump-user-fees-shares.md): The coins whose creator fees a wallet has a share of, with earned, claimed and unclaimed totals. 1 credit. - [GET /v1/pump/users/{wallet}/trader-stats](https://pumpfomo.com/docs/pump-user-trader-stats.md): Volume, trade count and biggest trade over 1, 7 and 30 days and all time, by platform. 1 credit. - [GET /v1/pump/users/{wallet}/streak](https://pumpfomo.com/docs/pump-user-streak.md): A wallet's current and longest daily trading streak, with day-by-day history. 1 credit. - [GET /v1/pump/search/users](https://pumpfomo.com/docs/pump-search-users.md): pump.fun users by name or wallet (top 20, labelled wallets included). 1 credit. - [GET /v1/pump/resolve](https://pumpfomo.com/docs/pump-resolve.md): Says whether an address is a pump.fun user, a coin or neither, with the match. 1 credit. ## pump.fun coins - [GET /v1/pump/coins/{mint}](https://pumpfomo.com/docs/pump-coin.md): One coin: name, symbol, images, socials, creator, supply, price and market cap. 1 credit. - [GET /v1/pump/coins/{mint}/holders/count](https://pumpfomo.com/docs/pump-coin-holders-count.md): How many wallets hold a coin. 1 credit. - [GET /v1/pump/coins/{mint}/traders](https://pumpfomo.com/docs/pump-coin-traders.md): The pump.fun users with a position in a coin, 50 at a time, by size, recency, rank or closed PnL. 2 credits. - [GET /v1/pump/coins/{mint}/top-traders](https://pumpfomo.com/docs/pump-coin-top-traders.md): PnL-leaderboard traders who traded a coin, and their trades in it. 2 credits. - [GET /v1/pump/coins/{mint}/ath](https://pumpfomo.com/docs/pump-coin-ath.md): A coin's all-time-high market cap in USD. 1 credit. - [GET /v1/pump/coins/{mint}/candles](https://pumpfomo.com/docs/pump-coin-candles.md): OHLCV candles in USD, from 1-second to 1-day bars, up to 500. 2 credits. - [GET /v1/pump/coins/{mint}/sparkline](https://pumpfomo.com/docs/pump-coin-sparkline.md): A small price line for lists: at most 120 points. 1 credit. - [GET /v1/pump/coins/{mint}/trades](https://pumpfomo.com/docs/pump-coin-trades.md): Every trade in a coin, newest first, 100 a page, with buy/sell aggregates. 2 credits. - [GET /v1/pump/coins/{mint}/live](https://pumpfomo.com/docs/pump-coin-live.md): Live stats of a coin: snipers, KOLs who traded, buys and sells, fees and tips, curve progress. 1 credit. - [GET /v1/pump/coins/{mint}/market-activity](https://pumpfomo.com/docs/pump-coin-market-activity.md): Trades, volume, buyers, sellers and price change over 5m, 1h, 6h and 24h. 1 credit. - [GET /v1/pump/coins](https://pumpfomo.com/docs/pump-coins-list.md): pump.fun coins by newest, last trade or market cap, 60 a page (NSFW excluded). 1 credit. - [GET /v1/pump/search/coins](https://pumpfomo.com/docs/pump-search-coins.md): pump.fun coins by name, symbol or address (top 50, NSFW excluded). 1 credit. ## pump.fun boards - [GET /v1/pump/boards/{board}](https://pumpfomo.com/docs/pump-board.md): pump.fun's movers or trending board (up to 150 coins), on chosen chains. 1 credit. - [GET /v1/pump/leaderboard](https://pumpfomo.com/docs/pump-leaderboard.md): pump.fun's top 100 traders by PnL, daily, weekly or monthly. 1 credit. - [GET /v1/pump/leaderboard/streaks](https://pumpfomo.com/docs/pump-leaderboard-streaks.md): The wallets with the longest current daily trading streaks. 1 credit. - [GET /v1/pump/leaderboard/positions](https://pumpfomo.com/docs/pump-leaderboard-positions.md): The best single positions behind the PnL leaderboard. 2 credits. - [GET /v1/pump/leaderboard/payouts](https://pumpfomo.com/docs/pump-leaderboard-payouts.md): Who pump.fun paid the most USDC to in the last day, 50 a page. 1 credit. - [GET /v1/pump/competitions](https://pumpfomo.com/docs/pump-competitions.md): pump.fun trading competitions: upcoming, live and past, with prizes and winners. 1 credit. - [GET /v1/pump/competitions/{id}](https://pumpfomo.com/docs/pump-competition.md): One competition with its live leaderboard. 1 credit. - [GET /v1/pump/competitions/{id}/entries/{entry}](https://pumpfomo.com/docs/pump-competition-entry.md): A competition entry's 10 best tokens and each member's PnL in them. 1 credit. - [GET /v1/pump/sol-price](https://pumpfomo.com/docs/pump-sol-price.md): pump.fun's SOL/USD price. Free. ## pump.fun callouts - [GET /v1/pump/users/{wallet}/callouts](https://pumpfomo.com/docs/pump-user-callouts.md): A pump.fun trader's callouts, newest first (100): thesis, call market cap, multiple, and how followers did. 2 credits. - [GET /v1/pump/users/{wallet}/callout-stats](https://pumpfomo.com/docs/pump-user-callout-stats.md): How a trader's callouts did: hit rates, multiples, and the PnL of those who followed them. 2 credits. - [GET /v1/pump/callouts/{id}](https://pumpfomo.com/docs/pump-callout.md): One pump.fun callout with its author. 1 credit. - [GET /v1/pump/callouts/{id}/replies](https://pumpfomo.com/docs/pump-callout-replies.md): The replies under a callout (up to 200), or only the author's own updates. 1 credit. ## pump.fun batch - [POST /v1/pump/users/batch](https://pumpfomo.com/docs/pump-users-batch.md): pump.fun profiles of up to 50 wallets; only matched wallets come back. 5 credits. - [POST /v1/pump/wallets/overview](https://pumpfomo.com/docs/pump-wallets-overview.md): Total value, SOL balance and first-trade time of up to 20 wallets. 5 credits. - [POST /v1/pump/coins/batch](https://pumpfomo.com/docs/pump-coins-batch.md): Full coin records of up to 50 mints. 5 credits. - [POST /v1/pump/users/{wallet}/pnl/coins](https://pumpfomo.com/docs/pump-user-pnl-coins.md): One wallet's PnL in each of up to 50 coins. 5 credits. - [POST /v1/pump/creators/fees/chart](https://pumpfomo.com/docs/pump-creators-fees-chart.md): Creator fees earned by up to 20 creator wallets over time. 5 credits. - [POST /v1/pump/coins/ath/batch](https://pumpfomo.com/docs/pump-coins-ath-batch.md): All-time-high market cap of up to 60 coins. 3 credits. - [POST /v1/pump/coins/market-activity/batch](https://pumpfomo.com/docs/pump-coins-market-activity-batch.md): Trades, volume, traders and price change over 5m, 1h, 6h and 24h of up to 50 coins. 3 credits. - [POST /v1/pump/coins/{mint}/holders/pnl](https://pumpfomo.com/docs/pump-coin-holders-pnl.md): Each of up to 50 wallets' PnL in one Solana coin. 5 credits. - [POST /v1/pump/coins/{mint}/trades/by-wallets](https://pumpfomo.com/docs/pump-coin-trades-by-wallets.md): The trades of up to 50 wallets in one coin. 5 credits. ## fomo.family users - [GET /v1/fomo/users/{handle}](https://pumpfomo.com/docs/fomo-user.md): A fomo.family trader by handle: wallets, bio, counts, volume, clan. 2 credits. - [GET /v1/fomo/users/{handle}/balances](https://pumpfomo.com/docs/fomo-user-balances.md): What a fomo.family trader holds now, with market data and PnL per token. 2 credits. - [GET /v1/fomo/users/{handle}/positions](https://pumpfomo.com/docs/fomo-user-positions.md): A fomo.family trader's swaps, newest first. 2 credits. - [GET /v1/fomo/users/{handle}/trades](https://pumpfomo.com/docs/fomo-user-trades.md): A trader's positions, open and closed, with the wallet each was traded from and any thesis. 2 credits. - [GET /v1/fomo/users/{handle}/following](https://pumpfomo.com/docs/fomo-user-following.md): The fomo.family traders a user follows, with their 24h PnL. 2 credits. - [GET /v1/fomo/users/{handle}/followers](https://pumpfomo.com/docs/fomo-user-followers.md): A fomo.family trader's followers (first page), with their 24h PnL. 2 credits. - [GET /v1/fomo/users/{handle}/rank](https://pumpfomo.com/docs/fomo-user-rank.md): A trader's leaderboard rank and PnL, all time and over 24h, 7d and 30d. 2 credits. - [GET /v1/fomo/users/{handle}/pnl-chart](https://pumpfomo.com/docs/fomo-user-pnl-chart.md): A trader's PnL and equity curve over 1, 7 or 30 days. 5 credits. - [GET /v1/fomo/users/{handle}/spotlight](https://pumpfomo.com/docs/fomo-user-spotlight.md): A trader's best trades and best theses. 2 credits. - [GET /v1/fomo/search](https://pumpfomo.com/docs/fomo-search.md): fomo.family traders by name or handle. 2 credits. ## fomo.family tokens - [GET /v1/fomo/tokens/{chain}/{address}/holders](https://pumpfomo.com/docs/fomo-token-holders.md): The fomo.family traders holding a token, with value, PnL and thesis. 2 credits. - [GET /v1/fomo/tokens/{chain}/{address}/devs](https://pumpfomo.com/docs/fomo-token-devs.md): What the token's developer wallets hold. 2 credits. - [GET /v1/fomo/tokens/{chain}/{address}/stats](https://pumpfomo.com/docs/fomo-token-stats.md): Buys, sells, volumes and unique traders over 5m, 1h, 4h and 24h; holders and top-10 share. 2 credits. - [GET /v1/fomo/tokens/{chain}/{address}/warnings](https://pumpfomo.com/docs/fomo-token-warnings.md): fomo.family's risk warnings for a token, and whether buying or selling is disabled. 2 credits. - [GET /v1/fomo/tokens/{chain}/{address}/candles](https://pumpfomo.com/docs/fomo-token-candles.md): OHLCV candles from fomo.family's market data, 1-minute to 1-week bars, up to 2,000. 2 credits. - [GET /v1/fomo/tokens/{chain}/{address}/theses](https://pumpfomo.com/docs/fomo-token-theses.md): fomo.family traders' theses on a token, 100 a page, optionally only from positions above a size. 2 credits. - [GET /v1/fomo/tokens/{chain}/{address}/trades](https://pumpfomo.com/docs/fomo-token-trades.md): The buys and sells of fomo.family users in one token, newest first. 2 credits. - [GET /v1/fomo/tokens/batch](https://pumpfomo.com/docs/fomo-tokens-batch.md): Market data for up to 50 tokens on any of fomo.family's chains. 5 credits. - [GET /v1/fomo/search/tokens](https://pumpfomo.com/docs/fomo-search-tokens.md): Tokens by name or symbol, or one token by address. 2 credits. ## fomo.family boards - [GET /v1/fomo/leaderboard/{window}](https://pumpfomo.com/docs/fomo-leaderboard.md): fomo.family's top traders by PnL over 24h, 7d, 30d or all time. 1 credit. - [GET /v1/fomo/tokens/trending](https://pumpfomo.com/docs/fomo-tokens-trending.md): The tokens trending on fomo.family now. 1 credit. - [GET /v1/fomo/tokens/most-held](https://pumpfomo.com/docs/fomo-tokens-most-held.md): The tokens most fomo.family traders hold. 1 credit. ## fomo.family clans - [GET /v1/fomo/leaderboard/clans/{window}](https://pumpfomo.com/docs/fomo-clans-leaderboard.md): fomo.family's top 50 clans by PnL over 24h, 7d, 30d or all time. 1 credit. - [GET /v1/fomo/clans/search](https://pumpfomo.com/docs/fomo-clans-search.md): fomo.family clans by name. 2 credits. - [GET /v1/fomo/clans/{id}](https://pumpfomo.com/docs/fomo-clan.md): One clan: profile, rank and PnL for a window, top tokens and members. 2 credits. - [GET /v1/fomo/clans/{id}/holdings](https://pumpfomo.com/docs/fomo-clan-holdings.md): What a clan's members hold together, 20 tokens a page. 2 credits. ## fomo.family feed and trades - [GET /v1/fomo/feed](https://pumpfomo.com/docs/fomo-feed.md): fomo.family's global activity feed: large buys and sells, theses, listings, milestones, 50 a page. 2 credits. - [GET /v1/fomo/trades/{id}](https://pumpfomo.com/docs/fomo-trade.md): One fomo.family position with its swaps, transfers and thesis. 2 credits. - [GET /v1/fomo/trades/{id}/comments](https://pumpfomo.com/docs/fomo-trade-comments.md): The thesis and comments on a fomo.family position. 2 credits. ## Account (dashboard session, not an API key) - [POST /v1/auth/wallet/challenge](https://pumpfomo.com/docs/auth-wallet-challenge.md): Starts a wallet sign-in: returns the message to sign. Free. - [POST /v1/auth/wallet/verify](https://pumpfomo.com/docs/auth-wallet-verify.md): Finishes a wallet sign-in with the signature; returns a session token. Free. - [POST /v1/auth/telegram](https://pumpfomo.com/docs/auth-telegram.md): Starts a Telegram sign-in: a bot link to open and a secret to poll with. Free. - [GET /v1/auth/telegram/{id}](https://pumpfomo.com/docs/auth-telegram-poll.md): Polls a Telegram sign-in; returns the session once the bot confirms. Free. - [POST /v1/auth/logout](https://pumpfomo.com/docs/auth-logout.md): Ends the current session (204). Free. - [GET /v1/account](https://pumpfomo.com/docs/account.md): The signed-in account. Free. - [GET /v1/account/keys](https://pumpfomo.com/docs/account-keys-list.md): The account's API keys (hints only, never the secret). Free. - [POST /v1/account/keys](https://pumpfomo.com/docs/account-keys-create.md): Makes a key; the secret (field "key") is shown once. Free. - [PATCH /v1/account/keys/{id}](https://pumpfomo.com/docs/account-keys-update.md): Changes a key's name, scopes, allowed IPs or expiry. Free. - [DELETE /v1/account/keys/{id}](https://pumpfomo.com/docs/account-keys-revoke.md): Revokes a key at once (204). Free. - [POST /v1/account/keys/{id}/rotate](https://pumpfomo.com/docs/account-keys-rotate.md): Makes a replacement key; the old one keeps working for a grace period. Free. - [GET /v1/account/wallets](https://pumpfomo.com/docs/account-wallets.md): The account's USDC deposit addresses (Solana and EVM), made on first ask. Free. - [GET /v1/account/balance](https://pumpfomo.com/docs/account-balance.md): USD balance, live plan and pack credits, and the current subscription and plan. Free. - [GET /v1/account/deposits](https://pumpfomo.com/docs/account-deposits.md): The account's last 100 deposits. Free. - [GET /v1/account/usage](https://pumpfomo.com/docs/account-usage.md): Calls and credits by day (and by hour for the last 48 hours), by endpoint and by key, up to a minute behind. Free. - [GET /v1/account/requests](https://pumpfomo.com/docs/account-requests.md): 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). Free. - [POST /v1/account/subscribe](https://pumpfomo.com/docs/account-subscribe.md): Buys or changes the plan from the USDC balance (needs an Idempotency-Key header). Free. - [POST /v1/account/packs](https://pumpfomo.com/docs/account-packs.md): Buys credits that never expire from the USDC balance (needs an Idempotency-Key header). Free. - [GET /v1/plans](https://pumpfomo.com/docs/plans.md): The public plans (price, credits, rate, streams, keys) and credit packs. Free. ## Optional - [The whole reference in one file](https://pumpfomo.com/llms-full.txt) - [The Claude skill (zip)](https://pumpfomo.com/pumpfomo-skill.zip) - [Plans and prices](https://pumpfomo.com/#pricing) - [Guides](https://pumpfomo.com/blog)