> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fomoscan.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# FomoScan API

> Verified trader wallets, realized PnL and trader theses, plus pump.fun callouts, over REST and WebSocket.

![FomoScan API at api.fomoscan.sh, over REST and WebSocket: identity (handle to wallets), PnL (realized profit), theses (why traders bought), pump.fun (callouts and trader rankings) and live WebSocket feeds](https://mintcdn.com/socialscan/pX0brSzGgXBryxeh/images/art/overview.webp?fit=max\&auto=format\&n=pX0brSzGgXBryxeh\&q=85\&s=b5eea0c8d0d0fabea55c8c3645aa52fc)

FomoScan gives you a trader's verified wallets, their realized profit and the
theses they write about tokens. Every wallet in a response is a verified match.

## Get started

> **[Quickstart](https://docs.fomoscan.sh/quickstart.md)**
>
> Create a key and make your first call in four steps.

> **[Credits and pricing](https://docs.fomoscan.sh/concepts/credits.md)**
>
> What each call costs and how to add credits.

## Build

> **[API reference](https://docs.fomoscan.sh/api-reference/introduction.md)**
>
> Every endpoint, with a live playground.

> **[WebSockets](https://docs.fomoscan.sh/websockets/overview.md)**
>
> Theses and pump.fun callouts as they arrive.

> **[Examples](https://docs.fomoscan.sh/examples/overview.md)**
>
> Terminals, bots and leaderboards we build with partners.

## What you can ask

| Question | Endpoint |
| - | - |
| Who is this trader, and which wallets are theirs? | `GET /v2/user/handle/{handle}` |
| Who is behind this wallet? | `GET /v2/user/wallet/{address}` |
| How much has this trader made over the last 24 hours, 7 days or 30 days? | `GET /v2/user/handle/{handle}/pnl` |
| Why are traders buying this token? | `GET /v2/thesis/token/{tokenAddress}` |
| What did pump.fun callers just post? | `GET /v2/pump/thesis`, `/v2/ws/pump` |

## Explore

> **[AI tools](https://docs.fomoscan.sh/ai/overview.md)**
>
> MCP server and llms.txt for your agent.

> **[Partner portal](https://docs.fomoscan.sh/portal/account.md)**
>
> Keys, plans and usage.

> **[Changelog](https://docs.fomoscan.sh/changelog.md)**
>
> What changed in the API.

## Need help?

> **[Telegram](https://t.me/fomoscan_support)**
>
> Talk to the team.

> **[Email](mailto:fomoscan-support@proton.me)**
>
> [fomoscan-support@proton.me](mailto:fomoscan-support@proton.me)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.