{"x402Version":1,"service_version":"0.5.0","service":"x402 Payment Gateway","description":"Pay-per-call premium data for autonomous AI agents, settled on Base (USDC) via HTTP 402.","resource":{"url":"https://x402.obolpay.xyz/api/v1/protected-data","method":"GET","description":"Premium autonomous core data. One micropayment per call.","product":"Obolpay Verifiable Data Feed — openunit index + LLM-equivalence + governance benchmarks","schema_version":"1.1"},"price":{"amount":"0.01","currency":"USDC","token_contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decimals":6},"network":{"name":"base-mainnet","chain_id":8453},"recipient":"0x0d444D405dC168f29D66891383aa3542F5030057","payment":{"schemes":["exact","obolpay-tx-receipt"],"preferred_scheme":"exact","standard_exact_available":true,"domain":"x402.obolpay.xyz","smart_wallet":"EIP-1271 (isValidSignature) supported","flows":{"exact":["Standard x402 `exact` (EIP-3009 transferWithAuthorization). Advertised only while it is actually usable.","GET the resource URL -> 402 with accepts[] containing {scheme:'exact', network:'base'}.","Sign an EIP-3009 authorization for the quoted amount. EIP-712 domain: name='USD Coin', version='2', chainId=8453, verifyingContract=the USDC address above.","Re-request with the X-PAYMENT header -> the gateway settles it for you (you pay no gas) and returns 200 OK with data."],"obolpay-tx-receipt":["Non-standard scheme specific to this gateway. YOU send the transfer and YOU pay the gas.","GET the resource URL -> 402 Payment Required with a JSON 'payment' challenge (invoice_id, amount, token_contract, recipient, chain_id).","Transfer the quoted USDC amount to `recipient` on Base from your wallet.","Sign the EIP-191 message 'x402:{domain}:{invoice_id}:{tx_hash}' with the paying key.","Re-request with headers X-Payment-Invoice-ID, X-Payment-Tx-Hash, X-Payment-Signature -> 200 OK with data."]},"binding":"EIP-191 signature over 'x402:{domain}:{invoice_id}:{tx_hash}' (applies to the `obolpay-tx-receipt` scheme only; `exact` needs no such binding)."},"docs":"https://x402.obolpay.xyz/docs","openapi":"https://x402.obolpay.xyz/openapi.json","reference_client":"https://x402.obolpay.xyz/client.py","mcp_server":"https://x402.obolpay.xyz/mcp-server.py","free_preview":"The 402 challenge includes a free 'preview' of the dataset so an agent can evaluate quality BEFORE paying.","proof_of_purchase":{"description":"Every successful 200 delivery includes a cryptographically signed 'receipt' (EIP-191) binding invoice_id, tx_hash, and a SHA-256 of the delivered data. Present it as verifiable proof of a legitimate purchase.","signer_address":"0xd50C176074fb94ED057f031C3Ebb6e2575433CA2","verify_endpoint":"https://x402.obolpay.xyz/verify-receipt"},"disproof_warranty":{"description":"If you can machine-disprove a delivered deterministic item — its archived artifact cannot be re-derived from its pinned, hash-bound source — you get an automatic 2x refund credited to a prepaid balance. No human discretion in the loop: the claim is adjudicated by recomputation. One claim per invoice.","endpoint":"POST https://x402.obolpay.xyz/warranty/disprove {message, signature, item_type, refund_address}","warranted_types":["jp-business-day","ft-jp-settlement-qa"],"multiplier":2,"archive_since":"2026-07-28","honest_limits":"covers deliveries archived since archive_since; items whose pinned source has since changed are adjudicated 'indeterminate' and escalate to the operator instead of silently refusing"},"wanted_board":{"description":"Recorded unmet demand, published. Ask for a category that doesn't exist (free 400) — 2+ real external requests trigger auto-productization; producers can supply the rest.","endpoint":"https://x402.obolpay.xyz/wanted"},"patronage":{"description":"Bundle your receipts into ONE signed proof-of-patronage certificate (only settled purchases count).","endpoint":"POST https://x402.obolpay.xyz/patronage {receipts:[…]}"},"vdp_spec":{"description":"The open Verifiable Data Product spec this catalog follows (CC-BY-4.0). /verify-receipt verifies third-party receipts too.","endpoint":"https://x402.obolpay.xyz/vdp"},"prepaid_balance":{"description":"Deposit USDC once, then make many GASLESS calls with off-chain signed vouchers — no on-chain tx or gas per call. Built for high-frequency habitual agent use.","topup":"POST https://x402.obolpay.xyz/account/topup {tx_hash} (after sending USDC to recipient)","balance":"GET https://x402.obolpay.xyz/account/{address}","spend":"GET /api/v1/protected-data with headers X-Account-Address, X-Account-Nonce, X-Account-Voucher (EIP-191 sig of 'x402-spend:{domain}:{address}:{nonce}:{amount_units}')"},"freshness_sla":{"description":"The 402 preview embeds a signed freshness attestation (EIP-191): content_sha256, generated_at, attested_at, age_seconds. Verify the data's age & integrity cryptographically before/after paying.","location":"402 response -> payment.preview.freshness","verify_endpoint":"https://x402.obolpay.xyz/verify-receipt","auto_refund":"SLA = 900s. If the data would be staler than that, you are not charged for stale data, by either of two paths: (a) prepaid-balance calls are served but the charge is credited straight back to your balance (see response.sla_refund); (b) on-chain / `exact` payments are refused with HTTP 503 before delivery (fail-closed enabled). Objective and abuse-proof: the check is elapsed seconds, nothing else."},"delta_delivery":{"description":"The dataset is an append-only feed (items have monotonic `seq`). Send header 'X-Since-Seq: <last seq you have>' to receive ONLY newer items — saves your context tokens on repeat purchases. The receipt still binds the FULL dataset hash.","start_from":"402 preview -> latest_seq","header":"X-Since-Seq"},"category_selection":{"description":"Multi-category verifiable data feed. Categories: `openunit` (population-weighted unit of account valued at today's ECB FX, byte-for-byte reproducible), `jp-business-day` (Japan bank/TSE business-day & T+1..T+20 settlement-date resolver, resolved for TODAY, year-end closure disclosed), `ft-jp-settlement-qa` (fine-tuning Q&A batch on business-day/settlement reasoning — deterministic ground truth, no LLM in the loop), `x402-ecosystem` (daily deterministic census of the whole x402 machine-payment economy from the public registry, source-hash-bound), `jp-equity-convergence` (event-cohort membership data of JP equities, informational only), `llm-equivalence` (measured local-LLM backend equivalence/consistency matrix on Apple Silicon), `ai-trust-artifacts` (real content-provenance certificates + 3-trail verified AI supply-chain bundle), `governance` (verified governed-AI spending benchmark), `llm-backend-decision` (deterministic backend-selection rankings derived from the same measured qswap data), `jp-disclosure-events` (point-in-time JP guidance/dividend revision events, T+20-business-day lag disclosed, both source disclosures sha256-bound). Request one with '?types=openunit' (or header X-Query-Types). Unknown categories are refused FREE (400) and recorded as unmet demand — categories requested 2+ times get auto-productized (snowball), so ask for what you actually need. Per-category demand is tracked so the market reveals the most valuable data.","param":"?types=<comma-separated>"},"demand_stats":{"description":"Aggregated demand analytics — which categories agents actually pay for. `selected_product` = the market-validated most-valuable category.","endpoint":"https://x402.obolpay.xyz/stats"},"confirmation_policy":{"description":"Deposit/payment confirmations scale with amount to protect against reorgs: small amounts settle instantly; larger deposits wait for extra block confirmations.","tiers_usd":{"instant_below":1.0,"two_conf_below":20.0,"three_conf_at_or_above":20.0}}}