# FomoScan - [FomoScan API](https://docs.fomoscan.sh/index.md): Verified trader wallets, realized PnL and trader theses, plus pump.fun callouts, over REST and WebSocket. - [Quickstart](https://docs.fomoscan.sh/quickstart.md): From sign-up to a first response in four steps. - [Authentication](https://docs.fomoscan.sh/concepts/authentication.md): Send your API key as a bearer token. - [Credits and pricing](https://docs.fomoscan.sh/concepts/credits.md): How compute units work, what each call costs, and how to add more. - [Paging and deduplication](https://docs.fomoscan.sh/concepts/pagination.md): Cursor paging on the feeds, and the keys to dedupe on. - [Errors](https://docs.fomoscan.sh/concepts/errors.md): One error shape, stable codes. - [Rate limits](https://docs.fomoscan.sh/concepts/rate-limits.md): A per-key limit from your plan, and a per-IP burst ceiling. - [Account and API keys](https://docs.fomoscan.sh/portal/account.md): Sign up, verify your email and manage the keys your integration uses. - [AI tools](https://docs.fomoscan.sh/ai/overview.md): Give your coding assistant or agent the FomoScan docs. - [API reference](https://docs.fomoscan.sh/api-reference/introduction.md): Every endpoint, generated from the running service. - [Identity and PnL](https://docs.fomoscan.sh/api/identity.md): Handle, user id or wallet to a trader and their verified wallets. - [Theses and pump.fun](https://docs.fomoscan.sh/api/theses.md): Trader theses and pump.fun callouts, paged newest first. - [Resolve a FOMO handle to the user and their verified wallet](https://docs.fomoscan.sh/api-reference/identities/resolve-a-fomo-handle-to-the-user-and-their-verified-wallet.md): Looks a user up by their FOMO handle. - [Resolve a wallet address to the user(s) behind it](https://docs.fomoscan.sh/api-reference/identities/resolve-a-wallet-address-to-the-users-behind-it.md): The same record as `/v2/user/handle/{handle}`. - [Resolve a FOMO user id to the user and their verified wallet](https://docs.fomoscan.sh/api-reference/identities/resolve-a-fomo-user-id-to-the-user-and-their-verified-wallet.md): Looks a user up by the `id` from a previous response. `id` is stable where `handle` is not, so it is the value to store against your own records and come back with. - [Resolve a handle to its wallets (temporarily unavailable)](https://docs.fomoscan.sh/api-reference/identities/resolve-a-handle-to-its-wallets-temporarily-unavailable.md): **Temporarily unavailable.** Live resolution is paused. - [One trader's realized and unrealized profit across their whole wallet](https://docs.fomoscan.sh/api-reference/identities/one-traders-realized-and-unrealized-profit-across-their-whole-wallet.md): Profit and trading activity across one account's whole wallet: every venue, Solana and EVM together. - [Whole-wallet profit for up to 100 traders in one call](https://docs.fomoscan.sh/api-reference/identities/whole-wallet-profit-for-up-to-100-traders-in-one-call.md): GET /v2/user/handle/{handle}/pnl for up to 100 handles at once. - [Every thesis, newest first — the unfiltered feed](https://docs.fomoscan.sh/api-reference/thesis-feed/every-thesis-newest-first-—-the-unfiltered-feed.md): Every thesis on the platform, newest first, 20 to a page — no token filter, no author filter. - [Theses for a token, newest first, ask on a timer for a live feed](https://docs.fomoscan.sh/api-reference/thesis-feed/theses-for-a-token-newest-first-ask-on-a-timer-for-a-live-feed.md): The 20 most recent theses for one token, newest first by post time. - [Theses by a user, newest first, ask on a timer for their feed](https://docs.fomoscan.sh/api-reference/thesis-feed/theses-by-a-user-newest-first-ask-on-a-timer-for-their-feed.md): Every thesis this user has posted, newest first, 20 to a page. - [Theses by a user about one token](https://docs.fomoscan.sh/api-reference/thesis-feed/theses-by-a-user-about-one-token.md): Everything one user has posted about one token, newest first. - [Introspect the calling API key](https://docs.fomoscan.sh/api-reference/account/introspect-the-calling-api-key.md): Returns the account, plan, scopes, entitlement and current usage for the presented API key. - [A pump.fun user by wallet](https://docs.fomoscan.sh/api-reference/pump/a-pumpfun-user-by-wallet.md): The pump.fun profile for a wallet: handle, bio, follower counts, linked X handle. - [Every pump.fun callout, newest first](https://docs.fomoscan.sh/api-reference/pump/every-pumpfun-callout-newest-first.md): The 25 most recent pump.fun callouts across ALL coins. The global thesis feed pump.fun itself does not expose. - [A coin's callout wall, newest first](https://docs.fomoscan.sh/api-reference/pump/a-coins-callout-wall-newest-first.md): The 25 most recent pump.fun callouts (their theses) for a coin. - [A wallet's callouts, newest first](https://docs.fomoscan.sh/api-reference/pump/a-wallets-callouts-newest-first.md): The 25 most recent callouts posted by one wallet. Same paging as the token wall. - [The pump.fun PnL leaderboard](https://docs.fomoscan.sh/api-reference/pump/the-pumpfun-pnl-leaderboard.md): pump.fun's top 100 traders by realized+unrealized PnL, as a snapshot. - [One pump.fun wallet's realized and unrealized profit](https://docs.fomoscan.sh/api-reference/pump/one-pumpfun-wallets-realized-and-unrealized-profit.md): Profit and trading activity across the whole wallet, on the same formula as GET /v2/user/handle/{handle}/pnl. - [Live theses, every token or a token list (WebSocket)](https://docs.fomoscan.sh/api-reference/websocket/live-theses-every-token-or-a-token-list-websocket.md): The live thesis feed. pump.fun callouts have their own socket at `/v2/ws/pump`, described below. Attach once, then declare what you want, every token or a list of tokens, and change it at any time without reconnecting. - [Live pump.fun callouts, every token or a token list (WebSocket)](https://docs.fomoscan.sh/api-reference/websocket/live-pumpfun-callouts-every-token-or-a-token-list-websocket.md): The pump.fun callout feed on its own socket. Everything on `GET /v2/ws` applies here: the handshake, the plan rule, one subscription per connection, the frames, the close codes and the per-minute meter. The section **The pump feed** there describes the `pump_callout` frame. - [Overview](https://docs.fomoscan.sh/websockets/overview.md): Two sockets, one subscribe model, theses and pump.fun callouts as they arrive. - [Thesis feed](https://docs.fomoscan.sh/websockets/theses.md): Trader theses pushed on /v2/ws as they arrive. - [pump.fun feed](https://docs.fomoscan.sh/websockets/pump.md): New pump.fun callouts pushed on /v2/ws/pump. - [Examples](https://docs.fomoscan.sh/examples/overview.md): Projects we build with partners on top of FomoScan data. - [Trading terminal](https://docs.fomoscan.sh/examples/trading-terminal.md): A token page with the live thesis wall and each author's track record. - [Wallet labels](https://docs.fomoscan.sh/examples/wallet-labels.md): Name the trader behind a wallet in a trade feed, holder list or alert. - [Callout alerts bot](https://docs.fomoscan.sh/examples/callout-bot.md): New pump.fun callouts, filtered, posted to Telegram within seconds. - [Trader leaderboard](https://docs.fomoscan.sh/examples/leaderboard.md): Rank traders by realized profit, or show pump.fun's top 100. - [Changelog](https://docs.fomoscan.sh/changelog.md): Changes to the public API. ## OpenAPI Specs - [openapi](https://api.fomoscan.sh/openapi.json) ## Optional - [Partner portal](https://partner.fomoscan.sh) - [OpenAPI spec](https://api.fomoscan.sh/openapi.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.