PumpRobin Trading API

Introduction

Welcome to the PumpRobin.fun API docs for builders. Use these routes to index launches, mirror Uniswap 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.

POST /api/tokens is an indexer, not a mint. Send the txHash of a confirmed PumpRobinFactory.createToken transaction that paid the creation fee and LP seed. Name, symbol, creator, and token address are taken from the on-chain TokenCreated event — unsigned JSON is rejected.

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 reads are open; launches and trades settle in 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 missing on-chain proof, 404 missing resource, 405 disabled simulation).

{ "error": "Indexing requires txHash from a confirmed PumpRobinFactory.createToken transaction." }

Endpoints

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

{
  "txHash": "0x…",
  "description": "",
  "metadata": { "twitter": "https://x.com/…" }
}

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

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

{ /* PlatformStats */ }

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