Access and base paths
The Pumpscan web app uses same-origin /api/v1/* browser routes. HTTP reads pass through the frontend server, while /api/v1/ws/* WebSockets authenticate during the upgrade and then connect directly to the Rust stream service.
Registered machine clients use https://api.pumpscan.io/v1/* with an issued API key in the Authorization: Bearer header. Anonymous requests to that host are rejected.
Browser routes are an application interface, not a public anonymous API contract. Response shapes may evolve with the dashboard.
Endpoint map
| Endpoint | What it returns |
|---|---|
| /v1/events | Paginated decoded events with filters for signature, mint, bonding curve, creator, user, route program, exact parent program, event type and time window. |
| /v1/events/:tx | One retained decoded transaction payload selected by exact signature. |
| /v1/metrics | Combined daily overview, account, mint and program metrics. |
| /v1/accounts | Creator, trader and active-account rows with sort and wallet filters. |
| /v1/accounts/:account/rpc | Cached current on-chain existence, owner, curve status and 30-second SOL balance hydration. No per-token balance data. |
| /v1/accounts/:account/account | Cached Pumpscan account roles, trade totals, claims, cashback earnings and classified core sweeps received by the address. |
| /v1/accounts/:account/mints | Cached creator/trader mint relations with mint details. |
| /v1/accounts/:account/relations | Ranked co-traders with shared-token counts and first buy/sell position histograms. |
| /v1/accounts/:account/programs | Paginated upstream programs observed for the account, split into routing and execution activity. Transaction-only protocol endpoints are excluded. |
| /v1/accounts/:account/events | Compact paginated creator/user transactions for the account. |
| /v1/accounts/mayhem/account | Reserved Mayhem Bot account endpoint; currently returns 501 Not Implemented. |
| /v1/accounts/mayhem/rpc | Mayhem Bot current on-chain existence, owner, curve status and cached SOL balance hydration. |
| /v1/accounts/mayhem/events | Retained event query used only by the Mayhem Bot page. |
| /v1/tokens | Token rankings, launch metadata, flags, reserves, volumes and transaction counts. |
| /v1/quote-mints | Retained quote-mint identities, known quote units per SOL, latest Jupiter USD market caps, and active token counts, with optional case-insensitive ?search= matching by address, name or symbol. |
| /v1/quote-mints/ticker | Compact USDC and top-active custom quote-mint rates for the global ticker. |
| /v1/quote-mints/:quote_mint | One retained quote-mint row with address, name, symbol, quote/SOL rate, latest Jupiter total supply, USD market cap and holder count, first-pool creation time, cached social links and tags, and active-token fields. |
| /v1/quote-mints/:quote_mint/charts | Ten-minute cached quote-rate and Jupiter holder-count history with aligned SOL/USD samples for single-request quote-mint charts. |
| /v1/tokens/:token/events | Paginated events for the mint. |
| /v1/tokens/:token/mint | Cached mint metadata, token classification and retained classified core sweep totals, count and latest timestamp. |
| /v1/tokens/:token/rpc | Live Solana mint-account metadata, authorities, supply and holder counts. |
| /v1/programs | Retained upstream router/integration activity. Terminal protocol and liquidity-venue programs are excluded. |
| /v1/programs/:program/rpc | Program-owned Solana RPC hydration: getAccountInfo is cached once in the name-anchored program accumulator, getBalance is reused for 30 seconds, and token balances are fetched per request. |
| /v1/programs/:program/program | Filesystem-backed program profile and deployment metadata plus current retained routing and execution activity, including approximate unique routed-buy tokens across the retention window. |
| /v1/programs/:program/charts | Read-only wall-clock hourly routing buckets covering the configured Redis retention window, with buy/sell flow and exact unique traders from the compact program shadow plus approximate unique routed-buy tokens from hourly program HyperLogLogs. |
| /v1/programs/:program/accounts | Paginated accounts observed by the program read model, with routing and execution scopes. |
| /v1/programs/:program/events | Paginated cached events from the exact route-program index; this endpoint never traverses the full retained event window. |
| /v1/overview/trends | Trend insights for peak trade and creation activity, selected-window creates and decoded AMM migration completions. |
| /v1/overview/charts | Slim chart buckets for buy/sell flow, token categories and unique accounts. |
| /v1/overview/widgets | Widget buckets for meme coin, mayhem and charity categories, including separate earned/allocated, Core swept and claimed fee stages. |
| /v1/resolve | Address-kind resolution for accounts, mints, programs and bonding curves, including bonding-curve-to-mint resolution and optional redirects to dedicated views. |
| /v1/token-rates | Cached SOL/USD rate; add ?mints=<a,b,c> for decimals and quote-per-SOL rates on a batch of specific retained quote mints. |
| /v1/ws/events | Topic-based live event WebSocket. Subscribe to events.all or events.mayhem; the Mayhem topic contains exact-wallet Mayhem trades and Pump Mayhem burns. |
| /v1/ws/metrics | Topic-based 3-second snapshot WebSocket. Subscribe to metrics.overview, metrics.mayhem, or both. |
Window semantics
- Day endpoints accept day_start_ms and day_end_ms when a caller needs an explicit UTC millisecond window.
- Overview endpoints accept window_start_ms, window_end_ms, bucket_count and bucket_size_ms.
- Service time windows use half-open semantics: start is included, end is excluded.
- Recent event and accumulator retention is capped by the service cache TTL configuration.