cryptofeed402

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Crypto market data for AI agents: Hyperliquid funding/OI, OKX spot, twice-daily brief. x402 USDC.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "cryptofeed402": {
      "url": "https://cryptofeed402.site/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (19)

• get_teaser read-only

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

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_sample_brief read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_pricing read-only

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

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• request_asset

  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.

  Parameters:

  • symbol (required) — string — Ticker, e.g. LINK (2-15 chars, letters/digits, optional hyphen; leading $ ok)
  • agent — string — Optional agent name/id (<=80 chars)
  • reason — string — Optional short reason (<=200 chars)

  Hints: read-only no · destructive no · idempotent yes · open-world no

• request_report_schedule

  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.

  Parameters:

  • frequency (required) — string
  • preferred_utc_hours (required) — array — Up to 6 UTC hours (0-23); [] = no preference
  • note — string — Plain text
  • symbols — array
  • agent_name — string
  • routes_of_interest — array

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_top_requested_assets read-only

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

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_price read-only

  Paid endpoint ($0.0025): 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

  Parameters:

  • symbol (required) — string — Hyperliquid perp ticker, e.g. BTC, ETH, kPEPE; HIP-3 builder-dex perps as dex:TICKER, e.g. xyz:TSLA

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_extreme_funding read-only

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

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_latest_brief read-only

  Paid endpoint ($0.015): 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

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_audit_sample read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_perps read-only

  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

  Parameters:

  • symbol (required) — string — Hyperliquid perp ticker, e.g. BTC, ETH, kPEPE; HIP-3 builder-dex perps as dex:TICKER, e.g. xyz:TSLA

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_sentiment read-only

  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

  Parameters:

  • symbol (required) — string — Ticker, e.g. BTC, ETH, SOL

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• audit_agent_ready read-only

  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.

  Parameters:

  • url (required) — string — Domain or http(s) URL of the site to audit (public hosts, ports 80/443)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_outlook read-only

  Paid endpoint ($0.01): pre-trade preflight for one Hyperliquid perp in one call: a short factual summary string plus 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

  Parameters:

  • symbol (required) — string — Hyperliquid perp ticker, e.g. BTC, ETH, kPEPE; HIP-3 builder-dex perps as dex:TICKER, e.g. xyz:TSLA

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_funding_history read-only

  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

  Parameters:

  • symbol (required) — string — Hyperliquid perp ticker, e.g. BTC, ETH, kPEPE; HIP-3 builder-dex perps as dex:TICKER, e.g. xyz:TSLA
  • to — string — End, YYYY-MM-DD (inclusive) or ISO 8601 UTC; default now
  • from — string — Start, YYYY-MM-DD or ISO 8601 UTC
  • hours — integer — Last N hours (default 168; max 720 for interval=1h). Do not combine with from/to.
  • interval — string — 1h = raw hourly settlements (default, max 720 hours); 4h/8h/1d = UTC buckets (max 2160 hours = 90 days)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_candles read-only

  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

  Parameters:

  • symbol (required) — string — Hyperliquid perp ticker, e.g. BTC, ETH, kPEPE; HIP-3 builder-dex perps as dex:TICKER, e.g. xyz:TSLA; for venue=okx a spot base ticker, e.g. PEPE
  • end — string — Hyperliquid only: end time, epoch ms or YYYY-MM-DD / ISO 8601 UTC
  • limit — integer — Default 100; max 300 for okx
  • venue — string
  • interval — string — Default 1h. 3d/8h are Hyperliquid only, 6h is OKX only

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_spot read-only

  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

  Parameters:

  • symbol (required) — string — Base ticker, e.g. BTC, PEPE, TON

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_oi_history read-only

  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

  Parameters:

  • symbol (required) — string — Hyperliquid main-dex perp ticker, e.g. BTC
  • hours — integer

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_history read-only

  Paid endpoint ($0.005 per day, max $0.50 per call): archived briefs for a date range. Returns the x402 payment requirements and URL. Free sample response: https://cryptofeed402.site/samples/history

  Parameters:

  • from (required) — string
  • to — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.