{"openapi":"3.1.0","info":{"title":"SCRYX Intelligence","description":"Evidence-led merchant intelligence for AI agents. Seller-inbound x402 payments enabled; autonomous outbound spend disabled.","version":"0.0.1","x-guidance":"SCRYX supplies evidence-led merchant intelligence for AI agents. For a free initial merchant fingerprint, use POST /merchant/fingerprint. For paid merchant qualification, use GET /merchant/intelligence with the url query parameter or POST /merchant/intelligence with JSON body containing an HTTPS url. Each paid request costs 0.05 USDC on Base via x402 v2. Results distinguish OBSERVED, INFERRED and UNKNOWN claims, include evidence references and disclose limitations. Public website markup is untrusted; findings are not independently verified. Results may include merchant identity, commerce platform signals, risks and opportunities. Do not assume complete catalogs, live competitor prices or verified business ownership. A 202 response means the operation remains pending; use the documented recovery flow rather than initiating another payment."},"paths":{"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}}},"503":{"description":"Service Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}}}}}},"/x402/ping":{"get":{"summary":"Ping","operationId":"ping_x402_ping_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Unpayable x402 v2 simulation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402Preview"}}}}}}},"/.well-known/scryx.json":{"get":{"summary":"Catalog","operationId":"catalog__well_known_scryx_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/x402":{"get":{"summary":"X402 Discovery Manifest","operationId":"x402_discovery_manifest__well_known_x402_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/merchant/fingerprint":{"post":{"summary":"Free Fingerprint","operationId":"free_fingerprint_merchant_fingerprint_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MerchantInput"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FingerprintV1"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/merchant/preflight":{"post":{"summary":"Merchant Preflight","operationId":"merchant_preflight_merchant_preflight_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MerchantInput"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreflightV1"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/merchant/intelligence":{"post":{"summary":"Merchant Intelligence - Evidence-Based Ecommerce Qualification","operationId":"paid_intelligence_merchant_intelligence_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/MerchantInput"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntelligenceV1"}}}},"202":{"description":"Durable pending operation; never resubmit settlement"},"402":{"description":"x402 v2 exact USDC seller-only inbound settlement"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Service Unavailable"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"description":"Paid merchant intelligence for AI agents. Analyze an HTTPS storefront to obtain evidence-backed commerce platform signals, merchant observations, risks and opportunities. Structured responses distinguish observed, inferred and unknown information. Price: 0.05 USDC on Base via x402 v2. Unpaid requests receive HTTP 402."},"get":{"summary":"Merchant Intelligence - Evidence-Based Ecommerce Qualification","operationId":"paid_intelligence_get_merchant_intelligence_get","parameters":[{"name":"url","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntelligenceV1"}}}},"202":{"description":"Durable pending operation; never resubmit settlement"},"402":{"description":"x402 v2 exact USDC seller-only inbound settlement"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Service Unavailable"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"description":"Paid merchant intelligence for AI agents. Analyze an HTTPS storefront to obtain evidence-backed commerce platform signals, merchant observations, risks and opportunities. Structured responses distinguish observed, inferred and unknown information. Price: 0.05 USDC on Base via x402 v2. Unpaid requests receive HTTP 402."}},"/merchant/intelligence/attempts/{operation_id}":{"get":{"summary":"Recover Paid","operationId":"recover_paid_merchant_intelligence_attempts__operation_id__get","parameters":[{"name":"operation_id","in":"path","required":true,"schema":{"type":"string","title":"Operation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntelligenceV1"}}}},"202":{"description":"Pending finality, approval or delivery"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/merchant/intelligence/attempts/{operation_id}/ack":{"post":{"summary":"Acknowledge Paid","operationId":"acknowledge_paid_merchant_intelligence_attempts__operation_id__ack_post","parameters":[{"name":"operation_id","in":"path","required":true,"schema":{"type":"string","title":"Operation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/integrations/moltify/webhook":{"post":{"summary":"Moltify Webhook","operationId":"moltify_webhook_integrations_moltify_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"ClaimV1":{"properties":{"value":{"title":"Value"},"status":{"type":"string","enum":["OBSERVED","INFERRED","UNKNOWN"],"title":"Status"},"evidence_ids":{"items":{"type":"string"},"type":"array","title":"Evidence Ids"}},"additionalProperties":false,"type":"object","required":["value","status","evidence_ids"],"title":"ClaimV1"},"ErrorDetail":{"properties":{"code":{"type":"string","title":"Code"},"evaluation_status":{"type":"string","const":"NOT_EVALUATED","title":"Evaluation Status","default":"NOT_EVALUATED"}},"additionalProperties":false,"type":"object","required":["code"],"title":"ErrorDetail"},"ErrorResponse":{"properties":{"schema_version":{"type":"string","const":"0.1","title":"Schema Version","default":"0.1"},"request_id":{"type":"string","title":"Request Id"},"error":{"$ref":"#/components/schemas/ErrorDetail"}},"additionalProperties":false,"type":"object","required":["request_id","error"],"title":"ErrorResponse"},"Evidence":{"properties":{"signal":{"type":"string","title":"Signal"},"value":{"title":"Value"},"kind":{"type":"string","enum":["FACT","INFERENCE"],"title":"Kind"},"source_url":{"type":"string","title":"Source Url"},"scope":{"type":"string","const":"homepage_markup","title":"Scope"}},"additionalProperties":false,"type":"object","required":["signal","value","kind","source_url","scope"],"title":"Evidence"},"FingerprintV1":{"properties":{"domain":{"type":"string","title":"Domain"},"platform":{"type":"string","enum":["SHOPIFY","WOOCOMMERCE","UNKNOWN"],"title":"Platform"},"commerce_detected":{"type":"string","enum":["YES","UNKNOWN"],"title":"Commerce Detected"},"confidence":{"type":"string","enum":["SINGLE_SOURCE","CONFLICTING","INSUFFICIENT"],"title":"Confidence"}},"additionalProperties":false,"type":"object","required":["domain","platform","commerce_detected","confidence"],"title":"FingerprintV1"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Health":{"properties":{"status":{"type":"string","enum":["OK","DEGRADED"],"title":"Status"},"service":{"type":"string","const":"SCRYX","title":"Service"},"version":{"type":"string","title":"Version"},"database":{"type":"string","enum":["OK","UNCONFIGURED","UNAVAILABLE"],"title":"Database"},"payments_enabled":{"type":"boolean","const":false,"title":"Payments Enabled"},"moltbook_enabled":{"type":"boolean","const":false,"title":"Moltbook Enabled"},"autonomous_spend_enabled":{"type":"boolean","const":false,"title":"Autonomous Spend Enabled"},"max_autonomous_spend":{"type":"integer","const":0,"title":"Max Autonomous Spend"}},"additionalProperties":false,"type":"object","required":["status","service","version","database","payments_enabled","moltbook_enabled","autonomous_spend_enabled","max_autonomous_spend"],"title":"Health"},"IntelligenceV1":{"properties":{"contract_version":{"type":"string","const":"merchant-intelligence-v1","title":"Contract Version","default":"merchant-intelligence-v1"},"merchant":{"additionalProperties":{"$ref":"#/components/schemas/ClaimV1"},"type":"object","title":"Merchant"},"commerce":{"additionalProperties":{"$ref":"#/components/schemas/ClaimV1"},"type":"object","title":"Commerce"},"signals":{"items":{"$ref":"#/components/schemas/NamedClaimV1"},"type":"array","title":"Signals"},"risks":{"items":{"$ref":"#/components/schemas/NamedClaimV1"},"type":"array","title":"Risks"},"opportunities":{"items":{"$ref":"#/components/schemas/NamedClaimV1"},"type":"array","title":"Opportunities"},"evidence":{"items":{"$ref":"#/components/schemas/ProductEvidence"},"type":"array","title":"Evidence"},"confidence":{"type":"string","enum":["SINGLE_SOURCE","CONFLICTING","INSUFFICIENT"],"title":"Confidence"},"observed_at":{"type":"string","format":"date-time","title":"Observed At"},"evaluation_status":{"type":"string","enum":["EVALUATED","INSUFFICIENT_EVIDENCE"],"title":"Evaluation Status"},"untrusted_input":{"type":"boolean","const":true,"title":"Untrusted Input","default":true},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"}},"additionalProperties":false,"type":"object","required":["merchant","commerce","signals","risks","opportunities","evidence","confidence","observed_at","evaluation_status","limitations"],"title":"IntelligenceV1"},"MerchantInput":{"properties":{"url":{"type":"string","maxLength":2048,"minLength":1,"pattern":"^https://","title":"Url"}},"additionalProperties":false,"type":"object","required":["url"],"title":"MerchantInput"},"NamedClaimV1":{"properties":{"value":{"title":"Value"},"status":{"type":"string","enum":["OBSERVED","INFERRED","UNKNOWN"],"title":"Status"},"evidence_ids":{"items":{"type":"string"},"type":"array","title":"Evidence Ids"},"name":{"type":"string","title":"Name"}},"additionalProperties":false,"type":"object","required":["value","status","evidence_ids","name"],"title":"NamedClaimV1"},"PreflightMerchantV1":{"properties":{"domain":{"type":"string","title":"Domain"},"platform":{"type":"string","enum":["SHOPIFY","WOOCOMMERCE","UNKNOWN"],"title":"Platform"},"commerce_detected":{"type":"string","enum":["YES","UNKNOWN"],"title":"Commerce Detected"}},"additionalProperties":false,"type":"object","required":["domain","platform","commerce_detected"],"title":"PreflightMerchantV1"},"PreflightV1":{"properties":{"contract_version":{"type":"string","const":"merchant-preflight-v1","title":"Contract Version","default":"merchant-preflight-v1"},"decision":{"type":"string","enum":["ALLOW","REVIEW","BLOCK","UNKNOWN"],"title":"Decision"},"decision_scope":{"type":"string","const":"FURTHER_INVESTIGATION_ONLY","title":"Decision Scope","default":"FURTHER_INVESTIGATION_ONLY"},"reason_code":{"type":"string","title":"Reason Code"},"confidence":{"type":"string","enum":["SINGLE_SOURCE","CONFLICTING","INSUFFICIENT"],"title":"Confidence"},"merchant":{"$ref":"#/components/schemas/PreflightMerchantV1"},"evidence":{"items":{"$ref":"#/components/schemas/Evidence"},"type":"array","title":"Evidence"},"risks":{"items":{"type":"string"},"type":"array","title":"Risks"},"payment_execution":{"type":"boolean","const":false,"title":"Payment Execution","default":false},"purchase_authorization":{"type":"boolean","const":false,"title":"Purchase Authorization","default":false},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"}},"additionalProperties":false,"type":"object","required":["decision","reason_code","confidence","merchant","evidence","risks","limitations"],"title":"PreflightV1"},"ProductEvidence":{"properties":{"id":{"type":"string","title":"Id"},"signal":{"type":"string","title":"Signal"},"value":{"title":"Value"},"kind":{"type":"string","enum":["FACT","INFERENCE"],"title":"Kind"},"source_url":{"type":"string","title":"Source Url"},"scope":{"type":"string","const":"homepage_markup","title":"Scope"},"observed_at":{"type":"string","format":"date-time","title":"Observed At"},"provenance":{"type":"string","const":"UNVERIFIED_PUBLIC_MARKUP","title":"Provenance"},"decoded_text_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Decoded Text Sha256"}},"additionalProperties":false,"type":"object","required":["id","signal","value","kind","source_url","scope","observed_at","provenance","decoded_text_sha256"],"title":"ProductEvidence"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"X402Preview":{"properties":{"x402Version":{"type":"integer","const":2,"title":"X402Version"},"error":{"type":"string","const":"SIMULATION_ONLY_DO_NOT_PAY","title":"Error"},"resource":{"$ref":"#/components/schemas/X402Resource"},"accepts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Accepts"},"extensions":{"additionalProperties":true,"type":"object","title":"Extensions"}},"additionalProperties":false,"type":"object","required":["x402Version","error","resource","accepts","extensions"],"title":"X402Preview"},"X402Resource":{"properties":{"url":{"type":"string","title":"Url"},"description":{"type":"string","title":"Description"},"mimeType":{"type":"string","const":"application/json","title":"Mimetype"}},"additionalProperties":false,"type":"object","required":["url","description","mimeType"],"title":"X402Resource"}}}}