Monthly plans

One plan covers the REST API and the MCP tools, on one credit balance. Credits roll over. Internal and product use is included on every paid plan; redistributing or reselling the raw rows to third parties needs Scale or Enterprise.

Plan	Price	Credits / month
BUILDER	$29/mo	100,000	Subscribe
GROWTH	$99/mo	500,000	Subscribe
SCALE	$249/mo	2,000,000	Subscribe

Free to start: keyless MCP, plus a free key with 1,000 credits, no card. Get a free key →

One-off instead of a plan? Credit packs, never expire: $10 = 5,000 · $49 = 50,000 · $199 = 250k. MCP + REST share one balance. Pro ($15/mo) is the website, a separate product, and does not include MCP or API access.

See it work, keyless

No key, no card, no account. Run this and you get the coins with unusual whale flow right now, each measured against its own baseline. It is the same radar the site runs.

# Coins with unusual whale flow right now (keyless) curl -s "https://coinlobster.com/api/public/whale-radar?window=4h"

Wire it into a bot or agent in minutes. Higher limits and the full-depth endpoints come with a plan above.

Your keys

Loading your account…

API keys

Loading your keys…

For funds & desks

Fund-grade whale intelligence, straight into your systems

Every executed whale trade · 15 exchanges + 3 chains + Hyperliquid · real time, one API
Both wallets on every Hyperliquid fill; profit we compute from its actual closing trades, not inferred from flow
Real forced-close liquidation trades across venues, not a model
Every signal logged and scored live, pull it and test it
Commercial use with approved redistribution · fund-grade volume and throughput

Enterprise feeds run into the thousands a month. One flat plan.

See developer plans

Quickstart

Manage keys in Your keys above, or register by API. Each key is shown once.

# 1. Register (email in, Stripe checkout link out) curl -X POST https://coinlobster.com/api/ai/v1/register \ -H "Content-Type: application/json" \ -d '{"email":"[email protected]","pack":"starter"}' # or subscribe: swap the body for {"email":"[email protected]","tier":"builder"}

# 2. Call an endpoint with your key curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://coinlobster.com/api/ai/v1/whales/tape?coin=BTC&limit=100"

MCP (Model Context Protocol)

No key needed. Point an MCP client at the URL below for 28 read-only tools: whale trades, radar, signal outcomes, flow, perp liquidations, DeFi lending liquidations, on-chain DEX swaps, Hyperliquid named wallets, funding, squeeze score, projected liq zones, market snapshot, screener, history and news. Tool calls draw on the same monthly credit allowance as the REST API, at 2x the mirrored endpoint's rate (40 to 100 credits per call), because one user prompt fans out into roughly ten tool calls. Keyless calls, discovery and failed calls are free. Full depth needs a paid developer plan from this page, and the same plan also covers the REST API. A free key does not lift it, and neither does the $15/mo Pro website subscription. Per-client setup: coinlobster.com/connect.

Server URL: https://coinlobster.com/mcp

// Example client config (Claude Desktop / any MCP-HTTP client) { "mcpServers": { "coinlobster": { "url": "https://coinlobster.com/mcp" } } }

22 endpoints

Every call deducts its credit cost.

Whales (6)

GET /api/ai/v1/whales/tape	Merged CEX + on-chain whale trades, full Pro depth: no delay filter, no $1M floorhot window ~7 days; rows exist since 2026-07-13 (CEX) / rolling 48h (DEX)	30 cr
GET /api/ai/v1/whales/flow-history	Daily whale-flow history per coin: total, buy and sell USD per UTC day (?coin=BTC required)grows daily; days exist since 2026-07-07; a day only appears when capture was verifiably up	30 cr
GET /api/ai/v1/whales/context	Vs-own-history stats per coin: 24h flow multiple, N-day high, buy mix, net flow, market breadth (?coin optional)derived hourly from the flow history; windows are each coin's real logged days	20 cr
GET /api/ai/v1/whales/radar	Smart Money Radar: per-coin whale flow vs baseline across 1h/4h/24h windowssnapshot refreshes ~30s	30 cr
GET /api/ai/v1/whales/flow/:coin	Hourly CEX/DEX buy-sell USD buckets for one coin30-day rolling hourly window	30 cr
GET /api/ai/v1/analytics/whale-trades	Large trades (min size configurable) with exchange, direction and net flow	30 cr

Signals (2)

