cryptofeed402

site.cryptofeed402Published by cryptofeed402.siteOfficial publisherv1.5.0Updated Oct 24, 2026

Hyperliquid perp funding, OI, preflight & news sentiment for agents. Pay per call in USDC (x402).

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Remote MCP server giving assistants Hyperliquid perpetual funding, open interest, price, sentiment and research briefs, paid per call in USDC via x402.

What you can do
Read free teasers, sample briefs, pricing and aggregate demand data, and request new assets or report schedules for human review. Get perp mark, funding, open interest, volume and premium for any listed Hyperliquid perp, including HIP-3 builder dexes. Pull funding extremes, hourly funding history, OHLCV candles and open-interest history. Fetch OKX spot tickers and news sentiment scores with headlines for one asset. Retrieve the latest or archived crypto research briefs, and run an agent-readiness audit of a public site or x402 API.
When to use it
Useful when an assistant needs Hyperliquid derivatives market data, funding and open-interest context, or crypto news sentiment for analysis, and when the caller already has an x402 client able to pay small USDC amounts per call. Free tools let you evaluate output before paying.
Requirements
Remote streamable HTTP endpoint with no authentication; an optional stdio mode runs via npx with CRYPTOFEED402_URL and CRYPTOFEED402_REF environment variables. Paid tools require your own x402 client and USDC on Base; the server returns payment requirements and a URL rather than charging directly. Network access to the hosted site and to OKX/Hyperliquid data sources.
Before you install
Paid tools cost real USDC per call (for example $0.002 to $0.05, with history billed per day up to a cap); the server does not pay for you and holds no keys, so your own x402 client and wallet handle spending. Free request tools log submissions for human review and are rate-limited per IP. Output is market data, not financial advice.

Installation

In SourceWeft

  1. Open cryptofeed402 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/site.cryptofeed402%2Ffeed/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": {
    "cryptofeed402": {
      "type": "http",
      "url": "https://cryptofeed402.site/mcp"
    }
  }
}

README

cryptofeed402-mcp

MCP server for cryptofeed402: crypto market data for AI agents, paid per call with x402 (USDC on Base). Not financial advice.

Use the hosted server (recommended)

Remote MCP, streamable HTTP, no auth:

https://cryptofeed402.site/mcp

Use it over stdio

json
{  "mcpServers": {    "cryptofeed402": { "command": "npx", "args": ["-y", "cryptofeed402-mcp"] }  }}

Before it is on npm, run it from a checkout: npm install && node index.mjs.

