MCP server for live crypto derivatives data from bykaranteli.com: funding rates, funding arbitrage, open interest pressure, liquidations, options, ETF flows, Fear & Greed and BTC dominance. 49 read-only tools, free account key, paid depth via plans or x402.
Strong tool naming (all verb-prefixed: get_*) and comprehensive descriptions (avg 180 chars, well above 34-char baseline). All 8 tools have clear, actionable descriptions explaining WHEN to call them and WHAT they return. Input schemas present for all tools with proper type declarations. However, parameter descriptions are sparse or missing in several tools (e.g., get_liquidations 'symbol' param lacks format guidance; get_pressure_scores 'limit' lacks min/max bounds). Output schemas are not explicitly documented in the source, responses are inferred from API behavior. Error handling is present (InputError class, HTTP status codes, timeout logic) but recovery guidance is minimal. No destructive operations, so confirmation patterns not applicable. Overall solid foundation with room for parameter constraint documentation.
Returns daily net inflow/outflow totals in USD for spot ETFs tracking Bitcoin, Ethereum, Solana, and XRP, recorded from public filings and exchange data. One row per finalized UTC day and asset; history begins 2024-01-10 and grows daily.
Returns funding rate arbitrage opportunities: symbols where the spot price is significantly lower than the perpetual price, so a trader could buy spot and short the perp to earn the funding rate spread. Refreshed every 1–2 minutes.
Returns current funding rates for all Binance USDT-M perpetuals, or filtered by symbol. Funding rate is the interest paid between long and short traders every 8 hours; positive means longs pay shorts (bearish signal), negative means shorts pay longs (bullish signal). Refreshed every 1–2 minutes.
Call this when the user asks how much was liquidated in crypto futures, whether longs or shorts got flushed, or for liquidation history. Returns daily long and short liquidation totals in USD per symbol and exchange, recorded from ByKaranteli's own stream collectors on every liquidation venue it counts, listed on bykaranteli.com/coverage (recorded events, a floor, not estimates). One row per finalized UTC day, symbol and exchange; history begins 2026-07-30 and grows daily.
Call this when the user asks about overall crypto market sentiment or macro state: the Fear & Greed index (today and yesterday), Bitcoin dominance percentage, total market cap, or the Retail Euphoria composite. Live values refreshed about every 30 minutes.
Output schemas not documented in source code. Responses are inferred from API behavior; LLMs cannot see what fields to expect without calling the tool first.
Parameter constraints missing or vague. 'limit' in get_pressure_scores lacks min/max bounds (default 20, max 100 mentioned in description but not in schema). 'symbol' in get_liquidations lacks format guidance (BTCUSDT vs BTC vs btcusdt).
Error recovery guidance minimal. InputError class exists but error messages are generic ('Invalid input: ...') without actionable next steps. No guidance on retryability or user-fixable vs fatal errors.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 64 | 2026-07-28+ | v2 |
Returns a detailed explanation of a metric: what it means, how to interpret it, what values are normal or extreme, and how it relates to market sentiment. Useful when the user asks 'what does funding rate mean?' or 'how do I read the Fear & Greed index?'
Returns open interest pressure scores for the top symbols by open interest. Pressure is a composite of funding rate, open interest change, and liquidation flow; positive means longs are under pressure (bearish), negative means shorts are under pressure (bullish). Refreshed every 1–2 minutes.
Returns the top movers by open interest change in the last 24 hours: symbols where open interest grew or shrank the most. Useful for spotting emerging trends or capitulation. Refreshed every 1–2 minutes.
Result truncation at 240k chars returns guidance instead of data, but no pagination mechanism offered. Agents cannot narrow queries systematically, they must guess at parameters.
API key handling via environment variable or parameter is functional but not documented in tool descriptions. Agents cannot know whether auth is required or optional.