PumpRobin Trading API

Introduction

Welcome to the PumpRobin.fun API docs for builders. Use these routes to index launches, mirror bonding-curve activity, or power bots and dashboards on Robinhood Chain.

Base URL (local): http://localhost:3000
Production: https://pumprobin.fun

Inspired by the structure of the Robinhood Crypto Trading API docs — adapted for an open launchpad, not custodial brokerage trading.

Authentication

Public read endpoints (GET /api/tokens, trades, stats, analytics) require no API key.

Admin routes (/api/admin/*) use a password session cookie. Set ADMIN_PASSWORD and ADMIN_SESSION_SECRET in env, then POST /api/admin/login.

Unlike Robinhood Crypto's x-api-key / x-signature / x-timestamp Ed25519 scheme, PumpRobin public trading reads are open; onchain settlement uses your wallet.

Pagination

Robinhood Crypto APIs return cursor pages with next / previous URLs and a results array.

PumpRobin currently returns full collections for tokens and trades. For large datasets, filter with GET /api/trades?token=0x…. Cursor pagination may be added later in the same next / previous style.

// Robinhood-style page shape (reference)
{
  "previous": null,
  "results": [ /* … */ ],
  "next": "https://api.example.com/items/?cursor=…"
}

Rate limiting

Be a good citizen: cache GET responses, avoid tight polling loops, and prefer event-driven updates when indexing. Abuse may result in temporary blocks at the edge.

Error responses

Errors return JSON with an error string and an appropriate HTTP status (400 validation, 401 admin auth, 404 missing resource).

{ "error": "name, symbol, and creator are required" }

Endpoints

{
  "tokens": [ /* Token[] */ ],
  "trades": [ /* Trade[] */ ],
  "count": 0
}

{
  "name": "Example",
  "symbol": "EX",
  "creator": "0x…",
  "imageUri": "",
  "description": ""
}

{ "trades": [ /* Trade[] */ ] }

{
  "tokenAddress": "0x…",
  "trader": "0x…",
  "isBuy": true,
  "amount": 0.01
}

{ /* PlatformStats */ }

{
  "stats": { /* … */ },
  "volumeSeries": [],
  "graduationSeries": []
}