Crypto Market Data MCP
eliasfire617/crypto-market-data-mcp
Dados de mercado cripto em tempo real de 100+ exchanges sem API keys
Ver no GitHubServidor MCP que fornece dados de mercado de criptomoedas em tempo real (preços, taxas de financiamento, open interest, ordem de livro, candles) de 100+ exchanges via CCXT, sem exigir chaves de API. Inclui ferramentas especializadas para análise de derivativos e identificação de oportunidades de arbitragem de funding.
Instalação
npx convez-ai eliasfire617/crypto-market-data-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Consultar preços spot e históricos de OHLCV em múltiplas exchanges
- Analisar taxas de financiamento de perpetuais e identificar oportunidades de arbitragem
- Monitorar open interest, long/short ratios e liquidações em tempo real
- Comparar profundidade de livro de ordens entre exchanges
Veredito

Ferramenta robusta e production-ready para acesso a dados cripto públicos com 13 tools bem estruturadas. O diferencial é o `compare_funding` que expõe oportunidades de arbitragem em uma única chamada. Ideal para traders, analistas e agentes que precisam de dados de derivativos e spot consolidados.
README
A tradução para o português deste README ainda está na fila.
Crypto Market Data MCP Server
A read-only Model Context Protocol server that gives any AI agent (Claude, Cursor, Cline, Windsurf…) live cryptocurrency market data across 100+ exchanges via CCXT. No API keys required — everything uses public endpoints.
Supported exchanges: bybit, binance, okx, hyperliquid, gate, kucoin (add more
CCXT ids in SUPPORTED_EXCHANGES).
Connect via MCPize
Use this MCP server instantly with no local installation:
npx -y mcpize connect @eliasfire617/crypto-market-data --client claude
Or connect at: https://mcpize.com/mcp/crypto-market-data
Tools (13)
Discovery
| Tool | What it does |
|---|---|
list_exchanges | Which exchanges are supported |
get_capabilities | Matrix of which exchange supports which data (no network) |
search_symbols | Find the exact symbol format for a coin |
Market data
| Tool | What it does |
|---|---|
get_price | Last price + 24h stats |
get_order_book | Top-of-book bids/asks |
get_ohlcv | Recent OHLCV candles |
get_recent_trades | Latest public trades |
Derivatives
| Tool | What it does |
|---|---|
get_funding_rate | Current perpetual funding rate |
get_funding_rate_history | Historical funding rates |
compare_funding | Funding rate across many exchanges + arb spread |
get_open_interest | Current open interest |
get_long_short_ratio | Global long/short account ratio (Binance) |
get_liquidations | Recent public liquidations (limited support) |
compare_funding is the differentiator: it surfaces funding-rate arbitrage
opportunities (which venue pays the most vs least) in one concurrent call.
Rates are annualized (apr_pct) before comparing — venues fund at different
cadences (Hyperliquid hourly vs 8h elsewhere), so raw rates aren't comparable.
Want the analysis, not just the data? The companion server Crypto Derivatives Intelligence builds on this data: funding-carry opportunities netted of fees (breakeven days, executable depth), OI-price divergence, liquidation zones, positioning extremes, and market-regime classification — one tool call each.
Robustness
Built for production, not a demo:
- Retries with exponential backoff on transient network errors (3 attempts).
- Per-request + overall timeouts (10s / 25s) so a hung exchange can't stall a call.
- Capability guards: never calls a method an exchange lacks — returns a clean
error listing which exchanges do support it (see
get_capabilities). - Structured errors (
{"error": {type, message, retryable, supported_exchanges}}) instead of crashes — agents always get a parseable response. - TTL response cache (~660x faster on repeat calls; eases rate limits).
- Input validation and clamped limits on every tool.
- Guaranteed exchange cleanup; logs to stderr only (safe for stdio transport).
Run locally
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
# stdio transport (Claude Desktop, Cursor, Cline) — local, no auth:
python server.py
# OR streamable HTTP (hosted / remote) — API-key auth + rate limiting ON:
python server.py --http # binds :8000 (override with PORT=8799)
Authentication & billing (HTTP mode)
The hosted HTTP transport is gated — this is what makes it billable. Local stdio stays open for single-user dev.
-
Clients send
Authorization: Bearer <api-key>. -
Each key maps to a
client_idand a tier; unknown/missing keys get401. -
Tiers (
auth.py→TIERS) set per-minute rate + monthly quota:Tier req/min monthly quota free 10 1,000 pro 120 100,000 ultra 600 2,000,000 -
Over the limit → a clean
ToolError(Rate limit exceeded…/Monthly quota exceeded…), never a crash.
Configure keys (either source; file wins):
# inline
export CRYPTO_MCP_API_KEYS="sk_live_abc:acme:pro,sk_live_xyz:jane:free"
# or a file (see api_keys.example.json)
export CRYPTO_MCP_API_KEYS_FILE=./api_keys.json
If no keys are set in HTTP mode, a throwaway demo key (tier=pro) is generated and printed to stderr so you can test immediately.
Behind a gateway (e.g. MCPize)
If you deploy behind a platform that already authenticates and rate-limits
subscribers, set CRYPTO_MCP_DISABLE_AUTH=1. The server then trusts the gateway
and skips its own auth + rate limiting — no double authentication, no double
throttling. Only do this when the container is reachable solely through that
gateway.
Use with Claude Desktop
Copy claude_desktop_config.example.json into your Claude Desktop config
(~/Library/Application Support/Claude/claude_desktop_config.json on macOS,
%APPDATA%\Claude\claude_desktop_config.json on Windows), adjusting paths.
Symbols
- Spot:
BTC/USDT - Perpetual:
BTC/USDT:USDT - Common shorthand is normalized automatically:
btc,BTCUSDT,BTC-USDTall work (funding/OI tools land on the perp form).
Roadmap
- Add more exchanges to
SUPPORTED_EXCHANGES. - More aggressive caching of hot symbols to cut latency.
- Optional websocket streaming for live order book / trades.