{"openapi":"3.1.0","info":{"title":"AI Rook — Agent Commerce Platform","version":"4.0.0","description":"43 pay-per-call APIs on x402. Trading intelligence (live BTC signals, CVD, order flow), AI inference via Queen M2.7 456B MoE, web utilities, verification, and ERC-8183 ACP escrow with live ERC-8004 reputation attestation. AI Rook is default evaluator (2% fee) on AgenticCommerce — every evaluation posts permanent on-chain feedback to ERC-8004 ReputationRegistry (Agent ID 59646). No API keys, no signup. USDC on Base mainnet 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":"0x162544A7ab157C9a0614033B4d2D84dF285F3174","hook":"0xb4d50D6DbA3E9cD0d5772168D0E9C5795180D97E","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"}],"paths":{"/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/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 Queen M2.7 (456B MoE) — 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 Queen 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 Queen 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 Queen 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 on Queen. 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 Queen M2.7 (456B MoE). 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. Queen M2.7 (456B MoE) 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. Queen 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. Queen 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 on Queen. 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 Queen 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"}}}}},"x-discovery":{"ownershipProofs":["0x1af8369db07255cd2fd394b8b59926b59b58f92b"]},"x-acp":{"standard":"ERC-8183","contract":"0x162544A7ab157C9a0614033B4d2D84dF285F3174","hook":"0xb4d50D6DbA3E9cD0d5772168D0E9C5795180D97E","reputationRegistry":"0x8004BAa17C55a88189AE136b182e5fdA19dE9b63","agentId":59646}}