Endpoints: 76,849MCP servers: 32,722Payout addresses: 3,825Paid calls: 6,098Letters: 83Defects: 3,891counted just now
teppi

Server definition

Hash
sha256:eba8be648459ebd6deae130c66edfc6be04e94bd3f1e9d81f0e6d0b864fe570a
What it is
What a remote MCP server returned when asked what it offers: 29 tools

The blob, as servednamed by its sha256

{ "instructions": "No account, no API key, no subscription: pay per call in USDC on Base, from $0.002 per call. cryptofeed402: crypto market data, a one-call perps + news context scan, per-asset news sentiment, attention volume and weekly narratives for AI agents (plus a paid agent-readiness audit for any site). Free tools return data directly; request_asset lets you ask for a coin to be monitored; request_report_schedule lets you tell us how often and when you want reports. Paid tools return x402 payment requirements (USDC on Base); fetch the returned URL with an x402-capable HTTP client (e.g. @x402/fetch) using your own wallet. You are only charged on a successful response (valid 200); 404/503/stale errors are never charged. Not financial advice.", "tools": [ { "description": "Use when you need to check whether a website or x402 API is discoverable and usable by AI agents. Agent-readiness audit ($0.05/call, USDC on Base via x402) for any public website or x402 API: checks llms.txt, robots.txt AI rules, sitemap, OpenAPI, /.well-known/x402, agent card, MCP initialize, a live unpaid 402 challenge, Bazaar metadata and x402 directory listings; returns score 0-100, grade, pass/warn/fail per check with evidence and fixes. Deterministic, no LLM. Free example: get_audit_sample. Example: GET https://cryptofeed402.site/audit/agent-ready?url=https%3A%2F%2Fexample.com", "inputSchema": { "additionalProperties": false, "examples": [ { "url": "https://example.com" } ], "properties": { "url": { "description": "Domain or http(s) URL of the site to audit (public hosts, ports 80/443)", "examples": [ "https://example.com" ], "maxLength": 2048, "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "audit_agent_ready", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "audit_version": { "description": "Audit version", "type": [ "string", "null" ] }, "audited_at": { "description": "ISO-8601 UTC", "type": [ "string", "null" ] }, "checks": { "description": "[{id, name, weight, status, points, evidence{}, fix}]", "items": { "type": "object" }, "type": "array" }, "counts": { "description": "{pass, warn, fail}", "properties": { "fail": { "type": [ "number", "null" ] }, "pass": { "type": [ "number", "null" ] }, "warn": { "type": [ "number", "null" ] } }, "type": "object" }, "disclaimer": { "description": "Scope notice", "type": [ "string", "null" ] }, "duration_ms": { "description": "Audit duration", "type": [ "number", "null" ] }, "grade": { "description": "Letter grade", "type": [ "string", "null" ] }, "method": { "description": "How checks run", "type": [ "string", "null" ] }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "score": { "description": "0-100", "type": [ "number", "null" ] }, "summary": { "description": "One-line summary", "type": [ "string", "null" ] }, "target": { "description": "{input, origin, host}", "properties": { "host": { "type": [ "string", "null" ] }, "input": { "type": [ "string", "null" ] }, "origin": { "type": [ "string", "null" ] } }, "type": "object" } }, "required": [ "audit_version", "audited_at", "checks", "counts", "disclaimer", "duration_ms", "grade", "method", "score", "summary", "target" ], "title": "Paid HTTP 200 body of GET /audit/agent-ready", "type": "object" } ], "type": "object" } }, { "description": "Use when you need which coins are getting unusual headline volume vs their 7-day average. Crypto news attention ($0.003/call, USDC on Base via x402): per-coin headline mention count in the latest 12h tagger run vs 7-day average (ratio, z-score, rank). Optional symbol returns one coin. Volume signal, not tone (use get_sentiment for bullish/bearish). Missing/stale data or unknown symbol: no charge. Example: GET https://cryptofeed402.site/attention or https://cryptofeed402.site/attention/BTC", "inputSchema": { "additionalProperties": false, "examples": [ { "symbol": "BTC" } ], "properties": { "symbol": { "description": "Optional ticker; omit for the full ranked table", "examples": [ "BTC" ], "pattern": "^[A-Za-z0-9]{1,20}$", "type": "string" } }, "type": "object" }, "name": "get_attention", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "age_seconds": { "description": "Data age", "type": [ "number", "null" ] }, "as_of": { "description": "ISO-8601 UTC", "type": [ "string", "null" ] }, "coins": { "description": "[{symbol, mentions_12h, avg_7d, ratio, z, rank}]", "items": { "type": "object" }, "type": "array" }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "events": { "description": "Optional (when the tagger push includes them): schema-6 headline events. /attention/{symbol} keeps only events for that symbol.", "items": { "properties": { "assets": { "items": { "type": "string" }, "type": "array" }, "etf_flow_direction": { "enum": [ "inflow", "outflow", "mixed", "flat", null ], "type": [ "string", "null" ] }, "event_class": { "type": "string" }, "event_tier": { "maximum": 3, "minimum": 1, "type": "integer" }, "event_time_pt": { "type": [ "string", "null" ] }, "headline": { "type": "string" }, "minutes_to_event": { "type": [ "integer", "null" ] }, "phase": { "enum": [ "pre", "post", null ], "type": [ "string", "null" ] }, "published": { "type": [ "string", "null" ] }, "source": { "type": "string" }, "url": { "type": "string" } }, "required": [ "event_class", "event_tier", "assets" ], "type": "object" }, "type": "array" }, "generated_at": { "description": "Pack build time", "type": [ "string", "null" ] }, "method": { "description": "Computation notes", "type": [ "string", "null" ] }, "n_headlines_current": { "description": "Headlines in current run", "type": [ "number", "null" ] }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "sentiment_regime": { "description": "Optional: 7-day headline sentiment regime (bull/bear balance vs 30-day baseline, flip and extreme flags).", "properties": { "as_of": { "type": "string" }, "balance_1d": { "type": "string" }, "balance_7d": { "type": "string" }, "balance_baseline": { "type": "string" }, "baseline_days": { "type": "integer" }, "bull_share_1d": { "type": "number" }, "bull_share_7d": { "type": "number" }, "bull_share_baseline": { "type": "number" }, "delta_7d_vs_baseline": { "type": "number" }, "directional_7d": { "type": "integer" }, "extreme": { "type": "boolean" }, "flip": { "type": "boolean" }, "net_1d": { "type": "number" }, "net_7d": { "type": "number" }, "note": { "type": "string" }, "z_7d": { "type": "number" } }, "type": "object" }, "timezone": { "description": "Timezone of run labels", "type": [ "string", "null" ] }, "window": { "description": "{current_run, current_hours, baseline_runs, baseline_days_approx}", "properties": { "baseline_days_approx": { "type": [ "number", "null" ] }, "baseline_runs": { "type": [ "number", "null" ] }, "current_hours": { "type": [ "number", "null" ] }, "current_run": { "type": [ "string", "null" ] } }, "type": "object" } }, "required": [ "age_seconds", "as_of", "coins", "disclaimer", "generated_at", "method", "n_headlines_current", "timezone", "window" ], "title": "Paid HTTP 200 body of GET /attention", "type": "object" } ], "type": "object" } }, { "description": "Use when you want to see the audit_agent_ready output format free. Free: cached example agent-readiness audit of cryptofeed402.site (score 0-100, grade, pass/warn/fail per check with evidence and fixes) showing the output of audit_agent_ready ($0.05). Example: GET https://cryptofeed402.site/audit/sample", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "get_audit_sample", "outputSchema": { "properties": { "audit_version": { "description": "Audit version", "type": [ "string", "null" ] }, "audited_at": { "description": "Audit time (cached)", "type": [ "string", "null" ] }, "checks": { "description": "Per-check results", "items": { "type": "object" }, "type": "array" }, "counts": { "description": "{pass, warn, fail}", "properties": { "fail": { "type": [ "number", "null" ] }, "pass": { "type": [ "number", "null" ] }, "warn": { "type": [ "number", "null" ] } }, "type": "object" }, "disclaimer": { "type": [ "string", "null" ] }, "duration_ms": { "type": [ "number", "null" ] }, "grade": { "description": "Letter grade", "type": [ "string", "null" ] }, "method": { "type": [ "string", "null" ] }, "note": { "description": "Sample note", "type": [ "string", "null" ] }, "sample": { "description": "Always true", "type": "boolean" }, "score": { "description": "0-100", "type": [ "number", "null" ] }, "summary": { "type": [ "string", "null" ] }, "target": { "description": "{input, origin, host}", "properties": { "host": { "type": [ "string", "null" ] }, "input": { "type": [ "string", "null" ] }, "origin": { "type": [ "string", "null" ] } }, "type": "object" } }, "required": [ "audit_version", "audited_at", "checks", "counts", "disclaimer", "duration_ms", "grade", "method", "note", "sample", "score", "summary", "target" ], "type": "object" } }, { "description": "Use when backtesting against the last 7 days of crypto briefs in one pre-built pack. 7-day crypto brief pack ($0.02/call, USDC on Base via x402): every twice-daily digest brief from the last ~7 days (primary writer plus standby for missed slots), full markdown bodies with sha256, model and slot. For backtests. Different from get_history (date range, $0.005/day). Missing/stale: no charge. Example: GET https://cryptofeed402.site/briefs/history", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "get_briefs_history", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "billing": { "description": "Charged only on this 200", "type": [ "string", "null" ] }, "briefs": { "description": "[{slot, source, generated_at, model, covers_gap, bytes, sha256, body}]", "items": { "type": "object" }, "type": "array" }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "generated_at": { "description": "Build time", "type": [ "string", "null" ] }, "n_briefs": { "description": "Briefs in pack", "type": [ "number", "null" ] }, "n_primary": { "description": "Primary-writer briefs", "type": [ "number", "null" ] }, "n_standby": { "description": "Standby briefs", "type": [ "number", "null" ] }, "price_usd": { "description": "Price charged", "type": [ "number", "null" ] }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "route": { "description": "Route id", "type": [ "string", "null" ] }, "schema": { "description": "Schema id", "type": [ "string", "null" ] }, "timezone": { "description": "Timezone", "type": [ "string", "null" ] }, "window": { "description": "{days, from_date, to_date}", "properties": { "days": { "type": [ "number", "null" ] }, "from_date": { "type": [ "string", "null" ] }, "to_date": { "type": [ "string", "null" ] } }, "type": "object" } }, "required": [ "billing", "briefs", "disclaimer", "generated_at", "n_briefs", "n_primary", "n_standby", "price_usd", "route", "schema", "timezone", "window" ], "title": "Paid HTTP 200 body of GET /briefs/history", "type": "object" } ], "type": "object" } }, { "description": "Use when you want the latest brief, news sentiment and perp funding/OI for one coin in one paid call. Bundle for one coin ($0.012/call, USDC on Base via x402; cheaper than $0.015 brief + $0.002 sentiment + $0.002 perps separately): latest twice-daily crypto brief, news sentiment (score, label) and perps radar (funding, open interest, mark) for one symbol. 503 if any part is missing or stale; no charge on errors. Example: GET https://cryptofeed402.site/bundle/brief-sentiment-perps?symbol=BTC", "inputSchema": { "additionalProperties": false, "examples": [ { "symbol": "BTC" } ], "properties": { "symbol": { "description": "Ticker, e.g. BTC", "examples": [ "BTC" ], "pattern": "^[A-Za-z0-9]{2,20}$", "type": "string" } }, "required": [ "symbol" ], "type": "object" }, "name": "get_bundle_brief_sentiment_perps", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "billing": { "description": "Charged only on this 200", "type": [ "string", "null" ] }, "brief": { "description": "Latest brief object (as get_latest_brief)", "properties": { "generated_at": { "type": [ "string", "null" ] }, "headline": { "type": [ "string", "null" ] } }, "type": "object" }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "includes": { "description": "Components included (brief, sentiment, perps)", "items": { "type": [ "string", "null" ] }, "type": "array" }, "perps": { "description": "Perps radar object (as get_perps)", "properties": { "schema_version": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "venue": { "type": [ "string", "null" ] } }, "type": "object" }, "price_usd": { "description": "Price charged", "type": [ "number", "null" ] }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "route": { "description": "Route id", "type": [ "string", "null" ] }, "sentiment": { "description": "Sentiment object (as get_sentiment)", "properties": { "label": { "type": [ "string", "null" ] }, "score": { "type": [ "number", "null" ] }, "symbol": { "type": [ "string", "null" ] } }, "type": "object" }, "symbol": { "description": "Ticker", "type": [ "string", "null" ] } }, "required": [ "billing", "brief", "disclaimer", "includes", "perps", "price_usd", "route", "sentiment", "symbol" ], "title": "Paid HTTP 200 body of GET /bundle/brief-sentiment-perps", "type": "object" } ], "type": "object" } }, { "description": "Use when you need OHLCV candles for a Hyperliquid perp or OKX spot pair for charting or indicators. OHLCV candles API ($0.003/call, USDC on Base via x402): any Hyperliquid perp (venue=hyperliquid default; main dex + HIP-3; 1m to 1M intervals; limit 1-500, default 100; optional end for older candles) or any OKX USDT spot pair (venue=okx; limit 1-300; most recent only). Each candle: open time, close time, o/h/l/c, volume, trade count, closed flag. Errors: no charge. Example: GET https://cryptofeed402.site/candles/BTC?interval=1h&limit=100", "inputSchema": { "additionalProperties": false, "examples": [ { "interval": "1h", "limit": 100, "symbol": "BTC" } ], "properties": { "end": { "description": "Hyperliquid only: end time, epoch ms or YYYY-MM-DD / ISO 8601 UTC", "type": "string" }, "interval": { "description": "Default 1h. 3d/8h are Hyperliquid only, 6h is OKX only", "enum": [ "1m", "3m", "5m", "15m", "30m", "1h", "2h", "4h", "8h", "12h", "1d", "3d", "1w", "1M", "6h" ], "examples": [ "1h" ], "type": "string" }, "limit": { "description": "Default 100; max 300 for okx", "examples": [ 100 ], "maximum": 500, "minimum": 1, "type": "integer" }, "symbol": { "description": "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", "examples": [ "BTC" ], "pattern": "^(?:[A-Za-z]{1,10}:)?[A-Za-z0-9]{1,20}$", "type": "string" }, "venue": { "enum": [ "hyperliquid", "okx" ], "type": "string" } }, "required": [ "symbol" ], "type": "object" }, "name": "get_candles", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "as_of": { "description": "ISO-8601 UTC", "type": [ "string", "null" ] }, "candles": { "description": "[{t, close_time, o, h, l, c, v, n, closed}]", "items": { "type": "object" }, "type": "array" }, "count": { "description": "Candles returned", "type": [ "number", "null" ] }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "fields": { "description": "Legend for candle keys", "properties": { "c": { "type": [ "string", "null" ] }, "close_time": { "type": [ "string", "null" ] }, "closed": { "type": [ "string", "null" ] }, "h": { "type": [ "string", "null" ] }, "l": { "type": [ "string", "null" ] }, "n": { "type": [ "string", "null" ] }, "o": { "type": [ "string", "null" ] }, "t": { "type": [ "string", "null" ] }, "v": { "type": [ "string", "null" ] } }, "type": "object" }, "generated_at": { "description": "Response time", "type": [ "string", "null" ] }, "interval": { "description": "Candle interval", "type": [ "string", "null" ] }, "limit": { "description": "Limit applied", "type": [ "number", "null" ] }, "market": { "description": "perp or spot", "type": [ "string", "null" ] }, "options": { "description": "Accepted values for params", "properties": { "end": { "type": [ "string", "null" ] }, "interval": { "type": [ "string", "null" ] }, "limit": { "type": [ "string", "null" ] }, "venue": { "type": [ "string", "null" ] } }, "type": "object" }, "price_basis": { "description": "Price basis note", "type": [ "string", "null" ] }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "source": { "description": "Upstream source", "type": [ "string", "null" ] }, "symbol": { "description": "Ticker", "type": [ "string", "null" ] }, "venue": { "description": "hyperliquid or okx", "type": [ "string", "null" ] }, "window": { "description": "{from, to, end_param}", "properties": { "end_param": {}, "from": { "type": [ "string", "null" ] }, "to": { "type": [ "string", "null" ] } }, "type": "object" } }, "required": [ "as_of", "candles", "count", "disclaimer", "fields", "generated_at", "interval", "limit", "market", "options", "price_basis", "source", "symbol", "venue", "window" ], "title": "Paid HTTP 200 body of GET /candles/{symbol}", "type": "object" } ], "type": "object" } }, { "description": "Use when you need which coins have news corroborated by multiple outlets in the latest run. Crypto news coverage heat ($0.002/call, USDC on Base via x402): per asset from the latest headline-tagger run (~every 12h): event count, events corroborated by 2+ outlets, max outlets, outlet names and up to 3 sample headlines. Missing/stale: no charge. Example: GET https://cryptofeed402.site/coverage/heat", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "get_coverage_heat", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "as_of": { "description": "ISO-8601 UTC", "type": [ "string", "null" ] }, "assets": { "description": "[{symbol, event_count, multi_outlet_count, max_outlets, outlet_names[], sample_headlines[]}]", "items": { "type": "object" }, "type": "array" }, "billing": { "description": "Charged only on this 200", "type": [ "string", "null" ] }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "generated_at": { "description": "Build time", "type": [ "string", "null" ] }, "method": { "description": "Computation notes", "type": [ "string", "null" ] }, "multi_outlet_events_total": { "description": "Events with 2+ outlets", "type": [ "number", "null" ] }, "n_assets": { "description": "Assets returned", "type": [ "number", "null" ] }, "n_events": { "description": "Events in run", "type": [ "number", "null" ] }, "n_headlines": { "description": "Headlines in run", "type": [ "number", "null" ] }, "price_usd": { "description": "Price charged", "type": [ "number", "null" ] }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "route": { "description": "Route id", "type": [ "string", "null" ] }, "run": { "description": "Tagger run label", "type": [ "string", "null" ] }, "schema": { "description": "Schema id", "type": [ "string", "null" ] }, "timezone": { "description": "Timezone", "type": [ "string", "null" ] } }, "required": [ "as_of", "assets", "billing", "disclaimer", "generated_at", "method", "multi_outlet_events_total", "n_assets", "n_events", "n_headlines", "price_usd", "route", "run", "schema", "timezone" ], "title": "Paid HTTP 200 body of GET /coverage/heat", "type": "object" } ], "type": "object" } }, { "description": "Use when scanning crypto funding rates for crowded longs/shorts, squeeze risk or funding-arbitrage candidates. Crypto funding rates scanner ($0.0025/call, USDC on Base via x402). Returns the 10 most extreme Hyperliquid perpetual funding rates right now (annualized %, with open interest in USD; perps with >$1M 24h volume) plus funding APR for the watchlist (BTC, ETH, SOL, HYPE, NEAR, AAVE). For trading agents checking crowded positioning before a trade. No params. Example: GET https://cryptofeed402.site/funding/extreme", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "get_extreme_funding", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "as_of": { "description": "ISO-8601 UTC snapshot time", "type": [ "string", "null" ] }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "most_extreme": { "description": "[{symbol, funding_apr_pct, open_interest_usd}] top 10 by absolute funding", "items": { "type": "object" }, "type": "array" }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "venue": { "description": "Data venue (hyperliquid)", "type": [ "string", "null" ] }, "watchlist": { "description": "[{symbol, funding_apr_pct}] for the 6 watchlist coins", "items": { "type": "object" }, "type": "array" } }, "required": [ "as_of", "disclaimer", "most_extreme", "venue", "watchlist" ], "title": "Paid HTTP 200 body of GET /funding/extreme", "type": "object" } ], "type": "object" } }, { "description": "Use when backtesting or analyzing historical crypto funding rates for one perp (up to 90 days). Historical funding rates for one Hyperliquid perp ($0.005/call, USDC on Base via x402): hourly settlements (rate hourly/8h/annualized, premium) plus mean/min/max APR, positive/negative hours and cumulative rate. hours=1-720 (default 168) or from/to; interval=4h/8h/1d buckets allow up to 2160 hours (90 days). HIP-3 supported. History back to listing (BTC since 2023-05-12). Errors: no charge. Example: GET https://cryptofeed402.site/funding/history/BTC?hours=168", "inputSchema": { "additionalProperties": false, "examples": [ { "hours": 168, "interval": "1h", "symbol": "BTC" } ], "properties": { "from": { "description": "Start, YYYY-MM-DD or ISO 8601 UTC", "type": "string" }, "hours": { "description": "Last N hours (default 168; max 720 for interval=1h). Do not combine with from/to.", "examples": [ 168 ], "maximum": 2160, "minimum": 1, "type": "integer" }, "interval": { "description": "1h = raw hourly settlements (default, max 720 hours); 4h/8h/1d = UTC buckets (max 2160 hours = 90 days)", "enum": [ "1h", "4h", "8h", "1d" ], "examples": [ "1h" ], "type": "string" }, "symbol": { "description": "Hyperliquid perp ticker, e.g. BTC, ETH, kPEPE; HIP-3 builder-dex perps as dex:TICKER, e.g. xyz:TSLA", "examples": [ "BTC" ], "pattern": "^(?:[A-Za-z]{1,10}:)?[A-Za-z0-9]{1,20}$", "type": "string" }, "to": { "description": "End, YYYY-MM-DD (inclusive) or ISO 8601 UTC; default now", "type": "string" } }, "required": [ "symbol" ], "type": "object" }, "name": "get_funding_history", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "as_of": { "description": "ISO-8601 UTC", "type": [ "string", "null" ] }, "count": { "description": "Number of points", "type": [ "number", "null" ] }, "coverage": { "description": "{expected_hours_approx, returned, max_hours_per_call, history_available}", "properties": { "expected_hours_approx": { "type": [ "number", "null" ] }, "history_available": { "type": [ "string", "null" ] }, "max_hours_per_call": { "type": [ "number", "null" ] }, "returned": { "type": [ "number", "null" ] } }, "type": "object" }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "generated_at": { "description": "Response time", "type": [ "string", "null" ] }, "interval_hours": { "description": "Bucket size in hours", "type": [ "number", "null" ] }, "latest_funding_time": { "description": "Latest settlement time", "type": [ "string", "null" ] }, "points": { "description": "[{time, rate_hourly, rate_8h, annualized_pct, premium}]", "items": { "type": "object" }, "type": "array" }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "sign_convention": { "description": "Positive = longs pay shorts", "type": [ "string", "null" ] }, "stats": { "description": "{mean_rate_hourly, mean_annualized_pct, min_annualized_pct, max_annualized_pct, positive_hours, negative_hours, cumulative_rate, last_24h_mean_annualized_pct}", "properties": { "cumulative_rate": { "type": [ "number", "null" ] }, "last_24h_mean_annualized_pct": { "type": [ "number", "null" ] }, "max_annualized_pct": { "type": [ "number", "null" ] }, "mean_annualized_pct": { "type": [ "number", "null" ] }, "mean_rate_hourly": { "type": [ "number", "null" ] }, "min_annualized_pct": { "type": [ "number", "null" ] }, "negative_hours": { "type": [ "number", "null" ] }, "positive_hours": { "type": [ "number", "null" ] } }, "type": "object" }, "symbol": { "description": "Ticker", "type": [ "string", "null" ] }, "venue": { "description": "hyperliquid", "type": [ "string", "null" ] }, "window": { "description": "{from, to, hours, mode}", "properties": { "from": { "type": [ "string", "null" ] }, "hours": { "type": [ "number", "null" ] }, "mode": { "type": [ "string", "null" ] }, "to": { "type": [ "string", "null" ] } }, "type": "object" } }, "required": [ "as_of", "count", "coverage", "disclaimer", "generated_at", "interval_hours", "latest_funding_time", "points", "sign_convention", "stats", "symbol", "venue", "window" ], "title": "Paid HTTP 200 body of GET /funding/history/{symbol}", "type": "object" } ], "type": "object" } }, { "description": "Use when comparing crypto funding rates across venues for basis/carry or funding-arbitrage trades. Cross-venue crypto funding rates spread ($0.005/call, USDC on Base via x402). For 1-20 symbols (default BTC, ETH, SOL, HYPE, NEAR, AAVE) returns Hyperliquid and OKX funding (Binance/Bybit when reachable) normalized to hourly and APR, with spread = max minus min per symbol. Fewer than 2 venues or bad params: error, no charge. Example: GET https://cryptofeed402.site/funding/spread?symbols=BTC,ETH", "inputSchema": { "additionalProperties": false, "examples": [ { "symbols": [ "BTC", "ETH" ] } ], "properties": { "symbols": { "description": "Optional; default watchlist", "examples": [ [ "BTC", "ETH" ] ], "items": { "pattern": "^[A-Za-z0-9]{2,20}$", "type": "string" }, "maxItems": 20, "minItems": 1, "type": "array", "uniqueItems": true }, "venues": { "items": { "enum": [ "hyperliquid", "okx", "binance", "bybit" ], "type": "string" }, "type": "array", "uniqueItems": true } }, "type": "object" }, "name": "get_funding_spread", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "as_of": { "description": "ISO-8601 UTC", "type": [ "string", "null" ] }, "billing": { "description": "Charged only on this 200", "type": [ "string", "null" ] }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "symbols": { "description": "Per symbol: symbol, venues[] (per-venue funding), spread{} (max-min)", "items": { "type": "object" }, "type": "array" }, "unit_note": { "description": "How rates are normalized", "type": [ "string", "null" ] } }, "required": [ "as_of", "billing", "disclaimer", "symbols", "unit_note" ], "title": "Paid HTTP 200 body of GET /funding/spread", "type": "object" } ], "type": "object" } }, { "description": "Use when you need archived crypto briefs for a specific date range (backtesting, narrative review). Crypto brief archive by date ($0.005 per day, max $0.50 per call, USDC on Base via x402): twice-daily briefs for from/to YYYY-MM-DD (up to 366 days), each with sentiment, funding rates, open interest, prices, news and macro calendar, as JSON + markdown. No briefs in range: 404, no charge. Example: GET https://cryptofeed402.site/history?from=2026-11-15&to=2026-11-16", "inputSchema": { "additionalProperties": false, "examples": [ { "from": "2026-10-27", "to": "2026-10-28" } ], "properties": { "from": { "examples": [ "2026-10-27" ], "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "to": { "examples": [ "2026-10-28" ], "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "required": [ "from" ], "type": "object" }, "name": "get_history", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "briefs": { "description": "[{generated_at, headline, brief{}, markdown, source}]", "items": { "type": "object" }, "type": "array" }, "count": { "description": "Briefs returned", "type": [ "number", "null" ] }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "from": { "description": "Start date", "type": [ "string", "null" ] }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "to": { "description": "End date", "type": [ "string", "null" ] } }, "required": [ "briefs", "count", "disclaimer", "from", "to" ], "title": "Paid HTTP 200 body of GET /history", "type": "object" } ], "type": "object" } }, { "description": "Use when you want where large Hyperliquid traders get liquidated (liquidation map) for one perp. Hyperliquid liquidation levels map ($0.01/call, USDC on Base via x402). For one main-dex perp: liquidation price and distance from mark of every open position held by the top ~150 Hyperliquid accounts by value, 1% liquidation bands below/above mark, totals by side and the nearest long and short liquidation. Optional min_usd filter. Unknown coin/no positions: 404; stale: 503; no charge on errors. Example: GET https://cryptofeed402.site/hyperliquid/liq-levels/BTC", "inputSchema": { "additionalProperties": false, "examples": [ { "coin": "BTC" } ], "properties": { "coin": { "description": "Hyperliquid main-dex ticker, e.g. BTC", "examples": [ "BTC" ], "pattern": "^[A-Za-z0-9]{1,20}$", "type": "string" }, "min_usd": { "description": "Only positions with notional >= this USD", "minimum": 0, "type": "number" } }, "required": [ "coin" ], "type": "object" }, "name": "get_hl_liq_levels", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "as_of": { "description": "ISO-8601 UTC of position read", "type": [ "string", "null" ] }, "billing": { "description": "Charged only on this 200", "type": [ "string", "null" ] }, "coin": { "description": "Ticker", "type": [ "string", "null" ] }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "levels": { "description": "{band_width_pct, range_pct, long_liqs_below[], short_liqs_above[]} 1% bands", "properties": { "band_width_pct": { "type": [ "number", "null" ] }, "long_liqs_below": { "type": "array" }, "range_pct": { "type": [ "number", "null" ] }, "short_liqs_above": { "type": "array" } }, "type": "object" }, "mark_px": { "description": "Current mark price", "type": [ "number", "null" ] }, "nearest": { "description": "{long_liq, short_liq} nearest position to liquidation per side (null if none)", "properties": { "long_liq": { "type": "object" }, "short_liq": {} }, "type": "object" }, "positions": { "description": "Positions with liquidation price", "type": "array" }, "positions_without_liq_px": { "description": "Positions with no liquidation price (e.g. over-collateralized)", "type": "array" }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "route": { "description": "Route id", "type": [ "string", "null" ] }, "schema": { "description": "Response schema id", "type": [ "string", "null" ] }, "totals": { "description": "{long_positions, short_positions, long_notional_usd, short_notional_usd, without_liq_px}", "properties": { "long_notional_usd": { "type": [ "number", "null" ] }, "long_positions": { "type": [ "number", "null" ] }, "short_notional_usd": { "type": [ "number", "null" ] }, "short_positions": { "type": [ "number", "null" ] }, "without_liq_px": { "type": [ "number", "null" ] } }, "type": "object" }, "universe": { "description": "{tracked_accounts, accounts_read, accounts_with_position, selection, list_as_of}", "properties": { "accounts_read": { "type": [ "number", "null" ] }, "accounts_with_position": { "type": [ "number", "null" ] }, "list_as_of": { "type": [ "string", "null" ] }, "selection": { "type": [ "string", "null" ] }, "tracked_accounts": { "type": [ "number", "null" ] } }, "type": "object" }, "venue": { "description": "hyperliquid", "type": [ "string", "null" ] } }, "required": [ "as_of", "billing", "coin", "disclaimer", "levels", "mark_px", "nearest", "positions", "positions_without_liq_px", "route", "schema", "totals", "universe", "venue" ], "title": "Paid HTTP 200 body of GET /hyperliquid/liq-levels/{coin}", "type": "object" } ], "type": "object" } }, { "description": "Use when you need a ready-made crypto market summary for a user, report or daily briefing. Latest twice-daily crypto market brief ($0.015/call, USDC on Base via x402), JSON + markdown: headline and bottom line, news sentiment and Fear & Greed, funding rates and open interest with crowded-trade flags, watchlist prices with 24h/7d moves, top news, macro calendar and token unlocks for the next 7 days. For agents writing reports. Stale/missing brief: 503, no charge. Free preview: get_sample_brief. Example: GET https://cryptofeed402.site/brief/latest", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "get_latest_brief", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "brief": { "description": "Structured brief object (coins, funding, sentiment, news, calendar, bottom_line)", "properties": { "bottom_line": { "type": [ "string", "null" ] }, "coins": { "type": "object" }, "date": { "type": [ "string", "null" ] }, "extreme_funding_hl": { "type": "array" }, "labels": { "type": "object" }, "market": { "type": "object" } }, "type": "object" }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "generated_at": { "description": "ISO-8601 UTC time the brief was written", "type": [ "string", "null" ] }, "headline": { "description": "One-line headline", "type": [ "string", "null" ] }, "markdown": { "description": "Full brief as markdown", "type": [ "string", "null" ] }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "source": { "description": "Writer (primary or standby)", "type": [ "string", "null" ] } }, "required": [ "brief", "disclaimer", "generated_at", "headline", "markdown", "source" ], "title": "Paid HTTP 200 body of GET /brief/latest", "type": "object" } ], "type": "object" } }, { "description": "Use when you need recent crypto liquidations (long vs short, USD notional) for one coin in the last 15 min to 24h. Recent crypto liquidations for one coin ($0.003/call, USDC on Base via x402). OKX USDT-SWAP public liquidation orders over the last hours=0.25-24 (default 1): count and USD notional split long/short, contract value, and each event (time, price, size, notional, side). Unknown symbol or upstream error: no charge. Example: GET https://cryptofeed402.site/liquidations/BTC?hours=1", "inputSchema": { "additionalProperties": false, "examples": [ { "hours": 1, "symbol": "BTC" } ], "properties": { "hours": { "examples": [ 1 ], "maximum": 24, "minimum": 0.25, "type": "number" }, "symbol": { "description": "Ticker, e.g. BTC", "examples": [ "BTC" ], "pattern": "^[A-Za-z0-9]{2,20}$", "type": "string" } }, "required": [ "symbol" ], "type": "object" }, "name": "get_liquidations", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "as_of": { "description": "ISO-8601 UTC", "type": [ "string", "null" ] }, "billing": { "description": "Charged only on this 200", "type": [ "string", "null" ] }, "contract_value": { "description": "{ct_val, ct_val_ccy} OKX contract size", "properties": { "ct_val": { "type": [ "number", "null" ] }, "ct_val_ccy": { "type": [ "string", "null" ] } }, "type": "object" }, "count": { "description": "Number of liquidation events", "type": [ "number", "null" ] }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "events": { "description": "[{time, price, size_contracts, size_coins, notional_usd, side, venue}]", "items": { "type": "object" }, "type": "array" }, "long_liquidations": { "description": "{count, notional_usd} longs liquidated", "properties": { "count": { "type": [ "number", "null" ] }, "notional_usd": { "type": [ "number", "null" ] } }, "type": "object" }, "notional_usd_total": { "description": "Total liquidated USD", "type": [ "number", "null" ] }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "short_liquidations": { "description": "{count, notional_usd} shorts liquidated", "properties": { "count": { "type": [ "number", "null" ] }, "notional_usd": { "type": [ "number", "null" ] } }, "type": "object" }, "symbol": { "description": "Ticker", "type": [ "string", "null" ] }, "venue": { "description": "okx", "type": [ "string", "null" ] }, "window_hours": { "description": "Window actually used", "type": [ "number", "null" ] } }, "required": [ "as_of", "billing", "contract_value", "count", "disclaimer", "events", "long_liquidations", "notional_usd_total", "short_liquidations", "symbol", "venue", "window_hours" ], "title": "Paid HTTP 200 body of GET /liquidations/{symbol}", "type": "object" } ], "type": "object" } }, { "description": "Use when you need up to 7 days of hourly/daily long vs short liquidation history for one coin. Weekly crypto liquidation history ($0.005/call, USDC on Base via x402). For one symbol (OKX USDT-SWAP, recorded continuously by cryptofeed402), days=1-7 (default 7): hourly and daily long/short buckets in USD, totals, long share %, largest single liquidation and top 5 hours. Reports real coverage (hours covered vs requested). Untracked, warming or stale: error, no charge. Example: GET https://cryptofeed402.site/liquidations/weekly/BTC?days=7", "inputSchema": { "additionalProperties": false, "examples": [ { "days": 7, "symbol": "BTC" } ], "properties": { "days": { "examples": [ 7 ], "maximum": 7, "minimum": 1, "type": "integer" }, "symbol": { "description": "Ticker, e.g. BTC", "examples": [ "BTC" ], "pattern": "^[A-Za-z0-9]{2,20}$", "type": "string" } }, "required": [ "symbol" ], "type": "object" }, "name": "get_liquidations_weekly", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "as_of": { "description": "Last collector update", "type": [ "string", "null" ] }, "billing": { "description": "Charged only on this 200", "type": [ "string", "null" ] }, "bucket": { "description": "Bucket size (1h UTC)", "type": [ "string", "null" ] }, "coverage": { "description": "{hours_requested, hours_covered, complete, covered_from}", "properties": { "complete": { "type": "boolean" }, "covered_from": { "type": [ "string", "null" ] }, "hours_covered": { "type": [ "number", "null" ] }, "hours_requested": { "type": [ "number", "null" ] } }, "type": "object" }, "daily": { "description": "Per UTC day long/short counts and USD", "items": { "type": "object" }, "type": "array" }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "hourly": { "description": "Every hourly bucket", "items": { "type": "object" }, "type": "array" }, "instrument": { "description": "OKX instrument id", "type": [ "string", "null" ] }, "method": { "description": "{notional, side} definitions", "properties": { "notional": { "type": [ "string", "null" ] }, "side": { "type": [ "string", "null" ] } }, "type": "object" }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "route": { "description": "Route id", "type": [ "string", "null" ] }, "schema": { "description": "Response schema id", "type": [ "string", "null" ] }, "symbol": { "description": "Ticker", "type": [ "string", "null" ] }, "top_hours": { "description": "Top 5 hours by USD liquidated", "items": { "type": "object" }, "type": "array" }, "totals": { "description": "{long_count, short_count, long_usd, short_usd, total_usd, long_share_pct, net_long_minus_short_usd, largest_single_usd}", "properties": { "largest_single_usd": { "type": [ "number", "null" ] }, "long_count": { "type": [ "number", "null" ] }, "long_share_pct": { "type": [ "number", "null" ] }, "long_usd": { "type": [ "number", "null" ] }, "net_long_minus_short_usd": { "type": [ "number", "null" ] }, "short_count": { "type": [ "number", "null" ] }, "short_usd": { "type": [ "number", "null" ] }, "total_usd": { "type": [ "number", "null" ] } }, "type": "object" }, "venue": { "description": "okx", "type": [ "string", "null" ] }, "window_days": { "description": "Days requested", "type": [ "number", "null" ] } }, "required": [ "as_of", "billing", "bucket", "coverage", "daily", "disclaimer", "hourly", "instrument", "method", "route", "schema", "symbol", "top_hours", "totals", "venue", "window_days" ], "title": "Paid HTTP 200 body of GET /liquidations/weekly/{symbol}", "type": "object" } ], "type": "object" } }, { "description": "Use when you need the week's top crypto news narratives with sources for a weekly report. Weekly crypto narratives pack ($0.025/call, USDC on Base via x402): top multi-outlet story clusters from 7 days of headline-tagger events, each with rank, asset, event type, outlet counts, corroboration, title, blurb and links. Missing/stale: no charge. Example: GET https://cryptofeed402.site/narratives/weekly", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "get_narratives_weekly", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "age_seconds": { "description": "Data age", "type": [ "number", "null" ] }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "generated_at": { "description": "Build time", "type": [ "string", "null" ] }, "narratives": { "description": "[{rank, cluster_id, asset, event_slug, event_type, event_count, outlets_max, outlets_sum, corroboration, title, blurb, links[]}]", "items": { "type": "object" }, "type": "array" }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "source_runs": { "description": "Tagger runs used", "type": [ "number", "null" ] }, "timezone": { "description": "Timezone", "type": [ "string", "null" ] }, "week_id": { "description": "ISO week id", "type": [ "string", "null" ] }, "window_end": { "description": "Window end", "type": [ "string", "null" ] }, "window_start": { "description": "Window start", "type": [ "string", "null" ] } }, "required": [ "age_seconds", "disclaimer", "generated_at", "narratives", "source_runs", "timezone", "week_id", "window_end", "window_start" ], "title": "Paid HTTP 200 body of GET /narratives/weekly", "type": "object" } ], "type": "object" } }, { "description": "Use when you need recent hourly open interest history for a Hyperliquid perp (up to 8 days). Open interest history for one Hyperliquid main-dex perp ($0.005/call, USDC on Base via x402): about-hourly points with OI in coins and USD, mark price and hourly funding rate, plus % change and min/max. From cryptofeed402's own snapshots (8-day retention; Hyperliquid has no public OI history). hours=1-192 (default 24). HIP-3 not supported. Errors: no charge. Example: GET https://cryptofeed402.site/oi/history/BTC?hours=24", "inputSchema": { "additionalProperties": false, "examples": [ { "hours": 24, "symbol": "BTC" } ], "properties": { "hours": { "examples": [ 24 ], "maximum": 192, "minimum": 1, "type": "integer" }, "symbol": { "description": "Hyperliquid main-dex perp ticker, e.g. BTC", "examples": [ "BTC" ], "pattern": "^[A-Za-z0-9]{1,20}$", "type": "string" } }, "required": [ "symbol" ], "type": "object" }, "name": "get_oi_history", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "as_of": { "description": "ISO-8601 UTC", "type": [ "string", "null" ] }, "count": { "description": "Points returned", "type": [ "number", "null" ] }, "coverage": { "description": "{first_snapshot_at, retention_days, max_hours_per_call, note}", "properties": { "first_snapshot_at": { "type": [ "string", "null" ] }, "max_hours_per_call": { "type": [ "number", "null" ] }, "note": { "type": [ "string", "null" ] }, "retention_days": { "type": [ "number", "null" ] } }, "type": "object" }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "generated_at": { "description": "Response time", "type": [ "string", "null" ] }, "interval": { "description": "Point spacing", "type": [ "string", "null" ] }, "points": { "description": "[{time, open_interest_coins, open_interest_usd, mark_px, funding_hourly}]", "items": { "type": "object" }, "type": "array" }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "source": { "description": "Snapshot source", "type": [ "string", "null" ] }, "stats": { "description": "{change_pct, min_coins, max_coins, first_at, last_at}", "properties": { "change_pct": { "type": [ "number", "null" ] }, "first_at": { "type": [ "string", "null" ] }, "last_at": { "type": [ "string", "null" ] }, "max_coins": { "type": [ "number", "null" ] }, "min_coins": { "type": [ "number", "null" ] } }, "type": "object" }, "symbol": { "description": "Ticker", "type": [ "string", "null" ] }, "venue": { "description": "hyperliquid", "type": [ "string", "null" ] }, "window": { "description": "{from, to, hours}", "properties": { "from": { "type": [ "string", "null" ] }, "hours": { "type": [ "number", "null" ] }, "to": { "type": [ "string", "null" ] } }, "type": "object" } }, "required": [ "as_of", "count", "coverage", "disclaimer", "generated_at", "interval", "points", "source", "stats", "symbol", "venue", "window" ], "title": "Paid HTTP 200 body of GET /oi/history/{symbol}", "type": "object" } ], "type": "object" } }, { "description": "Use when running a pre-trade check on one perp: price divergence, funding, OI change, sentiment and flags. Pre-trade preflight for one Hyperliquid perp ($0.01/call, USDC on Base via x402): factual summary string, perp mark vs OKX spot and vs oracle (bps), funding rate hourly/8h/annualized with next funding time and extreme rank, open interest with change vs ~1h/4h/24h/7d, news sentiment if covered, per-component as_of and neutral flags (funding_extreme, oi_spike, venue_divergence, stale_component). No buy/sell call. Errors: no charge. Example: GET https://cryptofeed402.site/outlook/BTC", "inputSchema": { "additionalProperties": false, "examples": [ { "symbol": "BTC" } ], "properties": { "symbol": { "description": "Hyperliquid perp ticker, e.g. BTC, ETH, kPEPE; HIP-3 builder-dex perps as dex:TICKER, e.g. xyz:TSLA", "examples": [ "BTC" ], "pattern": "^(?:[A-Za-z]{1,10}:)?[A-Za-z0-9]{1,20}$", "type": "string" } }, "required": [ "symbol" ], "type": "object" }, "name": "get_outlook", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "active_flags": { "type": "array" }, "as_of": { "description": "ISO-8601 UTC", "type": [ "string", "null" ] }, "disclaimer": { "type": [ "string", "null" ] }, "flag_rules": { "properties": { "funding_extreme": { "type": [ "string", "null" ] }, "oi_spike": { "type": [ "string", "null" ] }, "stale_component": { "type": [ "string", "null" ] }, "venue_divergence": { "type": [ "string", "null" ] } }, "type": "object" }, "flags": { "properties": { "funding_extreme": { "type": "boolean" }, "oi_spike": { "type": "boolean" }, "stale_component": { "type": "boolean" }, "venue_divergence": { "type": "boolean" } }, "type": "object" }, "freshness": { "properties": { "oi_history": { "type": "object" }, "perp": { "type": "object" }, "sentiment": { "type": "object" }, "spot": { "type": "object" } }, "type": "object" }, "funding": { "description": "Funding rates, next funding, extreme rank", "properties": { "annualized_pct": { "type": [ "number", "null" ] }, "as_of": { "type": [ "string", "null" ] }, "extreme_rank": { "type": [ "number", "null" ] }, "in_top10": { "type": "boolean" }, "interval_hours": { "type": [ "number", "null" ] }, "next_funding_time": { "type": [ "string", "null" ] }, "ranked_universe": { "type": [ "number", "null" ] }, "rate_8h": { "type": [ "number", "null" ] }, "rate_hourly": { "type": [ "number", "null" ] }, "side_paying": { "type": [ "string", "null" ] }, "time_to_next_seconds": { "type": [ "number", "null" ] } }, "type": "object" }, "generated_at": { "description": "Response time", "type": [ "string", "null" ] }, "kind": { "description": "main or hip3", "type": [ "string", "null" ] }, "max_leverage": { "description": "Venue max leverage", "type": [ "number", "null" ] }, "not_included": { "properties": { "liquidation_levels": { "type": [ "string", "null" ] }, "recommendation": { "type": [ "string", "null" ] } }, "type": "object" }, "open_interest": { "description": "OI coins/usd and % change vs 1h/4h/24h/7d", "properties": { "as_of": { "type": [ "string", "null" ] }, "change_1h_pct": { "type": [ "number", "null" ] }, "change_24h_pct": { "type": [ "number", "null" ] }, "change_4h_pct": { "type": [ "number", "null" ] }, "change_7d_pct": { "type": [ "number", "null" ] }, "coins": { "type": [ "number", "null" ] }, "note": { "type": [ "string", "null" ] }, "ref_1h_at": { "type": [ "string", "null" ] }, "ref_24h_at": { "type": [ "string", "null" ] }, "ref_4h_at": { "type": [ "string", "null" ] }, "ref_7d_at": { "type": [ "string", "null" ] }, "usd": { "type": [ "number", "null" ] } }, "type": "object" }, "price": { "description": "perp/spot/oracle prices and bps divergences", "properties": { "as_of": { "type": "object" }, "change_24h_pct": { "type": [ "number", "null" ] }, "mark_vs_oracle_bps": { "type": [ "number", "null" ] }, "mark_vs_spot_bps": { "type": [ "number", "null" ] }, "note": { "type": [ "string", "null" ] }, "perp_mark_px": { "type": [ "number", "null" ] }, "perp_mid_px": { "type": [ "number", "null" ] }, "perp_oracle_px": { "type": [ "number", "null" ] }, "premium_pct": { "type": [ "number", "null" ] }, "spot_pair": { "type": [ "string", "null" ] }, "spot_px": { "type": [ "number", "null" ] }, "spot_venue": { "type": [ "string", "null" ] } }, "type": "object" }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "sentiment": { "properties": { "age_seconds": { "type": [ "number", "null" ] }, "as_of": { "type": [ "string", "null" ] }, "available": { "type": "boolean" }, "label": { "type": [ "string", "null" ] }, "n_headlines": { "type": [ "number", "null" ] }, "score": { "type": [ "number", "null" ] }, "window_minutes": { "type": [ "number", "null" ] } }, "type": "object" }, "summary": { "description": "Short factual summary", "type": [ "string", "null" ] }, "symbol": { "description": "Ticker", "type": [ "string", "null" ] }, "venue": { "description": "hyperliquid", "type": [ "string", "null" ] }, "volume_24h_usd": { "description": "24h volume USD", "type": [ "number", "null" ] } }, "required": [ "active_flags", "as_of", "disclaimer", "flag_rules", "flags", "freshness", "funding", "generated_at", "kind", "max_leverage", "not_included", "open_interest", "price", "sentiment", "summary", "symbol", "venue", "volume_24h_usd" ], "title": "Paid HTTP 200 body of GET /outlook/{symbol}", "type": "object" } ], "type": "object" } }, { "description": "Use when you need one perp's funding rate, next funding time, open interest and mark/oracle price. Perps radar for one coin ($0.002/call, USDC on Base via x402): Hyperliquid funding rate hourly/8h/annualized with next_funding_time and time_to_next_seconds, open interest in coins and USD, 24h volume, mark/oracle/mid price, premium, max leverage, impact prices, top-10 extreme-funding rank and other-venue funding where available. HIP-3 (xyz:TSLA) supported (rank null). Unknown symbol: no charge. Example: GET https://cryptofeed402.site/perps/BTC", "inputSchema": { "additionalProperties": false, "examples": [ { "symbol": "ETH" } ], "properties": { "symbol": { "description": "Hyperliquid perp ticker, e.g. BTC, ETH, kPEPE; HIP-3 builder-dex perps as dex:TICKER, e.g. xyz:TSLA", "examples": [ "ETH" ], "pattern": "^(?:[A-Za-z]{1,10}:)?[A-Za-z0-9]{1,20}$", "type": "string" } }, "required": [ "symbol" ], "type": "object" }, "name": "get_perps", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "as_of": { "description": "Upstream time", "type": [ "string", "null" ] }, "change_24h_pct": { "description": "24h change %", "type": [ "number", "null" ] }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "funding": { "description": "{rate_hourly, rate_8h, annualized_pct, interval_hours, side_paying, next_funding_time, time_to_next_seconds}", "properties": { "annualized_pct": { "type": [ "number", "null" ] }, "interval_hours": { "type": [ "number", "null" ] }, "next_funding_time": { "type": [ "string", "null" ] }, "rate_8h": { "type": [ "number", "null" ] }, "rate_hourly": { "type": [ "number", "null" ] }, "side_paying": { "type": [ "string", "null" ] }, "time_to_next_seconds": { "type": [ "number", "null" ] } }, "type": "object" }, "funding_extreme": { "description": "{in_top10, rank, ranked_universe, rule, top10[]}", "properties": { "in_top10": { "type": "boolean" }, "rank": { "type": [ "number", "null" ] }, "ranked_universe": { "type": [ "number", "null" ] }, "rule": { "type": [ "string", "null" ] }, "top10": { "type": "array" } }, "type": "object" }, "generated_at": { "description": "Response time", "type": [ "string", "null" ] }, "impact_px": { "description": "{bid, ask} impact prices", "properties": { "ask": { "type": [ "number", "null" ] }, "bid": { "type": [ "number", "null" ] } }, "type": "object" }, "mark_px": { "description": "Mark price", "type": [ "number", "null" ] }, "max_leverage": { "description": "Venue max leverage", "type": [ "number", "null" ] }, "mid_px": { "description": "Mid price", "type": [ "number", "null" ] }, "not_included": { "description": "What this route does not return", "properties": { "liquidation_clusters": { "type": [ "string", "null" ] } }, "type": "object" }, "open_interest": { "description": "{coins, usd}", "properties": { "coins": { "type": [ "number", "null" ] }, "usd": { "type": [ "number", "null" ] } }, "type": "object" }, "oracle_px": { "description": "Oracle price", "type": [ "number", "null" ] }, "premium": { "description": "Mark vs oracle premium (fraction)", "type": [ "number", "null" ] }, "premium_pct": { "description": "Premium in %", "type": [ "number", "null" ] }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "source": { "description": "Upstream sources", "type": [ "string", "null" ] }, "symbol": { "description": "Ticker", "type": [ "string", "null" ] }, "venue": { "description": "hyperliquid", "type": [ "string", "null" ] }, "venues": { "description": "Other-venue funding rows", "items": { "type": "object" }, "type": "array" }, "volume_24h_usd": { "description": "24h volume USD", "type": [ "number", "null" ] } }, "required": [ "as_of", "change_24h_pct", "disclaimer", "funding", "funding_extreme", "generated_at", "impact_px", "mark_px", "max_leverage", "mid_px", "not_included", "open_interest", "oracle_px", "premium", "premium_pct", "source", "symbol", "venue", "venues", "volume_24h_usd" ], "title": "Paid HTTP 200 body of GET /perps/{symbol}", "type": "object" } ], "type": "object" } }, { "description": "Use when a trading agent needs one call covering perp state, funding, OI and news sentiment for many coins. One-call perps + news market scan for trading agents ($0.01/call, USDC on Base via x402). For the default set (watchlist + coins in the news, up to 25) or 1-20 symbols you pass: Hyperliquid mark, oracle, 24h change, funding hourly/8h/annualized, open interest USD, 24h volume, premium, extreme-funding rank, joined with news sentiment, headline attention vs 7-day average and neutral flags. Facts only. Errors are not charged. Example: GET https://cryptofeed402.site/perps/context?symbols=BTC,ETH", "inputSchema": { "additionalProperties": false, "examples": [ { "symbols": [ "BTC", "ETH", "SOL" ] }, {} ], "properties": { "symbols": { "description": "Optional Hyperliquid main-dex tickers; omit for the default set (watchlist + coins in the news)", "examples": [ [ "BTC", "ETH", "SOL" ] ], "items": { "pattern": "^[A-Za-z0-9]{1,20}$", "type": "string" }, "maxItems": 20, "minItems": 1, "type": "array", "uniqueItems": true } }, "type": "object" }, "name": "get_perps_context", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "as_of": { "description": "ISO-8601 UTC", "type": [ "string", "null" ] }, "coins": { "description": "Per coin: coin, in_watchlist, perp{}, sentiment{}, attention{}, flags{}, active_flags[]", "items": { "type": "object" }, "type": "array" }, "count": { "description": "Number of coins returned", "type": [ "number", "null" ] }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "freshness": { "description": "Per-component freshness: perp, sentiment, attention", "properties": { "attention": { "type": "object" }, "perp": { "type": "object" }, "sentiment": { "type": "object" } }, "type": "object" }, "method": { "description": "How fields are computed", "type": [ "string", "null" ] }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "selection": { "description": "How coins were chosen (default set or symbols param)", "type": [ "string", "null" ] }, "source": { "description": "Upstream sources", "type": [ "string", "null" ] } }, "required": [ "as_of", "coins", "count", "disclaimer", "freshness", "method", "selection", "source" ], "title": "Paid HTTP 200 body of GET /perps/context", "type": "object" } ], "type": "object" } }, { "description": "Use when you need a live crypto price API call: perp mark, funding rate, open interest and OKX spot for one coin. Crypto price API for trading agents ($0.0025/call, USDC on Base via x402). For one Hyperliquid perp (BTC, ETH, kPEPE, or HIP-3 like xyz:TSLA) returns perp mark price, hourly funding rate and annualized funding APR, open interest in coins and USD, 24h volume, premium, plus OKX spot last price and 24h change (no spot for HIP-3). Unknown symbol: error, no charge. Example: GET https://cryptofeed402.site/price/BTC", "inputSchema": { "additionalProperties": false, "examples": [ { "symbol": "BTC" } ], "properties": { "symbol": { "description": "Hyperliquid perp ticker, e.g. BTC, ETH, kPEPE; HIP-3 builder-dex perps as dex:TICKER, e.g. xyz:TSLA", "examples": [ "BTC" ], "pattern": "^(?:[A-Za-z]{1,10}:)?[A-Za-z0-9]{1,20}$", "type": "string" } }, "required": [ "symbol" ], "type": "object" }, "name": "get_price", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "as_of": { "description": "ISO-8601 UTC time of the snapshot", "type": [ "string", "null" ] }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "perp": { "description": "Hyperliquid perp: venue, mark_px, funding_hourly, funding_apr_pct, open_interest_coins, open_interest_usd, volume_24h_usd, premium", "properties": { "funding_apr_pct": { "type": [ "number", "null" ] }, "funding_hourly": { "type": [ "number", "null" ] }, "mark_px": { "type": [ "number", "null" ] }, "open_interest_coins": { "type": [ "number", "null" ] }, "open_interest_usd": { "type": [ "number", "null" ] }, "premium": { "type": [ "number", "null" ] }, "venue": { "type": [ "string", "null" ] }, "volume_24h_usd": { "type": [ "number", "null" ] } }, "type": "object" }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "spot": { "description": "OKX spot: venue, last, open_24h, change_24h_pct (absent/null for HIP-3)", "properties": { "change_24h_pct": { "type": [ "number", "null" ] }, "last": { "type": [ "number", "null" ] }, "open_24h": { "type": [ "number", "null" ] }, "venue": { "type": [ "string", "null" ] } }, "type": "object" }, "symbol": { "description": "Ticker requested", "type": [ "string", "null" ] } }, "required": [ "as_of", "disclaimer", "perp", "spot", "symbol" ], "title": "Paid HTTP 200 body of GET /price/{symbol}", "type": "object" } ], "type": "object" } }, { "description": "Use when you need current per-call prices, network and payTo before paying. Free: current per-call prices for every cryptofeed402 route (USDC on Base, eip155:8453, via x402), payTo address, launch discount and billing rule (charged only on a valid 200). Example: GET https://cryptofeed402.site/pricing", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "get_pricing", "outputSchema": { "properties": { "currency": { "description": "USDC", "type": [ "string", "null" ] }, "effective": { "description": "Route -> effective price map, plus billing rule", "properties": { "/attention": { "type": [ "string", "null" ] }, "/attention/{symbol}": { "type": [ "string", "null" ] }, "/audit/agent-ready?url=": { "type": [ "string", "null" ] }, "/audit/sample": { "type": [ "string", "null" ] }, "/brief/latest": { "type": [ "string", "null" ] }, "/brief/sample": { "type": [ "string", "null" ] }, "/brief/teaser": { "type": [ "string", "null" ] }, "/briefs/history": { "type": [ "string", "null" ] }, "/bundle/brief-sentiment-perps": { "type": [ "string", "null" ] }, "/candles/{symbol}": { "type": [ "string", "null" ] }, "/coverage/heat": { "type": [ "string", "null" ] }, "/feedback/schedule": { "type": [ "string", "null" ] }, "/funding/extreme": { "type": [ "string", "null" ] }, "/funding/history/{symbol}": { "type": [ "string", "null" ] }, "/funding/spread": { "type": [ "string", "null" ] }, "/history (cap per call)": { "type": [ "string", "null" ] }, "/history (per day)": { "type": [ "string", "null" ] }, "/hyperliquid/liq-levels/{coin}": { "type": [ "string", "null" ] }, "/liquidations/weekly/{symbol}": { "type": [ "string", "null" ] }, "/liquidations/{symbol}": { "type": [ "string", "null" ] }, "/narratives/weekly": { "type": [ "string", "null" ] }, "/oi/history/{symbol}": { "type": [ "string", "null" ] }, "/outlook/{symbol}": { "type": [ "string", "null" ] }, "/perps/context": { "type": [ "string", "null" ] }, "/perps/{symbol}": { "type": [ "string", "null" ] }, "/price/{symbol}": { "type": [ "string", "null" ] }, "/request/asset/top": { "type": [ "string", "null" ] }, "/samples/{price|funding|perps|sentiment|history|outlook|funding-history|candles|spot|oi-history|attention|narratives-weekly|perps-context|funding-spread|liquidations|liquidations-weekly|hl-liq-levels|bundle|coverage-heat|briefs-history}": { "type": [ "string", "null" ] }, "/sentiment": { "type": [ "string", "null" ] }, "/sentiment/{symbol}": { "type": [ "string", "null" ] }, "/spot/{symbol}": { "type": [ "string", "null" ] }, "POST /feedback/schedule": { "type": [ "string", "null" ] }, "POST /request/asset": { "type": [ "string", "null" ] }, "billing": { "type": [ "string", "null" ] } }, "type": "object" }, "launch_discount": { "description": "Discount factor vs list", "type": [ "number", "null" ] }, "list_prices_usd": { "description": "List prices", "properties": { "brief": { "type": [ "number", "null" ] }, "historyCap": { "type": [ "number", "null" ] }, "historyDay": { "type": [ "number", "null" ] }, "lookup": { "type": [ "number", "null" ] }, "outlook": { "type": [ "number", "null" ] } }, "type": "object" }, "network": { "description": "eip155:8453", "type": [ "string", "null" ] }, "payTo": { "description": "Receiving address", "type": [ "string", "null" ] } }, "required": [ "currency", "effective", "launch_discount", "list_prices_usd", "network", "payTo" ], "type": "object" } }, { "description": "Use when you want to see the brief format free before paying for get_latest_brief. Free delayed, trimmed sample of the twice-daily crypto brief (previous edition; no open interest, sentiment or markdown). Limit 30/hour/IP. Use to evaluate before paying $0.015 for get_latest_brief. Example: GET https://cryptofeed402.site/brief/sample", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "get_sample_brief", "outputSchema": { "properties": { "brief": { "description": "{date, coins{}, extreme_funding_hl[], bottom_line}", "properties": { "bottom_line": { "type": [ "string", "null" ] }, "coins": { "type": "object" }, "date": { "type": [ "string", "null" ] }, "extreme_funding_hl": { "type": "array" } }, "type": "object" }, "delayed": { "description": "True: previous edition", "type": "boolean" }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "full_brief": { "description": "{url, price, currency, network, payment} for the paid brief", "properties": { "currency": { "type": [ "string", "null" ] }, "network": { "type": [ "string", "null" ] }, "payment": { "type": [ "string", "null" ] }, "price": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ] } }, "type": "object" }, "generated_at": { "description": "Brief time", "type": [ "string", "null" ] }, "headline": { "description": "Headline", "type": [ "string", "null" ] }, "note": { "description": "Sample notes", "type": [ "string", "null" ] }, "omitted": { "description": "Fields removed from the sample", "items": { "type": [ "string", "null" ] }, "type": "array" }, "sample": { "description": "Always true", "type": "boolean" } }, "required": [ "brief", "delayed", "disclaimer", "full_brief", "generated_at", "headline", "note", "omitted", "sample" ], "type": "object" } }, { "description": "Use when you need bullish/bearish crypto news sentiment and top headlines for one coin. Crypto news sentiment for one coin ($0.002/call, USDC on Base via x402): score -1..1, bearish/neutral/bullish label, positive/negative/neutral headline counts and up to 5 top headlines with links and stance. Headlines labeled by a local LLM, refreshed about every 15 min. Free list of covered symbols: GET /sentiment. Uncovered or stale: no charge. Example: GET https://cryptofeed402.site/sentiment/BTC", "inputSchema": { "additionalProperties": false, "examples": [ { "symbol": "BTC" } ], "properties": { "symbol": { "description": "Ticker, e.g. BTC, ETH, SOL", "examples": [ "BTC" ], "pattern": "^[A-Za-z0-9]{1,20}$", "type": "string" } }, "required": [ "symbol" ], "type": "object" }, "name": "get_sentiment", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "age_seconds": { "description": "Snapshot age", "type": [ "number", "null" ] }, "counts": { "description": "{n_headlines, pos, neg, neu}", "properties": { "n_headlines": { "type": [ "number", "null" ] }, "neg": { "type": [ "number", "null" ] }, "neu": { "type": [ "number", "null" ] }, "pos": { "type": [ "number", "null" ] } }, "type": "object" }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "generated_at": { "description": "ISO-8601 UTC", "type": [ "string", "null" ] }, "label": { "description": "bearish|neutral|bullish", "type": [ "string", "null" ] }, "method": { "description": "Scoring method", "type": [ "string", "null" ] }, "model": { "description": "Labeling model", "type": [ "string", "null" ] }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "score": { "description": "-1..1 sentiment score", "type": [ "number", "null" ] }, "symbol": { "description": "Ticker", "type": [ "string", "null" ] }, "top_headlines": { "description": "[{title, source, url, stance}] up to 5", "items": { "type": "object" }, "type": "array" }, "window_minutes": { "description": "Lookback window", "type": [ "number", "null" ] } }, "required": [ "age_seconds", "counts", "disclaimer", "generated_at", "label", "method", "model", "score", "symbol", "top_headlines", "window_minutes" ], "title": "Paid HTTP 200 body of GET /sentiment/{symbol}", "type": "object" } ], "type": "object" } }, { "description": "Use when you need a live crypto spot price, bid/ask and spread for a <SYMBOL>-USDT pair on OKX. Crypto spot price API ($0.002/call, USDC on Base via x402): OKX spot ticker for any live <SYMBOL>-USDT pair: last, bid/ask with sizes, mid, spread in bps, 24h open/high/low/change, UTC-day change and 24h volume (base and USDT). Unknown pair: no charge. Example: GET https://cryptofeed402.site/spot/BTC", "inputSchema": { "additionalProperties": false, "examples": [ { "symbol": "BTC" } ], "properties": { "symbol": { "description": "Base ticker, e.g. BTC, PEPE, TON", "examples": [ "BTC" ], "pattern": "^[A-Za-z0-9]{1,20}$", "type": "string" } }, "required": [ "symbol" ], "type": "object" }, "name": "get_spot", "outputSchema": { "anyOf": [ { "properties": { "accepts": { "items": { "properties": { "amount": { "description": "USDC atomic units (6 decimals)", "type": "string" }, "asset": { "type": "string" }, "extra": { "type": "object" }, "maxTimeoutSeconds": { "type": "number" }, "network": { "const": "eip155:8453", "type": "string" }, "payTo": { "type": "string" }, "scheme": { "const": "exact", "type": "string" } }, "required": [ "scheme", "network", "amount", "asset", "payTo" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "resource": { "properties": { "description": { "type": "string" }, "mimeType": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "number" } }, "required": [ "x402Version", "accepts" ], "title": "x402 PaymentRequired (what this MCP tool returns, isError=true)", "type": "object" }, { "properties": { "age_seconds": { "description": "Quote age", "type": [ "number", "null" ] }, "as_of": { "description": "Upstream time", "type": [ "string", "null" ] }, "ask": { "description": "Best ask", "type": [ "number", "null" ] }, "ask_size": { "description": "Best ask size", "type": [ "number", "null" ] }, "bid": { "description": "Best bid", "type": [ "number", "null" ] }, "bid_size": { "description": "Best bid size", "type": [ "number", "null" ] }, "change_24h_pct": { "description": "24h change %", "type": [ "number", "null" ] }, "change_utc_day_pct": { "description": "UTC-day change %", "type": [ "number", "null" ] }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "generated_at": { "description": "Response time", "type": [ "string", "null" ] }, "high_24h": { "description": "24h high", "type": [ "number", "null" ] }, "last": { "description": "Last trade price", "type": [ "number", "null" ] }, "low_24h": { "description": "24h low", "type": [ "number", "null" ] }, "market": { "description": "spot", "type": [ "string", "null" ] }, "mid": { "description": "Mid price", "type": [ "number", "null" ] }, "open_24h": { "description": "Price 24h ago", "type": [ "number", "null" ] }, "open_utc0": { "description": "UTC-day open", "type": [ "number", "null" ] }, "pair": { "description": "OKX pair, e.g. BTC-USDT", "type": [ "string", "null" ] }, "provenance": { "description": "Optional provenance on paid 200s", "properties": { "data_sha256": { "type": "string" }, "fetched_at": { "type": "string" }, "max_age_s": { "type": "number" }, "source": { "type": "string" }, "sources": { "type": "array" } }, "type": "object" }, "quote_note": { "description": "Quote notes", "type": [ "string", "null" ] }, "source": { "description": "Upstream", "type": [ "string", "null" ] }, "spread_bps": { "description": "Bid/ask spread in bps", "type": [ "number", "null" ] }, "symbol": { "description": "Base ticker", "type": [ "string", "null" ] }, "venue": { "description": "okx", "type": [ "string", "null" ] }, "volume_24h_base": { "description": "24h volume (base)", "type": [ "number", "null" ] }, "volume_24h_usdt": { "description": "24h volume (USDT)", "type": [ "number", "null" ] } }, "required": [ "age_seconds", "as_of", "ask", "ask_size", "bid", "bid_size", "change_24h_pct", "change_utc_day_pct", "disclaimer", "generated_at", "high_24h", "last", "low_24h", "market", "mid", "open_24h", "open_utc0", "pair", "quote_note", "source", "spread_bps", "symbol", "venue", "volume_24h_base", "volume_24h_usdt" ], "title": "Paid HTTP 200 body of GET /spot/{symbol}", "type": "object" } ], "type": "object" } }, { "description": "Use when you want a free quick look at the latest brief, extreme funding and BTC/ETH/SOL prices. Free crypto brief teaser: latest brief headline and teaser text, Hyperliquid extreme funding rates (APR and 8h), watchlist funding line, BTC/ETH/SOL prices with 24h change. Limit 60/hour/IP. Full brief: get_latest_brief ($0.015). Example: GET https://cryptofeed402.site/brief/teaser", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "get_teaser", "outputSchema": { "properties": { "coins_covered": { "description": "Watchlist symbols", "items": { "type": [ "string", "null" ] }, "type": "array" }, "disclaimer": { "description": "Not financial advice notice", "type": [ "string", "null" ] }, "extreme_funding_coins": { "description": "Count of extreme-funding coins", "type": [ "number", "null" ] }, "extreme_funding_hl": { "description": "[{symbol, funding_apr_pct, funding_8h_pct}]", "items": { "type": "object" }, "type": "array" }, "full_brief": { "description": "Where to buy the full brief", "type": [ "string", "null" ] }, "generated_at": { "description": "Brief time", "type": [ "string", "null" ] }, "headline": { "description": "Brief headline", "type": [ "string", "null" ] }, "prices": { "description": "[{symbol, price, change_24h_pct}]", "items": { "type": "object" }, "type": "array" }, "session_pt": { "description": "Session label (PT)", "type": [ "string", "null" ] }, "teaser_text": { "description": "Short teaser", "type": [ "string", "null" ] }, "watchlist_funding": { "description": "Watchlist funding summary line", "type": [ "string", "null" ] } }, "required": [ "coins_covered", "disclaimer", "extreme_funding_coins", "extreme_funding_hl", "full_brief", "generated_at", "headline", "prices", "session_pt", "teaser_text", "watchlist_funding" ], "type": "object" } }, { "description": "Use when you want to see which coins other agents most want covered. Free: top 20 coins other agents asked cryptofeed402 to monitor in the last 30 days (aggregate counts only). Limit 60/hour/IP. Example: GET https://cryptofeed402.site/request/asset/top", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "get_top_requested_assets", "outputSchema": { "properties": { "counting": { "description": "Counting rule", "type": [ "string", "null" ] }, "distinct_symbols": { "description": "Distinct symbols", "type": [ "number", "null" ] }, "generated_at": { "description": "ISO-8601 UTC", "type": [ "string", "null" ] }, "note": { "description": "Notes", "type": [ "string", "null" ] }, "top": { "description": "[{symbol, count}]", "items": { "type": "object" }, "type": "array" }, "total": { "description": "Total requests", "type": [ "number", "null" ] }, "window_days": { "description": "Lookback days", "type": [ "number", "null" ] } }, "required": [ "counting", "distinct_symbols", "generated_at", "note", "top", "total", "window_days" ], "type": "object" } }, { "description": "Use when a coin you need is not covered and you want to ask for it to be added. Free: ask cryptofeed402 to monitor a coin it does not cover yet (covered: BTC, ETH, SOL, HYPE, NEAR, AAVE). Logged for human review, not a guarantee. Limit 10/hour/IP; repeats for the same symbol within 24h count once. Example: POST https://cryptofeed402.site/request/asset {\"symbol\":\"LINK\"}", "inputSchema": { "additionalProperties": false, "properties": { "agent": { "description": "Optional agent name/id (<=80 chars)", "maxLength": 80, "type": "string" }, "reason": { "description": "Optional short reason (<=200 chars)", "maxLength": 200, "type": "string" }, "symbol": { "description": "Ticker, e.g. LINK (2-15 chars, letters/digits, optional hyphen; leading $ ok)", "maxLength": 16, "minLength": 2, "type": "string" } }, "required": [ "symbol" ], "type": "object" }, "name": "request_asset", "outputSchema": { "properties": { "covered": { "items": { "type": "string" }, "type": "array" }, "error": { "type": "string" }, "message": { "enum": [ "queued for review", "already queued", "already covered" ], "type": "string" }, "note": { "type": "string" }, "ok": { "type": "boolean" }, "symbol": { "type": "string" } }, "required": [ "ok" ], "type": "object" } }, { "description": "Use when you want to tell cryptofeed402 how often and at which UTC hours you want fresh reports. Free: tell cryptofeed402 how often you want briefs/reports (hourly to daily or on_event) and up to 6 preferred UTC hours, plus optional symbols and routes. Stored only as aggregate demand (no IPs; notes and names never published). Limit 10/hour/IP. Example: POST https://cryptofeed402.site/feedback/schedule {\"frequency\":\"every_12h\",\"preferred_utc_hours\":[0,12]}", "inputSchema": { "additionalProperties": false, "properties": { "agent_name": { "maxLength": 64, "type": "string" }, "frequency": { "enum": [ "hourly", "every_4h", "every_6h", "every_12h", "daily", "on_event" ], "type": "string" }, "note": { "description": "Plain text", "maxLength": 280, "type": "string" }, "preferred_utc_hours": { "description": "Up to 6 UTC hours (0-23); [] = no preference", "items": { "maximum": 23, "minimum": 0, "type": "integer" }, "maxItems": 6, "type": "array", "uniqueItems": true }, "routes_of_interest": { "items": { "enum": [ "/price/{symbol}", "/funding/extreme", "/brief/latest", "/history", "/perps/{symbol}", "/sentiment/{symbol}", "/audit/agent-ready", "/brief/teaser", "/brief/sample", "/outlook/{symbol}", "/funding/history/{symbol}", "/candles/{symbol}", "/spot/{symbol}", "/oi/history/{symbol}", "/attention", "/attention/{symbol}", "/narratives/weekly", "/funding/spread", "/liquidations/{symbol}", "/bundle/brief-sentiment-perps" ], "type": "string" }, "type": "array", "uniqueItems": true }, "symbols": { "items": { "pattern": "^[A-Z0-9]{1,20}$", "type": "string" }, "maxItems": 20, "type": "array", "uniqueItems": true } }, "required": [ "frequency", "preferred_utc_hours" ], "type": "object" }, "name": "request_report_schedule", "outputSchema": { "properties": { "aggregate": { "type": "string" }, "error": { "type": "string" }, "message": { "type": "string" }, "ok": { "type": "boolean" }, "recorded": { "type": "boolean" } }, "required": [ "ok" ], "type": "object" } } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:eba8be648459ebd6deae130c66edfc6be04e94bd3f1e9d81f0e6d0b864fe570a | sha256sum