{"openapi":"3.1.0","info":{"title":"AI Rook — Agent Commerce Platform","version":"4.0.0","description":"Live crypto trading intelligence for AI agents — real-time BTC signals, CVD, order flow, and active strategy setups, no API keys or signup. 60+ pay-per-call endpoints total: trading data, AI inference (MiniMax M2.7 (456B-parameter Mixture-of-Experts)), web utilities, verification, and ERC-8183 ACP escrow with on-chain ERC-8004 reputation attestation (Agent ID 59646). Four payment rails: USDC on Base mainnet (default), USDC on Solana mainnet, HBAR/USDC on Hedera testnet, USDT on BNB Chain testnet. One free trial call per endpoint. Prices from $0.001/call.","contact":{"email":"rook@mailbox.org","url":"https://agents.ai-rook.com"},"x-erc8004":{"agentId":59646,"chain":"eip155:8453","registry":"0x8004A169FB4a3325136EB29fA0ceB6D2e539a432"},"x-erc8183":{"contract":"0xAED73468126f4E992d8c701Bb0047DD7f8589f5B","hook":"0x7eA28b8740151308b218eC2b4e46Ae18F8f317c6","role":"default-evaluator","platformFeeBps":200},"x-tags":["Trading","Utility","Crypto","Escrow","AI","DeFi"]},"tags":[{"name":"Trading","description":"Trading intelligence APIs"},{"name":"Utility","description":"Web utility APIs"},{"name":"Crypto","description":"Crypto data APIs"},{"name":"Escrow","description":"ERC-8183 AgenticCommerce escrow APIs"},{"name":"AI","description":"AI inference APIs"},{"name":"DeFi","description":"DeFi APIs"},{"name":"Hedera","description":"Hedera x402 payment rail — HBAR + USDC settlement on Hedera testnet with HCS audit receipts"}],"paths":{"/api/hello":{"get":{"security":[],"summary":"FREE hello-world — identity + real settlement receipt sample","description":"Free forever. Returns agent identity (ERC-8004 Agent ID 59646), discovery links, and a REAL past settlement receipt with HCS anchor so agents can validate receipt parsing without spending.","parameters":[],"responses":{"200":{"description":"Identity + sample receipt JSON"}}}},"/api/preview/market-pulse":{"get":{"security":[],"summary":"FREE preview: market pulse","description":"Free taste-test. Returns real BTC price + engine status. CVD, OI, whale flow, session P&L redacted. Full response at /api/market-pulse for $0.05.","parameters":[],"responses":{"200":{"description":"Preview JSON with _sample showing full response shape"}}}},"/api/preview/order-flow":{"get":{"security":[],"summary":"FREE preview: order flow","description":"Free taste-test. Returns real price, gear, volume ratio. CVD, OI, whale CVD, session levels, proximity redacted. Full response at /api/order-flow for $0.25.","parameters":[],"responses":{"200":{"description":"Preview JSON with _sample showing full response shape"}}}},"/api/verify-receipt":{"post":{"summary":"Proof-of-execution receipt","description":"Timestamped proof-of-execution receipt with SHA256 attestation hash.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"payload":{"type":"string","description":"Content to attest"}}}}}},"responses":{"200":{"description":"Receipt JSON"},"402":{"description":"Payment Required"}}}},"/api/liveness":{"post":{"summary":"Endpoint latency benchmarks","description":"Latency benchmarks for agent routing — p50/min/max per URL.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["urls"],"properties":{"urls":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Benchmark JSON"},"402":{"description":"Payment Required"}}}},"/api/webhook-relay":{"post":{"summary":"Webhook relay","description":"Async job notification relay — register, deliver, status.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"event":{"type":"string"}}}}}},"responses":{"200":{"description":"Relay JSON"},"402":{"description":"Payment Required"}}}},"/api/paywall":{"post":{"summary":"Paywall-as-a-service","description":"Register an endpoint behind an x402 paywall, collect payments (10% platform fee).","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"target_url":{"type":"string"},"price":{"type":"string"}}}}}},"responses":{"200":{"description":"Paywall JSON"}}}},"/api/metered":{"post":{"summary":"Streaming metered compute","description":"Streaming compute via MiniMax M2.7 — SSE, pay per 500-token chunk.","x-payment-info":{"protocols":["x402"],"price":{"mode":"metered","currency":"USD","amount":"0.02/chunk"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"}}}}}},"responses":{"200":{"description":"SSE stream"},"402":{"description":"Payment Required"}}}},"/api/ap2-verify":{"post":{"summary":"AP2 credential verification","description":"AP2/W3C Verifiable Credential mandate verification.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"credential":{"type":"object"}}}}}},"responses":{"200":{"description":"Verification JSON"},"402":{"description":"Payment Required"}}}},"/api/preview/trade-idea":{"get":{"security":[],"summary":"FREE preview: trade idea","description":"Free taste-test. Returns strategy name and direction only. Entry, stop, take-profit, confidence, CASPER score redacted. Full response at /api/trade-idea for $0.25.","parameters":[],"responses":{"200":{"description":"Preview JSON with _sample showing full response shape"}}}},"/api/market-pulse":{"get":{"summary":"Live BTC/ETH market pulse","description":"Real-time price, CVD, OI, whale flow, gear ratios, session P&L and win/loss counts from live trading engine. Refreshes every 15s.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"parameters":[{"name":"symbol","in":"query","schema":{"type":"string","default":"BTCUSDT"},"description":"Trading pair symbol"}],"responses":{"200":{"description":"Market pulse JSON"},"402":{"description":"Payment Required"}}}},"/api/trade-idea":{"get":{"summary":"Active trade setups","description":"Live trade signals from S10, S14, BOJAN, YAHTZEE strategies — entry, stop, target, confidence score, strategy name. Pulled from live rook-engine.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.25"}},"parameters":[{"name":"symbol","in":"query","schema":{"type":"string","default":"BTCUSDT"}}],"responses":{"200":{"description":"Trade idea JSON"},"402":{"description":"Payment Required"}}}},"/api/order-flow":{"get":{"summary":"Order flow snapshot","description":"CVD, OI, whale CVD, session levels, proximity to key S/R levels, volume gear ratio. Live from rook-engine MMT WebSocket feed.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.25"}},"parameters":[],"responses":{"200":{"description":"Order flow JSON"},"402":{"description":"Payment Required"}}}},"/api/liquidation-heatmap":{"get":{"summary":"Liquidation heatmap","description":"Price levels and intensity for 5x 10x 25x 50x 100x leverage longs and shorts relative to current BTC price.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.25"}},"parameters":[],"responses":{"200":{"description":"Heatmap JSON"},"402":{"description":"Payment Required"}}}},"/api/backtest":{"get":{"summary":"Strategy backtest results","description":"Win rate, profit factor, total P&L, trade count for rook-engine strategies. Based on historical tick data.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.50"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"strategy":{"type":"string","enum":["S7_MODE_B","S6","S15","S10"]},"symbol":{"type":"string","default":"BTCUSDT"},"period":{"type":"string","default":"6m"}}}}}},"responses":{"200":{"description":"Backtest results JSON"},"402":{"description":"Payment Required"}}}},"/api/ai-analysis":{"get":{"summary":"AI chart analysis","description":"Upload a base64 chart image or send a text query. Get technical analysis from MiniMax M2.7 (456B-parameter Mixture-of-Experts) — trend, S/R levels, patterns, directional bias.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.10"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"query":{"type":"string"},"image":{"type":"string","description":"Base64 encoded chart image (optional)"}}}}}},"responses":{"200":{"description":"Analysis JSON"},"402":{"description":"Payment Required"}}}},"/api/social-sentiment":{"get":{"summary":"Social sentiment","description":"Social media sentiment analysis. Bullish/bearish score, themes, volume, trend prediction.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["topic"],"properties":{"topic":{"type":"string","maxLength":500}}}}}},"responses":{"200":{"description":"Sentiment JSON"},"402":{"description":"Payment Required"}}}},"/api/news-digest":{"get":{"summary":"News digest","description":"Topic-based news digest with sentiment. 5 key developments + trend score.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["topic"],"properties":{"topic":{"type":"string","maxLength":500}}}}}},"responses":{"200":{"description":"Digest JSON"},"402":{"description":"Payment Required"}}}},"/api/company-profile":{"get":{"summary":"Company profile","description":"AI-enriched company profile via MiniMax M2.7. Sector, products, competitive position.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.10"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["company"],"properties":{"company":{"type":"string","maxLength":200}}}}}},"responses":{"200":{"description":"Profile JSON"},"402":{"description":"Payment Required"}}}},"/api/gas-tracker":{"get":{"summary":"Base gas tracker","description":"Current Base mainnet gas prices — slow, standard, fast in gwei.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.002"}},"parameters":[],"responses":{"200":{"description":"Gas JSON"},"402":{"description":"Payment Required"}}}},"/api/token-info":{"get":{"summary":"ERC-20 token info","description":"Name, symbol, decimals, total supply from contract address on Base.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["contract"],"properties":{"contract":{"type":"string"}}}}}},"responses":{"200":{"description":"Token JSON"},"402":{"description":"Payment Required"}}}},"/api/wallet-profile":{"get":{"summary":"Base wallet profile","description":"Base chain wallet profile — balance, tx count, contract detection via RPC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["address"],"properties":{"address":{"type":"string"}}}}}},"responses":{"200":{"description":"Profile JSON"},"402":{"description":"Payment Required"}}}},"/api/doc-qa":{"get":{"summary":"Document Q&A","description":"Ask questions about any document. Paste text + question, get cited answer.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["text","question"],"properties":{"text":{"type":"string","maxLength":50000},"question":{"type":"string","maxLength":1000}}}}}},"responses":{"200":{"description":"Answer JSON"},"402":{"description":"Payment Required"}}}},"/api/invoice-parse":{"get":{"summary":"Invoice parser","description":"Parse invoice text/OCR into structured data. Extracts vendor, line items, totals.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string","maxLength":20000}}}}}},"responses":{"200":{"description":"Invoice JSON"},"402":{"description":"Payment Required"}}}},"/api/contract-analysis":{"get":{"summary":"Contract analysis","description":"AI contract analysis via MiniMax M2.7. Risk flags, obligations, termination, overall risk rating.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.10"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string","maxLength":30000},"contract_type":{"type":"string"}}}}}},"responses":{"200":{"description":"Analysis JSON"},"402":{"description":"Payment Required"}}}},"/api/regex-test":{"get":{"summary":"Regex tester","description":"Test regex pattern against input string. Returns all matches with indices and groups.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.002"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["pattern","test_string"],"properties":{"pattern":{"type":"string"},"flags":{"type":"string","default":"g"},"test_string":{"type":"string"}}}}}},"responses":{"200":{"description":"Match JSON"},"402":{"description":"Payment Required"}}}},"/api/json-validate":{"get":{"summary":"JSON validator","description":"Validate JSON string + optional schema validation.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.002"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["json"],"properties":{"json":{"type":"string"},"schema":{"type":"object"}}}}}},"responses":{"200":{"description":"Validation JSON"},"402":{"description":"Payment Required"}}}},"/api/code-review":{"get":{"summary":"AI code review","description":"Find bugs, security issues, performance problems in code via MiniMax M2.7.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","maxLength":20000},"language":{"type":"string"}}}}}},"responses":{"200":{"description":"Review JSON"},"402":{"description":"Payment Required"}}}},"/api/tts":{"get":{"summary":"Text-to-speech","description":"Generate speech audio from text using Qwen3-TTS (MiniMax M2.7 infrastructure). Returns base64 WAV.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string","maxLength":5000},"voice":{"type":"string","default":"alloy"}}}}}},"responses":{"200":{"description":"Audio JSON"},"402":{"description":"Payment Required"}}}},"/api/smart-money":{"get":{"summary":"Smart money / whale tracker","description":"Large wallet movements on Base chain — whale USDC/WETH transfer tracking via Base RPC. Filter by asset and minimum transfer value.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.50"}},"parameters":[{"name":"asset","in":"query","schema":{"type":"string","enum":["USDC","WETH"],"default":"USDC"}},{"name":"min_value","in":"query","schema":{"type":"number","default":10000}}],"responses":{"200":{"description":"Transfer JSON"},"402":{"description":"Payment Required"}}}},"/api/agent-task":{"get":{"summary":"Spawn AI compute task","description":"Run any prompt on MiniMax M2.7 (456B-parameter Mixture-of-Experts). Falls back to Bishop Qwen3.6-27B. Max 4000 tokens output.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","maxLength":10000},"max_tokens":{"type":"integer","default":800}}}}}},"responses":{"200":{"description":"Result JSON"},"402":{"description":"Payment Required"}}}},"/api/credits/purchase":{"get":{"summary":"Buy credit bundle (50 credits / $5)","description":"Buy 50 AI Rook credits for $5 USDC. Use X-Credit-Wallet header on any endpoint for no per-call x402 handshake.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"5.00"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["wallet"],"properties":{"wallet":{"type":"string","description":"Base wallet address"}}}}}},"responses":{"200":{"description":"Credits added"},"402":{"description":"Payment Required"}}}},"/api/summarize":{"get":{"summary":"AI text summarization","description":"Summarize any text or URL. Styles: concise, bullets, eli5. MiniMax M2.7 (456B-parameter Mixture-of-Experts) inference.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"url":{"type":"string"},"style":{"type":"string","enum":["concise","bullets","eli5"],"default":"concise"}}}}}},"responses":{"200":{"description":"Summary JSON"},"402":{"description":"Payment Required"}}}},"/api/extract-data":{"get":{"summary":"Structured data extraction","description":"Extract structured JSON from unstructured text. Pass fields[] for key-value extraction or schema{} for typed output. MiniMax M2.7.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.10"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}},"schema":{"type":"object"}}}}}},"responses":{"200":{"description":"Extracted data JSON"},"402":{"description":"Payment Required"}}}},"/api/classify":{"get":{"summary":"Text classification","description":"Classify text into user-defined categories. Single-label or multi-label. MiniMax M2.7 inference.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["text","categories"],"properties":{"text":{"type":"string"},"categories":{"type":"array","items":{"type":"string"}},"multi_label":{"type":"boolean","default":false}}}}}},"responses":{"200":{"description":"Classification JSON"},"402":{"description":"Payment Required"}}}},"/api/image-gen":{"get":{"summary":"Text-to-image generation","description":"Generate images via FLUX.2-klein (MiniMax M2.7 infrastructure). Returns base64 PNG. First image generation endpoint on x402.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.15"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string"},"width":{"type":"integer","default":1024},"height":{"type":"integer","default":1024}}}}}},"responses":{"200":{"description":"Image JSON with base64 PNG"},"402":{"description":"Payment Required"}}}},"/api/web-fetch":{"get":{"summary":"URL text extraction","description":"Fetch any URL and extract clean readable text. Strips HTML, scripts, and ads. Returns title + body.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string"}}}}}},"responses":{"200":{"description":"Extracted text JSON"},"402":{"description":"Payment Required"}}}},"/api/search":{"get":{"summary":"Web search","description":"Web search via Brave Search API. Returns top 10 results with title, URL, and description.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string"},"count":{"type":"integer","default":10,"maximum":10}}}}}},"responses":{"200":{"description":"Search results JSON"},"402":{"description":"Payment Required"}}}},"/api/ip-lookup":{"get":{"summary":"IP geolocation + ASN","description":"IP geolocation, ASN, and proxy/VPN detection. Pass ?ip=x.x.x.x or omit for caller IP.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.002"}},"parameters":[{"name":"ip","in":"query","schema":{"type":"string"},"description":"IPv4 or IPv6 address (optional, defaults to caller IP)"}],"responses":{"200":{"description":"Geo + ASN JSON"},"402":{"description":"Payment Required"}}}},"/api/email-validate":{"get":{"summary":"Email validation","description":"Email syntax check plus live MX record DNS lookup to confirm deliverability.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.002"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string"}}}}}},"responses":{"200":{"description":"Validation JSON"},"402":{"description":"Payment Required"}}}},"/api/qr-generate":{"get":{"summary":"QR code generation","description":"Generate a QR code from any text or URL. Returns base64-encoded PNG.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.002"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string"},"size":{"type":"integer","default":300}}}}}},"responses":{"200":{"description":"QR PNG base64 JSON"},"402":{"description":"Payment Required"}}}},"/api/pdf-extract":{"get":{"summary":"PDF text extraction","description":"Extract full text and metadata from any publicly accessible PDF URL.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string"}}}}}},"responses":{"200":{"description":"Extracted text + metadata JSON"},"402":{"description":"Payment Required"}}}},"/api/domain-lookup":{"get":{"summary":"Domain DNS + SSL lookup","description":"A, MX, TXT, NS DNS records plus SSL certificate expiry date for any domain.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string"}}}}}},"responses":{"200":{"description":"DNS + SSL JSON"},"402":{"description":"Payment Required"}}}},"/api/screenshot":{"get":{"summary":"Full-page screenshot","description":"Screenshot any URL via headless Chromium. Full page. Returns base64 PNG.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string"},"full_page":{"type":"boolean","default":true},"width":{"type":"integer","default":1280}}}}}},"responses":{"200":{"description":"Screenshot base64 PNG JSON"},"402":{"description":"Payment Required"}}}},"/api/translate":{"get":{"summary":"AI translation (11 languages)","description":"Translate text between 11 languages via MiniMax M2.7. Supports es fr de ja zh ko ar pt it ru hi. Max 10,000 chars.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["text","target_lang"],"properties":{"text":{"type":"string","maxLength":10000},"target_lang":{"type":"string","enum":["es","fr","de","ja","zh","ko","ar","pt","it","ru","hi"]},"source_lang":{"type":"string"}}}}}},"responses":{"200":{"description":"Translation JSON"},"402":{"description":"Payment Required"}}}},"/api/crypto-price":{"get":{"summary":"Live crypto price","description":"Live crypto price via CoinGecko. Pass ?symbol=BTC. Returns price, 24h change, market cap.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.002"}},"parameters":[{"name":"symbol","in":"query","schema":{"type":"string","default":"BTC"},"description":"Crypto ticker e.g. BTC, ETH, SOL"}],"responses":{"200":{"description":"Price JSON"},"402":{"description":"Payment Required"}}}},"/api/convert":{"get":{"summary":"Unit + currency conversion","description":"Convert between units (length, weight, temp, speed) and 150+ fiat/crypto currency pairs.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.002"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["value","from","to"],"properties":{"value":{"type":"number"},"from":{"type":"string"},"to":{"type":"string"}}}}}},"responses":{"200":{"description":"Converted value JSON"},"402":{"description":"Payment Required"}}}},"/api/whois":{"get":{"summary":"WHOIS domain lookup","description":"WHOIS data — registrar, registration/expiry dates, nameservers, registrant info.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string"}}}}}},"responses":{"200":{"description":"WHOIS JSON"},"402":{"description":"Payment Required"}}}},"/api/timezone":{"get":{"summary":"Timezone conversion","description":"Convert a datetime between any IANA timezones.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.002"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["datetime","from_tz","to_tz"],"properties":{"datetime":{"type":"string"},"from_tz":{"type":"string"},"to_tz":{"type":"string"}}}}}},"responses":{"200":{"description":"Converted datetime JSON"},"402":{"description":"Payment Required"}}}},"/api/uuid":{"get":{"summary":"UUID / nanoid generation","description":"Generate UUID v4 or nanoid strings. Up to 100 per call.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["uuid","nanoid"],"default":"uuid"},"count":{"type":"integer","default":1,"maximum":100}}}}}},"responses":{"200":{"description":"IDs JSON"},"402":{"description":"Payment Required"}}}},"/api/hash":{"get":{"summary":"String hashing","description":"Cryptographic string hashing — md5, sha256, sha512. Returns hex digest.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string"},"algorithm":{"type":"string","enum":["md5","sha256","sha512"],"default":"sha256"}}}}}},"responses":{"200":{"description":"Hash JSON"},"402":{"description":"Payment Required"}}}},"/mcp/tools":{"get":{"security":[],"summary":"MCP tool manifest","description":"Machine-readable MCP tool catalog. Use with search_resources / proxy_tool_call for agent-to-agent discovery.","parameters":[],"responses":{"200":{"description":"MCP manifest JSON"}}}},"/api/acp-escrow/info":{"get":{"security":[],"summary":"ERC-8183 ACP escrow info","description":"Contract address, state machine, fee structure, hook details, reputation registry. Free — no payment required.","parameters":[],"responses":{"200":{"description":"Escrow info JSON"}}}},"/api/acp-escrow/hook":{"get":{"security":[],"summary":"RookAttestationHook info","description":"Hook contract address, function selectors, ERC-8004 reputation registry pointer, how giveFeedback() is called on complete/reject. Free.","parameters":[],"responses":{"200":{"description":"Hook info JSON"}}}},"/api/acp-escrow/job/{id}":{"get":{"security":[],"summary":"Job state lookup","description":"Read current state of any ERC-8183 job by ID. Free.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Job state JSON"}}}},"/api/acp-escrow/attestation/{id}":{"get":{"security":[],"summary":"Attestation record","description":"Read the on-chain attestation record for a completed or rejected job — provider agentId, approved/rejected, attestation hash, timestamp. Free.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Attestation record JSON"}}}},"/api/acp-escrow/create":{"post":{"summary":"Create ERC-8183 job","description":"Create a new AgenticCommerce escrow job on Base mainnet. AI Rook is assigned as default evaluator.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["description","budget","expiredAt"],"properties":{"description":{"type":"string"},"budget":{"type":"string","description":"USDC amount in wei"},"expiredAt":{"type":"integer","description":"Unix timestamp"},"provider":{"type":"string","description":"Provider wallet address (optional)"}}}}}},"responses":{"200":{"description":"Job ID + TX hash"},"402":{"description":"Payment Required"}}}},"/api/acp-escrow/complete":{"post":{"summary":"Complete job (evaluator)","description":"Evaluator approves a submitted job. Triggers RookAttestationHook — posts giveFeedback() to ERC-8004 ReputationRegistry for provider. AI Rook wallet only.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["jobId","attestationHash"],"properties":{"jobId":{"type":"integer"},"attestationHash":{"type":"string","description":"bytes32 hex"}}}}}},"responses":{"200":{"description":"TX hash"},"402":{"description":"Payment Required"}}}},"/api/acp-escrow/reject":{"post":{"summary":"Reject job (evaluator)","description":"Evaluator rejects a submitted job. Triggers attestation hook with score=0. AI Rook wallet only.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["jobId","reason"],"properties":{"jobId":{"type":"integer"},"reason":{"type":"string"}}}}}},"responses":{"200":{"description":"TX hash"},"402":{"description":"Payment Required"}}}},"/v1/chat/completions":{"post":{"summary":"OpenAI-compatible chat completions","description":"OpenAI-compatible /v1/chat/completions proxied to MiniMax M2.7 (456B-parameter Mixture-of-Experts). 10 free calls/day, then $0.01/call. Supports streaming.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["messages"],"properties":{"model":{"type":"string","default":"minimax-m2.7-mxfp4"},"messages":{"type":"array","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant"]},"content":{"type":"string"}}}},"temperature":{"type":"number","default":0.7},"max_tokens":{"type":"integer","default":800},"stream":{"type":"boolean","default":false}}}}}},"responses":{"200":{"description":"Chat completion"},"402":{"description":"Payment Required"}}}},"/v1/models":{"get":{"summary":"Model discovery (free)","description":"List available models with pricing, context length, and capabilities.","security":[],"parameters":[],"responses":{"200":{"description":"Model list"}}}},"/api/hyperliquid/funding":{"get":{"summary":"HL funding rates + OI","description":"Hyperliquid funding rate snapshot + OI regime for top perps.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.10"}},"parameters":[{"name":"top","in":"query","schema":{"type":"integer","default":20},"description":"Number of top perps (max 100)"}],"responses":{"200":{"description":"Funding JSON"},"402":{"description":"Payment Required"}}}},"/api/hyperliquid/setups":{"get":{"summary":"HL trade setups","description":"Active trade setups on HL perps - RSI, MA cross, S/R via candle analysis.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.50"}},"parameters":[{"name":"symbol","in":"query","schema":{"type":"string"},"description":"Perp symbol e.g. BTC-PERP"}],"responses":{"200":{"description":"Setups JSON"},"402":{"description":"Payment Required"}}}},"/api/hyperliquid/whale":{"get":{"summary":"HL whale tracker","description":"Large trader activity - top accounts by PnL, liquidation risk.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.25"}},"parameters":[{"name":"minPnl","in":"query","schema":{"type":"number","default":10000},"description":"Minimum PnL (USD)"}],"responses":{"200":{"description":"Whale JSON"},"402":{"description":"Payment Required"}}}},"/api/hyperliquid/liquidations":{"get":{"summary":"HL liquidation risk","description":"Liquidation cascade risk scoring - cluster zones, book depth, nearest liq levels.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.25"}},"parameters":[{"name":"symbol","in":"query","schema":{"type":"string","default":"BTC-PERP"},"description":"Perp symbol"}],"responses":{"200":{"description":"Liquidation risk JSON"},"402":{"description":"Payment Required"}}}},"/audio/v1/credits/purchase":{"post":{"summary":"Buy audio-services microcredits","description":"Buy microcredits for STT/TTS session usage. Fixed $0.50 tier via x402. 1 USD = 1,000,000 microcredits. Own-hardware STT/TTS product (Kokoro-82M TTS + Parakeet-TDT 0.6B STT on Mac Studio, no cloud dependency).","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.50"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["wallet_address"],"properties":{"wallet_address":{"type":"string","description":"Wallet address to credit (Solana or EVM)"}}}}}},"responses":{"200":{"description":"Credited microcredits + new balance"},"402":{"description":"Payment Required"}}}},"/audio/v1/account":{"get":{"summary":"Audio-services credit balance","description":"Check available microcredit balance for a wallet. Requires wallet-signature auth (sign 'GET\\n/audio/v1/account\\n<timestamp>' with your wallet key, base64-encode, send as Authorization: <chain>:<sig>). Free (no x402 payment) — auth alone gates this.","security":[],"parameters":[{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"<chain>:<base64_signature>, chain = solana | evm"},{"name":"X-Wallet-Address","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Wallet-Chain","in":"header","required":true,"schema":{"type":"string","enum":["solana","evm"]}},{"name":"X-Timestamp","in":"header","required":true,"schema":{"type":"string"},"description":"Unix ms, must match signed message, max 5min clock skew"}],"responses":{"200":{"description":"Balance JSON"},"401":{"description":"Missing or invalid signature"}}}},"/audio/v1/room":{"post":{"summary":"Create WebRTC room (production SFU)","description":"Reserve credits and create a LiveKit WebRTC room on our production SFU (wss://livekit.ai-rook.com), returning a scoped access token. Self-hosted on owned hardware — not LiveKit Cloud. Requires wallet-signature auth (same scheme as /account). Price: $0.00075 per participant-minute, reserved upfront from duration_minutes. Connect with any LiveKit SDK using the returned token. Refund policy: hard-failure (zero delivered output) = full refund; unused reservation = pro-rata refund on close; output sha256 anchored on-chain (HCS topic 0.0.9713907) for verification.","security":[],"parameters":[{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Wallet-Address","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Wallet-Chain","in":"header","required":true,"schema":{"type":"string","enum":["solana","evm"]}},{"name":"X-Timestamp","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["duration_minutes"],"properties":{"duration_minutes":{"type":"integer","description":"Expected call duration — determines credit reservation"}}}}}},"responses":{"200":{"description":"room, identity, token, wss:// server_url, expires_at"},"401":{"description":"Missing or invalid signature"},"402":{"description":"Insufficient credit balance"}}}},"/audio/v1/tts/session":{"post":{"summary":"Issue TTS streaming session","description":"Reserve credits and issue a WebSocket session for real-time text-to-speech. Kokoro-82M on MLX, running on owned Apple Silicon hardware (Mac Studio M3 Ultra) — not a cloud API. Requires wallet-signature auth (same scheme as /account). Price: $0.008 per 1,000 characters, reserved upfront based on max_characters and refunded pro-rata on session close based on actual characters synthesized. Connect the returned server_url as a WebSocket, send {session_key, voice} first, then {type:'synthesize', text} messages. Receive 'generating' event, then binary PCM16 48kHz mono audio chunks, then 'done' event.","security":[],"parameters":[{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Wallet-Address","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Wallet-Chain","in":"header","required":true,"schema":{"type":"string","enum":["solana","evm"]}},{"name":"X-Timestamp","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["max_characters"],"properties":{"max_characters":{"type":"integer","description":"Max characters you plan to synthesize this session — determines credit reservation"}}}}}},"responses":{"200":{"description":"session_id, token, wss:// server_url, expires_at"},"401":{"description":"Missing or invalid signature"},"402":{"description":"Insufficient credit balance"}}}},"/audio/v1/stt/session":{"post":{"summary":"Issue STT streaming session","description":"Reserve credits and issue a WebSocket session for real-time speech-to-text. Parakeet-TDT 0.6B on MLX, running on owned Apple Silicon hardware — not a cloud API. Requires wallet-signature auth. Price: $0.006/min, reserved upfront based on duration_minutes and refunded pro-rata on session close based on actual audio bytes streamed. Connect the returned server_url as a WebSocket, send config first, then stream raw PCM16 16kHz mono audio frames as binary messages. Send 'flush' to get a final, quality-checked transcription (full-context re-transcription, not just the fast streaming partial) — look for quality_checked:true in the final result.","security":[],"parameters":[{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Wallet-Address","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Wallet-Chain","in":"header","required":true,"schema":{"type":"string","enum":["solana","evm"]}},{"name":"X-Timestamp","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["duration_minutes"],"properties":{"duration_minutes":{"type":"number","description":"Max session duration you're reserving credits for"}}}}}},"responses":{"200":{"description":"session_id, token, wss:// server_url, expires_at"},"401":{"description":"Missing or invalid signature"},"402":{"description":"Insufficient credit balance"}}}}},"x-discovery":{"ownershipProofs":["0x1af8369db07255cd2fd394b8b59926b59b58f92b"]},"x-acp":{"standard":"ERC-8183","contract":"0xAED73468126f4E992d8c701Bb0047DD7f8589f5B","hook":"0x7eA28b8740151308b218eC2b4e46Ae18F8f317c6","reputationRegistry":"0x8004BAa17C55a88189AE136b182e5fdA19dE9b63","agentId":59646}}