{"serverInfo":{"name":"cryptofeed402","title":"cryptofeed402 crypto data for agents","version":"1.5.0"},"description":"No account, no API key, no subscription: pay per call in USDC on Base, from $0.002 per call. cryptofeed402: crypto market data and per-asset news sentiment 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); errors are never charged. Not financial advice.","transport":{"type":"streamable-http","url":"https://cryptofeed402.site/mcp"},"authentication":{"required":false},"payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC","note":"Paid tools return x402 requirements; payment is made over HTTP by the caller."},"tools":[{"name":"get_teaser","title":"Brief teaser (free)","description":"Free: latest brief teaser text, Hyperliquid extreme funding (8h-equivalent rates), BTC/ETH/SOL prices with 24h change.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false}},{"name":"get_sample_brief","title":"Sample brief (free)","description":"Free: a delayed, trimmed sample of the twice-daily crypto brief (previous edition; no OI, sentiment or markdown). Use to evaluate before paying for get_latest_brief.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false}},{"name":"get_pricing","title":"Pricing (free)","description":"Free: current per-call prices (USDC on Base via x402), network and payTo address.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false}},{"name":"request_asset","title":"Request an asset to monitor (free)","description":"Free: ask cryptofeed402 to consider monitoring a coin it does not cover yet (covered: BTC, ETH, SOL, HYPE, NEAR, AAVE). Logged for human review; high-demand assets may be added to the brief and paid endpoints later. Not a guarantee. Limit 10/hour/IP; repeat asks for the same symbol within 24h count once.","inputSchema":{"type":"object","properties":{"symbol":{"type":"string","description":"Ticker, e.g. LINK (2-15 chars, letters/digits, optional hyphen; leading $ ok)","minLength":2,"maxLength":16},"reason":{"type":"string","description":"Optional short reason (<=200 chars)","maxLength":200},"agent":{"type":"string","description":"Optional agent name/id (<=80 chars)","maxLength":80}},"required":["symbol"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":true,"destructiveHint":false}},{"name":"request_report_schedule","title":"Tell us when you want reports (free)","description":"Free: tell cryptofeed402 how often you want briefs/reports and the best UTC hours to have a fresh one ready, so we can schedule to match. Logged as aggregate demand (GET /feedback/schedule shows counts only; notes and agent names are never published; no IPs stored). Limit 10/hour/IP.","inputSchema":{"type":"object","properties":{"frequency":{"type":"string","enum":["hourly","every_4h","every_6h","every_12h","daily","on_event"]},"preferred_utc_hours":{"type":"array","items":{"type":"integer","minimum":0,"maximum":23},"maxItems":6,"uniqueItems":true,"description":"Up to 6 UTC hours (0-23); [] = no preference"},"symbols":{"type":"array","items":{"type":"string","pattern":"^[A-Z0-9]{1,20}$"},"maxItems":20,"uniqueItems":true},"routes_of_interest":{"type":"array","items":{"type":"string","enum":["/price/{symbol}","/funding/extreme","/brief/latest","/history","/perps/{symbol}","/sentiment/{symbol}","/audit/agent-ready","/brief/teaser","/brief/sample","/outlook/{symbol}","/funding/history/{symbol}"]},"uniqueItems":true},"agent_name":{"type":"string","maxLength":64},"note":{"type":"string","maxLength":280,"description":"Plain text"}},"required":["frequency","preferred_utc_hours"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false,"destructiveHint":false}},{"name":"get_top_requested_assets","title":"Top requested assets (free)","description":"Free: top 20 coins other agents have asked cryptofeed402 to monitor in the last 30 days (aggregate counts only).","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false}},{"name":"get_price","title":"Coin lookup (paid, x402)","description":"Paid endpoint: perp mark, funding, OI (Hyperliquid) plus OKX spot for one coin. Returns the x402 payment requirements and URL; pay with your own x402 client. Free sample response: https://cryptofeed402.site/samples/price","inputSchema":{"type":"object","properties":{"symbol":{"type":"string","enum":["BTC","ETH","SOL","HYPE","NEAR","AAVE"]}},"required":["symbol"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false}},{"name":"get_extreme_funding","title":"Extreme funding (paid, x402)","description":"Paid endpoint: most extreme Hyperliquid funding rates right now. Returns the x402 payment requirements and URL. Free sample response: https://cryptofeed402.site/samples/funding","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false}},{"name":"get_latest_brief","title":"Latest brief (paid, x402)","description":"Paid endpoint: the full latest twice-daily crypto research brief (JSON + markdown). Returns the x402 payment requirements and URL. Free sample: get_sample_brief or https://cryptofeed402.site/brief/sample","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false}},{"name":"get_audit_sample","title":"Agent-readiness audit sample (free)","description":"Free: a cached example agent-readiness audit of cryptofeed402.site (score 0-100, pass/warn/fail per check with evidence and fixes) so you can see the output of audit_agent_ready before paying.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false}},{"name":"get_perps","title":"Perps radar (paid, x402)","description":"Paid endpoint ($0.002): one Hyperliquid perp's funding (hourly, 8h, annualized), open interest in USD, 24h volume, mark/oracle price, premium and whether it is in the top-10 funding extremes. Any listed Hyperliquid perp; unknown symbols return an error and no charge. Returns the x402 payment requirements and URL. Free sample response: https://cryptofeed402.site/samples/perps","inputSchema":{"type":"object","properties":{"symbol":{"type":"string","pattern":"^[A-Za-z0-9]{1,20}$","description":"Hyperliquid perp ticker, e.g. BTC, ETH, SOL, HYPE"}},"required":["symbol"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false}},{"name":"get_sentiment","title":"News sentiment (paid, x402)","description":"Paid endpoint ($0.002): crypto news sentiment for one asset: -1..1 score, bearish/neutral/bullish label, pos/neg/neu headline counts and up to 5 top headlines with links. Headlines labeled by a local LLM, score is plain math, refreshed about every 15 min. Symbols not in the current snapshot or stale data return an error and no charge (free list: GET /sentiment). Returns the x402 payment requirements and URL. Free sample response: https://cryptofeed402.site/samples/sentiment","inputSchema":{"type":"object","properties":{"symbol":{"type":"string","pattern":"^[A-Za-z0-9]{1,20}$","description":"Ticker, e.g. BTC, ETH, SOL"}},"required":["symbol"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false}},{"name":"audit_agent_ready","title":"Agent-readiness audit (paid, x402)","description":"Paid endpoint ($0.05): audits a public website or x402 API for AI-agent readiness (llms.txt, robots.txt AI rules, sitemap, OpenAPI, /.well-known/x402, agent card, MCP initialize, a live unpaid 402 challenge, Bazaar metadata, Roundhouse / 402 Index / x402 Doctor listings). Deterministic, no LLM. Returns the x402 payment requirements and URL; see get_audit_sample for the output format.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Domain or http(s) URL of the site to audit (public hosts, ports 80/443)","maxLength":2048}},"required":["url"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false}},{"name":"get_outlook","title":"Pre-trade preflight (paid, x402)","description":"Paid endpoint ($0.01): pre-trade preflight for one Hyperliquid perp in one call: perp mark vs OKX spot and vs oracle (bps), funding hourly/8h/annualized with its extreme-funding rank, open interest and OI change vs ~1h/~24h ago, news sentiment if covered, as_of per component, and neutral flags (funding_extreme, oi_spike, venue_divergence, stale_component) with their rules. Factual checks only, no buy/sell call. Unknown symbol or unavailable data returns an error and no charge. Returns the x402 payment requirements and URL. Free sample response: https://cryptofeed402.site/samples/outlook","inputSchema":{"type":"object","properties":{"symbol":{"type":"string","pattern":"^[A-Za-z0-9]{1,20}$","description":"Hyperliquid perp ticker, e.g. BTC, ETH, SOL, HYPE"}},"required":["symbol"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false}},{"name":"get_funding_history","title":"Funding history (paid, x402)","description":"Paid endpoint ($0.005): hourly funding settlements for one Hyperliquid perp (rate hourly/8h/annualized, premium) plus mean/min/max, positive/negative hours and cumulative rate. Give hours (1-720, default 168) or from/to (YYYY-MM-DD or ISO 8601 UTC, max 720 hours). History back to each perp's listing (BTC since 2023-05-12). Bad params or unknown symbol return an error and no charge. Returns the x402 payment requirements and URL. Free sample response: https://cryptofeed402.site/samples/funding-history","inputSchema":{"type":"object","properties":{"symbol":{"type":"string","pattern":"^[A-Za-z0-9]{1,20}$","description":"Hyperliquid perp ticker, e.g. BTC"},"hours":{"type":"integer","minimum":1,"maximum":720,"description":"Last N hours (default 168). Do not combine with from/to."},"from":{"type":"string","description":"Start, YYYY-MM-DD or ISO 8601 UTC"},"to":{"type":"string","description":"End, YYYY-MM-DD (inclusive) or ISO 8601 UTC; default now"}},"required":["symbol"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false}},{"name":"get_history","title":"Brief archive (paid, x402)","description":"Paid endpoint: archived briefs for a date range. Returns the x402 payment requirements and URL. Free sample response: https://cryptofeed402.site/samples/history","inputSchema":{"type":"object","properties":{"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["from"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false}}],"resources":[],"prompts":[],"homepage":"https://cryptofeed402.site","docs":"https://cryptofeed402.site/llms.txt","discovery":{"server_card_v1":"https://cryptofeed402.site/mcp/server-card","agent_card":"https://cryptofeed402.site/.well-known/agent-card.json","ai_catalog":"https://cryptofeed402.site/.well-known/ai-catalog.json","x402":"https://cryptofeed402.site/.well-known/x402","receipt_key":"https://cryptofeed402.site/.well-known/receipt-key.json"},"receipts":{"alg":"Ed25519","key_id":"cf402-rk-06f3d92517614c38","public_key":"FbX3fMloih1T5xF7j3MRe3LmTdXYdpnrikz2BcpSPrQ","public_key_encoding":"base64url (raw 32-byte Ed25519 public key)","jwk":{"kty":"OKP","crv":"Ed25519","x":"FbX3fMloih1T5xF7j3MRe3LmTdXYdpnrikz2BcpSPrQ","kid":"cf402-rk-06f3d92517614c38","use":"sig","alg":"EdDSA"},"key_url":"https://cryptofeed402.site/.well-known/receipt-key.json","headers":{"receipt":"X-Receipt","signature":"X-Receipt-Signature"},"applies_to":"every paid HTTP 200 that settled via x402 (errors such as 400/404/429/503 are never charged and carry no receipt)","receipt_fields":["v","request_id","route","method","url","status","network","asset","asset_symbol","amount_unit","payTo","payer","quoted_amount","charged_amount","settle_tx","body_sha256","body_bytes","as_of","issued_at","key_id"],"verification":["base64url-decode the X-Receipt header to get the receipt JSON bytes (do not re-serialize).","base64url-decode X-Receipt-Signature and verify it as an Ed25519 signature over those exact bytes with this public key.","Parse the JSON; check key_id matches, and sha256(raw response body bytes) as lowercase hex equals body_sha256.","Optionally check settle_tx on Base (USDC transfer to payTo for charged_amount) and that charged_amount <= quoted_amount."],"settlement":"Payment settles only after the handler produced a valid 200; failed or error responses are not settled."}}