REST API

Tokens, external markets, portfolio, discovery, and rate-limit buckets.

JSON REST with wallet auth. Dual mount / and /api/*. Errors: { "success": false, "data": null, "error": "message" }.

List and detail

bashlist-tokens.sh

# Paginated list (sort: trending|newest|mcap|volume|curve|graduated)
curl -sS "${API_URL}/tokens?page=1&limit=20&sort=trending"

curl -sS "${API_URL}/tokens/trending?limit=20"
curl -sS "${API_URL}/tokens/0xToken"
curl -sS "${API_URL}/tokens/0xToken/chart?interval=1m"
curl -sS "${API_URL}/tokens/0xToken/trades?limit=50"
curl -sS "${API_URL}/search?q=exmpl&limit=10"
curl -sS "${API_URL}/stats"
curl -sS "${API_URL}/leaderboard?limit=50"

# External market display (non-Trancepad ERC-20s) and OG image
curl -sS "${API_URL}/market/external/0xToken"
curl -sS "${API_URL}/market/external/0xToken/chart?interval=1h"
curl -sS -o token-og.png "${API_URL}/og/token/0xToken"

Portfolio

bashportfolio.sh

# Public by wallet query, or JWT without query
curl -sS "${API_URL}/portfolio?wallet=0xYourWallet"
curl -sS "${API_URL}/portfolio" -H "authorization: Bearer $JWT"

Route groups

Tokens: list, trending, new, detail, chart, trades, holders, comments, create (JWT), patch metadata (JWT), uploads (JWT).
External markets: GET /market/external/:address and /chart for third-party display data (GeckoTerminal). Address required. Not settlement. See External markets.
OG images: GET /og/token/:address returns image/png (not the JSON envelope). Unknown tokens get a branded fallback.
Trading: POST /buy, POST /sell (JWT, receipt sync), GET /transactions.
Raises / governance: list, detail, register, commit, propose (JWT on writes).
Fee staking: pools, positions, stake/unstake/withdraw/claim/fund sync.
Discovery / social: leaderboard, stats, search, launchpad feed, comments, likes, follows, notifications. Public ambassador apply: POST /ambassador-applications (admin review is operator-only).
Health / RPC: GET /health, POST /rpc.

Rate limits: global plus auth, upload, trade, launch, ambassador, and read-heavy buckets. Exact windows live in backend/src/routes/index.ts. Contributor reference: docs/api.md in the repo.