Skip to main content

Launchpad API

The Launchpad API is a backend service that indexes blockchain events from the Launchpad and AMM contracts into a TimescaleDB database. It provides fast, pre-formatted REST endpoints and real-time Server-Sent Events (SSE) for frontends and bots.

Base URL

http://67.205.164.156:3001

Why Use This Instead of Chain API?

The Chain API (port 1317) gives you raw blockchain state. The Launchpad API gives you pre-indexed, enriched data that’s ready to display:
NeedChain APILaunchpad API
List all tokens with pricesQuery each contract individuallyGET /api/tokens — one call
Trade history for a tokenSearch events, parse wasm logsGET /api/trades/recent?token_address=...
OHLCV candlestick chartsNot availableGET /api/candles/:address
Real-time trade feedWebSocket + event parsingGET /api/sse/feed — ready-to-use events
Token 24h volumeAggregate from raw tradesPre-computed in token response

Authentication

All endpoints are public. No API key required.

Rate Limits

WindowMax Requests
60 seconds100 per IP
Rate limit headers are included in responses:
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1708300000

Health Check

curl http://67.205.164.156:3001/api/health
{
  "status": "ok",
  "timestamp": "2026-02-19T10:00:00.000Z"
}

Available Endpoints

SectionEndpoints
List TokensAll indexed tokens with metadata, prices, and 24h stats
Token DetailSingle token by contract address
TradesRecent trades, filterable by token
CandlesOHLCV candlestick data (1m, 5m, 1h, 1d)
SSE FeedReal-time trade, launch, and graduation events
WalletBalance, token holdings, transaction history, and broadcast

Data Sources

The API indexes events from two on-chain contracts:
SourceContractEvents Indexed
LaunchpadBonding curve contracttoken_created, buy, sell, buy_and_graduate, graduate
AMMConstant-product DEXswap (both directions)
The indexer polls the chain every ~5 seconds and writes all events atomically to the database. OHLCV candles are computed automatically by TimescaleDB continuous aggregates at 1-minute, 5-minute, 1-hour, and 1-day intervals.