Optional env: CRYPTOFEED402_URL (default https://cryptofeed402.site), CRYPTOFEED402_REF (attribution tag, default mcp-stdio).

Tools

ToolCostReturns
get_teaserfreeteaser text, Hyperliquid extreme funding (8h-equivalent), BTC/ETH/SOL + 24h change
get_sample_brieffreeprevious brief edition, trimmed (sample: true)
get_pricingfreeper-call prices, network, payTo
get_price {symbol}$0.0025x402 payment requirements + URL for /price/{symbol}
get_extreme_funding$0.0025x402 requirements for /funding/extreme
get_latest_brief$0.015x402 requirements for /brief/latest
get_history {from,to}$0.005/day (cap $0.50)x402 requirements for /history

Prices are launch prices (50% off). Paid tools do not pay for you. This package holds no keys. Fetch the returned URL with your own x402 client (for example @x402/fetch). You are charged only on a successful response.

Source: README.md at commit d894af8

Tools

19

get_teaser

Brief teaser (free)

Free: latest brief teaser text, Hyperliquid extreme funding (8h-equivalent rates), BTC/ETH/SOL prices with 24h change.

Takes no parameters.

get_sample_brief

Sample brief (free)

Free: a delayed, trimmed sample of the twice-daily crypto brief (previous edition; no OI, sentiment or markdown). Use to evaluate before paying for get_latest_brief.

Takes no parameters.

get_pricing

Pricing (free)

Free: current per-call prices (USDC on Base via x402), network and payTo address.

Takes no parameters.

request_asset

Request an asset to monitor (free)

Free: ask cryptofeed402 to consider monitoring a coin it does not cover yet (covered: BTC, ETH, SOL, HYPE, NEAR, AAVE). Logged for human review; high-demand assets may be added to the brief and paid endpoints later. Not a guarantee. Limit 10/hour/IP; repeat asks for the same symbol within 24h count once.

Parametersagentreasonsymbolrequired

request_report_schedule

Tell us when you want reports (free)

Free: tell cryptofeed402 how often you want briefs/reports and the best UTC hours to have a fresh one ready, so we can schedule to match. Logged as aggregate demand (GET /feedback/schedule shows counts only; notes and agent names are never published; no IPs stored). Limit 10/hour/IP.

Parametersnotesymbolsfrequencyrequiredagent_nameroutes_of_interestpreferred_utc_hoursrequired

get_top_requested_assets

Top requested assets (free)

Free: top 20 coins other agents have asked cryptofeed402 to monitor in the last 30 days (aggregate counts only).

Takes no parameters.

get_price

Coin lookup (paid, x402)

Paid endpoint: perp mark, funding, OI (Hyperliquid) plus OKX spot for any listed Hyperliquid perp (main dex or HIP-3 like xyz:TSLA; HIP-3 has no spot cross-check). Unknown symbols return an error and no charge. Returns the x402 payment requirements and URL; pay with your own x402 client. Free sample response: https://cryptofeed402.site/samples/price

Parameterssymbolrequired

get_extreme_funding

Extreme funding (paid, x402)

Paid endpoint: most extreme Hyperliquid funding rates right now. Returns the x402 payment requirements and URL. Free sample response: https://cryptofeed402.site/samples/funding

Takes no parameters.

get_latest_brief

Latest brief (paid, x402)

Paid endpoint: the full latest twice-daily crypto research brief (JSON + markdown). Returns the x402 payment requirements and URL. Free sample: get_sample_brief or https://cryptofeed402.site/brief/sample

Takes no parameters.

get_audit_sample

Agent-readiness audit sample (free)

Free: a cached example agent-readiness audit of cryptofeed402.site (score 0-100, pass/warn/fail per check with evidence and fixes) so you can see the output of audit_agent_ready before paying.

Takes no parameters.

get_perps

Perps radar (paid, x402)

Paid endpoint ($0.002): one Hyperliquid perp's funding (hourly, 8h, annualized), open interest in USD, 24h volume, mark/oracle price, premium and whether it is in the top-10 funding extremes. Any listed Hyperliquid perp, incl. HIP-3 builder dexes (xyz:TSLA; rank null); unknown symbols return an error and no charge. Returns the x402 payment requirements and URL. Free sample response: https://cryptofeed402.site/samples/perps

Parameterssymbolrequired

get_sentiment

News sentiment (paid, x402)

Paid endpoint ($0.002): crypto news sentiment for one asset: -1..1 score, bearish/neutral/bullish label, pos/neg/neu headline counts and up to 5 top headlines with links. Headlines labeled by a local LLM, score is plain math, refreshed about every 15 min. Symbols not in the current snapshot or stale data return an error and no charge (free list: GET /sentiment). Returns the x402 payment requirements and URL. Free sample response: https://cryptofeed402.site/samples/sentiment

Parameterssymbolrequired

audit_agent_ready

Agent-readiness audit (paid, x402)

Paid endpoint ($0.05): audits a public website or x402 API for AI-agent readiness (llms.txt, robots.txt AI rules, sitemap, OpenAPI, /.well-known/x402, agent card, MCP initialize, a live unpaid 402 challenge, Bazaar metadata, Roundhouse / 402 Index / x402 Doctor listings). Deterministic, no LLM. Returns the x402 payment requirements and URL; see get_audit_sample for the output format.

Parametersurlrequired

get_outlook

Pre-trade preflight (paid, x402)

Paid endpoint ($0.01): pre-trade preflight for one Hyperliquid perp in one call: perp mark vs OKX spot and vs oracle (bps), funding hourly/8h/annualized with its extreme-funding rank, open interest and OI change vs ~1h/~4h/~24h/~7d ago (null until our snapshots cover the window), news sentiment if covered, as_of per component, and neutral flags (funding_extreme, oi_spike, venue_divergence, stale_component) with their rules. Factual checks only, no buy/sell call. Unknown symbol or unavailable data returns an error and no charge. Returns the x402 payment requirements and URL. Free sample response: https://cryptofeed402.site/samples/outlook

Parameterssymbolrequired

get_funding_history

Funding history (paid, x402)

Paid endpoint ($0.005): hourly funding settlements for one Hyperliquid perp (rate hourly/8h/annualized, premium) plus mean/min/max, positive/negative hours and cumulative rate. Give hours (1-720, default 168) or from/to (YYYY-MM-DD or ISO 8601 UTC, max 720 hours); interval=4h/8h/1d returns UTC buckets (mean rate, cumulative) and allows up to 2160 hours (90 days). Any Hyperliquid perp incl. HIP-3 (xyz:TSLA). History back to each perp's listing (BTC since 2023-05-12). Bad params or unknown symbol return an error and no charge. Returns the x402 payment requirements and URL. Free sample response: https://cryptofeed402.site/samples/funding-history

Parameterstofromhourssymbolrequiredinterval

get_candles

OHLCV candles (paid, x402)

Paid endpoint ($0.003): OHLCV candles for any Hyperliquid perp (venue=hyperliquid, default; main dex + HIP-3; intervals 1m,3m,5m,15m,30m,1h,2h,4h,8h,12h,1d,3d,1w,1M; limit 1-500, default 100; optional end= epoch ms or ISO for older candles, Hyperliquid keeps the most recent 5000 per interval) or any OKX USDT spot pair (venue=okx; intervals 1m-12h,1d,1w,1M; limit 1-300; most recent only). Bad params or unknown symbol return an error and no charge. Returns the x402 payment requirements and URL. Free sample response: https://cryptofeed402.site/samples/candles

Parametersendlimitvenuesymbolrequiredinterval

get_spot

Spot ticker (paid, x402)

Paid endpoint ($0.002): OKX spot ticker for any live <SYMBOL>-USDT pair: last, bid/ask, spread in bps, 24h open/high/low/change, UTC-day change and 24h volume. Unknown pairs return an error and no charge. Returns the x402 payment requirements and URL. Free sample response: https://cryptofeed402.site/samples/spot

Parameterssymbolrequired

get_oi_history

Open-interest history (paid, x402)

Paid endpoint ($0.005): about-hourly open-interest history (coins, USD, mark, hourly funding) for one Hyperliquid main-dex perp, from cryptofeed402's own snapshots (8-day retention; Hyperliquid has no public OI history). hours 1-192, default 24. HIP-3 symbols, bad params or missing history return an error and no charge. Returns the x402 payment requirements and URL. Free sample response: https://cryptofeed402.site/samples/oi-history

Parametershourssymbolrequired

get_history

Brief archive (paid, x402)

Paid endpoint: archived briefs for a date range. Returns the x402 payment requirements and URL. Free sample response: https://cryptofeed402.site/samples/history

Parameterstofromrequired

Version history

2
  1. v1.5.0LatestOct 23, 2026
  2. v1.0.0Oct 18, 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