{"openapi":"3.1.0","info":{"title":"code402","version":"1.3.0","description":"Offline deterministic checks (no ML, no scraping) for business identifiers and rental due-diligence, paid per call via x402 (gasless EIP-3009 USDC on Base). Checksum-verifiable (IBAN, LEI, VAT, ABA, ISBN, SEDOL…) vs format-only (EIN, IFSC, SWIFT/BIC…) — every response returns a scope field. Non-custodial, signed receipts. First 3 calls/day free."},"servers":[{"url":"https://api.code402.dev"}],"paths":{"/v1/tools/receipt-verify/call":{"post":{"operationId":"receipt_verify","summary":"Verify any XDR-1 receipt — free, stateless, any issuer","description":"Verifies a signed XDR-1 receipt from ANY x402 service: recomputes the canonical digest and recovers the signer, then compares it to the declared signer. Free forever — no account, no quota, no storage (stateless). A valid receipt proves the signer signed that tool call at that timestamp; it does NOT prove funds moved or any business claim.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","properties":{"receipt":{"type":"string","description":"The full XDR-1 receipt object: v, tool, tool_version, input_hash, output_hash, payer, recipient, amount, nonce, ts, tier, signer, signature (optional successor/stream_state)."}},"required":["receipt"]}}},"example":{"input":{"receipt":{"v":"XDR-1","tool":"iban-check","tool_version":"1","input_hash":"0x…","output_hash":"0x…","payer":"0xc59c85e661d34084a7769f955d17fd38254a6235","recipient":"0xc59c85e661d34084a7769f955d17fd38254a6235","amount":"0","nonce":"0x…","ts":0,"tier":"free","signer":"0xa036e2e3e19c6d02f30b3a9eb0acd057e6d9a5c8","signature":"0x…"}}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"valid":{"type":"boolean"},"signer_recovered":{"type":"string"},"declared_signer":{"type":"string"},"digest":{"type":"string"},"canonical":{"type":"string"},"scope":{"type":"string"}}},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/simulate-spend-sentinel/call":{"post":{"operationId":"simulate_spend_sentinel","summary":"Simulate Spend Sentinel policy defense and delivery predicates","description":"Run synthetic prompt-injection halts, malformed-delivery rejection, and bounded-spend eligibility examples under AP2 envelopes. No live escrow, refund, facilitator or chain action occurs.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","properties":{"scenario":{"type":"string","description":"Simulation scenario: 'injection' (prompt attack), 'garbage' (bad subagent output), or 'provable' (verified settlement). Default 'injection'."}}}}},"example":{"input":{"scenario":"injection"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"is_synthetic":{"type":"boolean"},"simulated":{"type":"boolean"},"scenario":{"type":"string"},"status":{"type":"number"},"code":{"type":"string"},"verdict":{"type":"string"},"requested_amount_usdc":{"type":"number"},"actual_wallet_loss_usdc":{"type":"number"},"action_taken":{"type":"string"},"settlement_recipient":{"type":["string","null"]},"telemetry":{"type":"string"},"scope":{"type":"string"}},"required":["valid","scenario","verdict"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/create-ap2-pilot/call":{"post":{"operationId":"create_ap2_pilot","summary":"Create AP2 pilot retainer","description":"Provision a pre-cleared AP2 Merchant Pilot invoice ($49.00 USDC) with 50k gasless Base L2 calls and turnkey <code402-widget> setup.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","properties":{"client_name":{"type":"string","description":"Client or agent name (optional)."}}}}},"example":{"input":{"client_name":"Apex Autonomous Syndicate"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"invoiceId":{"type":"string"},"amountUsdc":{"type":"number"},"checkoutUrl":{"type":"string"},"recipient":{"type":"string"},"token":{"type":"string"},"chainId":{"type":"number"},"network":{"type":"string"},"features":{"type":"array"},"scope":{"type":"string"}},"required":["valid","invoiceId","checkoutUrl"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/iban-check/call":{"post":{"operationId":"iban_check","summary":"IBAN Check & Wire Fraud Shield","description":"Deterministically validates international bank accounts (ISO 13616) using MOD-97-10 checksums: structure and checksum only. Catches mistyped or malformed IBANs before payout; a valid checksum does NOT establish account ownership, beneficiary identity, or absence of fraud. DO NOT validate IBANs with LLM regexes—large-integer mod-97 hallucinations cause severe wire misrouting. Returns offline-verifiable signed XDR-1 receipt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["iban"],"properties":{"iban":{"type":"string","description":"IBAN to validate; spaces allowed."}}}}},"example":{"input":{"iban":"GB82 WEST 1234 5698 7654 32"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/assured-quote/call":{"post":{"operationId":"assured_quote","summary":"Assured Settlement Quote (0.2% lane)","description":"Premium quote for high-stakes settlement assurance: 20 bps standard (15/10 bps at committed annual volumes), $25 min / $25,000 cap, +5 bps POD adder. T0 counterparties refused outright; above the tier advisory cap the lane ESCALATES (POD-1 delivery proof + registered-underwriter insurance referral mandatory). Terms are RECORDS, never payment instruments; settlement moves buyer to seller in full; premium is invoiced post-hoc, never deducted from flow; insurance is referral-only — the operator never underwrites. Returns signed XDR-1 receipt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","properties":{"notional_minor":{"type":"string","description":"Settlement notional in USDC minor units (1e6 = $1)"},"rail":{"type":"string","description":"'crypto' or 'fiat'"},"counterparty_tier":{"type":"string","description":"ACI-1 tier T0..T3 (T0 refused)"},"annual_volume_minor":{"type":"string","description":"Optional committed annual volume for tiered bps"},"pod_required":{"type":"boolean","description":"Force the POD-1 delivery mandate"}},"required":["notional_minor","rail"]}}},"example":{"input":{"notional_minor":"1000000000","rail":"crypto","counterparty_tier":"T3"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/assured-create/call":{"post":{"operationId":"assured_create","summary":"Assured Settlement Record (receipt-bound)","description":"Bind a verified XDR-1 settlement receipt to assured terms and store the record: idempotent by receipt hash (the same receipt never creates twice), 7-day dispute window, verdict_only remedy disclosed. The receipt signature is verified statelessly — that proves the signer signed, never that funds moved. Terms are RECORDS, never payment instruments; premium is invoiced post-hoc; no custody. Returns signed XDR-1 receipt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","properties":{"notional_minor":{"type":"string","description":"Settlement notional in USDC minor units"},"rail":{"type":"string","description":"'crypto' or 'fiat'"},"counterparty_tier":{"type":"string","description":"ACI-1 tier T0..T3 (T0 refused)"},"receipt":{"type":"object","description":"The full XDR-1 receipt of the settlement being assured"}},"required":["notional_minor","rail","receipt"]}}},"example":{"input":{"notional_minor":"5000000","rail":"crypto","counterparty_tier":"T2","receipt":{"v":"XDR-1","tool":"iban-check","tool_version":"1","input_hash":"0x…","output_hash":"0x…","payer":"0x…","recipient":"0xc59c85e661d34084a7769f955d17fd38254a6235","amount":"5000","nonce":"0x…","ts":0,"tier":"paid","signer":"0x…","signature":"0x…"}}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/reconcile/call":{"post":{"operationId":"reconcile","summary":"Settlement Reconciliation (ISO 20022 + NACHA)","description":"Deterministic reconciliation verdicts: pain.001/pacs.008 instructions vs camt.053 statements or NACHA ACH files, matched by end-to-end id and BigInt-exact amounts. Verdicts: SETTLED, UNPAID, AMOUNT_MISMATCH, DUPLICATE_PAYMENT, plus unmatched statement entries. Facts computed from the documents only — never inferred, never guessed. Returns signed XDR-1 receipt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","properties":{"pain001_xml":{"type":"string","description":"pain.001 instructions (or use pacs008_xml)"},"pacs008_xml":{"type":"string","description":"pacs.008/PIX instructions (or use pain001_xml)"},"camt053_xml":{"type":"string","description":"camt.053 statement (or use nacha_ach)"},"nacha_ach":{"type":"string","description":"NACHA ACH text (94-char records) instead of camt053_xml"}}}}},"example":{"input":{"pain001_xml":"<Document>…</Document>","camt053_xml":"<Document>…</Document>"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/lei-check/call":{"post":{"operationId":"lei_check","summary":"Legal Entity Identifier (LEI) KYB Check","description":"CRITICAL B2B KYB CHECK: Deterministically validates Legal Entity Identifiers (ISO 17442) with ISO 7064 MOD-97-10 check digits for institutional entities. Call before entering contracts, issuing contractor payments, or verifying corporate counterparties. Returns signed XDR-1 receipt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["lei"],"properties":{"lei":{"type":"string","description":"20-character Legal Entity Identifier."}}}}},"example":{"input":{"lei":"529900T8BM49AURSDO55"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/vat-mod97-check/call":{"post":{"operationId":"vat_mod97_check","summary":"VAT Check & Tax Invoicing Shield","description":"CRITICAL TAX COMPLIANCE CHECK: Deterministically validates EU/BE VAT identifiers with MOD-97 checksums. Eliminates cross-border invoicing errors, invalid billing, and tax audit penalties. Returns signed XDR-1 receipt for accounting defense.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["vat_number"],"properties":{"vat_number":{"type":"string","description":"EU VAT id; BE mod-97 checksum (BE prefix optional)."}}}}},"example":{"input":{"vat_number":"BE0417497106"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/company-number-format/call":{"post":{"operationId":"company_number_format","summary":"UK Companies House Number Verifier","description":"Validate UK Companies House corporate registration format (8 digits, or 2 letters + 6 digits). Run before signing agreements or executing contractor disbursements to UK entities. Returns signed XDR-1 receipt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["company_number"],"properties":{"company_number":{"type":"string","description":"8 digits, or 2 letters + 6 digits."}}}}},"example":{"input":{"company_number":"12345678"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/rent-deposit-guard/call":{"post":{"operationId":"rent_deposit_guard","summary":"Rental Deposit Safety Guard","description":"CRITICAL ESCROW DEFENSE: Validates rental deposit safety by checking recipient IBAN checksum, matching property/deposit country jurisdiction, and flagging advance pre-viewing payment demands to prevent escrow theft.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["deposit_iban"],"properties":{"deposit_iban":{"type":"string","description":"IBAN the deposit would be paid to."},"property_country":{"type":"string","description":"ISO 3166-1 alpha-2 country of the property, e.g. DE."},"deposit_before_viewing":{"type":"boolean","description":"True if a deposit is demanded before any viewing."}}}}},"example":{"input":{"deposit_iban":"GB82WEST12345698765432","property_country":"DE","deposit_before_viewing":true}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"risk_score":{"type":"number"},"band":{"type":"string","enum":["low","elevated","high"]},"flags":{"type":"array"},"flags_fired":{"type":"array"},"recommendation":{"type":"string"},"scope":{"type":"string"}},"required":["risk_score","band"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/rental-listing-risk/call":{"post":{"operationId":"rental_listing_risk","summary":"Rental Listing Risk & Fraud Engine","description":"Explainable tenancy fraud risk score evaluated across irreversible payment demands, off-platform pressure, stolen photos, and advance wire signals. Deterministic rule engine.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":[],"properties":{"payment_irreversible":{"type":"boolean","description":"Paid via crypto/gift-card/wire-only."},"contact_moves_offplatform":{"type":"boolean","description":"Pushed off the listing platform."},"landlord_abroad_cannot_meet":{"type":"boolean","description":"Landlord 'abroad', can't meet in person."},"no_in_person_viewing":{"type":"boolean","description":"No viewing before payment."},"urgency_pressure":{"type":"boolean","description":"Pressure to secure today."},"photos_reverse_image_hit":{"type":"boolean","description":"Listing photos found elsewhere (stolen)."},"identity_docs_requested_upfront":{"type":"boolean","description":"Full ID/bank docs demanded upfront."},"price_below_market_pct":{"type":"number","description":"How far below local market the rent is asked, in percent."}}}}},"example":{"input":{"payment_irreversible":true,"no_in_person_viewing":true,"price_below_market_pct":45}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"risk_score":{"type":"number"},"band":{"type":"string","enum":["low","elevated","high"]},"flags":{"type":"array"},"flags_fired":{"type":"array"},"recommendation":{"type":"string"},"scope":{"type":"string"}},"required":["risk_score","band"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/rental-verdict/call":{"post":{"operationId":"rental_verdict","summary":"Tenancy Due-Diligence & Anti-Scam Verdict","description":"INSTITUTIONAL TENANCY SHIELD: Single combined, signed rental due-diligence verdict combining deposit IBAN checksum, cross-border jurisdiction, pre-viewing advance wire flags, landlord entity verification, and listing fraud heuristics. Outputs cover-your-agent verification proof.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["deposit_iban"],"properties":{"deposit_iban":{"type":"string","description":"Deposit IBAN."},"property_country":{"type":"string","description":"Property country, ISO alpha-2."},"deposit_before_viewing":{"type":"boolean","description":"True if a deposit is demanded before any viewing."},"landlord_lei":{"type":"string","description":"Landlord LEI (optional)."},"landlord_company_no":{"type":"string","description":"Landlord UK company number (optional)."},"payment_irreversible":{"type":"boolean","description":"Payment demanded via crypto/gift-card/wire-only."},"contact_moves_offplatform":{"type":"boolean","description":"Contact pushed off the listing platform."},"no_in_person_viewing":{"type":"boolean","description":"No in-person or video viewing before payment."},"urgency_pressure":{"type":"boolean","description":"Pressure to secure the property today."},"price_below_market_pct":{"type":"number","description":"How far below local market the rent is asked, in percent."}}}}},"example":{"input":{"deposit_iban":"GB82WEST12345698765432","property_country":"DE","deposit_before_viewing":true,"landlord_lei":"529900T8BM49AURSDO55"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"verdict":{"type":"string","enum":["clear","caution","high-risk"]},"risk_score":{"type":"number"},"band":{"type":"string"},"flags":{"type":"array"},"components":{"type":"object"},"summary":{"type":"string"},"scope":{"type":"string"}},"required":["verdict","risk_score"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/batch-validate/call":{"post":{"operationId":"batch_validate","summary":"Batch Identifier Pipeline (up to 50 checks, 1 payment)","description":"HIGH-THROUGHPUT DETERMINISTIC PIPELINE: Run up to 50 business identifier checks (IBAN / LEI / VAT / UK company / SWIFT / ABA / EIN / IFSC / ABN / Luhn / ISBN / E.164 / SEDOL / ISIN / EAN-13 / GSTIN / context-distill) in ONE paid call: one voucher, one settlement, one signed XDR-1 receipt covering the whole batch. 10x cheaper per item; essential for autonomous batch invoice processing.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["items"],"properties":{"items":{"type":"array","minItems":1,"maxItems":50,"description":"List of {tool, value} checks (max 50).","items":{"type":"object","required":["tool","value"],"properties":{"tool":{"type":"string","enum":["iban-check","lei-check","vat-mod97-check","company-number-format","swift-bic-check","aba-routing-check","ein-format-check","ifsc-check","abn-check","luhn-check","isbn-check","e164-check","sedol-check","isin-check","ean13-check","gstin-check","context-distill"],"description":"which validator to run"},"value":{"type":"string","description":"the identifier (or text, for context-distill) to check"}}}}}}}},"example":{"input":{"items":[{"tool":"iban-check","value":"GB82 WEST 1234 5698 7654 32"},{"tool":"lei-check","value":"529900T8BM49AURSDO55"},{"tool":"vat-mod97-check","value":"BE0417497106"}]}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"count":{"type":"number"},"valid_count":{"type":"number"},"invalid_count":{"type":"number"},"results":{"type":"array"},"scope":{"type":"string"}},"required":["count","results"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/swift-bic-check/call":{"post":{"operationId":"swift_bic_check","summary":"SWIFT/BIC Structure & Country Code Check","description":"Validate a SWIFT/BIC code by ISO 9362 structure (bank code, ISO country, location, optional branch). Run before foreign wire transfer dispatch to prevent routing rejection. Returns signed XDR-1 receipt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["bic"],"properties":{"bic":{"type":"string","description":"SWIFT/BIC code, 8 or 11 characters; spaces/dashes allowed."}}}}},"example":{"input":{"bic":"DEUTDEFF500"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/aba-routing-check/call":{"post":{"operationId":"aba_routing_check","summary":"ABA Routing Number Check (US Fedwire/ACH)","description":"Validate a US ABA routing number by its (3,7,1)-weight mod-10 Fedwire/ACH checksum. Catches mistyped or invalid routing numbers before payment; does NOT prevent transfer reversals or establish the recipient. Returns signed XDR-1 receipt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","properties":{"aba_routing":{"type":"string","description":"9-digit US bank routing number."},"routing":{"type":"string","description":"9-digit US bank routing number (alias)."}}}}},"example":{"input":{"aba_routing":"021000021"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/ein-format-check/call":{"post":{"operationId":"ein_format_check","summary":"EIN Format Check (US)","description":"Validate US Employer Identification Number FORMAT (NN-NNNNNNN). Use during US business counterparty KYB verification. Returns signed XDR-1 receipt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["ein"],"properties":{"ein":{"type":"string","description":"US EIN, 9 digits; dashes/spaces allowed."}}}}},"example":{"input":{"ein":"12-3456789"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/ifsc-check/call":{"post":{"operationId":"ifsc_check","summary":"IFSC Check (India NEFT/RTGS)","description":"Validate an Indian IFSC by RBI structure (BBBB0NNNNNN; 5th character always 0). Required for India bank payouts. Returns signed XDR-1 receipt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["ifsc"],"properties":{"ifsc":{"type":"string","description":"11-character Indian Financial System Code."}}}}},"example":{"input":{"ifsc":"HDFC0000123"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/abn-check/call":{"post":{"operationId":"abn_check","summary":"ABN Check (Australia)","description":"Validate an Australian Business Number by its mod-89 checksum (11 digits). Required before invoice payment to Australian contractors. Returns signed XDR-1 receipt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["abn"],"properties":{"abn":{"type":"string","description":"11-digit Australian Business Number; spaces allowed."}}}}},"example":{"input":{"abn":"51 824 753 556"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/luhn-check/call":{"post":{"operationId":"luhn_check","summary":"Luhn Check Digit Verifier","description":"Validate any 12-19 digit number by the Luhn mod-10 algorithm. Never submit real payment card numbers. Returns signed XDR-1 receipt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["number"],"properties":{"number":{"type":"string","description":"12-19 digit number; spaces/dashes allowed."}}}}},"example":{"input":{"number":"4111111111111111"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/isbn-check/call":{"post":{"operationId":"isbn_check","summary":"ISBN Check","description":"Validate an ISBN-10 (mod-11) or ISBN-13 (1,3-weight mod-10) checksum.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["isbn"],"properties":{"isbn":{"type":"string","description":"ISBN-10 or ISBN-13; dashes/spaces allowed."}}}}},"example":{"input":{"isbn":"978-0-306-40615-7"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/e164-check/call":{"post":{"operationId":"e164_check","summary":"E.164 International Phone Check","description":"Validate a phone number's E.164 structure (+CC, 8-15 digits, no leading zero) before dispatching SMS alerts or OTPs. Returns signed XDR-1 receipt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["phone"],"properties":{"phone":{"type":"string","description":"International phone number, e.g. +14155552671."}}}}},"example":{"input":{"phone":"+14155552671"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/sedol-check/call":{"post":{"operationId":"sedol_check","summary":"SEDOL Check (UK/Ireland Securities)","description":"Validate a UK/Ireland security identifier by its (1,3,1,7,3,9)-weight mod-10 checksum. Returns signed XDR-1 receipt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["sedol"],"properties":{"sedol":{"type":"string","description":"7-character SEDOL code."}}}}},"example":{"input":{"sedol":"B0YBKJ7"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/cnpj-check/call":{"post":{"operationId":"cnpj_check","summary":"Brazil CNPJ Check (Cadastro Nacional da Pessoa Jurídica)","description":"Validate Brazilian corporate tax ID (CNPJ) with official dual mod-11 check digits. Required for Brazilian B2B payments, PIX verification, and vendor due diligence. Returns signed XDR-1 receipt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["cnpj"],"properties":{"cnpj":{"type":"string","description":"14-digit Brazilian CNPJ; punctuation allowed (e.g. 00.000.000/0001-91)."}}}}},"example":{"input":{"cnpj":"00.000.000/0001-91"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/uscc-check/call":{"post":{"operationId":"uscc_check","summary":"China USCC Check (Unified Social Credit Code / 统一社会信用代码)","description":"Validate 18-character Chinese business registration and tax code using GB 32100-2015 ISO 7064 Mod-31-3 checksum. Required for B2B supply chain trade with Chinese manufacturers. Returns signed XDR-1 receipt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["uscc"],"properties":{"uscc":{"type":"string","description":"18-character Chinese Unified Social Credit Code (e.g. 91330100799655058B)."}}}}},"example":{"input":{"uscc":"91330100799655058B"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/japan-corp-check/call":{"post":{"operationId":"japan_corp_check","summary":"Japan Corporate Number Check (法人番号 - Houjin Bangou)","description":"Validate 13-digit Japanese Corporate Number assigned by the National Tax Agency using Mod-9 check digit algorithm. Required for Japanese B2B SaaS and enterprise billing. Returns signed XDR-1 receipt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["number"],"properties":{"number":{"type":"string","description":"13-digit Japanese Corporate Number (e.g. 1180301018771)."}}}}},"example":{"input":{"number":"1180301018771"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/kra-pin-check/call":{"post":{"operationId":"kra_pin_check","summary":"Kenya KRA PIN Check (Kenya Revenue Authority)","description":"Validate Kenyan Revenue Authority Tax PIN structure (A/P followed by 9 digits and checksum character). Required for M-Pesa B2B disbursement and Kenyan remote agency invoicing. Returns signed XDR-1 receipt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["pin"],"properties":{"pin":{"type":"string","description":"11-character KRA PIN (e.g. P051112223Z)."}}}}},"example":{"input":{"pin":"P051112223Z"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/rfc-check/call":{"post":{"operationId":"rfc_check","summary":"Mexico RFC Check (Registro Federal de Contribuyentes)","description":"Validate Mexican SAT RFC corporate (12-char) or individual (13-char) tax code and homoclave. Required for Mexican contractor invoicing and SPEI cross-border settlements. Returns signed XDR-1 receipt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["rfc"],"properties":{"rfc":{"type":"string","description":"12 or 13 character Mexican RFC (e.g. BBA830831LJ2)."}}}}},"example":{"input":{"rfc":"BBA830831LJ2"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/iso4217-currency-check/call":{"post":{"operationId":"iso4217_currency_check","summary":"ISO 4217 Currency Standard Check & Settlement Mapping","description":"Validate 3-letter alpha or 3-digit numeric currency codes against ISO 4217 standard. Returns minor unit decimals, symbol, official name, countries, and onchain Base L2 settlement token mapping (USDC/EURC).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["currency"],"properties":{"currency":{"type":"string","description":"3-letter ISO 4217 code (e.g. USD, EUR, JPY, CNY, BRL, KES, MXN) or 3-digit numeric code (e.g. 840, 978, 392)."}}}}},"example":{"input":{"currency":"EUR"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/pre-disbursement-guard/call":{"post":{"operationId":"pre_disbursement_guard","summary":"Pre-Disbursement Due Diligence Guard (Check Before You Send)","description":"MANDATORY COUNTERPARTY DUE DILIGENCE: Verifies counterparty before releasing invoice payments, contractor payouts, or wires. Screens ISO 13616 IBAN checksum, RDAP domain age (<30d = scam), disposable email domains, UK CRN/LEI format, and BEC cross-jurisdiction mismatches. Produces signed XDR-1 receipt for compliance.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":[],"properties":{"recipient_iban":{"type":"string","description":"Recipient bank IBAN (optional)."},"vendor_domain":{"type":"string","description":"Vendor website domain or invoicing email address (optional)."},"declared_country":{"type":"string","description":"2-letter ISO country code where vendor claims to be registered (optional, e.g. 'GB', 'US', 'DE')."},"company_number":{"type":"string","description":"Official corporate registration number, e.g. UK Companies House 8 digits/chars (optional)."},"lei":{"type":"string","description":"ISO 17442 Legal Entity Identifier (optional)."},"vat_number":{"type":"string","description":"EU VAT number (optional)."},"physical_address":{"type":"string","description":"Vendor physical office address (optional)."},"invoice_amount_usd":{"type":"number","description":"Disbursement transaction amount in USD (optional)."}}}}},"example":{"input":{"recipient_iban":"GB82WEST12345698765432","vendor_domain":"billing@acme-consulting.co.uk","declared_country":"GB","company_number":"01234567","invoice_amount_usd":4500}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"clear_to_disburse":{"type":"boolean"},"risk_level":{"type":"string"},"risk_score":{"type":"number"},"decision":{"type":"string"},"summary":{"type":"string"},"checks":{"type":"object"},"flags_triggered":{"type":"array"},"recommendations":{"type":"array"},"inspected_counterparty":{"type":"object"},"scope":{"type":"string"}},"required":["clear_to_disburse","risk_level","risk_score","decision"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/vendor-onboarding-pack/call":{"post":{"operationId":"vendor_onboarding_pack","summary":"All-in-One Vendor Onboarding & Clearing Shield","description":"INSTITUTIONAL COUNTERPARTY CLEARING: Screens vendor IBAN + LEI + VAT + UK company number in ONE signed call. Saves 50% vs individual checks. Produces an audit-ready compliance report and signed XDR-1 receipt to defend against invoice fraud before funds move.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":[],"properties":{"iban":{"type":"string","description":"Vendor IBAN (optional)."},"lei":{"type":"string","description":"Vendor LEI (optional)."},"vat_number":{"type":"string","description":"Vendor VAT number, BE mod-97 (optional)."},"company_number":{"type":"string","description":"Vendor UK company number (optional)."}}}}},"example":{"input":{"iban":"GB82 WEST 1234 5698 7654 32","lei":"529900T8BM49AURSDO55","vat_number":"BE0417497106","company_number":"12345678"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"checked_count":{"type":"number"},"all_valid":{"type":"boolean"},"verdict":{"type":"string"},"results":{"type":"array"},"scope":{"type":"string"}},"required":["checked_count","all_valid"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/india-supplier-check/call":{"post":{"operationId":"india_supplier_check","summary":"India Supplier Verification Pack","description":"One call, one receipt: GSTIN + PAN + UPI VPA + IFSC for an Indian counterparty. Four deterministic structural checks, each stating its own scope. Built for cross-border procurement where the buyer is an agent that cannot open an INR account.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":[],"properties":{"gstin":{"type":"string","description":"GSTIN (15 chars, optional)"},"pan":{"type":"string","description":"PAN (10 chars, optional)"},"vpa":{"type":"string","description":"UPI VPA handle (optional)"},"ifsc":{"type":"string","description":"IFSC bank code (optional)"}}}}},"example":{"input":{"gstin":"27AAPFU0939F1ZV","pan":"ABCDE1234F","vpa":"merchant@okhdfcbank","ifsc":"HDFC0001234"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"corridor":{"type":"string"},"checked_count":{"type":"number"},"all_valid":{"type":"boolean"},"verdict":{"type":"string"},"results":{"type":"array"},"next_steps":{"type":"string"},"scope":{"type":"string"}},"required":["checked_count","all_valid"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/china-supplier-check/call":{"post":{"operationId":"china_supplier_check","summary":"China Supplier Verification Pack","description":"One call, one receipt: USCC + settlement IBAN + SWIFT/BIC for a Chinese counterparty. Deterministic structure and checksum validation with explicit scope per identifier.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":[],"properties":{"uscc":{"type":"string","description":"Unified Social Credit Code (optional)"},"iban":{"type":"string","description":"Settlement IBAN (optional)"},"swift":{"type":"string","description":"SWIFT/BIC (optional)"}}}}},"example":{"input":{"uscc":"91350100M000100Y43","iban":"GB82WEST12345698765432","swift":"DEUTDEFF"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"corridor":{"type":"string"},"checked_count":{"type":"number"},"all_valid":{"type":"boolean"},"verdict":{"type":"string"},"results":{"type":"array"},"next_steps":{"type":"string"},"scope":{"type":"string"}},"required":["checked_count","all_valid"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/japan-supplier-check/call":{"post":{"operationId":"japan_supplier_check","summary":"Japan Supplier Verification Pack","description":"One call, one receipt: 13-digit Corporate Number + settlement IBAN for a Japanese counterparty. Deterministic check digits, explicit scope.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":[],"properties":{"corporate_number":{"type":"string","description":"13-digit Corporate Number (optional)"},"iban":{"type":"string","description":"Settlement IBAN (optional)"}}}}},"example":{"input":{"corporate_number":"7000012050002","iban":"GB82WEST12345698765432"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"corridor":{"type":"string"},"checked_count":{"type":"number"},"all_valid":{"type":"boolean"},"verdict":{"type":"string"},"results":{"type":"array"},"next_steps":{"type":"string"},"scope":{"type":"string"}},"required":["checked_count","all_valid"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/latam-supplier-check/call":{"post":{"operationId":"latam_supplier_check","summary":"LatAm Supplier Verification Pack","description":"One call, one receipt: Brazilian CNPJ + Mexican RFC + settlement IBAN. Deterministic checks for the two largest LatAm corridors in one paid call.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":[],"properties":{"cnpj":{"type":"string","description":"Brazilian CNPJ (optional)"},"rfc":{"type":"string","description":"Mexican RFC (optional)"},"iban":{"type":"string","description":"Settlement IBAN (optional)"}}}}},"example":{"input":{"cnpj":"04.252.011/0001-10","rfc":"GODE561231GR8","iban":"GB82WEST12345698765432"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"corridor":{"type":"string"},"checked_count":{"type":"number"},"all_valid":{"type":"boolean"},"verdict":{"type":"string"},"results":{"type":"array"},"next_steps":{"type":"string"},"scope":{"type":"string"}},"required":["checked_count","all_valid"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/gulf-supplier-check/call":{"post":{"operationId":"gulf_supplier_check","summary":"Gulf Supplier Verification Pack","description":"One call, one receipt: UAE TRN + settlement IBAN + SWIFT/BIC. Deterministic structure validation for Gulf trade corridors, scope stated per identifier.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":[],"properties":{"trn":{"type":"string","description":"UAE TRN (15 digits, optional)"},"iban":{"type":"string","description":"Settlement IBAN (optional)"},"swift":{"type":"string","description":"SWIFT/BIC (optional)"}}}}},"example":{"input":{"trn":"100123456700003","iban":"AE070331234567890123456","swift":"EBILAEAD"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"corridor":{"type":"string"},"checked_count":{"type":"number"},"all_valid":{"type":"boolean"},"verdict":{"type":"string"},"results":{"type":"array"},"next_steps":{"type":"string"},"scope":{"type":"string"}},"required":["checked_count","all_valid"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/africa-supplier-check/call":{"post":{"operationId":"africa_supplier_check","summary":"Africa Supplier Verification Pack","description":"One call, one receipt: Kenya KRA PIN + settlement IBAN + SWIFT/BIC. Deterministic structural checks for East African trade corridors.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":[],"properties":{"kra_pin":{"type":"string","description":"KRA PIN (optional)"},"iban":{"type":"string","description":"Settlement IBAN (optional)"},"swift":{"type":"string","description":"SWIFT/BIC (optional)"}}}}},"example":{"input":{"kra_pin":"P051234567X","iban":"GB82WEST12345698765432","swift":"BARCKENX"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"corridor":{"type":"string"},"checked_count":{"type":"number"},"all_valid":{"type":"boolean"},"verdict":{"type":"string"},"results":{"type":"array"},"next_steps":{"type":"string"},"scope":{"type":"string"}},"required":["checked_count","all_valid"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/settlement-history-check/call":{"post":{"operationId":"settlement_history_check","summary":"On-Chain Counterparty Settlement History","description":"ON-CHAIN COUNTERPARTY PROOF: Audit USDC transfers sent and received by any EVM address over the last ~48h of Base blocks. Preflighted so you never pay during an RPC outage.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"EVM address, 0x-prefixed."}}}}},"example":{"input":{"address":"0xc59c85e661d34084a7769f955d17fd38254a6235"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"address":{"type":"string"},"usdc_sent":{"type":"object"},"usdc_received":{"type":"object"},"scope":{"type":"string"}},"required":["valid","address"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/balance-check/call":{"post":{"operationId":"balance_check","summary":"Base Balance & Solvency Snapshot","description":"PRE-PAYMENT SOLVENCY PROOF: Snapshot verified native ETH and USDC token balance on Base with raw units and decimals provenance. Preflighted so you never pay during an RPC outage.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"EVM address, 0x-prefixed."},"token_address":{"type":"string","description":"ERC-20 token contract address (optional; defaults to USDC on Base)."}}}}},"example":{"input":{"address":"0xc59c85e661d34084a7769f955d17fd38254a6235"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"address":{"type":"string"},"native":{"type":"object"},"token":{"type":"object"},"reason":{"type":"string"},"retryable":{"type":"boolean"},"scope":{"type":"string"}},"required":["valid","address"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/erc20-balance/call":{"post":{"operationId":"erc20_balance","summary":"ERC-20 Token Balance Snapshot","description":"Raw + formatted ERC-20 balanceOf for an address at any token contract on Base. Decimals read on-chain. Preflighted so you never pay during an RPC outage.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["address","token_address"],"properties":{"address":{"type":"string","description":"Holder EVM address, 0x-prefixed."},"token_address":{"type":"string","description":"ERC-20 token contract address, 0x-prefixed."},"decimals":{"type":"number","description":"Token decimals override (optional)."}}}}},"example":{"input":{"address":"0xc59c85e661d34084a7769f955d17fd38254a6235","token_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"address":{"type":"string"},"token_address":{"type":"string"},"balance_raw":{"type":"string"},"decimals":{"type":"number"},"decimals_source":{"type":"string"},"balance":{"type":"number"},"reason":{"type":"string"},"retryable":{"type":"boolean"},"scope":{"type":"string"}},"required":["valid","address","token_address"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/tx-activity/call":{"post":{"operationId":"tx_activity","summary":"Tx Activity & Contract Detection","description":"On-chain activity snapshot: total outbound nonce, bytecode check (is_contract), and funded status on Base. Preflighted before payment.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"EVM address, 0x-prefixed."}}}}},"example":{"input":{"address":"0xc59c85e661d34084a7769f955d17fd38254a6235"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"address":{"type":"string"},"tx_count":{"type":"number"},"is_contract":{"type":"boolean"},"first_funded_heuristic":{"type":"boolean"},"scope":{"type":"string"}},"required":["valid","address","tx_count"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/block-info/call":{"post":{"operationId":"block_info","summary":"Base Block Header Info","description":"Latest (or specified) Base block header: number, timestamp, transaction count, base fee. Preflighted before payment.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":[],"properties":{"block":{"type":"string","description":"Block number as hex (0x…) or decimal, or a tag (latest/earliest/pending/finalized/safe); defaults to latest."}}}}},"example":{"input":{"block":"latest"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"block":{"type":"string"},"block_number":{"type":"number"},"timestamp":{"type":"number"},"timestamp_iso":{"type":"string"},"tx_count":{"type":"number"},"base_fee_gwei":{"type":"number"},"reason":{"type":"string"},"retryable":{"type":"boolean"},"scope":{"type":"string"}},"required":["valid","block_number"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/isin-check/call":{"post":{"operationId":"isin_check","summary":"ISIN check","description":"Validate an ISIN (ISO 6166) by structure and Luhn mod-10 check digit over the A=10…Z=35 converted string.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["isin"],"properties":{"isin":{"type":"string","description":"12-character ISIN: 2-letter country code + 9 alphanumerics + check digit; spaces allowed."}}}}},"example":{"input":{"isin":"US0378331005"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/ean13-check/call":{"post":{"operationId":"ean13_check","summary":"EAN-13 check","description":"Validate an EAN-13 barcode by its mod-10 checksum (odd positions x1, even positions x3).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"13-digit EAN-13 barcode; spaces/dashes allowed."}}}}},"example":{"input":{"code":"5901234123457"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/gstin-check/call":{"post":{"operationId":"gstin_check","summary":"GSTIN check (India)","description":"Validate an Indian GSTIN by structure (2-digit state code + PAN + entity code + 'Z') and its mod-36 cross-sum checksum.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["gstin"],"properties":{"gstin":{"type":"string","description":"15-character Indian Goods and Services Tax Identification Number."}}}}},"example":{"input":{"gstin":"27AAPFU0939F1ZV"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/crypto-ticker/call":{"post":{"operationId":"crypto_ticker","summary":"Crypto ticker","description":"Current spot price (USD) for a symbol via the public CoinGecko API; common tickers (btc, eth, …) are mapped to CoinGecko ids automatically. Cached 60s server-side; preflighted so you never pay during an API outage.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["symbol"],"properties":{"symbol":{"type":"string","description":"Ticker symbol (btc, eth, sol, …) or a CoinGecko asset id (bitcoin, ethereum, …)."}}}}},"example":{"input":{"symbol":"btc"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"symbol":{"type":"string"},"coingecko_id":{"type":"string"},"price_usd":{"type":"number"},"currency":{"type":"string"},"cached":{"type":"boolean"},"fetched_at":{"type":"string"},"reason":{"type":"string"},"retryable":{"type":"boolean"},"scope":{"type":"string"}},"required":["valid","symbol"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/context-distill/call":{"post":{"operationId":"context_distill","summary":"Context distill","description":"Deterministic text digest: word count, top-5 most frequent meaningful words (stop words excluded), first sentence, and a keccak-256 content hash. Pure function — no external calls, no ML.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["text"],"properties":{"text":{"type":"string","description":"Arbitrary text to distill (any length; hashing is over the exact input)."}}}}},"example":{"input":{"text":"The landlord demanded the deposit before the viewing. The deposit was paid before any viewing of the property."}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"word_count":{"type":"number"},"meaningful_word_count":{"type":"number"},"top_words":{"type":"array"},"first_sentence":{"type":"string"},"content_hash":{"type":"string"},"scope":{"type":"string"}},"required":["valid","word_count"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/instant-json-schema-verifier/call":{"post":{"operationId":"instant_json_schema_verifier","summary":"Instant JSON schema verifier","description":"Validate JSON data payloads against schema definitions. Preflighted for agent tool call pipelines.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["data","schema"],"properties":{"data":{"type":"object","description":"The JSON data object to validate against the schema."},"schema":{"type":"object","description":"The JSON schema object with expected properties and types."}}}}},"example":{"input":{"data":{"name":"Apex Agent","version":2},"schema":{"required":["name","version"],"properties":{"name":{"type":"string"},"version":{"type":"number"}}}}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"valid":{"type":"boolean"},"errors":{"type":"array"},"execution_ms":{"type":"number"}},"required":["valid","errors","execution_ms"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/clean-markdown-scraper/call":{"post":{"operationId":"clean_markdown_scraper","summary":"Clean markdown scraper","description":"Transform noisy HTML web documents into clean, LLM-optimized Markdown while preserving semantic headers and links.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["html"],"properties":{"html":{"type":"string","description":"Raw HTML string to scrape and clean into pristine Markdown."}}}}},"example":{"input":{"html":"<h1>Protocol Overview</h1><p>Agentic non-custodial settlement gateway.</p><ul><li>Zero custody</li><li>Sub-cent fees</li></ul>"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"markdown":{"type":"string"},"wordCount":{"type":"number"},"headings":{"type":"array"}},"required":["markdown","wordCount"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/fx-spot-price-oracle/call":{"post":{"operationId":"fx_spot_price_oracle","summary":"FX spot price oracle","description":"High-precision fiat & stablecoin foreign exchange spot rates (USDC, EUR, GBP, JPY, etc.) computed from TWAP edge oracles.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["base","quote"],"properties":{"base":{"type":"string","description":"Base currency symbol (e.g. USDC, EUR, GBP, JPY)."},"quote":{"type":"string","description":"Quote currency symbol (e.g. USD, EUR, JPY)."}}}}},"example":{"input":{"base":"EUR","quote":"USD"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"pair":{"type":"string"},"rate":{"type":"number"},"inverse":{"type":"number"},"timestamp":{"type":"number"},"source":{"type":"string"}},"required":["pair","rate","inverse","timestamp","source"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/create-b2b-invoice/call":{"post":{"operationId":"create_b2b_invoice","summary":"Create B2B contractor invoice","description":"Generate a pre-cleared, gasless B2B settlement invoice on Base L2 with floating piecewise dynamic fee (capped) and dual-rail bank coordinates (JUANA LIMITED Tide / CurrencyCloud).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["amount_usdc","merchant"],"properties":{"amount_usdc":{"type":"number","description":"Invoice total in USDC (e.g. 50000)."},"merchant":{"type":"string","description":"Beneficiary contractor Base EVM wallet address (0x...)."},"client_name":{"type":"string","description":"Client enterprise organization name (optional)."},"memo":{"type":"string","description":"Engagement scope / milestone description (optional)."},"referrer":{"type":"string","description":"Referral partner wallet address to earn 20% protocol fee rebate (optional)."}}}}},"example":{"input":{"amount_usdc":50000,"merchant":"0xc59c85e661d34084a7769f955d17fd38254a6235","client_name":"Apex AI","memo":"Sprint #14 Milestones"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"invoice_id":{"type":"string"},"amount_usdc":{"type":"number"},"merchant":{"type":"string"},"status":{"type":"string"},"cart_hash":{"type":"string"},"protocol_fee_usdc":{"type":"number"},"invoice_url":{"type":"string"},"pay_url":{"type":"string"},"scope":{"type":"string"}},"required":["valid","invoice_id","invoice_url","pay_url"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/get-b2b-invoice/call":{"post":{"operationId":"get_b2b_invoice","summary":"Get B2B invoice status","description":"Inspect live settlement status, on-chain transaction hash, and payment timestamps for any Code402 B2B invoice.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["invoice_id"],"properties":{"invoice_id":{"type":"string","description":"Unique invoice identifier, e.g. inv_a1b2c3d4e5f6."}}}}},"example":{"input":{"invoice_id":"inv_example1234"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"invoice_id":{"type":"string"},"status":{"type":"string"},"amount_usdc":{"type":"number"},"merchant":{"type":"string"},"client_name":{"type":"string"},"tx_hash":{"type":"string"},"settled_at":{"type":"number"},"scope":{"type":"string"}},"required":["valid","invoice_id","status"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/calculate-fx-savings/call":{"post":{"operationId":"calculate_fx_savings","summary":"Calculate cross-border FX savings","description":"Arithmetic comparison of a USDC settlement against comparator percentages YOU supply (bank_fee_pct, custodial_fee_pct) across 14 global fiat currencies. The comparators are assumptions, not measurements of any bank or provider; no protocol fee is deducted on this rail.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","properties":{"amount_usdc":{"type":"number","description":"Gross invoice settlement volume in USD/USDC."},"amount_usd":{"type":"number","description":"Gross invoice settlement volume in USD/USDC (alias)."},"amount":{"type":"number","description":"Gross invoice settlement volume in USD/USDC (alias)."},"currency":{"type":"string","description":"Target currency for local comparison (e.g. EUR, GBP, BRL, INR, ARS, PHP, NGN, SGD)."}}}}},"example":{"input":{"amount_usdc":50000,"currency":"BRL"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"amount_usdc":{"type":"number"},"currency":{"type":"string"},"legacy_swift_fee_usd":{"type":"number"},"deel_fee_usd":{"type":"number"},"code402_protocol_fee_usd":{"type":"number"},"retained_savings_usd":{"type":"number"},"pct_retained":{"type":"number"},"local_currency":{"type":"object"},"scope":{"type":"string"}},"required":["amount_usdc","retained_savings_usd","pct_retained"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/aci-trust-lookup/call":{"post":{"operationId":"aci_trust_lookup","summary":"ACI-1 Agent Credit & Trust Rating Lookup","description":"Deterministic agent trust scoring and non-custodial unsettled exposure advisory evaluation (ACI-1). Quantifies counterparty grade (T0-T3), historical success rate, and maximum suggested settlement exposure without uncollateralized lending or float.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","properties":{"subject":{"type":"string","description":"Agent wallet address (0x...) or canonical ANS identifier (c402:...) to evaluate"},"role":{"type":"string","description":"Agent role: 'payer' or 'seller' (default 'payer')"},"settled_calls_90d":{"type":"number","description":"Number of settled transactions in the past 90 days"},"settlement_success_rate":{"type":"number","description":"Historical settlement success rate 0.0 to 1.0"},"dispute_loss_rate":{"type":"number","description":"Historical dispute loss rate 0.0 to 1.0"},"first_seen_days":{"type":"number","description":"Days since first active on-chain settlement"},"sponsor_attestations":{"type":"array","description":"Array of signed sponsorship edges"}},"required":["subject"]}}},"example":{"input":{"subject":"0x1111111111111111111111111111111111111111","settled_calls_90d":1500,"settlement_success_rate":0.999,"first_seen_days":120}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"ok":{"type":"boolean"},"standard":{"type":"string"},"subject":{"type":"string"},"tier":{"type":"string"},"score_bp":{"type":"number"},"unsettled_exposure_hint_minor":{"type":"string"},"evidence":{"type":"object"},"policy_notice":{"type":"string"},"receipt_digest":{"type":"string"}},"required":["ok","standard","subject","tier","score_bp"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/dip-file-dispute/call":{"post":{"operationId":"dip_file_dispute","summary":"DIP-1 Deterministic Dispute Adjudication","description":"Deterministic machine-to-machine dispute resolution against signed XDR-1 execution receipts (DIP-1). Evaluates verifiable claims (NOT_DELIVERED, TIMEOUT_UNDELIVERED, OUTPUT_MISMATCH, SCHEMA) and issues non-custodial remedies.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","properties":{"dispute_id":{"type":"string","description":"Unique dispute reference identifier"},"receipt":{"type":"object","description":"Signed XDR-1 execution receipt being contested"},"claim":{"type":"string","description":"Claim type: 'NOT_DELIVERED', 'TIMEOUT_UNDELIVERED', 'OUTPUT_MISMATCH', or 'SCHEMA'"},"claimed_input":{"type":"string","description":"Original input payload or string for hash verification"},"delivered_output":{"type":"object","description":"Delivered output payload received from seller"},"refund_threshold_minor":{"type":"string","description":"USDC minor units threshold above which REFUND_ORDER_QUEUED is staged"}},"required":["dispute_id","receipt","claim"]}}},"example":{"input":{"dispute_id":"disp-101","receipt":{"v":"XDR-1","tool":"iban-check","payer":"0x1111111111111111111111111111111111111111","recipient":"0xc59c85e661d34084a7769f955d17fd38254a6235","amount":"999","ts":1700000000,"input_hash":"0x01","output_hash":"0x02","nonce":"0x01","signature":"0x01"},"claim":"NOT_DELIVERED"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"ok":{"type":"boolean"},"standard":{"type":"string"},"dispute_id":{"type":"string"},"verdict":{"type":"string"},"upheld":{"type":"boolean"},"remedy":{"type":"string"},"remedy_detail":{"type":"object"},"receipt_digest":{"type":"string"}},"required":["ok","standard","dispute_id","verdict","upheld","remedy"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/pod-verify-delivery/call":{"post":{"operationId":"pod_verify_delivery","summary":"POD-1 Proof-of-Delivery Attestation Verifier","description":"Physical IoT and off-chain service delivery verification using integer E7 point-in-polygon geometry and hardware sensor threshold validation (POD-1). Deterministic integer arithmetic avoids floating-point coordinate drift; verification only, no custody or escrow.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","properties":{"mandate":{"type":"object","description":"Delivery mandate with geofence polygon (lat_e7/lon_e7) and time window"},"attestation":{"type":"object","description":"Signed IoT device delivery attestation with coordinates, counter, and signatures"},"last_seen_counter":{"type":"number","description":"Anti-replay counter from previous delivery attestations"}},"required":["mandate","attestation"]}}},"example":{"input":{"mandate":{"mandate_id":"mandate-99","order_ref":"ord-99","geofence":{"type":"polygon_e7","ring":[[377749000,-1224194000],[377759000,-1224194000],[377759000,-1224094000],[377749000,-1224094000]]},"window":{"not_before":1700000000,"not_after":1700003600},"max_accuracy_m":50,"required_signers":["device"]},"attestation":{"mandate_id":"mandate-99","device_id":"DEV-1","device_pubkey":"0x01","scheme":1,"geo":{"lat_e7":377750000,"lon_e7":-122415000,"accuracy_m":10},"ts":1700001000,"counter":1,"signatures":{"device":"0x01010101010101010101010101010101010101010101010101010101010101010101010101010101010101010101010101010101010101010101010101010101"}},"last_seen_counter":0}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"ok":{"type":"boolean"},"standard":{"type":"string"},"mandate_id":{"type":"string"},"verdict":{"type":"string"},"verified":{"type":"boolean"},"details":{"type":"object"},"attestation_receipt_digest":{"type":"string"}},"required":["ok","standard","verdict","verified"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/csp-commitment-create/call":{"post":{"operationId":"csp_commitment_create","summary":"CSP-1 Confidential Terms Commitment & Stealth Announce","description":"Generates cryptographic commitments to commercial terms and formats ERC-5564 dual-key stealth address announcements (CSP-1) for invoice-scale B2B payments on Base L2.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","properties":{"invoice_object":{"type":"object","description":"Structured invoice or commercial agreement object to commit to"},"salt_hex":{"type":"string","description":"Optional 32-byte salt (0x...). If omitted, cryptographically derived"},"stealth_recipient":{"type":"string","description":"Optional Base L2 stealth recipient address for announcement"},"ephemeral_pubkey":{"type":"string","description":"Optional ephemeral public key for ERC-5564 announcement"},"view_tag":{"type":"string","description":"Optional 1-byte hex view tag (0xNN)"}},"required":["invoice_object"]}}},"example":{"input":{"invoice_object":{"invoice_id":"INV-402","amount_usdc":5000,"line_items":[{"sku":"H100_HR","qty":10}]}}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"ok":{"type":"boolean"},"standard":{"type":"string"},"invoice_commitment":{"type":"string"},"salt_hex":{"type":"string"},"canonical_jcs":{"type":"string"},"announcement":{"type":"object"}},"required":["ok","standard","invoice_commitment","salt_hex"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/iso20022-validate/call":{"post":{"operationId":"iso20022_validate","summary":"BAP-1 ISO 20022 Banking Message Validator","description":"Deterministic validation for institutional ISO 20022 XML/JSON payment messages (pain.001 credit transfer, pacs.008 customer credit, camt.053 bank statement) with XML DOCTYPE security guards, BigInt CtrlSum decimal sums, and ISO 13616 / 9362 / 17442 checksums (BAP-1).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","properties":{"raw_payload":{"type":"string","description":"Raw ISO 20022 XML or JSON message text"},"format":{"type":"string","description":"'xml' or 'json' (default auto-detected)"},"namespace":{"type":"string","description":"Expected ISO 20022 schema namespace (e.g. 'pain.001.001.09')"},"transactions":{"type":"array","description":"Structured transactions array for JSON validation"}},"required":["raw_payload"]}}},"example":{"input":{"raw_payload":"<Document xmlns=\"urn:iso:std:iso:20022:tech:xsd:pain.001.001.09\"><CstmrCdtTrfInitn><GrpHdr><MsgId>MSG-2026-001</MsgId><NbOfTxs>1</NbOfTxs><CtrlSum>100.00</CtrlSum></GrpHdr><PmtInf><CdtTrfTxInf><Amt><InstdAmt Ccy=\"USD\">100.00</InstdAmt></Amt><CdtrAgt><FinInstnId><BICFI>DEUTDEDDFXX</BICFI></FinInstnId></CdtrAgt><CdtrAcct><Id><IBAN>DE89370400440532013000</IBAN></Id></CdtrAcct></CdtTrfTxInf></PmtInf></CstmrCdtTrfInitn></Document>"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"ok":{"type":"boolean"},"standard":{"type":"string"},"valid":{"type":"boolean"},"namespace":{"type":"string"},"message_id":{"type":"string"},"tx_count":{"type":"number"},"ctrl_sum_minor":{"type":"string"},"findings":{"type":"array"},"receipt_digest":{"type":"string"}},"required":["ok","standard","valid"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/iso20022-to-x402-intent/call":{"post":{"operationId":"iso20022_to_x402_intent","summary":"BAP-1 ISO 20022 to x402 Intent Mapper","description":"Translates validated ISO 20022 payment instructions (pain.001 / pacs.008) into deterministic EIP-712 payment-intent templates for autonomous x402 Base L2 USDC settlement (BAP-1). Zero custody, no fiat leg.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","properties":{"instruction":{"type":"object","description":"Validated BAP-1 payment instruction object"},"counterparty_wallet_directory":{"type":"object","description":"Enterprise IBAN -> 0x Base L2 wallet address map"},"seller_pay_to_address":{"type":"string","description":"Fallback recipient Base L2 address"},"chain_id":{"type":"number","description":"Target chain ID (default 8453 for Base)"}},"required":["instruction"]}}},"example":{"input":{"instruction":{"end_to_end_id":"E2E-1001","instructed_amount":{"currency":"USD","amount_str":"250.00","amount_minor":"250000000"},"debtor":{"iban":"DE89370400440532013000"},"creditor":{"iban":"DE77100100100123456789"}},"seller_pay_to_address":"0xc59c85e661d34084a7769f955d17fd38254a6235"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"ok":{"type":"boolean"},"standard":{"type":"string"},"intent_template":{"type":"object"},"status":{"type":"string"},"notice":{"type":"string"}},"required":["ok","standard","intent_template","status"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/list-approved-insurers/call":{"post":{"operationId":"list_approved_insurers","summary":"List registered 3rd-party transaction insurers","description":"List underwriters in the open insurance referral directory. The directory ships EMPTY: an underwriter appears only after it self-registers via /api/insurance/register, and self-registration is not vetting — buyers must perform their own due diligence on any listed counterparty.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","properties":{"coverage_type":{"type":"string","description":"Optional filter: 'smart_contract_execution', 'commercial_trade_credit', 'wire_fraud_bec_defense', or 'subagent_sla_delivery'"},"min_coverage_usdc":{"type":"number","description":"Minimum desired coverage limit in USDC"}}}}},"example":{"input":{"coverage_type":"commercial_trade_credit"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"total_count":{"type":"number"},"underwriters":{"type":"array"},"open_access_policy":{"type":"string"}},"required":["valid","total_count","underwriters"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/quote-3rd-party-insurance/call":{"post":{"operationId":"quote_3rd_party_insurance","summary":"Quote 3rd-party transaction & payment insurance","description":"Compare insurance quotes from underwriters registered in the open referral directory (coverage for transaction, smart-contract, trade-credit, and BEC wire-fraud risk). Returns zero quotes until an underwriter has self-registered; this gateway never underwrites risk itself.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","properties":{"amount_usdc":{"type":"number","description":"Transaction or invoice settlement amount in USDC (e.g. 50000)."},"amount":{"type":"number","description":"Alias for amount_usdc."},"tx_hash":{"type":"string","description":"On-chain transaction hash to insure (optional)."},"transaction_id":{"type":"string","description":"Transaction identifier (optional)."},"invoice_id":{"type":"string","description":"Associated invoice identifier (optional)."},"coverage_type":{"type":"string","description":"Desired coverage type: 'smart_contract_execution', 'commercial_trade_credit', 'wire_fraud_bec_defense', 'subagent_sla_delivery'"},"counterparty_address":{"type":"string","description":"Counterparty Base EVM wallet address (optional)."}}}}},"example":{"input":{"amount_usdc":50000,"coverage_type":"commercial_trade_credit"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"amount_usdc":{"type":"number"},"tx_hash":{"type":"string"},"transaction_id":{"type":"string"},"invoice_id":{"type":"string"},"total_quotes":{"type":"number"},"quotes":{"type":"array"},"recommended_underwriter":{"type":"object"},"plain_english_summary":{"type":"string"},"scope":{"type":"string"}},"required":["valid","amount_usdc","quotes"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/bind-insurance-policy/call":{"post":{"operationId":"bind_insurance_policy","summary":"Bind 3rd-party insurance policy to transaction","description":"Bind an insurance policy from a REGISTERED directory underwriter to a specific transaction, payment, or B2B invoice, generating an offline-verifiable POL-1 certificate. Bilateral non-custodial agreement with the named underwriter — the gateway neither underwrites nor accredits anyone.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","required":["underwriter_id"],"properties":{"underwriter_id":{"type":"string","description":"Underwriter id from the open self-registration directory (run list-approved-insurers for current ids; the directory ships empty)"},"amount_usdc":{"type":"number","description":"Transaction coverage amount in USDC"},"amount":{"type":"number","description":"Alias for amount_usdc"},"tx_hash":{"type":"string","description":"Transaction hash being insured (optional)"},"transaction_id":{"type":"string","description":"Transaction reference ID (optional)"},"invoice_id":{"type":"string","description":"Associated invoice identifier (optional)"},"policyholder_address":{"type":"string","description":"Policyholder Base EVM address (0x...)"},"beneficiary_address":{"type":"string","description":"Beneficiary Base EVM address for claim payouts (0x...)"},"coverage_type":{"type":"string","description":"Coverage type override (optional)"}}}}},"example":{"input":{"underwriter_id":"euler_allianz_trade_credit","amount_usdc":50000,"policyholder_address":"0x1111111111111111111111111111111111111111"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"policy_id":{"type":"string"},"certificate_hash":{"type":"string"},"tx_hash":{"type":"string"},"invoice_id":{"type":"string"},"underwriter_id":{"type":"string"},"underwriter_name":{"type":"string"},"coverage_amount_usdc":{"type":"number"},"premium_usdc":{"type":"number"},"status":{"type":"string"},"pol1_certificate":{"type":"object"},"scope":{"type":"string"}},"required":["valid","policy_id","certificate_hash","status"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/upi-vpa-check/call":{"post":{"operationId":"upi_vpa_check","summary":"India UPI Virtual Payment Address (VPA) Validator","description":"Deterministic validation of Indian UPI Virtual Payment Address (VPA / handle) against NPCI guidelines and accredited PSP handle registry (okhdfcbank, okaxis, paytm, ybl, etc.).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","properties":{"vpa":{"type":"string","description":"UPI Virtual Payment Address (e.g. 'merchant@okhdfcbank', '9876543210@paytm')"}},"required":["vpa"]}}},"example":{"input":{"vpa":"merchant@okhdfcbank"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"username":{"type":"string"},"handle":{"type":"string"},"accredited_psp":{"type":"boolean"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["tool","valid"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/pan-format-check/call":{"post":{"operationId":"pan_format_check","summary":"India Permanent Account Number (PAN) Format Validator","description":"Deterministic validation of Indian Permanent Account Number (PAN) issued by CBDT / Income Tax Department with 4th-character entity type classification (Individual, Company, Firm, Trust, HUF).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","properties":{"pan":{"type":"string","description":"10-character PAN string (e.g. 'ABCDE1234F')"}},"required":["pan"]}}},"example":{"input":{"pan":"AAACP1234M"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"entity_code":{"type":"string"},"entity_type":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["tool","valid"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/uae-trn-check/call":{"post":{"operationId":"uae_trn_check","summary":"UAE Tax Registration Number (TRN) Format Validator","description":"Deterministic validation of UAE 15-digit Tax Registration Number (TRN) issued by the Federal Tax Authority (FTA) for VAT purposes.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","properties":{"trn":{"type":"string","description":"15-digit UAE TRN string (starts with 100)"}},"required":["trn"]}}},"example":{"input":{"trn":"100123456700003"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"authority":{"type":"string"},"trn_type":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["tool","valid"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}},"/v1/tools/ofac-sdn-check/call":{"post":{"operationId":"ofac_sdn_check","summary":"OFAC SDN & Sanctions List Edge Screener","description":"Deterministic screen of EVM addresses and jurisdictions against a curated local blocklist of sanctioned addresses and prohibited jurisdictions. Address- and jurisdiction-level only — this is NOT name-based screening and NOT a complete OFAC SDN check. Absence of a match is not a sanctions clearance; use as one informational input alongside your own compliance process.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"object","properties":{"subject":{"type":"string","description":"EVM address (0x...) or ISO 3166-1 country code / jurisdiction name"}},"required":["subject"]}}},"example":{"input":{"subject":"0x7f367cc41522ce07553e823bf3be79a889debe1b"}}}}},"responses":{"200":{"description":"Result + signed XDR-1 receipt","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"is_sanctioned":{"type":"boolean"},"match_type":{"type":"string"},"subject":{"type":"string"},"sanction_program":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["tool","valid","is_sanctioned"]},"tier":{"type":"string"},"settlement":{"type":"object"},"receipt":{"type":"object"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (x402). Sign accepts[0] EIP-3009 authorization and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array"},"error":{"type":"string"}}}}}}}}}}}