{"openapi":"3.1.0","info":{"title":"VeriState x402 — Ground-Truth & Visual Forensics Oracle API","version":"1.0.0","description":"Autonomous agent-payable Oracle powered by Gemini 4 Argon and Coinbase Developer Platform (CDP) Server Wallets. All /api/v1/oracle/* routes use the HTTP 402 (Coinbase Base USDC EIP-3009) micropayment protocol. PayTo Wallet: 0x21B4c6fc23ca4Ab41B272d1BAe5EE3DF1e2F0cdC."},"servers":[{"url":"https://veristate.xyz","description":"Public x402 Oracle Gateway"}],"paths":{"/api/v1/oracle/visual-forensics":{"post":{"operationId":"ep_visual_forensics","summary":"Visual Invoice & Tampering Attestation ($0.009 USDC via x402)","description":"Independent cryptographic audit of commercial invoices, wire instructions, and supply-chain documents using Gemini 4 Argon before autonomous treasury bots release funds. — Protected by Coinbase Base x402 (EIP-3009 USDC at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo: 0x21B4c6fc23ca4Ab41B272d1BAe5EE3DF1e2F0cdC).","parameters":[{"name":"X-PAYMENT","in":"header","required":false,"description":"Base64-encoded Coinbase x402 v1 EIP-3009 TransferWithAuthorization signature payload. Omit on first call to receive the 402 PaymentRequirements challenge.","schema":{"type":"string"}}],"responses":{"200":{"description":"Payment settled and Oracle attestation signed by CDP TEE Server Wallet","headers":{"X-PAYMENT-RESPONSE":{"description":"Base64-encoded x402 settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"settled_and_attested"},"x402Settlement":{"type":"object"},"oracleResult":{"type":"object"},"attestation":{"type":"object","properties":{"oracleSigner":{"type":"string","example":"0xA8d8f4d21F2da8D4698F646d82D9eFc79A530dFd"},"oracleSignerMode":{"type":"string","example":"CDP_EVM_SERVER_WALLET_TEE"},"contentKeccak256":{"type":"string"},"verdictKeccak256":{"type":"string"},"oracleSignature":{"type":"string"},"verifiedAt":{"type":"string"}}}}}}}},"402":{"description":"Payment Required — returns Coinbase x402 v1 PaymentRequirements and Bazaar schema","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string"},"accepts":{"type":"array","items":{"type":"object"}}}}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"imageUrl":{"type":"string","description":"Direct HTTP/HTTPS URL to an invoice, receipt, chart, or document image (or \"demo\" for built-in invoice test)."},"imageBase64":{"type":"string","description":"Optional Base64-encoded document/invoice image for forensic audit (pass either imageUrl or imageBase64)."},"customPrompt":{"type":"string","description":"Specific forensic checks to perform"}}}}}}}},"/api/v1/oracle/live-web-state":{"post":{"operationId":"ep_live_dom_state","summary":"Live Gated Web State & Orderbook Oracle ($0.007 USDC via x402)","description":"Captures and visually verifies dynamic WebGL orderbooks, live GPU spot rates, and inventory behind anti-bot walls with a signed timestamped state proof. — Protected by Coinbase Base x402 (EIP-3009 USDC at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo: 0x21B4c6fc23ca4Ab41B272d1BAe5EE3DF1e2F0cdC).","parameters":[{"name":"X-PAYMENT","in":"header","required":false,"description":"Base64-encoded Coinbase x402 v1 EIP-3009 TransferWithAuthorization signature payload. Omit on first call to receive the 402 PaymentRequirements challenge.","schema":{"type":"string"}}],"responses":{"200":{"description":"Payment settled and Oracle attestation signed by CDP TEE Server Wallet","headers":{"X-PAYMENT-RESPONSE":{"description":"Base64-encoded x402 settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"settled_and_attested"},"x402Settlement":{"type":"object"},"oracleResult":{"type":"object"},"attestation":{"type":"object","properties":{"oracleSigner":{"type":"string","example":"0xA8d8f4d21F2da8D4698F646d82D9eFc79A530dFd"},"oracleSignerMode":{"type":"string","example":"CDP_EVM_SERVER_WALLET_TEE"},"contentKeccak256":{"type":"string"},"verdictKeccak256":{"type":"string"},"oracleSignature":{"type":"string"},"verifiedAt":{"type":"string"}}}}}}}},"402":{"description":"Payment Required — returns Coinbase x402 v1 PaymentRequirements and Bazaar schema","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string"},"accepts":{"type":"array","items":{"type":"object"}}}}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"targetUrl":{"type":"string","description":"Live HTTPS URL to fetch, hash (Keccak-256), and extract ground-truth state from"},"extractionSchemaPrompt":{"type":"string","description":"Specific fields, prices, or entities to extract and sign"}},"required":["targetUrl"]}}}}}},"/api/v1/oracle/telemetry-stream":{"get":{"operationId":"ep_proprietary_stream","summary":"Continuous Spot Liquidity, Token Risk & Sanctions Stream ($0.004 USDC via x402)","description":"Micro-minute metered state stream ($0.004/min) & on-chain Base token/wallet risk oracle. Pass any 0x contract or wallet address to inspect Base Mainnet bytecode, ETH/USDC balances, and receive a TEE-signed SAFE_TO_INTERACT / HIGH_RISK verdict. — Protected by Coinbase Base x402 (EIP-3009 USDC at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo: 0x21B4c6fc23ca4Ab41B272d1BAe5EE3DF1e2F0cdC).","parameters":[{"name":"X-PAYMENT","in":"header","required":false,"description":"Base64-encoded Coinbase x402 v1 EIP-3009 TransferWithAuthorization signature payload. Omit on first call to receive the 402 PaymentRequirements challenge.","schema":{"type":"string"}},{"name":"address","in":"query","required":false,"description":"Optional Base Mainnet token contract or wallet address (0x...) to inspect bytecode, balances, and generate a signed counterparty risk verdict.","schema":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"name":"url","in":"query","required":false,"description":"Optional live target URL for continuous state stream check","schema":{"type":"string"}}],"responses":{"200":{"description":"Payment settled and Oracle attestation signed by CDP TEE Server Wallet","headers":{"X-PAYMENT-RESPONSE":{"description":"Base64-encoded x402 settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"settled_and_attested"},"x402Settlement":{"type":"object"},"oracleResult":{"type":"object"},"attestation":{"type":"object","properties":{"oracleSigner":{"type":"string","example":"0xA8d8f4d21F2da8D4698F646d82D9eFc79A530dFd"},"oracleSignerMode":{"type":"string","example":"CDP_EVM_SERVER_WALLET_TEE"},"contentKeccak256":{"type":"string"},"verdictKeccak256":{"type":"string"},"oracleSignature":{"type":"string"},"verifiedAt":{"type":"string"}}}}}}}},"402":{"description":"Payment Required — returns Coinbase x402 v1 PaymentRequirements and Bazaar schema","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string"},"accepts":{"type":"array","items":{"type":"object"}}}}}}}}}}}}