Content
# Crypto Market Data MCP Server
[](https://mcpize.com/mcp/crypto-market-data)
A **read-only** [Model Context Protocol](https://modelcontextprotocol.io) server that
gives any AI agent (Claude, Cursor, Cline, Windsurf…) live cryptocurrency market data
across 100+ exchanges via [CCXT](https://github.com/ccxt/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:
```bash
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**](https://mcpize.com/mcp/crypto-derivs-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
```bash
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_id` and a **tier**; unknown/missing keys get `401`.
- 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):
```bash
# 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-USDT`
all 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.
