{"openapi":"3.1.0","info":{"title":"WorxAI x402 Data Gateway","version":"2.0.0","description":"Buyer FAQ: human-data and market-data are priced at $0.035 per delivered row with payment required on every delivery; rejected rows are not billed. Purchased synthetic output is licensed for commercial fine-tuning and internal production use, but raw redistribution requires separate written permission. Human-data quality scores cover schema completeness, bounded values, emotion-appraisal consistency, causal-summary presence, diversity, provenance, and safety. Market-data records are synthetic and schema-driven, not historical or calibrated unless explicitly documented. Full buyer documentation is available at https://worxai.tech/market. Reproducible 50-row trial evidence, representative samples, quality scores, and rejected-row reporting are published at https://worxai.tech/evidence. Synthetic dataset delivery for autonomous AI agents, paid via the x402 protocol in USDC on Base. Synthetic responses include a signed provenance oracle envelope; verify payload integrity at https://worxai.tech/api/oracle/verify. On-chain anchoring is reported when a provenance oracle contract is configured. Every agent (identified by wallet address, or by IP if no wallet is given) receives 0 free rows total across up to 0 calls before payment is required. After the free quota, every channel is priced at $0.035 per delivered row, including catalog and ledger access — no separate per-call surcharge. Start with GET /api/x402/v2/datasets for catalog discovery.","contact":{"url":"https://worxai.tech/developers"},"x-google-cloud":{"vertexAiExtension":true,"cloudRunBaseUrl":"https://worxai.tech","discovery":"https://worxai.tech/.well-known/worx.json","mcpDescriptor":"https://worxai.tech/.well-known/mcp.json","datasets":[],"payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC","checkout":"https://worxai.tech/market"}}},"servers":[{"url":"https://worxai.tech"}],"x-payment-configuration":{"protocol":"x402-v2","network":"eip155:8453","asset":"USDC","recipient_address":"0xd924640f948ef4643d78e83609d791a2982d99a9"},"paths":{"/api/oracle/verify":{"get":{"summary":"Get signed provenance oracle status","responses":{"200":{"description":"Oracle identity and anchoring status."}}},"post":{"summary":"Verify signed synthetic-data provenance","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["payload","provenance"],"properties":{"payload":{"type":"object"},"provenance":{"type":"object"}}}}}},"responses":{"200":{"description":"Verification result."}}}},"/api/v1/human-data/generate":{"get":{"summary":"Generate quality-controlled synthetic human-like traces and conversations","operationId":"generateHumanFidelityData","parameters":[{"name":"scenario","in":"query","schema":{"type":"string"}},{"name":"rows","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"format","in":"query","schema":{"type":"string","enum":["traces","conversations"]}}],"responses":{"200":{"description":"Synthetic traces, conversations, quality score, rejected-row report, and signed provenance envelope."},"402":{"description":"Payment required. Read PAYMENT-REQUIRED or PAYMENT-REQUIRED header and submit an x402 payment."},"503":{"description":"Payment configuration unavailable."}}}},"/api/v1/synthetic-data/search":{"get":{"summary":"Search and deliver synthetic data rows","operationId":"searchSyntheticData","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"}},{"name":"rows","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000000}},{"name":"dryRun","in":"query","schema":{"type":"boolean"},"description":"Return the exact row count and USDC quote without generating or charging."}],"responses":{"200":{"description":"Data rows or a dry-run quote."},"402":{"description":"x402 payment challenge."}}}},"/api/v1/synthetic-data/generate":{"get":{"summary":"Generate synthetic data rows","operationId":"generateSyntheticData","parameters":[{"name":"need","in":"query","schema":{"type":"string"}},{"name":"rows","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000000}},{"name":"dryRun","in":"query","schema":{"type":"boolean"},"description":"Return the exact row count and USDC quote without generating or charging."}],"responses":{"200":{"description":"Data rows or a dry-run quote."},"402":{"description":"x402 payment challenge."}}}},"/api/x402/v2/datasets":{"get":{"summary":"Browse the full dataset category catalog","description":"Returns the list of well-known dataset categories and their detail endpoints. Requires payment on every call ($0.035 per delivered row) — there is no paid x402 access on this endpoint itself; paid x402 access is on /datasets/detail.","operationId":"listDatasets","responses":{"200":{"description":"Catalog of dataset categories.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"description":{"type":"string"},"detailEndpoint":{"type":"string"}}}},"count":{"type":"integer"}}}}}},"402":{"description":"Payment required."}}}},"/api/x402/v2/datasets/detail":{"get":{"summary":"Purchase a specific dataset category","description":"Generates and delivers rows for a given category id on demand. Payment is required for every delivered row at $0.035 USDC per row.","operationId":"getDatasetDetail","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","enum":["financial-markets","consumer-signals","event-streams","mcp-traces","healthcare-claims","iot-sensor-logs","social-graph","geospatial-mobility","retail-transactions","weather-observations","network-security-logs","genomics-variants","support-conversations","x402-agent-traces","agent-payment-negotiation-logs","mcp-tool-call-transcripts","llm-reasoning-chains","agent-behavioral-drift","protocol-error-injection"]},"description":"One of the 19 published dataset category IDs. Unlisted names are not part of the published marketplace catalog."},{"name":"rows","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}},{"name":"wallet","in":"query","required":false,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}}],"responses":{"200":{"description":"Dataset delivered — free trial or paid."},"402":{"description":"Payment required — x402 payment is required for every delivery."}}}},"/api/x402/v2/answers":{"post":{"summary":"Generate a paid high-fidelity answer","operationId":"generateHighFidelityAnswer","description":"Preferred: send a signed x402 v2 PaymentPayload in the PAYMENT-SIGNATURE header, settled through the CDP facilitator. A legacy `txHash` body field (a buyer-broadcast USDC transfer receipt, verified directly on-chain) is also accepted for backward compatibility.","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"Base64-encoded signed x402 v2 exact-EVM PaymentPayload. Omit on the first request to receive a 402 challenge."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["question"],"properties":{"question":{"type":"string","maxLength":4000},"context":{"type":"string","maxLength":12000},"txHash":{"type":"string","description":"Legacy fallback: on-chain tx hash of a direct USDC transfer, used only when PAYMENT-SIGNATURE is absent."}}}}}},"responses":{"200":{"description":"Answer with key points, confidence, assumptions, limitations, citations, model, and settlement."},"402":{"description":"Payment required or verification failed. Read the PAYMENT-REQUIRED header for the x402 v2 challenge (accepts, network, asset, facilitator) and retry with a signed PAYMENT-SIGNATURE."}}},"get":{"summary":"Inspect answer generator pricing and policy","responses":{"200":{"description":"Answer product discovery metadata, including the x402 v2 challenge shape and facilitator URL."}}}},"/api/x402/v2/manifest":{"get":{"summary":"Machine-readable discovery manifest","description":"Lists every metered resource and the current free-tier/pricing terms in one call.","operationId":"getManifest","responses":{"200":{"description":"Discovery manifest."}}}},"/api/x402/v2/analytics":{"get":{"summary":"Gateway usage and settlement analytics","operationId":"getAnalytics","responses":{"200":{"description":"Analytics payload."},"402":{"description":"Payment required."}}}},"/api/x402/v2/ledger":{"get":{"summary":"Financial settlement ledger","operationId":"getLedger","responses":{"200":{"description":"Ledger payload."},"402":{"description":"Payment required."}}}}},"x-free-tier":{"rowsPerAgent":0,"callsPerAgent":0,"metering":"wallet","fallbackMetering":"ip","paidPriceUsdcPerRow":0.035},"x-dataset-catalog":{"count":19,"endpointTemplate":"https://worxai.tech/api/x402/v2/datasets/detail?id=<category>&rows=<count>","items":[{"category":"financial-markets","label":"Financial Markets","description":"Synthetic market events, pricing signals, and portfolio-ready records.","protocol":"x402-v2","priceUsdcPerRow":0.035,"accessPolicy":"free-tier-then-x402-v2","privateDeliveryAfterSettlement":true},{"category":"consumer-signals","label":"Consumer Signals","description":"Synthetic customer profiles, purchase behavior, and intent patterns.","protocol":"x402-v2","priceUsdcPerRow":0.035,"accessPolicy":"free-tier-then-x402-v2","privateDeliveryAfterSettlement":true},{"category":"event-streams","label":"Event Streams","description":"Synthetic real-time events for testing agents at production scale.","protocol":"x402-v2","priceUsdcPerRow":0.035,"accessPolicy":"free-tier-then-x402-v2","privateDeliveryAfterSettlement":true},{"category":"mcp-traces","label":"MCP Traces","description":"Synthetic JSON-RPC tool calls, latency profiles, and protocol outcomes for MCP clients.","protocol":"x402-v2","priceUsdcPerRow":0.035,"accessPolicy":"free-tier-then-x402-v2","privateDeliveryAfterSettlement":true},{"category":"healthcare-claims","label":"Healthcare Claims","description":"Synthetic, de-identified insurance claims for model testing. No real patient data.","protocol":"x402-v2","priceUsdcPerRow":0.035,"accessPolicy":"free-tier-then-x402-v2","privateDeliveryAfterSettlement":true},{"category":"iot-sensor-logs","label":"IoT Sensor Logs","description":"Synthetic telemetry from simulated industrial and consumer sensors.","protocol":"x402-v2","priceUsdcPerRow":0.035,"accessPolicy":"free-tier-then-x402-v2","privateDeliveryAfterSettlement":true},{"category":"social-graph","label":"Social Graph","description":"Synthetic anonymized follower/connection graphs and engagement signals.","protocol":"x402-v2","priceUsdcPerRow":0.035,"accessPolicy":"free-tier-then-x402-v2","privateDeliveryAfterSettlement":true},{"category":"geospatial-mobility","label":"Geospatial Mobility","description":"Synthetic anonymized location pings and movement patterns.","protocol":"x402-v2","priceUsdcPerRow":0.035,"accessPolicy":"free-tier-then-x402-v2","privateDeliveryAfterSettlement":true},{"category":"retail-transactions","label":"Retail Transactions","description":"Synthetic point-of-sale transactions across categories and channels.","protocol":"x402-v2","priceUsdcPerRow":0.035,"accessPolicy":"free-tier-then-x402-v2","privateDeliveryAfterSettlement":true},{"category":"weather-observations","label":"Weather Observations","description":"Synthetic station-level weather observations for model back-testing.","protocol":"x402-v2","priceUsdcPerRow":0.035,"accessPolicy":"free-tier-then-x402-v2","privateDeliveryAfterSettlement":true},{"category":"network-security-logs","label":"Network Security Logs","description":"Synthetic intrusion-detection and firewall log entries.","protocol":"x402-v2","priceUsdcPerRow":0.035,"accessPolicy":"free-tier-then-x402-v2","privateDeliveryAfterSettlement":true},{"category":"genomics-variants","label":"Genomics Variants","description":"Synthetic, non-identifying variant-call style records for pipeline testing.","protocol":"x402-v2","priceUsdcPerRow":0.035,"accessPolicy":"free-tier-then-x402-v2","privateDeliveryAfterSettlement":true},{"category":"support-conversations","label":"Support Conversations","description":"Privacy-safe synthetic multi-turn support threads with resolution and sentiment labels.","protocol":"x402-v2","priceUsdcPerRow":0.035,"accessPolicy":"free-tier-then-x402-v2","privateDeliveryAfterSettlement":true},{"category":"x402-agent-traces","label":"x402 Agent Payment Traces","description":"Synthetic multi-step x402 lifecycle traces (request -> 402 -> signed authorization -> settlement) with realistic-shaped signatures, nonces, and tx hashes for testing agent payment clients.","protocol":"x402-v2","priceUsdcPerRow":0.035,"accessPolicy":"free-tier-then-x402-v2","privateDeliveryAfterSettlement":true},{"category":"agent-payment-negotiation-logs","label":"Agent Payment Negotiation Logs","description":"Synthetic decision traces of autonomous agents reacting to budget limits, gas surges, and pricing changes mid-transaction.","protocol":"x402-v2","priceUsdcPerRow":0.035,"accessPolicy":"free-tier-then-x402-v2","privateDeliveryAfterSettlement":true},{"category":"mcp-tool-call-transcripts","label":"MCP Tool Call Transcripts","description":"Synthetic JSON-RPC session transcripts across the MCP tool-call lifecycle, for testing MCP clients and servers under realistic sequencing.","protocol":"x402-v2","priceUsdcPerRow":0.035,"accessPolicy":"free-tier-then-x402-v2","privateDeliveryAfterSettlement":true},{"category":"llm-reasoning-chains","label":"LLM Reasoning Chains","description":"Synthetic multi-step reasoning traces (thought -> action -> confidence) for testing agent orchestration and evaluation harnesses.","protocol":"x402-v2","priceUsdcPerRow":0.035,"accessPolicy":"free-tier-then-x402-v2","privateDeliveryAfterSettlement":true},{"category":"agent-behavioral-drift","label":"Agent Behavioral Drift","description":"Synthetic records of autonomous agents changing payment behavior in response to budget exhaustion, gas spikes, or routing changes.","protocol":"x402-v2","priceUsdcPerRow":0.035,"accessPolicy":"free-tier-then-x402-v2","privateDeliveryAfterSettlement":true},{"category":"protocol-error-injection","label":"Protocol Error Injection Cases","description":"Synthetic stateful error cases (bad nonces, replay attempts, expired authorizations) for hardening x402 client/server error handling.","protocol":"x402-v2","priceUsdcPerRow":0.035,"accessPolicy":"free-tier-then-x402-v2","privateDeliveryAfterSettlement":true}]},"x-dataset-policies":{"financial-markets":{"priceCentsPerCall":3.5,"recordsPerCall":25,"accessPolicy":"pay-per-row","refundPolicy":"Refunds are available only for verified facilitator failures; delivered rows are non-refundable.","privateDeliveryAfterSettlement":true},"consumer-signals":{"priceCentsPerCall":2,"recordsPerCall":25,"accessPolicy":"pay-per-row","refundPolicy":"Refunds are available only for verified facilitator failures; delivered rows are non-refundable.","privateDeliveryAfterSettlement":true},"event-streams":{"priceCentsPerCall":1,"recordsPerCall":25,"accessPolicy":"pay-per-row","refundPolicy":"Refunds are available only for verified facilitator failures; delivered rows are non-refundable.","privateDeliveryAfterSettlement":true},"mcp-traces":{"priceCentsPerCall":1,"recordsPerCall":25,"accessPolicy":"pay-per-row","refundPolicy":"Refunds are available only for verified facilitator failures; delivered rows are non-refundable.","privateDeliveryAfterSettlement":true},"high-intent-financial-grounding":{"priceCentsPerCall":3,"recordsPerCall":25,"accessPolicy":"live-stream","refundPolicy":"Refunds are available only for verified facilitator failures; delivered rows are non-refundable.","privateDeliveryAfterSettlement":true},"wallet-behavior-cohorts":{"priceCentsPerCall":2,"recordsPerCall":25,"accessPolicy":"token-gated","refundPolicy":"Refunds are available only for verified facilitator failures; delivered rows are non-refundable.","privateDeliveryAfterSettlement":true},"network-infrastructure-logs":{"priceCentsPerCall":3,"recordsPerCall":25,"accessPolicy":"pay-per-row","refundPolicy":"Refunds are available only for verified facilitator failures; delivered rows are non-refundable.","privateDeliveryAfterSettlement":true},"web-intent-signals":{"priceCentsPerCall":2,"recordsPerCall":25,"accessPolicy":"pay-per-row","refundPolicy":"Synthetic data; refunds only for verified facilitator failures.","privateDeliveryAfterSettlement":true},"commerce-behavior":{"priceCentsPerCall":2,"recordsPerCall":25,"accessPolicy":"pay-per-row","refundPolicy":"Synthetic data; refunds only for verified facilitator failures.","privateDeliveryAfterSettlement":true},"agent-action-benchmarks":{"priceCentsPerCall":3,"recordsPerCall":25,"accessPolicy":"pay-per-row","refundPolicy":"Synthetic data; refunds only for verified facilitator failures.","privateDeliveryAfterSettlement":true},"onchain-identity-cohorts":{"priceCentsPerCall":2,"recordsPerCall":25,"accessPolicy":"pay-per-row","refundPolicy":"Synthetic data; refunds only for verified facilitator failures.","privateDeliveryAfterSettlement":true},"mcp-schemas":{"priceCentsPerCall":1,"recordsPerCall":25,"accessPolicy":"pay-per-row","refundPolicy":"Synthetic data; refunds only for verified facilitator failures.","privateDeliveryAfterSettlement":true},"weather-live-metrics":{"priceCentsPerCall":2,"recordsPerCall":10,"accessPolicy":"token-gated","refundPolicy":"Provider outages qualify for verified refunds.","privateDeliveryAfterSettlement":true},"market-ticks":{"priceCentsPerCall":3,"recordsPerCall":10,"accessPolicy":"live-stream","refundPolicy":"Provider outages qualify for verified refunds.","privateDeliveryAfterSettlement":true},"legal-regulatory-search":{"priceCentsPerCall":4,"recordsPerCall":5,"accessPolicy":"token-gated","refundPolicy":"Provider outages qualify for verified refunds.","privateDeliveryAfterSettlement":true},"translation-retrieval":{"priceCentsPerCall":2,"recordsPerCall":5,"accessPolicy":"token-gated","refundPolicy":"Provider outages qualify for verified refunds.","privateDeliveryAfterSettlement":true},"agent-inference-compute":{"priceCentsPerCall":5,"recordsPerCall":1,"accessPolicy":"token-gated","refundPolicy":"Failed jobs qualify for verified refunds.","privateDeliveryAfterSettlement":true},"research-content":{"priceCentsPerCall":5,"recordsPerCall":3,"accessPolicy":"token-gated","refundPolicy":"Unavailable or improperly licensed content is not delivered and is eligible for review.","privateDeliveryAfterSettlement":true}},"x-answer-generator":{"path":"/api/x402/v2/answers","priceUsdc":0.02,"unit":"question","maxQuestionLength":4000,"quality":["answer","keyPoints","confidence","assumptions","limitations","citations","model"],"payment":"x402-v2-confirmed-before-generation"},"x-x402":{"version":2,"network":"eip155:8453","asset":"USDC","discovery":"bazaar-agentic-market","llmsTxt":"https://worxai.tech/llms.txt","manifest":"https://worxai.tech/api/x402/v2/manifest","endpointIndex":"https://worxai.tech/api/x402/v2/manifest#endpointIndex"}}