Crypto Market Data

io.github.zaffy18Published by GitHub account zaffy18v0.1.3Updated Oct 27, 2026

Live crypto market data and Hyperliquid wallet reports for AI agents, paid per call with x402.

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Live crypto market data, Hyperliquid wallet reports and 24-hour market watches for AI assistants, paid per call in USDC on Base via x402.

What you can do
  • Read live prices, derivatives, order book, liquidations, whale orders, news and sentiment for top coins
  • Get a combined snapshot of all metrics for a single coin
  • Pull an enriched Hyperliquid wallet report with positions, liquidation distance, risk label and PnL
  • Create, check and stop 24-hour watches on up to 10 conditions, with a signed webhook when one fires
  • Use free variants of prices and sentiment, plus service info and spending details
When to use it
Useful when an assistant needs current crypto market context — price moves, funding, liquidations, whale activity or news — or a risk read on a Hyperliquid wallet. Also fits monitoring setups where the assistant should be alerted when a market condition is met.
Requirements
Runs as a remote Streamable HTTP endpoint with no sign-up, or locally via npx crypto-market-data-mcp (Node.js). Paid tools need a wallet key in X402_PRIVATE_KEY holding USDC on Base; optional limits X402_MAX_PER_CALL_USD and X402_MAX_TOTAL_USD. Clients built with @x402/mcp pay automatically. Without a key, only the free tools work.
Before you install
Paid tools spend real money per call (USD 0.003 to 0.02) from the wallet behind X402_PRIVATE_KEY; use a dedicated wallet with a small balance and set the spending limits. create_watch sends a webhook to a destination you supply. Data is public market data and explicitly not financial advice.

Installation

In SourceWeft

  1. Open Crypto Market Data in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.zaffy18%2Fcrypto-market-data/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "crypto-market-data": {
      "type": "http",
      "url": "https://crypto-market-data.zafermemon87.workers.dev/mcp"
    }
  }
}

README

crypto-market-data-mcp

Live crypto market data and Hyperliquid wallet reports as MCP tools for Claude, Cursor, Codex, VS Code and any MCP client. Your agent pays per call, in USDC on Base, from its own wallet (x402). There is no account, no API key and no subscription, and a call that fails is never charged.

ToolReturnsPrice
pricesPrice and 5m/1h/4h/24h change, 24h volume, top 50 coins$0.003
derivativesFunding rate, futures premium, open interest, long/short ratio$0.003
orderbookSpread, order-book imbalance, buyer share$0.003
liquidationsEvery Binance futures liquidation of the last hour, by coin$0.003
whale_ordersBiggest market orders of the last hour, Binance and Hyperliquid$0.003
newsTop crypto stories now from 31 sources, with price reaction$0.003
sentimentFear and Greed, trending coins, breadth, mood$0.003
coin_snapshotAll of the above for one coin$0.005
hyperliquid_walletPositions, liquidation distance, risk label, PnL, volume for any address$0.01
create_watchUp to 10 conditions (price, % change, funding, open interest, liquidations, order book, Fear and Greed, whale orders, news impact) checked every minute for 24 hours; a signed webhook when one happens$0.02
watch_statusA watch's status and its last 20 firesfree
stop_watchStop a watchfree
service_infoWhat is offered and what this session has spentfree

Data refreshes every minute from 24/7 monitoring of Binance spot and futures, Hyperliquid and 31 news sources.

Connect without installing

Remote MCP server (Streamable HTTP, no sign-up): https://crypto-market-data.zafermemon87.workers.dev/mcp

Add it as a custom connector or remote server in Claude, ChatGPT, Cursor, VS Code or any MCP client. prices_free, sentiment_free and service_info are free. The other tools are paid per call with x402 over MCP, and clients built with @x402/mcp pay automatically.

Install

Claude Desktop, one click: download crypto-market-data.mcpb and open it. The wallet key is optional and is stored in your system keychain.

Claude Code:

claude mcp add crypto-market-data -e X402_PRIVATE_KEY=0x... -- npx -y crypto-market-data-mcp

Claude Desktop, Cursor or any MCP client (mcpServers config):

json
{  "mcpServers": {    "crypto-market-data": {      "command": "npx",      "args": ["-y", "crypto-market-data-mcp"],      "env": { "X402_PRIVATE_KEY": "0x...", "X402_MAX_TOTAL_USD": "1.00" }    }  }}

