Base paths
The frontend proxies service endpoints under /v1. Several dashboard route handlers also expose /api/v1/* wrappers for no-store browser reads.
Response shapes are designed for the PumpScan application and 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 owner, curve status and 30-second SOL balance hydration. No per-token balance data. |
| /v1/accounts/:account/account | Cached PumpVibe account roles, trade totals, claims and cashback earnings. |
| /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 on-chain 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/tokens/:token/events | Paginated events for the mint. |
| /v1/tokens/:token/mint | Cached mint metadata and token classification. |
| /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. |
| /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/top | Top account and mint rows for the compact top dashboard. |
| /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. |
| /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/sol-rate | Cached SOL/USD rate used for quote normalization and display. |
| /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. |
| /v1/ws | Compatibility event WebSocket that starts subscribed to events.all. |
| /v1/ws/overview/mayhem | Compatibility event WebSocket that starts subscribed to events.mayhem. |
| /v1/ws/overview | Compatibility metrics WebSocket that starts subscribed to metrics.overview and accepts the legacy refresh command. |
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.