GET /api/ai/v1/analytics/signals	Raw fired signal-log rows: whale spikes, funding extremes, squeeze flips, liquidation cascades, flow divergence, and major single-trade and percentile flags, with fire-time price and outcomesfire-time rows, never backfilled; live since 2026-07-13	50 cr
GET /api/ai/v1/signals/:type/:coin	Every historical firing of one signal type on one coin, with outcomesfire-time rows, never backfilled; live since 2026-07-13	30 cr

Market (8)

GET /api/ai/v1/market/ticker	Latest price, 5m volume, funding rates and open interest for any pair	10 cr
GET /api/ai/v1/market/pairs	All supported trading pairs and exchange mappings	10 cr
GET /api/ai/v1/market/config	Full market configuration	10 cr
GET /api/ai/v1/market/orderbook	Combined orderbook merged across exchanges	20 cr
GET /api/ai/v1/market/trades	Recent trades across all exchanges	20 cr
GET /api/ai/v1/market/funding-rates	Funding rates plus long/short sentiment across futures exchanges	20 cr
GET /api/ai/v1/market/open-interest	Open interest per exchange and totals	20 cr
GET /api/ai/v1/market/liquidations	Recent liquidations with long/short breakdown	20 cr

News (4)

GET /api/ai/v1/news/summary	AI-generated news briefing with sentiment	50 cr
GET /api/ai/v1/news/headlines	Raw crypto news headlines	10 cr
GET /api/ai/v1/news/sentiment	Sentiment score for a coin plus macro	30 cr
GET /api/ai/v1/news/ohlc	7-day hourly OHLC candle data	20 cr

DeFi (2)

GET /api/ai/v1/defi/summary	24h DeFi trading summary	30 cr
GET /api/ai/v1/defi/top-tokens	Top DeFi tokens by 24h volume	20 cr

Free, permanently

No key, no signup, rate-limited per IP. These stay free.

GET /api/public/crypto-whales	$100K+ exchange whale trades, trimmed shape	Free
GET /api/public/onchain-whales	On-chain DEX swaps, Ethereum / Base / Arbitrum, $250K+ teaser rows	Free
GET /api/public/defi-summary	Per-chain DEX volume and TVL, top tokens, whale swap activity	Free
GET /api/public/liquidations	Market-wide perp liquidations: 24h long vs short, hourly series, top coins, the Hyperliquid wallets closed out. Lending rides on a separate lane, never summed in	Free
GET /api/public/defi-liquidations	Aave V3 lending liquidations, both wallets named on every row	Free
GET /api/public/hyperliquid/whales	Hyperliquid whale fills with the wallet address attached	Free
GET /api/public/hyperliquid/board	Tracked Hyperliquid accounts: equity, leverage, net bias	Free
GET /api/public/whale-radar	Smart Money Radar, free shape (magnitude stripped on locked coins)	Free
GET /api/public/receipts/:type/:coin	Signal log outcome aggregates: how the last N clean firings went	Free
POST /mcp	28 read-only market-data tools over the Model Context Protocol, keyless	Free

FAQ

What's in the whale feed?

/whales/tape merges CEX and on-chain whale trades in the same Pro shape the terminal uses: no delay filter, no $1M floor. Hot window is about 7 days; rows exist since 2026-07-13 on the CEX side, a rolling 48h on the DEX side.

What is the signal log?

Every fired flag (whale spike, funding extreme, squeeze flip, liquidation cascade, flow divergence, and major single-trade and percentile flags) is logged at fire time with its price and magnitude. The outcome gets appended later; the row is never recomputed or reshaped. Outcomes are appended when they are measured. Recording started 2026-07-13.

Can I use the data commercially?

Yes, for your own internal or product use, on every paid plan. Redistributing or reselling the raw rows to third parties (public feeds, resale, a data product) needs Scale or Enterprise. Roughly, each REST call costs 10 to 50 credits, so a plan's monthly credits are a few thousand to tens of thousands of calls. Plans: Builder ($29/mo, 100k credits), Growth ($99/mo, 500k credits), Scale ($249/mo, 2M credits).

What happens when my credits run out?

Plan credits refill on your billing date and unused credits roll over. Run dry mid-cycle? Top up with any credit pack (POST /api/ai/v1/credits/purchase), or upgrade your plan. Requests return a 402 with your balance, never a surprise charge.

How is my key handled?

After payment, poll the register/status endpoint: your raw key is shown exactly once, then only a masked version comes back. Store it securely. Lost it? Revoke it yourself in Your keys and create a new one. No support ticket, no waiting.