X402_PRIVATE_KEY is the key of a wallet that holds a little USDC on Base. No ETH is needed, because payments are gasless. Use a dedicated wallet with a small balance.

Spending limits

  • X402_MAX_PER_CALL_USD (default 0.02, the price of a watch): no single payment above this.
  • X402_MAX_TOTAL_USD (default 1.00): no more payments after this much in a session.

Without a key, prices and sentiment work free, with data refreshed every 15 minutes. service_info works too, and the other tools explain how to pay.

Other ways to use the same data

Public market data. Not financial advice.

Source: README.md at commit eee06cf

Tools

15

prices

Prices

Live prices with 5-minute, 1-hour, 4-hour and 24-hour change and 24-hour volume for the top 50 crypto coins, refreshed every minute. Costs USD 0.003 per call, paid with x402 (USDC on Base); calls that fail are not charged.

Parameterstokens

derivatives

Derivatives

Funding rate per 8 hours, futures premium, open interest with 1-hour and 24-hour change, and long/short account ratio per coin. Costs USD 0.003 per call, paid with x402 (USDC on Base); calls that fail are not charged.

Parameterstokens

orderbook

Orderbook

Bid-ask spread, order-book imbalance, buyer share of the last 15 minutes and volume versus normal per coin. Costs USD 0.003 per call, paid with x402 (USDC on Base); calls that fail are not charged.

Parameterstokens

liquidations

Liquidations

Every Binance futures liquidation of the last hour across 190+ coins: totals, per coin longs and shorts, and the biggest ones. Costs USD 0.003 per call, paid with x402 (USDC on Base); calls that fail are not charged.

Parameterslimittoken

whale_orders

Whale Orders

The biggest market orders of the last hour on Binance futures, Binance spot and Hyperliquid, with what each Hyperliquid order did. Costs USD 0.003 per call, paid with x402 (USDC on Base); calls that fail are not charged.

Parameterslimittoken

news

News

Top crypto stories now from 31 sources, each with an impact score, outlet count and the price reaction afterwards. Costs USD 0.003 per call, paid with x402 (USDC on Base); calls that fail are not charged.

Parameterslimittoken

sentiment

Sentiment

Crypto Fear and Greed index with the previous value, trending coins, market breadth, mood and volatility regime. Costs USD 0.003 per call, paid with x402 (USDC on Base); calls that fail are not charged.

Parameterslimit

coin_snapshot

Coin Snapshot

Everything for one coin in one call: price, funding and open interest, order book, liquidations, whale orders and news. Costs USD 0.005 per call, paid with x402 (USDC on Base); calls that fail are not charged.

Parameterstokenrequired

hyperliquid_wallet

Hyperliquid Wallet

Enriched Hyperliquid wallet report: open positions with liquidation distance and a risk label, account value and leverage, PnL and volume by day, week, month and all time, spot balances and the last 24 hours of trading. Costs USD 0.01 per call, paid with x402 (USDC on Base); calls that fail are not charged.

Parametersaddressrequired

create_watch

Create Watch

Watch the crypto market for 24 hours: up to 10 conditions (price, % change, funding, open interest, liquidations, order book, Fear and Greed, whale orders, news impact), checked every minute; when one happens you get a signed webhook and it shows in the watch's status. Costs USD 0.02, paid with x402 (USDC on Base); a request that fails is not charged. Keep the returned secret: watch_status and stop_watch need it.

Parameterslabelformatconditionsrequiredcallback_url

watch_status

Watch Status

Free: a watch's status, current conditions and its last 20 fires (what triggered, when, and whether the webhook was delivered).

Parameterssecretrequiredwatch_idrequired

stop_watch

Stop Watch

Free: stop a watch before it expires.

Parameterssecretrequiredwatch_idrequired

prices_free

Prices Free

Free: the same answer as prices, from a copy refreshed every 15 minutes (up to 30 calls a minute). prices has live data every minute for USD 0.003.

Parameterstokens

sentiment_free

Sentiment Free

Free: the same answer as sentiment, from a copy refreshed every 15 minutes (up to 30 calls a minute). sentiment has live data every minute for USD 0.003.

Parameterslimit

service_info

Service Info

Free: what this server offers, the price of each tool and how payment works.

Takes no parameters.

Version history

2
  1. v0.1.3LatestOct 24, 2026
  2. v0.1.0Oct 23, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts