{"openapi":"3.1.0","info":{"title":"Crypto Pulse API","version":"0.7.0","description":"One call replaces four crypto data fetches for AI agents: (1) BTC/ETH/SOL/HYPE spot USD + 24h change (CoinGecko), (2) Crypto Fear & Greed (alternative.me), (3) Hyperliquid perp funding + mark + open interest, (4) DefiLlama total TVL + top stable yields - plus a plain-English summary line and deterministic signals. Keyless upstreams, 60s live cache, pay-per-request USDC on Solana via x402. Typical single-purpose x402 market tools on Solana list around $0.001-$0.005 each; this $0.02 bundle is usually cheaper than paying four of them when you need the full brief. Free stale sample at GET /v1/sample; MCP tools at POST /mcp.","contact":{"url":"https://cryptopulseapi.com"}},"servers":[{"url":"https://cryptopulseapi.com"}],"paths":{"/":{"get":{"summary":"Service summary","operationId":"root","responses":{"200":{"description":"Agent-oriented service description","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/health":{"get":{"summary":"Health check","operationId":"health","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/sample":{"get":{"summary":"Free stale sample of the full pulse","description":"Same JSON shape as /v1/pulse including summary/signals, but data may be up to 15 minutes old. Rate-limited (10/min/IP). Not a substitute for the paid live feed.","operationId":"getSample","responses":{"200":{"description":"Sample pulse JSON","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Pulse"}}}},"429":{"description":"Rate limited"}}}},"/mcp":{"post":{"summary":"MCP Streamable HTTP endpoint","description":"JSON-RPC MCP (initialize, tools/list, tools/call). Tools: get_market_sample (free), get_market_pulse / get_market_spots (x402 payment hints), arena_rules / arena_current_round / arena_submit_prediction / arena_leaderboard / arena_results / arena_history (free).","operationId":"mcp","responses":{"200":{"description":"JSON-RPC response"}}}},"/llms.txt":{"get":{"summary":"llms.txt discovery","operationId":"llmsTxt","responses":{"200":{"description":"Markdown for agents"}}}},"/.well-known/x402":{"get":{"summary":"x402 well-known index","operationId":"wellKnownX402","responses":{"200":{"description":"Static paid resource index","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/openapi.json":{"get":{"summary":"This OpenAPI document","operationId":"openapi","responses":{"200":{"description":"OpenAPI 3.1","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/pulse":{"get":{"summary":"Full crypto market pulse (one call replaces four)","description":"One call replaces four crypto data fetches for AI agents: (1) BTC/ETH/SOL/HYPE spot USD + 24h change (CoinGecko), (2) Crypto Fear & Greed (alternative.me), (3) Hyperliquid perp funding + mark + open interest, (4) DefiLlama total TVL + top stable yields - plus a plain-English summary line and deterministic signals. Keyless upstreams, 60s live cache, pay-per-request USDC on Solana via x402. Typical single-purpose x402 market tools on Solana list around $0.001-$0.005 each; this $0.02 bundle is usually cheaper than paying four of them when you need the full brief. Free stale sample at GET /v1/sample; MCP tools at POST /mcp.","operationId":"getPulse","x-x402":{"price":"$0.02","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"37CP6YemJJQ6sMu4Ue6C7pgC7BXkN6iCcCHVeZunvPod","scheme":"exact","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"},"responses":{"200":{"description":"Pulse JSON after payment (includes summary + signals)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Pulse"}}}},"402":{"description":"Payment Required (x402)"}}}},"/v1/pulse/{asset}":{"get":{"summary":"Single-asset pulse slice","operationId":"getPulseAsset","parameters":[{"name":"asset","in":"path","required":true,"schema":{"type":"string","enum":["BTC","ETH","SOL","HYPE"]},"description":"Ticker"}],"x-x402":{"price":"$0.02","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"37CP6YemJJQ6sMu4Ue6C7pgC7BXkN6iCcCHVeZunvPod","scheme":"exact","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"},"responses":{"200":{"description":"Asset slice JSON after payment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetPulse"}}}},"402":{"description":"Payment Required (x402)"}}}},"/v1/spots":{"get":{"summary":"Spot prices only (cheaper)","description":"BTC/ETH/SOL/HYPE USD spots and 24h change from CoinGecko + summary. Prefer /v1/pulse (one call replaces four) for funding, Fear & Greed, and DeFi.","operationId":"getSpots","x-x402":{"price":"$0.005","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"37CP6YemJJQ6sMu4Ue6C7pgC7BXkN6iCcCHVeZunvPod","scheme":"exact","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"},"responses":{"200":{"description":"Spots JSON after payment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Spots"}}}},"402":{"description":"Payment Required (x402)"}}}},"/arena":{"get":{"summary":"Crypto Pulse Prediction Arena (HTML)","operationId":"arenaPage","responses":{"200":{"description":"Human-readable arena page"}}}},"/v1/arena/rules":{"get":{"summary":"Arena rules + signing format","description":"Free entry. No wagering. Daily BTC/ETH/SOL close predictions. Scoring by average abs % error vs CoinGecko. Sponsor prizes $1 USDC daily / $10 USDC weekly paid automatically on-chain while funded.","operationId":"arenaRules","responses":{"200":{"description":"Rules JSON","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/arena/round":{"get":{"summary":"Current or specific arena round","operationId":"arenaRound","parameters":[{"name":"round","in":"query","required":false,"schema":{"type":"string"},"description":"Round id YYYY-MM-DD (settlement midnight UTC)"}],"responses":{"200":{"description":"Round timing, entry counts, top of board","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/arena/predict":{"post":{"summary":"Submit or update a signed prediction (free)","description":"Body: roundId, wallet, asset (BTC|ETH|SOL), price, signature (base58 ed25519), optional botName. Server never receives private keys.","operationId":"arenaPredict","responses":{"200":{"description":"Updated prediction"},"201":{"description":"Created prediction"},"400":{"description":"Validation / signature / cutoff error"}}}},"/v1/arena/leaderboard":{"get":{"summary":"Daily arena leaderboard","operationId":"arenaLeaderboard","parameters":[{"name":"round","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Leaderboard JSON","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/arena/leaderboard/weekly":{"get":{"summary":"Weekly arena leaderboard (Mon–Sun UTC)","operationId":"arenaLeaderboardWeekly","parameters":[{"name":"week","in":"query","required":false,"schema":{"type":"string"},"description":"Week id = Monday YYYY-MM-DD UTC"}],"responses":{"200":{"description":"Weekly leaderboard JSON","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/ai-catalog.json":{"get":{"summary":"AI Catalog (MCP Server Card discovery)","operationId":"aiCatalog","responses":{"200":{"description":"AI Catalog JSON","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/mcp/server-card":{"get":{"summary":"MCP Server Card","operationId":"mcpServerCard","responses":{"200":{"description":"MCP Server Card JSON","content":{"application/mcp-server-card+json":{"schema":{"type":"object"}},"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"Pulse":{"type":"object","properties":{"service":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"},"summary":{"type":"string","description":"Plain-English one-liner derived from the returned fields"},"signals":{"type":"object","description":"Deterministic sentiment / funding bias flags"},"spotPrices":{"type":"object"},"fearAndGreed":{"type":"object"},"hyperliquidFunding":{"type":"object"},"defi":{"type":"object"},"cache":{"type":"object"},"sample":{"type":"boolean"},"dataAgeSeconds":{"type":"integer"}}},"AssetPulse":{"type":"object","properties":{"asset":{"type":"string"},"summary":{"type":"string"},"signals":{"type":"object"},"spot":{"type":"object"},"funding":{"type":"object"},"fearAndGreed":{"type":"object"},"defi":{"type":"object"}}},"Spots":{"type":"object","properties":{"service":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"},"summary":{"type":"string"},"signals":{"type":"object"},"spotPrices":{"type":"object"}}}}}}