{"openapi":"3.1.0","info":{"title":"WritersLogic Verifiable AI Agent Hub","version":"2.0.0","description":"Pay-per-call agents settled in USDC on Base via x402. Every response carries a signed provenance envelope.","contact":{"name":"WritersLogic","url":"https://writerslogic.com/agents"}},"servers":[{"url":"https://agents.writerslogic.com"}],"components":{"securitySchemes":{"x402":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"x402 v2 payment payload (base64) sent after a 402 challenge"},"apiKey":{"type":"apiKey","in":"header","name":"X-API-KEY"}}},"paths":{"/api/v1/enrich-lead":{"post":{"operationId":"lead_enrichment","summary":"Autonomous Lead Enrichment","description":"Scrapes a company homepage, deduces its value proposition and buyer persona, and drafts a targeted B2B cold email.\n\nPrice: 0.50 USDC on Base (x402).","x-x402-price-usdc":"0.50","x-x402-amount":"500000","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"url":{"type":"string","minLength":3,"maxLength":2048,"description":"Company homepage URL; https:// is assumed if omitted."},"senderContext":{"type":"string","maxLength":2000,"description":"What you sell, used to tailor the pitch."}}},"example":{"url":"https://stripe.com","senderContext":"We sell AI-driven chargeback dispute automation for online merchants."}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","additionalProperties":false,"required":["company_name","industry","value_proposition","target_customers","key_offerings","buyer_persona","cold_email","source_url","page_title","company_name_source","contact","pages_read","email_check"],"properties":{"company_name":{"type":"string"},"industry":{"type":"string"},"value_proposition":{"type":"string","description":"One or two sentences: what they sell, to whom, and why it wins."},"target_customers":{"type":"array","items":{"type":"string"}},"key_offerings":{"type":"array","items":{"type":"string"}},"buyer_persona":{"type":"object","additionalProperties":false,"required":["title","pain_points"],"properties":{"title":{"type":"string","description":"Job title of the most likely decision maker to email."},"pain_points":{"type":"array","items":{"type":"string"}}}},"cold_email":{"type":"object","additionalProperties":false,"required":["subject","body"],"properties":{"subject":{"type":"string"},"body":{"type":"string"}}},"source_url":{"type":"string"},"page_title":{"type":"string"},"company_name_source":{"type":"string","enum":["json-ld","og:site_name","model"],"description":"Where company_name came from; parsed values are never model-generated."},"contact":{"type":"object","additionalProperties":false,"required":["emails","phones","social_links","address"],"properties":{"emails":{"type":"array","items":{"type":"string"}},"phones":{"type":"array","items":{"type":"string"}},"social_links":{"type":"array","items":{"type":"string"}},"address":{"type":"string","description":"Empty string when none was found."}}},"pages_read":{"type":"array","items":{"type":"string"},"description":"Extra same-site pages (about, pricing, customers, careers) read besides the homepage."},"email_check":{"type":"object","additionalProperties":false,"required":["passed","violations","retried"],"properties":{"passed":{"type":"boolean"},"violations":{"type":"array","items":{"type":"string"}},"retried":{"type":"boolean"}}}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/api/v1/audit-contract":{"post":{"operationId":"contract_auditor","summary":"Smart Contract Auditor","description":"Solidity vulnerability analysis (reentrancy, overflow, access control, logic bugs) with a severity-ranked JSON report.\n\nPrice: 1.00 USDC on Base (x402).","x-x402-price-usdc":"1.00","x-x402-amount":"1000000","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code"],"properties":{"code":{"type":"string","minLength":1,"maxLength":100000,"description":"Raw Solidity source (one or more files concatenated)."},"contractName":{"type":"string","maxLength":200,"description":"Contract to focus on when several are present."}}},"example":{"code":"pragma solidity ^0.8.20;\ncontract Vault {\n mapping(address => uint256) public balances;\n function deposit() external payable { balances[msg.sender] += msg.value; }\n function withdraw() external {\n (bool ok, ) = msg.sender.call{value: balances[msg.sender]}(\"\");\n require(ok);\n balances[msg.sender] = 0;\n }\n}","contractName":"Vault"}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","additionalProperties":false,"required":["summary","overall_risk","findings","contract_names","compiler_version","not_checked","severity_counts","lines_of_code"],"properties":{"summary":{"type":"string"},"overall_risk":{"type":"string","enum":["critical","high","medium","low","informational","none"]},"findings":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","title","severity","category","location","code_snippet","description","exploit_scenario","recommendation","confidence","source","verification","line_start","line_end"],"properties":{"id":{"type":"string","description":"Sequential id such as F-01."},"title":{"type":"string"},"severity":{"type":"string","enum":["critical","high","medium","low","informational"]},"category":{"type":"string","enum":["reentrancy","integer_overflow_underflow","access_control","logic_error","unchecked_external_call","oracle_price_manipulation","front_running_mev","denial_of_service","timestamp_dependence","tx_origin_auth","delegatecall_proxy","storage_collision_uninitialized","signature_replay","erc_standard_violation","centralization_risk","gas_optimization","other"]},"location":{"type":"string","description":"Contract.function and line number(s) from the numbered source."},"code_snippet":{"type":"string","description":"The exact source text of the vulnerable statement, copied verbatim without the line-number prefix."},"description":{"type":"string"},"exploit_scenario":{"type":"string","description":"Concrete attacker steps, or \"n/a\" for non-exploitable issues."},"recommendation":{"type":"string","description":"Specific fix, with a short code snippet when useful."},"confidence":{"type":"string","enum":["high","medium","low"]},"source":{"type":"string","enum":["model","static"],"description":"static = raised by the deterministic detector pass."},"verification":{"type":"string","enum":["verified","line_corrected","snippet_not_found","static_detector"],"description":"snippet_not_found lowers confidence to low."},"line_start":{"type":"integer","description":"True 1-based line of the snippet; 0 when it could not be located."},"line_end":{"type":"integer"}}}},"contract_names":{"type":"array","items":{"type":"string"},"description":"Parsed from the source, not model-generated."},"compiler_version":{"type":"string","description":"Parsed pragma expression, or \"unspecified\"."},"not_checked":{"type":"array","items":{"type":"string"},"description":"What this review could not see; an empty findings list does not cover these."},"severity_counts":{"type":"object","additionalProperties":false,"required":["critical","high","medium","low","informational"],"properties":{"critical":{"type":"integer"},"high":{"type":"integer"},"medium":{"type":"integer"},"low":{"type":"integer"},"informational":{"type":"integer"}}},"lines_of_code":{"type":"integer"}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/api/v1/predict-market":{"post":{"operationId":"market_predictor","summary":"Prediction Market Analyzer","description":"Sentiment analysis and a calibrated 0-100 probability that a Polymarket/Kalshi-style event resolves Yes.\n\nPrice: 0.10 USDC on Base (x402).","x-x402-price-usdc":"0.10","x-x402-amount":"100000","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["text"],"properties":{"text":{"type":"string","minLength":1,"maxLength":20000,"description":"News excerpt or event description."},"question":{"type":"string","maxLength":500,"description":"Exact market question; inferred when omitted."},"marketPriceYes":{"type":"number","minimum":0,"maximum":100,"description":"Current implied Yes probability, used to compute edge. Percent (0-100) by default; a value strictly between 0 and 1 is read as a 0-1 market price (Polymarket/Kalshi style) unless marketPriceScale says otherwise."},"marketPriceScale":{"type":"string","enum":["percent","fraction"],"description":"Force the unit of marketPriceYes: percent (35 = 35%) or fraction (0.35 = 35%)."}}},"example":{"text":"The Fed chair said the committee sees no urgency to cut rates at the December meeting, citing sticky services inflation.","question":"Will the Fed cut rates at its December 2026 meeting?","marketPriceYes":35}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","additionalProperties":false,"required":["market_question","probability_yes","confidence","sentiment","factors_for_yes","factors_for_no","information_gaps","rationale","probability_no","analyzed_at"],"properties":{"market_question":{"type":"string","description":"The binary Yes/No question being forecast, stated precisely."},"probability_yes":{"type":"integer","description":"Probability (0-100) that the event resolves Yes."},"confidence":{"type":"string","enum":["low","medium","high"]},"sentiment":{"type":"object","additionalProperties":false,"required":["label","score"],"properties":{"label":{"type":"string","enum":["positive","negative","neutral","mixed"],"description":"Derived from score and the factor lists, never model-reported."},"score":{"type":"number"}}},"factors_for_yes":{"type":"array","items":{"type":"string"}},"factors_for_no":{"type":"array","items":{"type":"string"}},"information_gaps":{"type":"array","items":{"type":"string"}},"rationale":{"type":"string"},"probability_no":{"type":"integer"},"market_price_yes_pct":{"type":"number","description":"marketPriceYes normalized to percent; present only when a price was given."},"market_price_interpretation":{"type":"string","enum":["percent","fraction"],"description":"How marketPriceYes was read."},"edge_vs_market":{"type":"number","description":"probability_yes minus the normalized market price; present only when a price was given."},"analyzed_at":{"type":"string"}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/api/v1/arbitrage-lawyer":{"post":{"operationId":"arbitrage_lawyer","summary":"Cross-Platform Arbitrage & Resolution Rules Lawyer","description":"Finds fine-print divergences between two prediction markets (e.g. Polymarket vs Kalshi), prices basis risk, and returns ARBITRAGE_SAFE / BASIS_RISK_TRAP / NO_EDGE with Kelly hedge sizing. Prices are USD per share (0-1).\n\nPrice: 0.75 USDC on Base (x402).","x-x402-price-usdc":"0.75","x-x402-amount":"750000","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["marketA","marketB"],"properties":{"marketA":{"type":"object","additionalProperties":false,"required":["platform","title","resolutionRules","yesPrice","noPrice"],"properties":{"platform":{"type":"string","minLength":1,"maxLength":100,"description":"e.g. Polymarket, Kalshi"},"title":{"type":"string","minLength":1,"maxLength":500},"description":{"type":"string","maxLength":5000},"resolutionRules":{"type":"string","minLength":1,"maxLength":20000,"description":"Exact resolution rules and fine print."},"yesPrice":{"type":"number","minimum":0,"maximum":1,"description":"Best ask for one Yes share in USD (0-1)."},"noPrice":{"type":"number","minimum":0,"maximum":1,"description":"Best ask for one No share in USD (0-1)."},"feeBps":{"type":"number","minimum":0,"maximum":2000,"description":"Trading fee on this leg in bps of notional."}}},"marketB":{"type":"object","additionalProperties":false,"required":["platform","title","resolutionRules","yesPrice","noPrice"],"properties":{"platform":{"type":"string","minLength":1,"maxLength":100,"description":"e.g. Polymarket, Kalshi"},"title":{"type":"string","minLength":1,"maxLength":500},"description":{"type":"string","maxLength":5000},"resolutionRules":{"type":"string","minLength":1,"maxLength":20000,"description":"Exact resolution rules and fine print."},"yesPrice":{"type":"number","minimum":0,"maximum":1,"description":"Best ask for one Yes share in USD (0-1)."},"noPrice":{"type":"number","minimum":0,"maximum":1,"description":"Best ask for one No share in USD (0-1)."},"feeBps":{"type":"number","minimum":0,"maximum":2000,"description":"Trading fee on this leg in bps of notional."}}},"minEdgeBps":{"type":"number","minimum":0,"maximum":10000,"description":"Default 100 (1%)."},"bankrollUsd":{"type":"number","minimum":0,"maximum":1000000000000,"description":"Used to convert the Kelly fraction to USD."}}},"example":{"marketA":{"platform":"Polymarket","title":"Will Candidate X win the 2028 election?","resolutionRules":"Resolves Yes if the Associated Press, Fox News, and NBC all call the race for Candidate X by Jan 20, 2029 12:00 PM ET.","yesPrice":0.52,"noPrice":0.49,"feeBps":0},"marketB":{"platform":"Kalshi","title":"Who will win the 2028 presidential election? Candidate X","resolutionRules":"Resolves Yes if Candidate X is inaugurated as President on Jan 20, 2029.","yesPrice":0.55,"noPrice":0.45,"feeBps":70},"minEdgeBps":100,"bankrollUsd":10000}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","additionalProperties":false,"required":["same_underlying_event","equivalence_score","resolution_source_a","resolution_source_b","deadline_a","deadline_b","divergences","loophole_clauses","summary","analysis_mode","unverified_divergences","recommendation","best_direction","directions","unavailable_directions","hedge_sizing"],"properties":{"same_underlying_event":{"type":"boolean"},"equivalence_score":{"type":"integer","description":"0-100: how closely the resolution criteria coincide."},"resolution_source_a":{"type":"string"},"resolution_source_b":{"type":"string"},"deadline_a":{"type":"string","description":"Resolution deadline and timezone as written, or \"unspecified\"."},"deadline_b":{"type":"string"},"divergences":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["scenario","market_a_resolves","market_b_resolves","probability_pct","clause_a","clause_b","clauses_verified"],"properties":{"scenario":{"type":"string"},"market_a_resolves":{"type":"string","enum":["YES","NO","VOID","SPLIT"],"description":"YES, NO, VOID (cancelled or refunded; priced as a refund of the purchase price) or SPLIT (50-50 settlement; each share pays $0.50)."},"market_b_resolves":{"type":"string","enum":["YES","NO","VOID","SPLIT"]},"probability_pct":{"type":"number","description":"Probability (0-100) this scenario occurs."},"clause_a":{"type":"string","description":"Verbatim clause from market A that drives its outcome."},"clause_b":{"type":"string","description":"Verbatim clause from market B that drives its outcome."},"clauses_verified":{"type":"boolean","description":"Both quoted clauses were found in the supplied rules; an unverified scenario is priced only when it lowers the payout."}}}},"loophole_clauses":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["market","clause","risk"],"properties":{"market":{"type":"string","enum":["A","B"]},"clause":{"type":"string"},"risk":{"type":"string"}}}},"summary":{"type":"string"},"analysis_mode":{"type":"string","enum":["model","price_only"],"description":"price_only: no positive spread at the quoted prices, so NO_EDGE was decided without the rules analysis."},"unverified_divergences":{"type":"integer"},"recommendation":{"type":"string","enum":["ARBITRAGE_SAFE","BASIS_RISK_TRAP","NO_EDGE","INSUFFICIENT_EVIDENCE"]},"best_direction":{"type":"object","properties":{"cost_per_pair":{"type":"number"},"fees_per_pair":{"type":"number"},"gross_spread_bps":{"type":"number"},"p_double_win":{"type":"number"},"p_double_loss":{"type":"number"},"p_shortfall":{"type":"number"},"expected_payout":{"type":"number"},"risk_adjusted_spread_bps":{"type":"number"},"worst_case_loss_per_pair":{"type":"number"},"kelly_fraction":{"type":"number"}}},"directions":{"type":"array","items":{"type":"object","properties":{"cost_per_pair":{"type":"number"},"fees_per_pair":{"type":"number"},"gross_spread_bps":{"type":"number"},"p_double_win":{"type":"number"},"p_double_loss":{"type":"number"},"p_shortfall":{"type":"number"},"expected_payout":{"type":"number"},"risk_adjusted_spread_bps":{"type":"number"},"worst_case_loss_per_pair":{"type":"number"},"kelly_fraction":{"type":"number"}}}},"unavailable_directions":{"type":"array","items":{"type":"string"},"description":"Directions skipped because a leg has no ask (price 0)."},"hedge_sizing":{"type":"object"}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/api/v1/heal-scraper":{"post":{"operationId":"heal_scraper","summary":"Self-Healing Scraper & DOM-to-JSON Compiler","description":"Synthesizes durable CSS selectors (Cheerio; no XPath) for a target JSON schema, proves them against the live DOM in-request, and returns the extracted data plus a ready-to-run TypeScript Cheerio extractor.\n\nPrice: 0.40 USDC on Base (x402).","x-x402-price-usdc":"0.40","x-x402-amount":"400000","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["targetSchema"],"properties":{"url":{"type":"string","maxLength":2048,"description":"Page to fetch. Provide url or html."},"html":{"type":"string","maxLength":1500000,"description":"Raw HTML to use instead of fetching."},"targetSchema":{"type":"object","description":"JSON Schema of the fields to extract: an object whose properties are string/number/integer/boolean (or arrays of those), or an array whose items are such an object for list pages. The pattern keyword is not allowed."},"previousBrokenSelectors":{"type":"object","description":"Map of field name to the CSS selector that stopped working."}}},"example":{"url":"https://news.ycombinator.com","targetSchema":{"type":"array","items":{"type":"object","required":["title","link"],"properties":{"title":{"type":"string"},"link":{"type":"string"},"points":{"type":"integer"}}}},"previousBrokenSelectors":{"title":".storylink"}}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Final fetched URL, or null when html was supplied."},"healed":{"type":"boolean","description":"True when every field fills at least 4 in 5 records (single record: filled) and the data validates against targetSchema."},"decidedBy":{"type":"string","enum":["previous_selectors","structured_markup","llm"],"description":"Which stage produced the returned spec; the first two make no model call."},"llmCalls":{"type":"integer"},"data":{"description":"Extracted data shaped like targetSchema."},"selectorMap":{"type":"object"},"spec":{"type":"object"},"validation":{"type":"object"},"extractorCode":{"type":"string","description":"Standalone TypeScript module exporting extract(html)."},"page_structure_notes":{"type":"string"}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/api/v1/detect-token-trap":{"post":{"operationId":"token_trap_detector","summary":"On-Chain Bytecode & Unverified Token Trap Detector","description":"Reads live Base bytecode, proxy slots (EIP-1967/beacon/zeppelinos/EIP-1822/EIP-1167), ERC-20 state, and privileged selectors to score honeypot and rug risk: SAFE | CAUTION | HONEYPOT_RUG.\n\nPrice: 0.25 USDC on Base (x402).","x-x402-price-usdc":"0.25","x-x402-amount":"250000","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["tokenAddress"],"properties":{"tokenAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Token contract address on Base."},"sourceCode":{"type":"string","maxLength":100000,"description":"Optional Solidity source claimed for the token."}}},"example":{"tokenAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","additionalProperties":false,"required":["honeypotProbability","proxyRisk","maxSafeSlippage","verdict","confidence","risk_factors","mitigating_factors","summary","verdict_floor_applied","decidedBy","llmCalls","oracles","privilegedSelectorsFound","telemetry"],"properties":{"honeypotProbability":{"type":"integer","description":"0-100 probability that buyers cannot sell or are taxed to near zero."},"proxyRisk":{"type":"string","enum":["none","low","medium","high","critical"]},"maxSafeSlippage":{"type":"number","description":"Suggested maximum slippage tolerance in percent for a buy."},"verdict":{"type":"string","enum":["SAFE","CAUTION","HONEYPOT_RUG"]},"confidence":{"type":"string","enum":["low","medium","high"]},"risk_factors":{"type":"array","items":{"type":"string"}},"mitigating_factors":{"type":"array","items":{"type":"string"}},"summary":{"type":"string"},"verdict_floor_applied":{"type":"boolean"},"decidedBy":{"type":"string","enum":["rules:simulation","llm:bytecode_only"],"description":"rules:simulation: decided in code from a honeypot.is buy/sell simulation, no model call."},"llmCalls":{"type":"integer"},"oracles":{"type":"object","description":"honeypot.is and GoPlus readings (taxes in percent) and any oracle errors."},"privilegedSelectorsFound":{"type":"array","items":{"type":"object","properties":{"selector":{"type":"string"},"signature":{"type":"string"},"category":{"type":"string"}}}},"telemetry":{"type":"object"}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/api/v1/competitor-battlecard":{"post":{"operationId":"competitor_battlecard","summary":"SaaS Pricing & Competitor Battlecard Spy","description":"Scrapes up to 3 competitor sites (plus their pricing pages) and returns a live deal battlecard: pricing tiers, hidden fees and limits, landmine questions, objection handling, and wedge features.\n\nPrice: 1.50 USDC on Base (x402).","x-x402-price-usdc":"1.50","x-x402-amount":"1500000","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["ourProductDescription","competitorUrls"],"properties":{"ourProductDescription":{"type":"string","minLength":20,"maxLength":4000},"competitorUrls":{"type":"array","minItems":1,"maxItems":3,"items":{"type":"string","minLength":3,"maxLength":2048},"description":"Competitor homepage or pricing URLs. A same-site pricing page is discovered automatically."},"scenario":{"type":"object","additionalProperties":false,"description":"Optional deal size used to compute monthly and annual cost per verified tier: seats for per-seat prices, monthlyVolume for usage prices.","properties":{"seats":{"type":"integer","minimum":1,"maximum":100000},"monthlyVolume":{"type":"integer","minimum":0,"maximum":1000000000}}}}},"example":{"ourProductDescription":"Acme Support is an AI-first help desk with usage-based pricing ($0.40 per resolved ticket), SSO on every plan, and native Slack and Shopify integrations.","competitorUrls":["https://www.zendesk.com","https://www.intercom.com","https://www.freshworks.com/freshdesk/"]}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","additionalProperties":false,"required":["our_positioning","competitors","talk_track","evidence_gaps","pricing_comparison","pricing_scenario","priceVerification","pricingEvidence","pagesScraped","fetchFailures","generatedAt"],"properties":{"our_positioning":{"type":"string"},"competitors":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","url","positioning","target_segment","pricing_model","pricing_tiers","hidden_fees_and_limits","enterprise_upsell_triggers","strengths","weaknesses","landmine_questions","objection_handling","wedge_features"],"properties":{"name":{"type":"string"},"url":{"type":"string"},"positioning":{"type":"string","description":"Their core claim, paraphrasing their own copy."},"target_segment":{"type":"string"},"pricing_model":{"type":"string","description":"e.g. per seat, usage-based, flat tiers, contact sales. \"not published\" if absent."},"pricing_tiers":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["tier","price","billing","key_limits","notable_features"],"properties":{"tier":{"type":"string"},"price":{"type":"string","description":"Exactly as shown on the page, or \"not listed\"."},"billing":{"type":"string"},"key_limits":{"type":"array","items":{"type":"string"}},"notable_features":{"type":"array","items":{"type":"string"}}}}},"hidden_fees_and_limits":{"type":"array","items":{"type":"string"}},"enterprise_upsell_triggers":{"type":"array","items":{"type":"string"},"description":"Features or limits that force an upgrade (SSO, audit logs, seat caps...)."},"strengths":{"type":"array","items":{"type":"string"}},"weaknesses":{"type":"array","items":{"type":"string"}},"landmine_questions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["question","exposes"],"properties":{"question":{"type":"string"},"exposes":{"type":"string"}}}},"objection_handling":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["objection","response"],"properties":{"objection":{"type":"string"},"response":{"type":"string"}}}},"wedge_features":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["feature","why_we_win"],"properties":{"feature":{"type":"string"},"why_we_win":{"type":"string"}}}}}}},"talk_track":{"type":"string","description":"A 3-5 sentence opener for a live deal against these competitors."},"evidence_gaps":{"type":"array","items":{"type":"string"},"description":"What could not be verified from the scraped pages."},"pricing_comparison":{"type":"string","description":"Computed in code from prices verified on the scraped pages; the model does not write it."},"pricing_scenario":{"type":"object"},"priceVerification":{"type":"array","items":{"type":"object"},"description":"Per model-written tier: verified | unverified | no_amount against the scraped text."},"pricingEvidence":{"type":"array","items":{"type":"object"},"description":"Per competitor: whether any price or structured offer was found (pricingPublished)."},"pagesScraped":{"type":"array","items":{"type":"string"}},"fetchFailures":{"type":"array","items":{"type":"object"}},"generatedAt":{"type":"string"}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/api/v1/gatekeep-diff":{"post":{"operationId":"diff_gatekeeper","summary":"PR / Dependency Breaking-Change & Exploit Gatekeeper","description":"Two-stage adversarial review of a unified diff (bug hunter, then patch synthesizer) plus deterministic secret, dependency, and SAST scanning; returns mergeApproved, riskScore 0-100, findings, and drop-in patches.\n\nPrice: 0.50 USDC on Base (x402).","x-x402-price-usdc":"0.50","x-x402-amount":"500000","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["gitDiff"],"properties":{"gitDiff":{"type":"string","minLength":1,"maxLength":300000,"description":"Raw unified diff (git diff output)."},"packageJsonDiff":{"type":"string","maxLength":50000},"context":{"type":"string","maxLength":4000,"description":"What the PR is supposed to do."}}},"example":{"gitDiff":"diff --git a/src/users.ts b/src/users.ts\n--- a/src/users.ts\n+++ b/src/users.ts\n@@ -10,3 +10,4 @@ export async function findUser(db, req) {\n- return db.query('SELECT * FROM users WHERE id = $1', [req.params.id]);\n+ const id = req.params.id;\n+ return db.query(`SELECT * FROM users WHERE id = ${id}`);\n }\n","context":"Refactor user lookup for readability."}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"summary":{"type":"string"},"intent_alignment":{"type":"string","description":"Does the diff do what the context says, and anything it does beyond that."},"breakingChanges":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","file","location","severity","description","affected_consumers","grounded","source"],"properties":{"id":{"type":"string","description":"BC-01, BC-02..."},"file":{"type":"string"},"location":{"type":"string"},"severity":{"type":"string","enum":["critical","high","medium","low"]},"description":{"type":"string"},"affected_consumers":{"type":"string"},"grounded":{"type":"boolean","description":"False when the file or line is not in the diff; ungrounded findings never block."},"source":{"type":"string","enum":["model","rule"]}}}},"securityFlaws":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","file","line","category","severity","description","exploit_scenario","grounded","source"],"properties":{"id":{"type":"string","description":"SEC-01, SEC-02..."},"file":{"type":"string"},"line":{"type":"integer"},"category":{"type":"string","enum":["sql_injection","nosql_injection","command_injection","xss","ssrf","path_traversal","authz_bypass","secret_exposure","insecure_crypto","deserialization","supply_chain","other"]},"severity":{"type":"string","enum":["critical","high","medium","low"]},"description":{"type":"string"},"exploit_scenario":{"type":"string"},"grounded":{"type":"boolean","description":"False when the file or line is not in the diff; ungrounded findings never block."},"source":{"type":"string","enum":["model","rule"]}}}},"bugs":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","file","line","category","severity","description","grounded","source"],"properties":{"id":{"type":"string","description":"BUG-01, BUG-02..."},"file":{"type":"string"},"line":{"type":"integer"},"category":{"type":"string","enum":["race_condition","state_mutation","error_handling","logic_error","resource_leak","null_handling","performance","other"]},"severity":{"type":"string","enum":["critical","high","medium","low"]},"description":{"type":"string"},"grounded":{"type":"boolean","description":"False when the file or line is not in the diff; ungrounded findings never block."},"source":{"type":"string","enum":["model","rule"]}}}},"dependency_risks":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["package","risk","severity"],"properties":{"package":{"type":"string"},"risk":{"type":"string"},"severity":{"type":"string","enum":["critical","high","medium","low"]}}}},"riskScore":{"type":"integer","description":"0-100 overall merge risk."},"mergeApproved":{"type":"boolean"},"modelRiskScore":{"type":"integer","description":"The model's own 0-100 estimate; advisory. riskScore is computed from grounded findings (critical 40, high 20, medium 8, low 2, capped at 100) with scanner floors."},"blockers":{"type":"array","items":{"type":"string"}},"dependencyRisks":{"type":"object"},"secretsDetected":{"type":"array","items":{"type":"object"}},"suggestedPatches":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["finding_id","file","original_code","corrected_code","explanation"],"properties":{"finding_id":{"type":"string"},"file":{"type":"string"},"original_code":{"type":"string","description":"The exact lines from the diff being replaced."},"corrected_code":{"type":"string","description":"Drop-in replacement code."},"explanation":{"type":"string"}}}},"stats":{"type":"object"}},"required":["summary","intent_alignment","breakingChanges","securityFlaws","bugs","riskScore","mergeApproved","modelRiskScore","blockers","dependencyRisks","secretsDetected","suggestedPatches","stats"]},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/api/v1/audit-medical-bill":{"post":{"operationId":"medical_bill_auditor","summary":"Medical Bill Upcoding & Overcharge Slasher","description":"Audits itemized medical bills for E/M upcoding, NCCI unbundling, duplicate and unit errors; estimates Medicare and fair-price benchmarks; and drafts a dispute letter citing applicable No Surprises Act and NCCI rules.\n\nPrice: 3.00 USDC on Base (x402).","x-x402-price-usdc":"3.00","x-x402-amount":"3000000","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["lineItems","facilityType"],"properties":{"lineItems":{"type":"array","minItems":1,"maxItems":200,"items":{"type":"object","additionalProperties":false,"required":["cptOrHcpcsCode","description","chargedAmount","units"],"properties":{"cptOrHcpcsCode":{"type":"string","pattern":"^[A-Za-z0-9]{5}$","description":"5-character CPT or HCPCS Level II code."},"description":{"type":"string","maxLength":500},"chargedAmount":{"type":"number","minimum":0,"maximum":10000000,"description":"Total billed for this line, USD."},"units":{"type":"integer","minimum":1,"maximum":10000},"modifiers":{"type":"array","maxItems":4,"items":{"type":"string","pattern":"^[A-Za-z0-9]{2}$"}},"serviceDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"revenueCode":{"type":"string","pattern":"^\\d{3,4}$"}}}},"facilityType":{"type":"string","enum":["emergency_room","urgent_care","outpatient_hospital","inpatient_hospital","ambulatory_surgery_center","physician_office","laboratory","imaging_center","other"]},"coverage":{"type":"string","enum":["uninsured_self_pay","in_network","out_of_network","medicare","medicaid","unknown"],"description":"Determines which No Surprises Act protections can apply."},"patientState":{"type":"string","pattern":"^[A-Za-z]{2}$"},"visitSummary":{"type":"string","maxLength":4000,"description":"What actually happened: symptoms, duration, tests, treatment."},"facilityName":{"type":"string","maxLength":200},"patientName":{"type":"string","maxLength":200},"accountNumber":{"type":"string","maxLength":100},"goodFaithEstimateAmount":{"type":"number","minimum":0,"maximum":10000000,"description":"Good Faith Estimate received (self-pay)."},"claimType":{"type":"string","enum":["professional","facility"],"description":"Physician (CMS-1500) or hospital/facility (UB-04) bill. Medicare physician fee schedule benchmarks apply only to professional claims."},"billReceivedDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Date the initial bill was received; used for the 120-day dispute deadline."}}},"example":{"facilityType":"emergency_room","coverage":"uninsured_self_pay","patientState":"TX","visitSummary":"Twisted ankle, 40-minute visit, one X-ray, no fracture, given an ACE bandage and ibuprofen.","lineItems":[{"cptOrHcpcsCode":"99285","description":"ED visit level 5","chargedAmount":3250,"units":1,"serviceDate":"2026-09-14"},{"cptOrHcpcsCode":"73610","description":"X-ray ankle 3 views","chargedAmount":640,"units":1,"serviceDate":"2026-09-14"},{"cptOrHcpcsCode":"A4570","description":"Splint / elastic bandage","chargedAmount":185,"units":1,"serviceDate":"2026-09-14"},{"cptOrHcpcsCode":"99070","description":"Supplies and materials","chargedAmount":95,"units":1,"serviceDate":"2026-09-14"}]}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"summary":{"type":"object"},"no_surprises_act":{"type":"object"},"lines":{"type":"array","items":{"type":"object"}},"overall_assessment":{"type":"string"},"applicable_protections":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["protection","citation","applies_because"],"properties":{"protection":{"type":"string"},"citation":{"type":"string"},"applies_because":{"type":"string"}}}},"dispute_letter":{"type":"object","additionalProperties":false,"required":["subject","body"],"properties":{"subject":{"type":"string"},"body":{"type":"string"}}},"next_steps":{"type":"array","items":{"type":"string"}},"notice":{"type":"string"}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/api/v1/fight-chargeback":{"post":{"operationId":"chargeback_fighter","summary":"E-Commerce Chargeback Representment Builder","description":"Scores representment win probability, maps merchant evidence to the network rubric for the reason code (including deterministic Visa CE3.0 eligibility and invalid-dispute checks), lists missing evidence, and writes a rebuttal ready for Stripe or Shopify disputes. Uses only supplied evidence; never fabricates.\n\nPrice: 2.50 USDC on Base (x402).","x-x402-price-usdc":"2.50","x-x402-amount":"2500000","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["network","reasonCode","orderDetails","evidence"],"properties":{"network":{"type":"string","enum":["visa","mastercard","amex","discover"]},"reasonCode":{"type":"string","pattern":"^[0-9A-Za-z.]{1,10}$","description":"e.g. 10.4, 13.1, 13.3 (Visa); 4837, 4853, 4855 (Mastercard)."},"disputeDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}"},"orderDetails":{"type":"object","additionalProperties":false,"required":["orderId","amount","currency","transactionDate","items"],"properties":{"orderId":{"type":"string","maxLength":100},"amount":{"type":"number","minimum":0,"maximum":10000000},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"transactionDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}"},"items":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","additionalProperties":false,"required":["name","quantity","unitPrice"],"properties":{"name":{"type":"string","maxLength":300},"quantity":{"type":"integer","minimum":1},"unitPrice":{"type":"number","minimum":0}}}},"customerEmail":{"type":"string","maxLength":320},"shippingAddress":{"type":"string","maxLength":500},"billingAddress":{"type":"string","maxLength":500},"productType":{"type":"string","enum":["physical","digital","service","subscription"]}}},"evidence":{"type":"object","additionalProperties":false,"properties":{"trackingNumber":{"type":"string","maxLength":100},"carrier":{"type":"string","maxLength":100},"deliveryConfirmation":{"type":"string","maxLength":2000},"deliveryDate":{"type":"string","maxLength":40},"signedProofOfDelivery":{"type":"boolean"},"ipAddress":{"type":"string","maxLength":64},"deviceFingerprint":{"type":"string","maxLength":256},"deviceId":{"type":"string","maxLength":256},"customerAccountId":{"type":"string","maxLength":256},"authorization":{"type":"object","additionalProperties":false,"description":"Authorization-message data from the processor; lets Visa 10.4 invalid disputes be decided without a model call.","properties":{"eci":{"type":"string","pattern":"^0?[0-9]$","description":"Electronic Commerce Indicator, e.g. 05 or 5."},"cavvPresent":{"type":"boolean"},"authenticationConfirmed":{"type":"boolean","description":"Issuer returned an Authentication Confirmation (Visa Secure / EMV 3DS)."},"attemptResponse":{"type":"boolean"},"cvv2PresenceIndicator":{"type":"string","pattern":"^[0-9]$"},"cvv2ResultCode":{"type":"string","pattern":"^[A-Za-z]$","description":"CVV2 result code in the authorization response, e.g. M, N, U."},"approved":{"type":"boolean"}}},"avsResult":{"type":"string","maxLength":100},"cvvResult":{"type":"string","maxLength":100},"threeDSecure":{"type":"string","maxLength":200},"priorUndisputedTransactions":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"required":["date"],"properties":{"transactionId":{"type":"string","maxLength":100},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}"},"amount":{"type":"number","minimum":0},"ipAddress":{"type":"string","maxLength":64},"deviceId":{"type":"string","maxLength":256},"deviceFingerprint":{"type":"string","maxLength":256},"shippingAddress":{"type":"string","maxLength":500},"customerAccountId":{"type":"string","maxLength":256},"description":{"type":"string","maxLength":1000,"description":"What was purchased; CE3.0 requires a detailed description for each prior transaction."},"disputed":{"type":"boolean"}}}},"customerCommunications":{"type":"string","maxLength":20000},"refundPolicyExcerpt":{"type":"string","maxLength":5000},"productDescription":{"type":"string","maxLength":5000},"digitalUsageLogs":{"type":"string","maxLength":10000},"cancellationPolicy":{"type":"string","maxLength":5000},"refundIssued":{"type":"string","maxLength":500}}}}},"example":{"network":"visa","reasonCode":"13.1","disputeDate":"2026-10-20","orderDetails":{"orderId":"SHOP-10442","amount":189,"currency":"USD","transactionDate":"2026-09-28","items":[{"name":"Trail running shoes, size 10","quantity":1,"unitPrice":189}],"shippingAddress":"42 Elm St, Austin, TX 78701","productType":"physical"},"evidence":{"trackingNumber":"1Z999AA10123456784","carrier":"UPS","deliveryConfirmation":"Delivered 2026-10-02 14:12, left at front door, 42 Elm St Austin TX","deliveryDate":"2026-10-02","avsResult":"Y (full match)","cvvResult":"M (match)","customerCommunications":"2026-10-03 customer email: 'Got the shoes, they run a bit small.'"}}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"reason_code_name":{"type":"string"},"winProbability":{"type":"integer","description":"0-100 probability of winning representment with the supplied evidence."},"win_rationale":{"type":"string"},"evidence_map":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["evidence","rubric_requirement","how_it_satisfies","strength"],"properties":{"evidence":{"type":"string","description":"The merchant-supplied evidence item."},"rubric_requirement":{"type":"string","description":"The network rule or remedy element it answers."},"how_it_satisfies":{"type":"string"},"strength":{"type":"string","enum":["strong","moderate","weak"]}}}},"missingEvidence":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["item","why_it_matters","where_to_get_it"],"properties":{"item":{"type":"string"},"why_it_matters":{"type":"string"},"where_to_get_it":{"type":"string"}}}},"weaknesses":{"type":"array","items":{"type":"string"}},"rebuttal":{"type":"object","additionalProperties":false,"required":["title","summary","body","attachments_checklist"],"properties":{"title":{"type":"string"},"summary":{"type":"string","description":"2-3 sentence case summary for the dispute form's first field."},"body":{"type":"string","description":"Full representment letter, plain text."},"attachments_checklist":{"type":"array","items":{"type":"string"}}}},"recommend_accept":{"type":"boolean","description":"True when fighting is unlikely to succeed and accepting the dispute is cheaper."},"rubric":{"type":"object"},"ce3":{"type":"object","properties":{"applicable":{"type":"boolean"},"eligible":{"type":"boolean"},"undetermined":{"type":"boolean"},"qualifyingTransactions":{"type":"array","items":{"type":"string"}},"unmet":{"type":"array","items":{"type":"string"}}}},"invalidDispute":{"type":"object"},"decision":{"type":"object","properties":{"source":{"type":"string","enum":["model","deterministic_rule"]}}}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/api/v1/terminate-contract":{"post":{"operationId":"contract_terminator","summary":"Dark Pattern Contract & Subscription Exit Lawyer","description":"Finds auto-renewal, notice-window, and early-termination traps in a contract or live Terms page, maps them to ROSCA, state automatic-renewal laws, EU/UK consumer law, and contract breach triggers, and drafts a formal termination and payment-revocation notice.\n\nPrice: 1.00 USDC on Base (x402).","x-x402-price-usdc":"1.00","x-x402-amount":"1000000","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["vendorName","userJurisdiction","reasonForExit"],"properties":{"termsUrl":{"type":"string","maxLength":2048,"description":"Terms of Service or cancellation policy URL. Provide termsUrl or contractText."},"contractText":{"type":"string","maxLength":200000},"vendorName":{"type":"string","minLength":1,"maxLength":200},"userJurisdiction":{"type":"string","minLength":2,"maxLength":100,"description":"e.g. California, New York, EU (Germany), UK."},"reasonForExit":{"type":"string","minLength":1,"maxLength":2000},"customerType":{"type":"string","enum":["consumer","business"]},"customerName":{"type":"string","maxLength":200},"accountIdentifier":{"type":"string","maxLength":200},"contractStartDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"signupMethod":{"type":"string","enum":["online","phone","in_person"]}}},"example":{"contractText":"This Agreement renews automatically for successive 12-month terms unless either party gives written notice of non-renewal by certified mail at least 60 days before the end of the then-current term. Early termination requires payment of all remaining fees for the current term.","vendorName":"Acme Fitness Clubs","userJurisdiction":"California","reasonForExit":"Moved out of state; signed up online.","customerType":"consumer","signupMethod":"online"}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"contract_summary":{"type":"string"},"hiddenTraps":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["trap_type","clause","why_it_traps","severity"],"properties":{"trap_type":{"type":"string","enum":["auto_renewal","notice_window","early_termination_fee","cancellation_channel_restriction","price_escalation","minimum_term","non_refundable_prepayment","arbitration_or_class_waiver","data_retention","other"]},"clause":{"type":"string","description":"Verbatim text from the contract."},"why_it_traps":{"type":"string"},"severity":{"type":"string","enum":["high","medium","low"]},"verbatim":{"type":"boolean"}}}},"legalLeverage":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["basis","citation","applies_because","effect","confidence"],"properties":{"basis":{"type":"string","enum":["statute","regulation","contract_term","material_breach","payment_network_rule","other"]},"citation":{"type":"string"},"applies_because":{"type":"string"},"effect":{"type":"string","description":"What it lets the user do, e.g. void the ETF, cancel online, get a refund."},"confidence":{"type":"string","enum":["high","medium","low"]},"in_reference_table":{"type":"boolean","description":"The citation names an authority the service knows. It does not establish that the authority applies or is in force."}}}},"deadlines":{"type":"array","items":{"type":"string"}},"cancellationSteps":{"type":"array","items":{"type":"string"}},"terminationNotice":{"type":"object","additionalProperties":false,"required":["subject","body","send_to"],"properties":{"subject":{"type":"string"},"body":{"type":"string"},"send_to":{"type":"string","description":"Address or channel the contract designates for notices, or where to find it."}}},"risk_of_fees":{"type":"string","enum":["high","medium","low","none"]},"caveats":{"type":"array","items":{"type":"string"}},"unverifiedTraps":{"type":"array","description":"Traps whose quoted clause was not found in the contract text; withheld from hiddenTraps.","items":{"type":"object"}},"computed_deadlines":{"type":"object","description":"Renewal and notice dates computed by code from the contract text; see status for why none may be present."},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"contract_chars":{"type":"integer"},"truncated_for_model":{"type":"boolean"}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/api/v1/optimize-tariff":{"post":{"operationId":"tariff_engineer","summary":"Global Customs & Tariff Engineering Optimizer","description":"Classifies a product under the HS/HTS with GRI reasoning, estimates MFN and additional duties, lists defensible lower-duty alternatives and lawful physical tariff-engineering changes, and drafts an accurate commercial invoice description.\n\nPrice: 1.50 USDC on Base (x402).","x-x402-price-usdc":"1.50","x-x402-amount":"1500000","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["productName","materialsBreakdown","intendedUse","originCountry","destinationCountry"],"properties":{"productName":{"type":"string","minLength":2,"maxLength":300},"materialsBreakdown":{"type":"array","minItems":1,"maxItems":30,"items":{"type":"object","additionalProperties":false,"required":["material","percentByWeight"],"properties":{"material":{"type":"string","minLength":1,"maxLength":200},"percentByWeight":{"type":"number","minimum":0,"maximum":100},"percentByValue":{"type":"number","minimum":0,"maximum":100}}}},"intendedUse":{"type":"string","minLength":2,"maxLength":2000},"originCountry":{"type":"string","minLength":2,"maxLength":60},"destinationCountry":{"type":"string","minLength":2,"maxLength":60},"productDescription":{"type":"string","maxLength":5000,"description":"Construction, dimensions, how it works, packaging."},"customsValueUsd":{"type":"number","minimum":0,"maximum":10000000000,"description":"Entered value, used to estimate duty and savings."},"currentHtsCode":{"type":"string","pattern":"^\\d{4}(\\.?\\d{2}){1,3}$"},"importStateOfAssembly":{"type":"string","enum":["fully_assembled","unassembled_kit","components","bulk"]}}},"example":{"productName":"Women's waterproof ankle boot","materialsBreakdown":[{"material":"Rubber/plastics outer sole","percentByWeight":45},{"material":"Polyurethane-coated textile upper","percentByWeight":40},{"material":"Textile lining","percentByWeight":15}],"intendedUse":"Everyday wet-weather footwear","originCountry":"Vietnam","destinationCountry":"United States","customsValueUsd":85000,"importStateOfAssembly":"fully_assembled"}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"primaryClassification":{"type":"object","additionalProperties":false,"required":["htsCode","description","adValoremPct","rateText","reasoning"],"properties":{"htsCode":{"type":"string","description":"Destination tariff code, 6-10 digits (e.g. 6404.11.90)."},"description":{"type":"string","description":"Heading/subheading text."},"adValoremPct":{"type":"number","description":"General ad valorem duty rate in percent; -1 if specific or compound."},"rateText":{"type":"string","description":"Rate as written, including specific components."},"reasoning":{"type":"string","description":"GRI analysis, section/chapter notes, and any relevant rulings."},"rate_source":{"type":"string","enum":["usitc_hts","model"],"description":"usitc_hts: description and rate come from the official HTS line; model: the model's recollection."},"hts_status":{"type":"string","enum":["found","not_final","not_found","lookup_failed","invalid_format","not_checked"]},"hts_note":{"type":"string"},"rate_kind":{"type":"string","enum":["free","ad_valorem","specific","compound","other"]},"units":{"type":"array","items":{"type":"string"}},"origin_preference":{"type":"object","description":"Special-column rate listing the origin country; informational, not applied to the estimate."},"nearest_codes":{"type":"array","items":{"type":"object"},"description":"Real HTS lines sharing the longest prefix with a code that does not exist."},"candidates":{"type":"array","items":{"type":"object"},"description":"Final 8-digit lines under a heading or subheading code."}}},"additionalDuties":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["program","adValoremPct","applies_because","verify_at"],"properties":{"program":{"type":"string","description":"e.g. Section 301, Section 232, IEEPA, AD/CVD, or an FTA preference."},"adValoremPct":{"type":"number","description":"Additional percent; negative for a preference reduction."},"applies_because":{"type":"string"},"verify_at":{"type":"string","description":"Where to confirm the current rate."},"verified":{"type":"boolean","description":"Always false: add-on programs are model-recalled and not checked against Chapter 99, CSMS or AD/CVD orders."},"verification":{"type":"string"}}}},"alternatives":{"type":"array","items":{"type":"object","properties":{"classification":{"type":"object","additionalProperties":false,"required":["htsCode","description","adValoremPct","rateText","reasoning"],"properties":{"htsCode":{"type":"string","description":"Destination tariff code, 6-10 digits (e.g. 6404.11.90)."},"description":{"type":"string","description":"Heading/subheading text."},"adValoremPct":{"type":"number","description":"General ad valorem duty rate in percent; -1 if specific or compound."},"rateText":{"type":"string","description":"Rate as written, including specific components."},"reasoning":{"type":"string","description":"GRI analysis, section/chapter notes, and any relevant rulings."},"rate_source":{"type":"string","enum":["usitc_hts","model"],"description":"usitc_hts: description and rate come from the official HTS line; model: the model's recollection."},"hts_status":{"type":"string","enum":["found","not_final","not_found","lookup_failed","invalid_format","not_checked"]},"hts_note":{"type":"string"},"rate_kind":{"type":"string","enum":["free","ad_valorem","specific","compound","other"]},"units":{"type":"array","items":{"type":"string"}},"origin_preference":{"type":"object","description":"Special-column rate listing the origin country; informational, not applied to the estimate."},"nearest_codes":{"type":"array","items":{"type":"object"},"description":"Real HTS lines sharing the longest prefix with a code that does not exist."},"candidates":{"type":"array","items":{"type":"object"},"description":"Final 8-digit lines under a heading or subheading code."}}}}}},"engineeringOptions":{"type":"array","items":{"type":"object","properties":{"target":{"type":"object","additionalProperties":false,"required":["htsCode","description","adValoremPct","rateText","reasoning"],"properties":{"htsCode":{"type":"string","description":"Destination tariff code, 6-10 digits (e.g. 6404.11.90)."},"description":{"type":"string","description":"Heading/subheading text."},"adValoremPct":{"type":"number","description":"General ad valorem duty rate in percent; -1 if specific or compound."},"rateText":{"type":"string","description":"Rate as written, including specific components."},"reasoning":{"type":"string","description":"GRI analysis, section/chapter notes, and any relevant rulings."},"rate_source":{"type":"string","enum":["usitc_hts","model"],"description":"usitc_hts: description and rate come from the official HTS line; model: the model's recollection."},"hts_status":{"type":"string","enum":["found","not_final","not_found","lookup_failed","invalid_format","not_checked"]},"hts_note":{"type":"string"},"rate_kind":{"type":"string","enum":["free","ad_valorem","specific","compound","other"]},"units":{"type":"array","items":{"type":"string"}},"origin_preference":{"type":"object","description":"Special-column rate listing the origin country; informational, not applied to the estimate."},"nearest_codes":{"type":"array","items":{"type":"object"},"description":"Real HTS lines sharing the longest prefix with a code that does not exist."},"candidates":{"type":"array","items":{"type":"object"},"description":"Final 8-digit lines under a heading or subheading code."}}}}}},"commercialInvoiceDescription":{"type":"string","description":"Accurate description of the goods as actually imported."},"documentation":{"type":"array","items":{"type":"string"}},"complianceWarnings":{"type":"array","items":{"type":"string"}},"bindingRulingAdvice":{"type":"string"},"currentHtsCodeCheck":{"type":"object","additionalProperties":false,"required":["htsCode","description","adValoremPct","rateText","reasoning"],"properties":{"htsCode":{"type":"string","description":"Destination tariff code, 6-10 digits (e.g. 6404.11.90)."},"description":{"type":"string","description":"Heading/subheading text."},"adValoremPct":{"type":"number","description":"General ad valorem duty rate in percent; -1 if specific or compound."},"rateText":{"type":"string","description":"Rate as written, including specific components."},"reasoning":{"type":"string","description":"GRI analysis, section/chapter notes, and any relevant rulings."},"rate_source":{"type":"string","enum":["usitc_hts","model"],"description":"usitc_hts: description and rate come from the official HTS line; model: the model's recollection."},"hts_status":{"type":"string","enum":["found","not_final","not_found","lookup_failed","invalid_format","not_checked"]},"hts_note":{"type":"string"},"rate_kind":{"type":"string","enum":["free","ad_valorem","specific","compound","other"]},"units":{"type":"array","items":{"type":"string"}},"origin_preference":{"type":"object","description":"Special-column rate listing the origin country; informational, not applied to the estimate."},"nearest_codes":{"type":"array","items":{"type":"object"},"description":"Real HTS lines sharing the longest prefix with a code that does not exist."},"candidates":{"type":"array","items":{"type":"object"},"description":"Final 8-digit lines under a heading or subheading code."}}},"estimate":{"type":"object"}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/api/v1/bypass-patent":{"post":{"operationId":"patent_design_around","summary":"Patent Design-Around & Freedom-to-Operate Architect","description":"Breaks independent claims into atomic limitations, maps the product to each (literal and doctrine of equivalents), scores claims under the all-elements rule, and proposes 3 engineering design-arounds that remove at least one required limitation.\n\nPrice: 2.00 USDC on Base (x402).","x-x402-price-usdc":"2.00","x-x402-amount":"2000000","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["patentClaimsText","proposedProductDescription"],"properties":{"patentClaimsText":{"type":"string","minLength":20,"maxLength":50000,"description":"Numbered claims (at least the independent claims)."},"proposedProductDescription":{"type":"string","minLength":20,"maxLength":20000},"patentNumber":{"type":"string","maxLength":40},"jurisdiction":{"type":"string","maxLength":40,"description":"Defaults to US."}}},"example":{"patentNumber":"US 9,999,999 B2","patentClaimsText":"1. A method of notifying a user, comprising: receiving, at a server, a location of a mobile device; determining that the location is within a geofence associated with a merchant; and transmitting a push notification comprising a coupon to the mobile device in response to the determining.\n2. The method of claim 1, wherein the geofence is circular.","proposedProductDescription":"Our app checks the phone's location on-device against a list of nearby store polygons downloaded daily, and shows a local in-app banner with a discount when the user opens the app inside a store area. No location is sent to our servers."}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"infringementRiskScore":{"type":"integer"},"claims":{"type":"array","items":{"type":"object"}},"designArounds":{"type":"array","items":{"type":"object"}},"designAroundCount":{"type":"integer"},"summary":{"type":"string"},"caveats":{"type":"array","items":{"type":"string"}},"parsed_claims":{"type":"array","items":{"type":"object"}}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/api/v1/patch-accessibility":{"post":{"operationId":"accessibility_patcher","summary":"ADA / WCAG Lawsuit Shield & DOM Auto-Patcher","description":"Audits a page's DOM for the WCAG failures most cited in ADA demand letters (alt text, form labels, empty buttons/links, lang, headings, landmarks, skip links, zoom), returns a litigation risk score, per-element patched HTML, and a drop-in interim