{"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 and Gabriel 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 50 free rows total across up to 5 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/gabriel for the fastest path: one free-text `need` param, one response, no catalog lookup required.","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":[{"id":"synthetic-event-streams","endpoint":"/api/x402/v2/gabriel","query":{"need":"synthetic event telemetry","rows":50},"access":"free-tier-then-x402"},{"id":"financial-data-validation","endpoint":"/api/x402/v2/gabriel","query":{"need":"financial data validation","rows":50},"access":"free-tier-then-x402"}],"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/gabriel":{"get":{"summary":"Match a free-text need to a dataset and deliver rows in one response","description":"The fastest path to data: describe what you need in plain text and Gabriel matches it instantly to an exact or inferred schema, returning generated rows directly in this response. No second fetch, no catalog browsing required.","operationId":"gabrielFetch","tags":["Google Cloud datasets","x402 payment gateway"],"x-google-cloud-operation":{"extensionType":"vertex-ai","datasetAccess":"synthetic public data; paid x402 access then x402"},"parameters":[{"name":"need","in":"query","required":true,"schema":{"type":"string"},"description":"Free-text description of the dataset you need, e.g. 'financial markets', 'iot sensor telemetry', 'checkout conversion rates'. Any description works — known categories match exactly, anything else is schema-inferred."},{"name":"rows","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000000,"default":5},"description":"Number of synthetic rows to generate. Price scales with row count once the free quota is used."},{"name":"wallet","in":"query","required":false,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"description":"Your EVM wallet address, used to track your free-tier quota by wallet instead of IP. Optional but recommended if you plan to pay later from this address."}],"responses":{"200":{"description":"Rows delivered after a settled x402 payment.","content":{"application/json":{"schema":{"type":"object","properties":{"signal":{"type":"string"},"matchedCategory":{"type":"string"},"rows":{"type":"integer"},"records":{"type":"array","items":{"type":"object"}},"paid":{"type":"boolean"},"txHash":{"type":"string","nullable":true}}}}}},"402":{"description":"Payment required — x402 payment is required for every delivery. Read the PAYMENT-REQUIRED header and submit an x402 payment before retrying."}}}},"/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; the paid x402 access is on /datasets/detail and /gabriel.","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 or free-trial a specific dataset category","description":"Generates and delivers rows for a given category id on demand. Every agent gets 50 free rows total across up to 5 calls (tracked by wallet or IP) before payment is required.","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":50,"callsPerAgent":5,"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":1,"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"}}