{"openapi":"3.1.0","info":{"title":"WorxAI x402 Data Gateway","version":"2.0.0","description":"Synthetic dataset delivery for autonomous AI agents, paid via the x402 protocol in USDC on Base. 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.01 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"}],"paths":{"/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, and rejected-row report."}}}},"/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; free tier 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 — either as a free-trial grant or after a settled 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"},"freeTrial":{"type":"boolean"},"txHash":{"type":"string","nullable":true}}}}}},"402":{"description":"Payment required — free quota exhausted. Response body is an x402 v2 payment challenge; accepted payment options are also base64-encoded in the PAYMENT-REQUIRED header."}}}},"/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.01 minimum) — there is no free tier on this endpoint itself; the free tier 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"},"description":"Dataset category id, e.g. 'financial-markets', 'x402-agent-traces'. Unlisted names still generate a schema-inferred dataset."},{"name":"rows","in":"query","required":false,"schema":{"type":"integer","minimum":5,"maximum":1000000,"default":5}},{"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 — free quota exhausted."}}}},"/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.01},"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"}}