API Reference

All endpoints are served by Next.js routes and return JSON. Unless noted, methods are GET and public.

Launches

• GET /api/launches?sortBy=newest|marketCap|price&order=asc|desc&limit&offset
  List tokens from the on-chain program. Returns name, symbol, mint, createdAt, and computed metrics (price, marketCapUsd) when available.

Home

• GET /api/home/stats
  Aggregated stats (tokens launched, total volume in SOL/USD, active users, royalties paid in SOL/USD).

Royalties

• GET /api/royalties/creator/balance?creator=<pubkey> — creator claimable balances.
• POST /api/royalties/creator/claim — body: { mint, amountLamports? } to claim creator royalties.
• GET /api/royalties/social/balance?token=<mint>&wallet=<pubkey> — social pool/claimable.
• POST /api/royalties/social/claim — body: { mint, recipient, lamports } with platform attestor.

Trading & Analytics

• GET /api/trading/sol-price — Returns { usd, source } with cache.
• GET /api/trading/summary?token=<mint> — Consolidated price/marketcap summary.
• GET /api/trading/curve?token=<mint> — Curve reserves and derived price.
• GET /api/portfolio/trades?wallet=<pubkey>&limit=300 — Buy/sell trades for a wallet (rate-limited parsing).

Tokens

• GET /api/tokens/[id] — token details by mint (augmented with metadata URI).
• GET /api/tokens/all — backend DB proxy (optional) for catalog.