Read data
Coins, trades, holders, candles, curve state and the Exit Queue.
All reads are GET requests with your key.
Coins
GET /api/v1/coins?sort=active|new|graduated&limit=20&pair=SOL
Coins on woop, most active first by default. pair filters by a pair's symbol or mint.
GET /api/v1/coins/{mint}
One coin: name, ticker, image, pair, price, market cap, liquidity, holders, 24h volume and move, how far along the curve it is, and what holding it has paid.
Trades, holders, candles
| Endpoint | Returns |
|---|---|
/coins/{mint}/trades?limit=60 | The newest trades. Fair Block orders, Exit Queue fills and fair launch shares are tagged in via |
/coins/{mint}/holders | The biggest holders: share, since when, what each bought, sold and earned, and their PnL |
/coins/{mint}/candles?tf=60 | Market-cap candles in USD. tf in seconds: 1, 5, 15, 30, 60, 300, 900, 1800, 3600 or 14400 |
The curve
GET /api/v1/coins/{mint}/curve?wallet=…
The woopcurve's state: its status (opening, trading, graduated and so on), how much it has raised and needs to graduate, market caps, the open Fair Block, the fees and the creator's lock. With wallet, that wallet's position too.
The Exit Queue
GET /api/v1/coins/{mint}/queue?wallet=…: see Exit Queue.
Positions, payouts, events, signals
| Endpoint | Returns |
|---|---|
/coins/{mint}/positions/{wallet} | One wallet in the coin: holding, paid, got, profit or loss (Position) |
/coins/{mint}/payouts | The hourly payouts to holders (Payout) |
/coins/{mint}/events | Holder payouts, promoter fees, Fair Blocks, Exit Queue fills and creator fees, oldest first (Event) |
/coins/{mint}/signals | Rug signals: dev-linked wallets, snipers, bundled buys, who funded the creator (Signals) |
Wallets
GET /api/v1/wallets/{wallet}/portfolio
Every woop coin the wallet holds or earned from, with what each is worth and has paid it, and totals (Portfolio).
Every field of every response is on Objects.
Pairs, tickers, you
| Endpoint | Returns |
|---|---|
/pairs | Pairs a coin can launch on |
/tickers/{symbol} | Whether a ticker is free (a taken one costs 1 SOL, paid to its holders) |
/me | Your key's wallet, its usage, and the coins it launched |
/launches | The coins your key's wallet launched through the API |