22 endpoints · keyless MCP · permanent free tier
The whale data layer
Executed whale trades across 15 exchanges and 3 chains, unusualness flags, and outcomes, logged live and never backfilled.
Plan & credits
Loading your account…
API keys
Loading your keys…
Plans
10 to 50 credits per REST call, 40 to 100 per MCP tool call, from one shared balance. Plans refill monthly, roll over, and allow commercial use.
Using this through Claude or ChatGPT? That is the MCP surface. Keyless is free, and the plans below cover it too: tool calls draw on the same credit balance, so one plan covers both. Pro ($9/mo) is the website and does not include MCP or API access. Connector setup →
| Plan | Price | Credits / month | |
|---|---|---|---|
| KEYLESS | $0 | Public whale surfaces + the MCP server (see below) | no key needed |
| FREE KEY | $0 | 1,000 credits once, no card (about 20 to 100 calls) | Get a free key |
| BUILDER | $29/mo | 100,000 | Get Builder |
| GROWTH | $99/mo | 500,000 | Get Growth |
| SCALE | $249/mo | 2,000,000 | Get Scale |
Or pay per request, no subscription:
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 16 read-only tools: whale trades, radar, signal outcomes, flow, liquidations, funding, squeeze score, projected liq zones, market snapshot, screener, history, news and more. 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 $9/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-ledger 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/whale-radar | Smart Money Radar, free shape (magnitude stripped on locked coins) | Free |
| GET /api/public/receipts/:type/:coin | Signal ledger outcome aggregates: how the last N clean firings went | Free |
| POST /mcp | 16 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 ledger?
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. Live since 2026-07-13, never backfilled.
Can I use the data commercially?
Yes. Every paid plan and credit pack allows commercial use. Plans differ in monthly credits: 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.
