canonical: https://jentic.com/apis/coinlobster.com/coinlobster # CoinLobster Crypto Data API The CoinLobster Crypto Data API tracks crypto whale activity and market structure in real time. It serves a merged tape of large trades across centralized exchanges and on-chain DEX venues, a Smart Money Radar that flags coins with unusual whale flow, live price, orderbook, funding-rate and open-interest data, and a ledger of scored trading signals. It also returns AI-generated news summaries and sentiment, DeFi analytics, and lets you arm standing watches that push alerts to your webhook. Many endpoints are credit-metered, with a set of public endpoints that need no key. ## For AI agents Track crypto whale trades, market data, funding rates, scored trading signals, and news sentiment across centralized and on-chain venues. Agents can also arm standing watches that notify a webhook. ## Scope Does not handle order execution, custody, or fiat on-ramps. Use for crypto market data, whale tracking, and trading signals only. ## Capabilities - Track large whale trades across centralized and on-chain DEX venues from a merged tape - Read live price, combined orderbook, funding rates, and open interest for trading pairs - Pull scored trading signals such as whale spikes, funding extremes, and liquidation cascades - Follow per-coin whale buy/sell flow history and the Smart Money Radar - Get AI-generated crypto news summaries, headlines, and sentiment scoring - Arm standing watches that push to your webhook when a condition fires - Query DeFi and on-chain analytics including DEX volume and top tokens by chain ## Use cases ### AI Agent Whale Monitoring An AI agent connected through Jentic can pull the merged whale tape and the Smart Money Radar on demand to watch for large positioning changes. The agent searches for the operation it needs, CoinLobster returns the matching endpoint and input schema, and the agent calls it with a stored key. This lets a market assistant surface unusual whale flow without a human watching a terminal. Example prompt: Fetch the merged whale tape for a pair and flag any single trade above 1,000,000 USD ### Trading Signal Automation Read the signal ledger of fired flags, each with its fire-time price and later outcome, and drill into every historical firing of one signal type on one coin. This supports automations that react to whale spikes, funding extremes, squeeze flips, and liquidation cascades. Example prompt: Retrieve the fired signals for a coin and summarise the squeeze and liquidation flags ### Cross-Exchange Market Data Get a combined orderbook and recent trades aggregated across the supported exchanges, plus funding rates, open interest, and liquidations from the futures venues. This gives an agent one consistent market view instead of polling each exchange separately. Example prompt: Get the latest ticker and combined orderbook for a trading pair ### Standing Watches with Webhooks Arm a standing watch on a coin so CoinLobster pushes an alert to your registered webhook when the watched condition fires. Agents can list the active watches on a key and remove ones that are no longer needed. Example prompt: Arm a watch on a coin and confirm it appears in the list of active watches ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/whales/tape` | Merged CEX and DEX whale tape | | GET | `/market/ticker` | Latest price and market stats for a pair | | GET | `/analytics/signals` | Fired signal-ledger flags | | GET | `/whales/radar` | Smart Money Radar per coin | | GET | `/news/sentiment` | AI sentiment analysis for a coin | | POST | `/watches` | Arm a standing watch | | GET | `/credits/balance` | Remaining credit balance | | GET | `/market/funding-rates` | Funding rates across futures exchanges | ## Key resources - **Whales** — Merged CEX and on-chain whale tape, Smart Money Radar, and flow history - **Market** — Price, combined orderbook, funding rates, open interest, and liquidations - **Analytics** — Scored signal ledger and per-type firing history - **News** — AI-generated summaries, headlines, and sentiment scoring - **Watches** — Standing watches that push to a webhook when they fire ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 57 / 100 - **Maturity:** Foundational - **Dimensions:** - Foundational Compliance: 49 / 100 - Developer Experience & Jentic Compatibility: 58 / 100 - AI-Readiness & Agent Experience: 42 / 100 - Agent Usability: 93 / 100 - Security: 60 / 100 - AI Discoverability: 73 / 100 - **View full report:** https://jentic.com/apis/coinlobster.com/coinlobster/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring CoinLobster by hand means registering for a Bearer API key, tracking credit costs per call, and separating the public endpoints from the metered ones. Through Jentic you install once, import CoinLobster from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** CoinLobster's standing-watch operations (arming and removing watches) are separate from its read-only market, whale, and signal endpoints, so a rule can hold your agent to the data reads it needs. You choose the operations it may call, so arming or removing a watch is not included unless you add it. - **Credential handling:** Your CoinLobster API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'get whale trades' or 'read funding rates', and Jentic returns the matching CoinLobster operation with its input schema so the agent calls the right endpoint without reading the reference docs. ## Related APIs - **Bitculator Data API** — Broad crypto market data with indicators, sentiment, and liquidations. - **CoinGecko** — Free, broad crypto market data covering prices, coins, and exchanges. - **CoinMarketCap** — Market caps, prices, and rankings for a large coin universe. - **Binance** — Exchange API for live order books and trade execution. ## FAQ ### What authentication does the CoinLobster API use? CoinLobster authenticates with a Bearer API key per its OpenAPI spec: register for a key and send it in the Authorization header. A set of public endpoints that back the web terminal need no key, while the metered data endpoints do. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time, so it never reaches the agent's prompt. ### Can I track whale trades with the CoinLobster API? Yes. The merged whale tape combines large centralized-exchange trades and on-chain DEX swaps, and the Smart Money Radar surfaces coins with unusual whale flow versus their own baseline. Per-coin daily flow history and hourly buy/sell buckets are available too. ### Is there a CoinLobster MCP server? CoinLobster exposes an MCP endpoint, and you can also connect it directly through Jentic from the API Directory. Import the API, store your key once, and your agent calls the endpoints it needs without loading another server's tool definitions into its context. ### Can I limit what my agent is allowed to do with the CoinLobster API? Yes. Write a rule that allows only the market, whale, and signal read operations, so the agent can pull data while the credit-spending watch operations stay out of reach, and every call it makes is logged. ### What are the rate limits for the CoinLobster API? The OpenAPI spec does not publish request-rate limits. CoinLobster meters usage with credits per call instead, and exposes a credit-balance endpoint and a pricing endpoint you can read. See coinlobster.com for current credit costs and plan allowances. ### How do I get whale trades with the CoinLobster API through Jentic? Search Jentic for an intent like 'get whale trades', and it returns the CoinLobster whale-tape operation with its input schema so your agent calls it with a pair. Your stored key is injected at call time. To run it on your own infrastructure, install Jentic One from its GitHub repo.