Cryptohopper MCP

The Cryptohopper MCP server gives AI assistants live and historical crypto market data: candles, tickers, orderbooks and market details from the exchanges Cryptohopper supports. Connect it to Claude, ChatGPT, Cursor or any other client that speaks the Model Context Protocol.

Server URL
https://mcp-data.cryptohopper.com/mcp
Transport
Streamable HTTP
Sign-in
OAuth 2.1 or API key
Access
Read-only market data

Connect your AI client

Claude and ChatGPT sign in with OAuth. Add a custom connector with the server URL above and approve access with your Cryptohopper account. You do not need an API key.

Claude Code, Cursor and other clients send an API key in the Authorization header. Replace mcp_your_api_key with your own key.

claude mcp add --transport http cryptohopper-market-data \
  https://mcp-data.cryptohopper.com/mcp \
  --header "Authorization: Bearer mcp_your_api_key"

API keys

Create a key in your Cryptohopper account: open Edit profile and go to the MCP API Keys tab. Keys start with mcp_ and are shown only once, so store yours right away. The same tab shows your current plan limits and lets you revoke a key.

Send the key as Authorization: Bearer mcp_.... All keys of one account share the same rate limits.

Tools

All tools are read-only. Pairs are given as base and quote (for example BTC and USDT) and exchanges by their lowercase name (for example binance). Times are ISO 8601 or Unix milliseconds.

ToolWhat it returnsArguments
get_candlesOHLCV candles for a pair: the latest candle, the latest N, or a historical range. Periods 1m, 5m, 15m, 1h, 4h and 1d.exchange, base, quote, period, limit, start, end
get_tickerLast price, bid, ask, 24h high, low, volume and change. Latest or a historical range.exchange, base, quote, start, end, period
get_orderbookBids and asks as [price, volume] pairs. Latest snapshot or historical snapshots, with an optional depth limit.exchange, base, quote, start, end, period, limit
list_exchangesAll supported spot exchanges with the time of their last health check.none
list_marketsAll trading pairs on an exchange with precision, order size limits and fees.exchange
get_marketThe market definition of one pair: price and amount precision, order limits and maker/taker fees.exchange, base, quote
list_quote_currenciesThe quote currencies of an exchange and the base currencies paired with each.exchange
get_usageYour plan, requests used this minute and this week, and when the weekly budget resets.none

Data

  • Spot markets only. Futures, margin and derivatives data are not available.
  • The minimum resolution is 1 minute. Latest data is updated about every minute.
  • Historical candles go back up to 3 years, depending on your plan.
  • Exchanges: Binance, Binance US, Bybit, Coinbase, Crypto.com, KuCoin, Kraken, Bitmart, OKX, HTX, Bitvavo, BingX and Poloniex.

Plans and limits

Your MCP allowance follows your Cryptohopper subscription.

PlanRequests per minuteWeekly budgetHistoryAPI keysExchanges
No subscription (free)156,000None13
Explorer6030,00090 days18
Adventurer200150,000365 days3All
Hero6001,250,0003 years10All

The weekly budget resets every Friday at 00:00 UTC. Historical queries use more of the budget than requests for the latest data. Responses carry X-RateLimit-Remaining and X-RateLimit-Reset headers, and a 429 response carries Retry-After. Ask your assistant to call get_usage to see where you stand.

Questions

Is the Cryptohopper MCP free?

Yes. Every Cryptohopper account can use it: without a subscription you get 6,000 requests per week for 3 exchanges, without historical data. Explorer, Adventurer and Hero raise the limits and add history.

Can my AI agent place trades through the MCP?

No. The MCP server is read-only: it serves market data and never touches your bots, orders or exchange keys. To manage hoppers and orders from code, use the Cryptohopper REST API.

Which exchanges are supported?

Binance, Binance US, Bybit, Coinbase, Crypto.com, KuCoin, Kraken, Bitmart, OKX, HTX, Bitvavo, BingX and Poloniex. Ask your assistant to call list_exchanges for the live list.

Does it include futures data?

No. The MCP serves spot markets only, at a minimum resolution of 1 minute.

More about what you can do with it: Cryptohopper MCP.