{"openapi":"3.1.0","info":{"title":"DropEngine x402 Agent Services","version":"1.7.0","description":"Paid agent tools: preflight security, service routing, live web data, claim evidence, and crypto intelligence.","x-guidance":"POST JSON to one service path. Unpaid probes return x402 PAYMENT-REQUIRED. Verify network, asset, payTo and amount; sign and retry once with PAYMENT-SIGNATURE. Verify PAYMENT-RESPONSE and use the structured result according to your policy. Each request purchases only the selected service. MCP tools are also available at /api/agent-services; invoice quote and OCR tiers at /api/invoice-mcp."},"servers":[{"url":"https://mcp.dropenginehq.com"}],"paths":{"/api/invoice-preflight":{"post":{"operationId":"invoice_preflight","summary":"Invoice Preflight","description":"Check invoice amounts, purchase details and line items; return match, discrepancy or needs_review with evidence.","tags":["Invoice Preflight"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.065000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"document_xml":{"type":"string","description":"UBL Invoice XML document, up to 1 MB."},"document_url":{"type":"string","description":"Public HTTPS URL to a PDF, PNG, or JPEG (up to 10 MB, 3 pages for this tool)."},"document_base64":{"type":"string","description":"Base64 encoded PDF, PNG, or JPEG (up to 10 MB, 3 pages for this tool)."},"mime_type":{"type":"string","enum":["application/pdf","image/png","image/jpeg"]},"expected":{"type":"object","properties":{"supplier_name":{"type":"string"},"purchase_order":{"type":"string"},"currency":{"type":"string","minLength":3,"maxLength":3},"subtotal":{"type":"string"},"tax":{"type":"string"},"total":{"type":"string"},"line_items":{"type":"array","minItems":1,"maxItems":1000,"items":{"type":"object","required":["description","amount"],"properties":{"description":{"type":"string","minLength":1,"maxLength":300},"amount":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false}},"anyOf":[{"required":["document_xml"]},{"required":["document_url"]},{"required":["document_base64","mime_type"]}],"additionalProperties":false},"example":{"document_xml":"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Invoice xmlns=\"urn:oasis:names:specification:ubl:schema:xsd:Invoice-2\" xmlns:cac=\"urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2\" xmlns:cbc=\"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2\">\n  <cbc:ID>INV-8821</cbc:ID>\n  <cbc:DocumentCurrencyCode>USD</cbc:DocumentCurrencyCode>\n  <cac:OrderReference><cbc:ID>PO-8841</cbc:ID></cac:OrderReference>\n  <cac:AccountingSupplierParty><cac:Party><cac:PartyLegalEntity><cbc:RegistrationName>Example Ltd</cbc:RegistrationName></cac:PartyLegalEntity></cac:Party></cac:AccountingSupplierParty>\n  <cac:TaxTotal><cbc:TaxAmount currencyID=\"USD\">24.00</cbc:TaxAmount></cac:TaxTotal>\n  <cac:LegalMonetaryTotal><cbc:TaxExclusiveAmount currencyID=\"USD\">100.00</cbc:TaxExclusiveAmount><cbc:PayableAmount currencyID=\"USD\">124.00</cbc:PayableAmount></cac:LegalMonetaryTotal>\n  <cac:InvoiceLine><cbc:ID>1</cbc:ID><cbc:LineExtensionAmount currencyID=\"USD\">60.00</cbc:LineExtensionAmount><cac:Item><cbc:Name>Service A</cbc:Name></cac:Item></cac:InvoiceLine>\n  <cac:InvoiceLine><cbc:ID>2</cbc:ID><cbc:LineExtensionAmount currencyID=\"USD\">40.00</cbc:LineExtensionAmount><cac:Item><cbc:Name>Service B</cbc:Name></cac:Item></cac:InvoiceLine>\n</Invoice>","expected":{"supplier_name":"Example Ltd","purchase_order":"PO-8841","currency":"USD","total":"124.00"}}}}},"responses":{"200":{"description":"Machine-readable service result with PAYMENT-RESPONSE settlement receipt","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["decision","invoice","checks","evidence","source_sha256","warnings"],"properties":{"decision":{"type":"string","enum":["match","discrepancy","needs_review"]},"invoice":{"type":"object","additionalProperties":false,"required":["number","supplier_name","purchase_order","currency","subtotal","tax","total","line_items"],"properties":{"number":{"type":["string","null"]},"supplier_name":{"type":["string","null"]},"purchase_order":{"type":["string","null"]},"currency":{"type":["string","null"]},"subtotal":{"type":["string","null"]},"tax":{"type":["string","null"]},"total":{"type":["string","null"]},"line_items":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["description","amount"],"properties":{"description":{"type":["string","null"]},"amount":{"type":"string"}}}}}},"checks":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field","status"],"properties":{"field":{"type":"string"},"status":{"type":"string","enum":["match","discrepancy","needs_review"]},"expected":{"type":"string"},"actual":{"type":"string"},"calculated":{"type":"string"}}}},"evidence":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["field","source","text"],"properties":{"field":{"type":"string"},"source":{"type":"string"},"text":{"type":"string"}}}},"source_sha256":{"type":"string"},"pages_processed":{"type":"integer","minimum":1},"warnings":{"type":"array","items":{"type":"string"}}}},"example":{"decision":"match","invoice":{"number":"INV-8821","supplier_name":"Example Ltd","purchase_order":"PO-8841","currency":"USD","subtotal":"100.00","tax":"24.00","total":"124.00","line_items":[{"description":"Service A","amount":"60.00"},{"description":"Service B","amount":"40.00"}]},"checks":[{"field":"supplier_name","status":"match","expected":"Example Ltd","actual":"Example Ltd"},{"field":"purchase_order","status":"match","expected":"PO-8841","actual":"PO-8841"},{"field":"currency","status":"match","expected":"USD","actual":"USD"},{"field":"total","status":"match","expected":"124.00","actual":"124.00"},{"field":"line_items_sum","status":"match","calculated":"100.00","actual":"100.00"},{"field":"subtotal_plus_tax","status":"match","calculated":"124.00","actual":"124.00"}],"evidence":[{"field":"number","source":"Invoice/ID","text":"INV-8821"},{"field":"supplier_name","source":"Invoice/AccountingSupplierParty/Party/PartyLegalEntity/RegistrationName","text":"Example Ltd"},{"field":"purchase_order","source":"Invoice/OrderReference/ID","text":"PO-8841"},{"field":"currency","source":"Invoice/DocumentCurrencyCode","text":"USD"},{"field":"subtotal","source":"Invoice/LegalMonetaryTotal/TaxExclusiveAmount","text":"100.00"},{"field":"tax","source":"Invoice/TaxTotal/TaxAmount","text":"24.00"},{"field":"total","source":"Invoice/LegalMonetaryTotal/PayableAmount","text":"124.00"}],"source_sha256":"924b90ef73afa563db0e69f5f512e96e8041e9c6e192748011f1a8a809469fed","warnings":[]}}}},"400":{"description":"Invalid request or payment authorization; no service execution"},"402":{"description":"Payment Required: x402 v2 challenge in PAYMENT-REQUIRED"},"413":{"description":"Request body exceeds the service limit"},"422":{"description":"Service failed; no successful settlement reported"},"502":{"description":"Successful settlement and service result were not confirmed"},"503":{"description":"Service temporarily unavailable"}}}},"/api/mcp-server-inspect":{"post":{"operationId":"mcp_server_inspect","summary":"MCP Server Inspector","description":"Read-only health and tool-schema inspection for a public MCP endpoint.","tags":["MCP Server Inspector"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"endpoint":{"type":"string","maxLength":2048,"format":"uri"},"expected_tools":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":128}}},"required":["endpoint"],"additionalProperties":false},"example":{"endpoint":"https://mcp.dropenginehq.com/api/agent-services"}}}},"responses":{"200":{"description":"Machine-readable service result with PAYMENT-RESPONSE settlement receipt","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["reachable"]},"tool_count":{"type":"integer"},"read_only_inspection":{"type":"boolean","const":true}},"required":["status","tool_count","read_only_inspection"]},"example":{"status":"reachable","tool_count":4,"read_only_inspection":true,"tools_were_not_called":true}}}},"400":{"description":"Invalid request or payment authorization; no service execution"},"402":{"description":"Payment Required: x402 v2 challenge in PAYMENT-REQUIRED"},"413":{"description":"Request body exceeds the service limit"},"422":{"description":"Service failed; no successful settlement reported"},"502":{"description":"Successful settlement and service result were not confirmed"},"503":{"description":"Service temporarily unavailable"}}}},"/api/check-url":{"post":{"operationId":"check_url","summary":"URL Safety Gate","description":"Paid URL preflight security check with SSRF-safe HTTPS redirect inspection and optional threat intelligence.","tags":["URL Safety Gate"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"url":{"type":"string","minLength":1,"maxLength":4096}},"required":["url"],"additionalProperties":false},"example":{"url":"https://example.com"}}}},"responses":{"200":{"description":"Machine-readable service result with PAYMENT-RESPONSE settlement receipt","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"recommendation":{"type":"string","enum":["allow","caution","block"]},"risk_score":{"type":"integer","minimum":0,"maximum":100},"degraded":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"string"}}},"required":["success","recommendation","risk_score","degraded","warnings"]},"example":{"success":true,"safe":false,"risk_score":20,"risk_level":"medium","recommendation":"caution","normalized_url":"https://example.com/","final_url":"https://example.com/","redirect_count":0,"https":true,"domain_age_risk":"unknown","phishing":false,"malware":false,"suspicious_redirect":false,"suspicious_domain":false,"threats":[],"warnings":["external_threat_intel_not_configured; heuristic-only result"],"sources":["local_heuristics"],"cached":false,"degraded":true,"checked_at":"2026-09-28T00:00:00.000Z"}}}},"400":{"description":"Invalid request or payment authorization; no service execution"},"402":{"description":"Payment Required: x402 v2 challenge in PAYMENT-REQUIRED"},"413":{"description":"Request body exceeds the service limit"},"422":{"description":"Service failed; no successful settlement reported"},"502":{"description":"Successful settlement and service result were not confirmed"},"503":{"description":"Service temporarily unavailable"}}}},"/api/scan-content":{"post":{"operationId":"scan_content","summary":"Prompt-Injection Firewall","description":"Scan untrusted content for prompt injection and autonomous-agent manipulation.","tags":["Prompt-Injection Firewall"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"content":{"type":"string","minLength":1},"content_type":{"type":"string","enum":["text","html","markdown","email","tool_output","api_response","document_text"]},"source":{"type":"string","maxLength":2048}},"required":["content"],"additionalProperties":false},"example":{"content":"Product information: price USD 25, available in stock.","content_type":"text"}}}},"responses":{"200":{"description":"Machine-readable service result with PAYMENT-RESPONSE settlement receipt","content":{"application/json":{"schema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"safe":{"type":"boolean"},"risk_score":{"type":"integer","minimum":0,"maximum":100},"risk_level":{"type":"string","enum":["low","medium","high","critical"]},"recommendation":{"type":"string","enum":["allow","caution","sanitize","block"]},"prompt_injection_detected":{"type":"boolean"},"data_exfiltration_risk":{"type":"boolean"},"credential_theft_risk":{"type":"boolean"},"tool_manipulation_risk":{"type":"boolean"},"instruction_override_risk":{"type":"boolean"},"detected_patterns":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["instruction_override","system_prompt_extraction","credential_request","secret_exfiltration","tool_manipulation","external_data_exfiltration","unsafe_navigation_instruction","privilege_escalation","hidden_instruction","encoded_instruction","role_impersonation","memory_manipulation","security_bypass","suspicious_action_request"]},"severity":{"type":"string","enum":["low","medium","high","critical"]}},"required":["type","severity"],"additionalProperties":false}},"requested_actions":{"type":"array","items":{"type":"string"}},"sanitized_content":{"type":"string"},"sources":{"type":"array","items":{"type":"string"}},"cached":{"type":"boolean"},"degraded":{"type":"boolean"},"scanned_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["safe","risk_score","risk_level","recommendation","prompt_injection_detected","data_exfiltration_risk","credential_theft_risk","tool_manipulation_risk","instruction_override_risk","detected_patterns","requested_actions","sanitized_content","sources","cached","degraded","scanned_at"],"additionalProperties":false},"example":{"safe":true,"risk_score":0,"risk_level":"low","recommendation":"allow","prompt_injection_detected":false,"data_exfiltration_risk":false,"credential_theft_risk":false,"tool_manipulation_risk":false,"instruction_override_risk":false,"detected_patterns":[],"requested_actions":[],"sanitized_content":"The page has normal product information and pricing.","sources":[],"cached":false,"degraded":false,"scanned_at":"2026-09-28T00:00:00.000Z"}}}},"400":{"description":"Invalid request or payment authorization; no service execution"},"402":{"description":"Payment Required: x402 v2 challenge in PAYMENT-REQUIRED"},"413":{"description":"Request body exceeds the service limit"},"422":{"description":"Service failed; no successful settlement reported"},"502":{"description":"Successful settlement and service result were not confirmed"},"503":{"description":"Service temporarily unavailable"}}}},"/api/simulate-transaction":{"post":{"operationId":"simulate_transaction","summary":"Transaction Preflight","description":"Simulate an unsigned Base transaction and inspect top-level call and approval risks before execution.","tags":["Transaction Preflight"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"chain":{"type":"string","enum":["base","base-sepolia"]},"from":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"to":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"value":{"type":"string","maxLength":78,"pattern":"^(?:0|[1-9]\\d*)$"},"data":{"type":"string","maxLength":131074,"pattern":"^0x(?:[a-fA-F0-9]{2})*$"}},"required":["chain","from","to","value","data"],"additionalProperties":false},"example":{"chain":"base","from":"0x1111111111111111111111111111111111111111","to":"0x1111111111111111111111111111111111111111","value":"0","data":"0x"}}}},"responses":{"200":{"description":"Machine-readable service result with PAYMENT-RESPONSE settlement receipt","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request or payment authorization; no service execution"},"402":{"description":"Payment Required: x402 v2 challenge in PAYMENT-REQUIRED"},"413":{"description":"Request body exceeds the service limit"},"422":{"description":"Service failed; no successful settlement reported"},"502":{"description":"Successful settlement and service result were not confirmed"},"503":{"description":"Service temporarily unavailable"}}}},"/api/check-wallet":{"post":{"operationId":"check_wallet","summary":"Wallet Risk Check","description":"Check a public Base wallet or contract for counterparty risk before value moves.","tags":["Wallet Risk Check"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"chain":{"type":"string","enum":["base","base-sepolia"]},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}},"required":["chain","address"],"additionalProperties":false},"example":{"chain":"base","address":"0x833589fCD6eDb6E08f4c7C32D4F71b54bdA02913"}}}},"responses":{"200":{"description":"Machine-readable service result with PAYMENT-RESPONSE settlement receipt","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request or payment authorization; no service execution"},"402":{"description":"Payment Required: x402 v2 challenge in PAYMENT-REQUIRED"},"413":{"description":"Request body exceeds the service limit"},"422":{"description":"Service failed; no successful settlement reported"},"502":{"description":"Successful settlement and service result were not confirmed"},"503":{"description":"Service temporarily unavailable"}}}},"/api/check-package":{"post":{"operationId":"check_package","summary":"Package Safety Gate","description":"Check npm package metadata and security before installation.","tags":["Package Safety Gate"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ecosystem":{"type":"string","const":"npm"},"package":{"type":"string","minLength":1,"maxLength":214},"version":{"type":"string","maxLength":128}},"required":["ecosystem","package"],"additionalProperties":false},"example":{"ecosystem":"npm","package":"axios"}}}},"responses":{"200":{"description":"Machine-readable service result with PAYMENT-RESPONSE settlement receipt","content":{"application/json":{"schema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"success":{"type":"boolean","const":true},"ecosystem":{"type":"string","const":"npm"},"package":{"type":"string"},"requested_version":{"type":["string","null"]},"resolved_version":{"type":"string"},"risk_score":{"type":"integer","minimum":0,"maximum":100},"risk_level":{"type":"string","enum":["low","medium","high","critical"]},"risk_confidence":{"type":"string","enum":["low","medium","high"]},"recommendation":{"type":"string","enum":["allow","caution","block"]},"known_malicious":{"type":["boolean","null"]},"malicious_confidence":{"anyOf":[{"type":"string","enum":["low","medium","high"]},{"type":"null"}]},"known_vulnerabilities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"summary":{"type":["string","null"]},"severity":{"type":"string","enum":["low","medium","high","critical","unknown"]},"affected":{"type":"boolean","const":true},"fixed_version":{"type":["string","null"]}},"required":["id","summary","severity","affected","fixed_version"],"additionalProperties":false}},"typosquat_risk":{"type":"string","enum":["low","medium","high","critical","unknown"]},"similar_to":{"type":["string","null"]},"similarity_score":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"install_script_risk":{"type":"string","enum":["low","medium","high","critical","unknown"]},"suspicious_scripts":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"signals":{"type":"array","items":{"type":"string"}}},"required":["name","signals"],"additionalProperties":false}},"dependency_risk":{"type":"string","enum":["low","medium","high","unknown"]},"dependency_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"dependencies_analyzed":{"type":"integer","minimum":0,"maximum":9007199254740991},"dependency_findings":{"type":"array","items":{"type":"object","properties":{"package":{"type":"string"},"version":{"type":"string"},"known_malicious":{"type":["boolean","null"]},"vulnerabilities":{"type":"array","items":{"type":"string"}},"risk":{"type":"string","enum":["low","medium","high","critical","unknown"]}},"required":["package","version","known_malicious","vulnerabilities","risk"],"additionalProperties":false}},"maintainer_risk":{"type":"string","enum":["low","medium","high","unknown"]},"maintainer_count":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"reputation":{"type":"string","enum":["good","neutral","suspicious","malicious","unknown"]},"package_age_days":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"new_package":{"type":["boolean","null"]},"deprecated":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"string"}},"degraded":{"type":"boolean"},"cached":{"type":"boolean"},"checked_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"data_freshness_seconds":{"type":"number","minimum":0}},"required":["success","ecosystem","package","requested_version","resolved_version","risk_score","risk_level","risk_confidence","recommendation","known_malicious","malicious_confidence","known_vulnerabilities","typosquat_risk","similar_to","similarity_score","install_script_risk","suspicious_scripts","dependency_risk","dependency_count","dependencies_analyzed","dependency_findings","maintainer_risk","maintainer_count","reputation","package_age_days","new_package","deprecated","warnings","sources","degraded","cached","checked_at","data_freshness_seconds"],"additionalProperties":false},"example":{"success":true,"ecosystem":"npm","package":"axios","requested_version":null,"resolved_version":"1.7.0","risk_score":10,"risk_level":"low","risk_confidence":"medium","recommendation":"allow","known_malicious":false,"malicious_confidence":null,"known_vulnerabilities":[],"typosquat_risk":"low","similar_to":null,"similarity_score":null,"install_script_risk":"low","suspicious_scripts":[],"dependency_risk":"low","dependency_count":0,"dependencies_analyzed":0,"dependency_findings":[],"maintainer_risk":"unknown","maintainer_count":null,"reputation":"neutral","package_age_days":null,"new_package":null,"deprecated":false,"warnings":[],"sources":["npm_registry","osv"],"degraded":false,"cached":false,"checked_at":"2026-09-28T00:00:00.000Z","data_freshness_seconds":0}}}},"400":{"description":"Invalid request or payment authorization; no service execution"},"402":{"description":"Payment Required: x402 v2 challenge in PAYMENT-REQUIRED"},"413":{"description":"Request body exceeds the service limit"},"422":{"description":"Service failed; no successful settlement reported"},"502":{"description":"Successful settlement and service result were not confirmed"},"503":{"description":"Service temporarily unavailable"}}}},"/api/route-tool":{"post":{"operationId":"route_tool","summary":"Agent Tool Router + Trust Layer","description":"Finds and ranks machine-payable services for an agent capability.","tags":["Agent Tool Router + Trust Layer"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"capability":{"type":"string","minLength":2,"maxLength":80,"pattern":"^[a-zA-Z][a-zA-Z0-9_.-]*$"},"query":{"type":"string","maxLength":300},"constraints":{"type":"object","properties":{"max_price_usd":{"type":"number","minimum":0,"maximum":1000000},"max_latency_ms":{"type":"integer","minimum":1,"maximum":600000},"min_success_rate":{"type":"number","minimum":0,"maximum":1}},"additionalProperties":false},"preferences":{"type":"object","properties":{"optimize_for":{"type":"string","enum":["cheapest","fastest","quality","reliability","balanced"]}},"additionalProperties":false}},"required":["capability"],"additionalProperties":false},"example":{"capability":"wallet_risk","preferences":{"optimize_for":"balanced"}}}}},"responses":{"200":{"description":"Machine-readable service result with PAYMENT-RESPONSE settlement receipt","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"match_found":{"type":"boolean"},"capability":{"type":"string"},"candidates_found":{"type":"integer"},"candidates_after_filters":{"type":"integer"},"degraded":{"type":"boolean"}},"required":["success","match_found","capability","candidates_found","candidates_after_filters","degraded"]},"example":{"success":true,"match_found":false,"capability":"crypto_price","recommended":null,"alternatives":[],"candidates_found":0,"candidates_after_filters":0,"routing_reason":[],"registry_sources":["local_registry"],"degraded":true,"cached":false,"checked_at":"2026-01-01T00:00:00.000Z"}}}},"400":{"description":"Invalid request or payment authorization; no service execution"},"402":{"description":"Payment Required: x402 v2 challenge in PAYMENT-REQUIRED"},"413":{"description":"Request body exceeds the service limit"},"422":{"description":"Service failed; no successful settlement reported"},"502":{"description":"Successful settlement and service result were not confirmed"},"503":{"description":"Service temporarily unavailable"}}}},"/api/get-live-quote":{"post":{"operationId":"get_live_quote","summary":"Live Product Quote","description":"Return public product price and availability before purchase.","tags":["Live Product Quote"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"url":{"type":"string","maxLength":4096,"format":"uri"},"quantity":{"type":"integer","minimum":1,"maximum":100},"destination":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":2,"pattern":"^[A-Za-z]{2}$"},"postal_code":{"type":"string","maxLength":20}},"required":["country"],"additionalProperties":false},"variant":{"type":"object","properties":{"size":{"type":"string","maxLength":80},"color":{"type":"string","maxLength":80}},"additionalProperties":false}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.adafruit.com/product/4298"}}}},"responses":{"200":{"description":"Machine-readable service result with PAYMENT-RESPONSE settlement receipt","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request or payment authorization; no service execution"},"402":{"description":"Payment Required: x402 v2 challenge in PAYMENT-REQUIRED"},"413":{"description":"Request body exceeds the service limit"},"422":{"description":"Service failed; no successful settlement reported"},"502":{"description":"Successful settlement and service result were not confirmed"},"503":{"description":"Service temporarily unavailable"}}}},"/api/extract-structured":{"post":{"operationId":"extract_structured","summary":"Fresh Structured Extract","description":"Extract fresh structured JSON from a public webpage.","tags":["Fresh Structured Extract"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"url":{"type":"string","maxLength":4096,"format":"uri"},"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","enum":["string","number","boolean","string|null","number|null","boolean|null"]}}},"required":["url"],"additionalProperties":false},"example":{"url":"https://example.com","schema":{"title":"string|null","description":"string|null"}}}}},"responses":{"200":{"description":"Machine-readable service result with PAYMENT-RESPONSE settlement receipt","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request or payment authorization; no service execution"},"402":{"description":"Payment Required: x402 v2 challenge in PAYMENT-REQUIRED"},"413":{"description":"Request body exceeds the service limit"},"422":{"description":"Service failed; no successful settlement reported"},"502":{"description":"Successful settlement and service result were not confirmed"},"503":{"description":"Service temporarily unavailable"}}}},"/api/check-change":{"post":{"operationId":"check_change","summary":"Change / Diff Check","description":"Compare normalized public webpage text with a prior SHA-256 hash.","tags":["Change / Diff Check"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"url":{"type":"string","maxLength":4096,"format":"uri"},"previous_hash":{"type":"string","minLength":1,"maxLength":80}},"required":["url","previous_hash"],"additionalProperties":false},"example":{"url":"https://example.com","previous_hash":"sha256:0000000000000000000000000000000000000000000000000000000000000000"}}}},"responses":{"200":{"description":"Machine-readable service result with PAYMENT-RESPONSE settlement receipt","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request or payment authorization; no service execution"},"402":{"description":"Payment Required: x402 v2 challenge in PAYMENT-REQUIRED"},"413":{"description":"Request body exceeds the service limit"},"422":{"description":"Service failed; no successful settlement reported"},"502":{"description":"Successful settlement and service result were not confirmed"},"503":{"description":"Service temporarily unavailable"}}}},"/api/verify-claim":{"post":{"operationId":"verify_claim","summary":"Freshness / Claim Verifier","description":"Verify a factual claim against fresh web evidence.","tags":["Freshness / Claim Verifier"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"claim":{"type":"string","minLength":8,"maxLength":2000},"freshness_days":{"type":"integer","minimum":1,"maximum":3650},"preferred_domains":{"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":253,"pattern":"^[a-zA-Z0-9.-]+$"}}},"required":["claim"],"additionalProperties":false},"example":{"claim":"Base is an Ethereum layer 2 blockchain.","freshness_days":365}}}},"responses":{"200":{"description":"Machine-readable service result with PAYMENT-RESPONSE settlement receipt","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request or payment authorization; no service execution"},"402":{"description":"Payment Required: x402 v2 challenge in PAYMENT-REQUIRED"},"413":{"description":"Request body exceeds the service limit"},"422":{"description":"Service failed; no successful settlement reported"},"502":{"description":"Successful settlement and service result were not confirmed"},"503":{"description":"Service temporarily unavailable"}}}},"/api/estimate-trade-execution":{"post":{"operationId":"estimate_trade_execution","summary":"Trade Execution Quote","description":"Request an indicative read-only swap quote.","tags":["Trade Execution Quote"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"chain":{"type":"string","enum":["solana","ethereum","base","arbitrum","optimism","polygon"]},"from_asset":{"type":"string","minLength":1,"maxLength":90},"to_asset":{"type":"string","minLength":1,"maxLength":90},"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000000000},"from_decimals":{"type":"integer","minimum":0,"maximum":36},"to_decimals":{"type":"integer","minimum":0,"maximum":36},"max_slippage_bps":{"default":100,"type":"integer","minimum":1,"maximum":500},"venues":{"maxItems":2,"type":"array","items":{"type":"string","enum":["jupiter","0x"]}}},"required":["chain","from_asset","to_asset","amount"],"additionalProperties":false},"example":{"chain":"solana","from_asset":"So11111111111111111111111111111111111111112","to_asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","amount":0.1,"from_decimals":9,"to_decimals":6}}}},"responses":{"200":{"description":"Machine-readable service result with PAYMENT-RESPONSE settlement receipt","content":{"application/json":{"schema":{"type":"object","required":["success","tool","timestamp","data","meta"],"properties":{"success":{"type":"boolean","const":true},"tool":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"data":{"type":"object","additionalProperties":true},"meta":{"type":"object","additionalProperties":true}}},"example":{"success":true,"tool":"crypto_intelligence_tool","timestamp":"2026-01-01T00:00:00.000Z","data":{},"meta":{"sources":[],"latency_ms":1,"partial":false,"failed_sources":[],"cache":{"hit":false,"age_ms":0}}}}}},"400":{"description":"Invalid request or payment authorization; no service execution"},"402":{"description":"Payment Required: x402 v2 challenge in PAYMENT-REQUIRED"},"413":{"description":"Request body exceeds the service limit"},"422":{"description":"Service failed; no successful settlement reported"},"502":{"description":"Successful settlement and service result were not confirmed"},"503":{"description":"Service temporarily unavailable"}}}},"/api/analyze-whale-activity":{"post":{"operationId":"analyze_whale_activity","summary":"Whale Intelligence","description":"Analyze public indexed large DEX trades.","tags":["Whale Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","oneOf":[{"type":"object","properties":{"mode":{"type":"string","const":"asset"},"chain":{"type":"string","enum":["solana","ethereum","base","arbitrum","optimism","polygon"]},"asset":{"type":"string","minLength":1,"maxLength":90},"window":{"default":"1h","type":"string","enum":["5m","15m","1h","4h","24h"]},"min_transaction_usd":{"default":100000,"type":"number","minimum":1,"maximum":1000000000},"limit":{"default":50,"type":"integer","minimum":1,"maximum":100}},"required":["mode","chain","asset"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"wallet"},"chain":{"type":"string","enum":["solana","ethereum","base","arbitrum","optimism","polygon"]},"address":{"type":"string","minLength":1,"maxLength":128}},"required":["mode","chain","address"],"additionalProperties":false}]},"example":{"mode":"asset","chain":"solana","asset":"So11111111111111111111111111111111111111112","window":"1h","min_transaction_usd":100000,"limit":50}}}},"responses":{"200":{"description":"Machine-readable service result with PAYMENT-RESPONSE settlement receipt","content":{"application/json":{"schema":{"type":"object","required":["success","tool","timestamp","data","meta"],"properties":{"success":{"type":"boolean","const":true},"tool":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"data":{"type":"object","additionalProperties":true},"meta":{"type":"object","additionalProperties":true}}},"example":{"success":true,"tool":"crypto_intelligence_tool","timestamp":"2026-01-01T00:00:00.000Z","data":{},"meta":{"sources":[],"latency_ms":1,"partial":false,"failed_sources":[],"cache":{"hit":false,"age_ms":0}}}}}},"400":{"description":"Invalid request or payment authorization; no service execution"},"402":{"description":"Payment Required: x402 v2 challenge in PAYMENT-REQUIRED"},"413":{"description":"Request body exceeds the service limit"},"422":{"description":"Service failed; no successful settlement reported"},"502":{"description":"Successful settlement and service result were not confirmed"},"503":{"description":"Service temporarily unavailable"}}}},"/api/scan-arbitrage":{"post":{"operationId":"scan_arbitrage","summary":"Arbitrage Intelligence","description":"Compare public exchange order books after fee assumptions.","tags":["Arbitrage Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"asset":{"type":"string","pattern":"^[A-Z0-9]{2,15}$"},"quote_asset":{"default":"USDT","type":"string","enum":["USDT","USDC","USD"]},"venues":{"default":["binance","coinbase"],"minItems":2,"maxItems":2,"type":"array","items":{"type":"string","enum":["binance","coinbase"]}},"trade_size_usd":{"type":"number","minimum":10,"maximum":10000000},"min_net_spread_bps":{"default":0,"type":"number","minimum":0,"maximum":5000},"fee_bps_by_venue":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number","minimum":0,"maximum":1000}}},"required":["asset","trade_size_usd"],"additionalProperties":false},"example":{"asset":"BTC","quote_asset":"USDT","trade_size_usd":1000,"min_net_spread_bps":0}}}},"responses":{"200":{"description":"Machine-readable service result with PAYMENT-RESPONSE settlement receipt","content":{"application/json":{"schema":{"type":"object","required":["success","tool","timestamp","data","meta"],"properties":{"success":{"type":"boolean","const":true},"tool":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"data":{"type":"object","additionalProperties":true},"meta":{"type":"object","additionalProperties":true}}},"example":{"success":true,"tool":"crypto_intelligence_tool","timestamp":"2026-01-01T00:00:00.000Z","data":{},"meta":{"sources":[],"latency_ms":1,"partial":false,"failed_sources":[],"cache":{"hit":false,"age_ms":0}}}}}},"400":{"description":"Invalid request or payment authorization; no service execution"},"402":{"description":"Payment Required: x402 v2 challenge in PAYMENT-REQUIRED"},"413":{"description":"Request body exceeds the service limit"},"422":{"description":"Service failed; no successful settlement reported"},"502":{"description":"Successful settlement and service result were not confirmed"},"503":{"description":"Service temporarily unavailable"}}}},"/api/backtest-strategy":{"post":{"operationId":"backtest_strategy","summary":"Strategy Backtest","description":"Run a bounded declarative historical spot strategy backtest.","tags":["Strategy Backtest"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"market":{"type":"string","pattern":"^[A-Z0-9]{4,20}$"},"timeframe":{"type":"string","enum":["1h","4h","1d"]},"start":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"end":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"initial_capital":{"type":"number","minimum":10,"maximum":100000000},"fee_bps":{"default":10,"type":"number","minimum":0,"maximum":500},"slippage_bps":{"default":5,"type":"number","minimum":0,"maximum":500},"strategy":{"type":"object","properties":{"type":{"type":"string","enum":["moving_average_crossover","rsi_mean_reversion","momentum","breakout","buy_and_hold"]},"parameters":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["type"],"additionalProperties":false}},"required":["market","timeframe","start","end","initial_capital","strategy"],"additionalProperties":false},"example":{"market":"BTCUSDT","timeframe":"1d","start":"2025-01-01","end":"2025-04-01","initial_capital":10000,"strategy":{"type":"buy_and_hold","parameters":{}}}}}},"responses":{"200":{"description":"Machine-readable service result with PAYMENT-RESPONSE settlement receipt","content":{"application/json":{"schema":{"type":"object","required":["success","tool","timestamp","data","meta"],"properties":{"success":{"type":"boolean","const":true},"tool":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"data":{"type":"object","additionalProperties":true},"meta":{"type":"object","additionalProperties":true}}},"example":{"success":true,"tool":"crypto_intelligence_tool","timestamp":"2026-01-01T00:00:00.000Z","data":{},"meta":{"sources":[],"latency_ms":1,"partial":false,"failed_sources":[],"cache":{"hit":false,"age_ms":0}}}}}},"400":{"description":"Invalid request or payment authorization; no service execution"},"402":{"description":"Payment Required: x402 v2 challenge in PAYMENT-REQUIRED"},"413":{"description":"Request body exceeds the service limit"},"422":{"description":"Service failed; no successful settlement reported"},"502":{"description":"Successful settlement and service result were not confirmed"},"503":{"description":"Service temporarily unavailable"}}}},"/api/token-security-audit":{"post":{"operationId":"token_security_audit","summary":"Token Security Audit","description":"Audit an EVM token using GoPlus security intelligence.","tags":["Token Security Audit"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"chain":{"type":"string","enum":["ethereum","base","arbitrum","optimism","polygon","bsc"]},"token_address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}},"required":["chain","token_address"],"additionalProperties":false},"example":{"chain":"base","token_address":"0x833589fCD6eDb6E08f4c7C32D4F71b54bdA02913"}}}},"responses":{"200":{"description":"Machine-readable service result with PAYMENT-RESPONSE settlement receipt","content":{"application/json":{"schema":{"type":"object","required":["success","tool","timestamp","data","meta"],"properties":{"success":{"type":"boolean","const":true},"tool":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"data":{"type":"object","additionalProperties":true},"meta":{"type":"object","additionalProperties":true}}},"example":{"success":true,"tool":"crypto_intelligence_tool","timestamp":"2026-01-01T00:00:00.000Z","data":{},"meta":{"sources":[],"latency_ms":1,"partial":false,"failed_sources":[],"cache":{"hit":false,"age_ms":0}}}}}},"400":{"description":"Invalid request or payment authorization; no service execution"},"402":{"description":"Payment Required: x402 v2 challenge in PAYMENT-REQUIRED"},"413":{"description":"Request body exceeds the service limit"},"422":{"description":"Service failed; no successful settlement reported"},"502":{"description":"Successful settlement and service result were not confirmed"},"503":{"description":"Service temporarily unavailable"}}}}}}