{ "openapi": "3.1.0", "info": { "title": "Parallax", "version": "0.1.0", "summary": "The x402 economy, measured: read from the settlement graph, stamped with frame and coverage.", "description": "Facts from the public x402 settlement graph on Base, both sides of every settlement: who pays whom, which payers are infrastructure, what a paying agent buys, and how much of a seller's traffic is organic. Readings are free; facts sell per query over x402.", "contact": { "email": "hello@parallax402.com" }, "x-guidance": "Parallax sells facts read from the public x402 settlement graph — who paid whom, which payers are infrastructure, what a paying agent buys, and how much of a seller's traffic is organic — and every paid response carries its frame, coverage ratio and method beside the number, with the dated readings behind that method free at https://parallax402.com/readings. Paid routes cost $0.005 to $0.05 per served fact, in USDC on Base or Solana — the same price on either rail. A paid route called with no argument answers 402 with the quote: accepts[] for both rails beside a free week-old preview of the same fact, so a caller can see the shape and a real value before paying. A call that names an argument and gets it wrong answers 400 with the parameter error before any payment is looked at and is not charged, and the fact is built before the payment is settled, so a call with no fact behind it is a 404 rather than a sale. There is no API key, no account, no registration and no minimum: the x402 payment is the whole authentication, and one settled request is a complete transaction. Live today: /v1/window, /v1/edge/parallax402, /v1/wallet, /v1/seller, /v1/basket; /v1/settlement/{txHash} is documented but not yet live and answers 501 with a link to a computed sample instead of a quote." }, "servers": [ { "url": "https://parallax402.com" } ], "paths": { "/readings": { "get": { "operationId": "readings", "summary": "Every reading, its method, and its data at a stable URL.", "description": "Free. HTML index, or JSON list of {id, catalog_no, title, date, frame, headline}", "security": [], "responses": { "200": { "description": "HTML index, or JSON list of {id, catalog_no, title, date, frame, headline}", "content": { "application/json": { "schema": { "type": "array" } } } } } } }, "/v1/settlement/{txHash}": { "get": { "operationId": "settlement", "summary": "Confirm an x402 settlement: facilitator, buyer, seller, amount, block, listing.", "description": "$0.005 per served fact, paid over x402 (exact scheme, Base or Solana USDC). First buyer: Routers verifying delivery. Agents confirming payment. Arbitration. Status: sample.", "security": [], "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" } }, "parameters": [ { "name": "txHash", "in": "path", "required": true, "description": "0x-prefixed 32-byte transaction hash on Base", "schema": { "type": "string" } } ], "responses": { "200": { "description": "the envelope carrying the fact", "content": { "application/json": { "schema": { "type": "object", "required": [ "as_of", "frame", "coverage", "method", "attribution", "fact", "tier" ], "properties": { "as_of": { "type": "string", "description": "ISO-8601 of the reading or scan the fact was computed from" }, "frame": { "type": "string", "enum": [ "bazaar-payto", "settler-eip3009-base" ] }, "coverage": { "type": "object", "description": "{ok, failed, ratio} from the scan manifest" }, "method": { "type": "string", "description": "path to the METHOD.md the numbers follow" }, "attribution": { "type": "array", "items": { "type": "string" } }, "fact": { "type": "object", "description": "is_x402: boolean — EIP-3009 authorization submitted by a known facilitator settler; facilitator: facilitator id or null; settler: submitting address; buyer: authorizer / Transfer from; seller: Transfer to; amount_usdc: number; block: integer; timestamp: ISO-8601; seller_listing: {hosts: [...], listed_price_match: boolean} or null" }, "tier": { "type": "string", "enum": [ "preview", "full" ], "description": "preview | full" } } }, "examples": { "sample": { "summary": "the full response, computed at build time from PLX-002", "value": { "as_of": "2026-09-01", "frame": "settler-eip3009-base", "coverage": { "ok": null, "failed": null, "ratio": null, "note": "single-transaction positive control, not a scan; no coverage ratio applies" }, "method": "docs/settler-feasibility.md", "attribution": [ "x402-list.com facilitator settler lists and daily figures (CC BY 4.0)", "CDP Bazaar discovery API (public)" ], "fact": { "is_x402": true, "facilitator": "coinbase", "settler": "0x14fda13953fc30428938e6bf950d036e77214e52", "buyer": "0x908ee74710870b12ea873185d4828c52778b8d2e", "seller": "0x942bd3e3073543c674efc0c378d5bce20f9120c1", "amount_usdc": 10.0, "block": 50481532, "seller_listing": { "listed_price_match": true, "source": "selector-audit.json big[0], Bazaar frame 2026-09-01" } }, "tier": "full", "_sample": { "computed_from": "readings/2026-09-01-buyer-census/settlement-control.json", "reading": "PLX-002", "fields_pending": [ "timestamp" ], "note": "Block timestamp was not captured by the control. seller_listing carries listed_price_match but not the hosts array." } } } } } } }, "402": { "description": "payment required — the x402 envelope in the v1 body and the v2 PAYMENT-REQUIRED header. accepts[] carries one entry per rail: Base or Solana USDC, same price on either. The body also carries 'preview': the same envelope at tier preview — week-old, headline aggregates of the same fact (exact numbers, preview_fields only), returned free in the 402 body. Sample: https://parallax402.com/samples/settlement.preview.json", "content": { "application/json": { "schema": { "type": "object", "required": [ "x402Version", "accepts", "preview" ] }, "examples": { "sample": { "summary": "the 402 body: accepts[] beside the free preview", "value": { "x402Version": 1, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "maxAmountRequired": "5000", "resource": "https://parallax402.com/v1/settlement/0x2f7f6dd9b6ca726228111a0b444bdb06a0d6539c91451a47f4a6a3f59aa5af51", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x790fE337b89900028E16fE63Cc087112F7a2BA49", "outputSchema": { "input": { "discoverable": true } } }, { "scheme": "exact", "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "maxAmountRequired": "5000", "resource": "https://parallax402.com/v1/settlement/0x2f7f6dd9b6ca726228111a0b444bdb06a0d6539c91451a47f4a6a3f59aa5af51", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "payTo": "DMrJUdvmorbEXx8pA4R8yZ9kPfH3pUanCGxoG5AoPuTC", "outputSchema": { "input": { "discoverable": true } } } ], "preview": { "as_of": "2026-09-01", "frame": "settler-eip3009-base", "coverage": { "ok": null, "failed": null, "ratio": null, "note": "single-transaction positive control, not a scan; no coverage ratio applies" }, "method": "docs/settler-feasibility.md", "attribution": [ "x402-list.com facilitator settler lists and daily figures (CC BY 4.0)", "CDP Bazaar discovery API (public)" ], "fact": { "is_x402": true, "facilitator": "coinbase", "amount_usdc": 10.0, "block": 50481532 }, "tier": "preview", "stale_by": "≥7 days at serve time", "_sample": { "computed_from": "readings/2026-09-01-buyer-census/settlement-control.json", "reading": "PLX-002", "fields_pending": [], "note": "Block timestamp was not captured by the control. seller_listing carries listed_price_match but not the hosts array." } } } } } } } }, "400": { "description": "malformed input: not served, not charged" } } } }, "/v1/window": { "get": { "operationId": "window", "summary": "Census any UTC window: per-facilitator purchases, USDC, buyers, sellers, residual, breadth, coverage.", "description": "$0.01 per served fact, paid over x402 (exact scheme, Base or Solana USDC). First buyer: Anyone quoting agent-economy numbers. Status: live.", "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.01" } }, "parameters": [ { "name": "from", "in": "query", "required": true, "description": "ISO date (UTC)", "schema": { "type": "string" } }, { "name": "to", "in": "query", "required": true, "description": "ISO date (UTC), exclusive", "schema": { "type": "string" } } ], "responses": { "200": { "description": "the envelope carrying the fact", "content": { "application/json": { "schema": { "type": "object", "required": [ "as_of", "frame", "coverage", "method", "attribution", "fact", "tier" ], "properties": { "as_of": { "type": "string", "description": "ISO-8601 of the reading or scan the fact was computed from" }, "frame": { "type": "string", "enum": [ "bazaar-payto", "settler-eip3009-base" ] }, "coverage": { "type": "object", "description": "{ok, failed, ratio} from the scan manifest" }, "method": { "type": "string", "description": "path to the METHOD.md the numbers follow" }, "attribution": { "type": "array", "items": { "type": "string" } }, "fact": { "type": "object", "description": "facilitators: {id: {txs, purchases, usdc, fees, buyers, sellers}}; unattributed: {txs, purchases, usdc, fees, buyers, sellers}; totals: {txs, purchases, usdc, fees, buyers, sellers}; attributed_share: {txs, usdc}; breadth: {buyers_ge2_sellers, buyers_ge2_facilitators, sellers_ge2_facilitators}; top_sellers: [{t, usdc, purchases, buyers, facilitators}]" }, "tier": { "type": "string", "enum": [ "preview", "full" ], "description": "preview | full" } } }, "examples": { "sample": { "summary": "the full response, computed at build time from PLX-003", "value": { "as_of": "2026-08-31", "frame": "settler-eip3009-base", "coverage": { "ok": 44, "failed": 0, "ratio": 1.0 }, "method": "readings/2026-08-31-settler-frame/METHOD.md", "attribution": [ "x402-list.com facilitator settler lists and daily figures (CC BY 4.0)", "CDP Bazaar discovery API (public)" ], "fact": { "facilitators": { "agentdata": { "txs": 5, "purchases": 5, "usdc": 0.015, "fees": 0.0, "buyers": 1, "sellers": 1 }, "coinbase": { "txs": 72246, "purchases": 72246, "usdc": 8995.887533, "fees": 0.0, "buyers": 1574, "sellers": 716 }, "daydreams": { "txs": 22, "purchases": 22, "usdc": 0.32, "fees": 0.0, "buyers": 5, "sellers": 2 }, "fluxa": { "txs": 12655, "purchases": 12655, "usdc": 7450.306284, "fees": 0.0, "buyers": 623, "sellers": 418 }, "mogami": { "txs": 4, "purchases": 4, "usdc": 9.052516, "fees": 0.0, "buyers": 3, "sellers": 2 }, "mrdn": { "txs": 268, "purchases": 268, "usdc": 6760.234134, "fees": 67.60221, "buyers": 8, "sellers": 9 }, "openx402": { "txs": 17, "purchases": 17, "usdc": 15.015, "fees": 0.0, "buyers": 2, "sellers": 3 }, "payAI": { "txs": 1623, "purchases": 1623, "usdc": 7905.519304, "fees": 0.0, "buyers": 77, "sellers": 50 }, "polymer": { "txs": 190, "purchases": 190, "usdc": 19.0, "fees": 0.0, "buyers": 1, "sellers": 1 }, "primer": { "txs": 200, "purchases": 200, "usdc": 51.316641, "fees": 0.0, "buyers": 41, "sellers": 10 }, "solvador": { "txs": 1, "purchases": 1, "usdc": 1.0, "fees": 0.0, "buyers": 1, "sellers": 1 }, "thirdweb": { "txs": 3, "purchases": 6, "usdc": 1.19357, "fees": 0.00357, "buyers": 4, "sellers": 2 }, "ultravioletadao": { "txs": 8, "purchases": 8, "usdc": 0.17, "fees": 0.0, "buyers": 7, "sellers": 2 } }, "unattributed": { "txs": 12595, "purchases": 16914, "usdc": 1361611.281592, "fees": 2540.869776, "buyers": 2118, "sellers": 1067 }, "totals": { "txs": 99837, "purchases": 104159, "usdc": 1392820.311574, "fees": 2608.475556, "buyers": 4382, "sellers": 2272 }, "attributed_share": { "txs": 0.873844, "usdc": 0.022407 }, "breadth": { "buyers_ge2_sellers": 451, "buyers_ge2_facilitators": 29, "sellers_ge2_facilitators": 6 }, "top_sellers": [ { "t": "0x47c5d3fc37f66f7cbf450bd3ea912b0765104fc3", "usdc": 191665.82, "purchases": 1830, "buyers": 481, "facilitators": [] }, { "t": "0xdedb92c76eb38c15b0fdca2b49a5ed56aec54455", "usdc": 144447.566234, "purchases": 5, "buyers": 3, "facilitators": [] }, { "t": "0xa54dc4425190570cb5c841adf445bbecf3b249f5", "usdc": 63754.953908, "purchases": 7, "buyers": 1, "facilitators": [] }, { "t": "0xbf91ea97b3e7307112e2d49421bf8afeaa5f7551", "usdc": 50941.406612, "purchases": 2, "buyers": 1, "facilitators": [] }, { "t": "0xdf629f54b7aca2044a22aab61e23b492187c30ee", "usdc": 49750.32, "purchases": 42, "buyers": 4, "facilitators": [] }, { "t": "0x8a474fd1b929306a6827630aefeade443128ec68", "usdc": 35675.655678, "purchases": 1, "buyers": 1, "facilitators": [] }, { "t": "0x0bfa625da669398fef9654c9341b9aee1251b56c", "usdc": 33151.54, "purchases": 3, "buyers": 3, "facilitators": [] }, { "t": "0x3b6db380305e57076a25621d8de6b6a51a148976", "usdc": 31843.979517, "purchases": 1, "buyers": 1, "facilitators": [] }, { "t": "0x2fc617e933a52713247ce25730f6695920b3befe", "usdc": 22445.37776, "purchases": 28, "buyers": 21, "facilitators": [] }, { "t": "0x7dbb4bdcfe614398d1a68ecc219f15280d0959e0", "usdc": 22215.693832, "purchases": 43, "buyers": 31, "facilitators": [] }, { "t": "0xc1483208e740f6fc70eb924e00708ab2e1ec3515", "usdc": 20552.320252, "purchases": 104, "buyers": 68, "facilitators": [] }, { "t": "0xee715613fd314c5c79994f34a9bac7c34184fb2b", "usdc": 20489.288106, "purchases": 3, "buyers": 1, "facilitators": [] }, { "t": "0x388ee46831eae3ef13c5032fb3139b92c29956df", "usdc": 20000.0, "purchases": 1, "buyers": 1, "facilitators": [] }, { "t": "0xaaa19ef515ecfa261b316f971c3ff85b3fefb3e5", "usdc": 20000.0, "purchases": 2, "buyers": 1, "facilitators": [] }, { "t": "0x679db66b8b7df32b0bb07e778229f01fbcc8a4e2", "usdc": 18500.0, "purchases": 1, "buyers": 1, "facilitators": [] }, { "t": "0x47923a759cf333a95221cc91b36b7d1c6721d9ab", "usdc": 18078.409027, "purchases": 1, "buyers": 1, "facilitators": [] }, { "t": "0x13314732ccd0268f694f09d66dbd2b2b078263c6", "usdc": 17761.796092, "purchases": 1, "buyers": 1, "facilitators": [] }, { "t": "0x9f1aae2d78a7a3fb58a581e25f563a73b3b72292", "usdc": 16908.46, "purchases": 1, "buyers": 1, "facilitators": [] }, { "t": "0x4cd00e387622c35bddb9b4c962c136462338bc31", "usdc": 16895.680365, "purchases": 182, "buyers": 16, "facilitators": [] }, { "t": "0x9a32f27ff65dbbba4264e67d216465182fb54308", "usdc": 15100.0, "purchases": 1, "buyers": 1, "facilitators": [] } ] }, "tier": "full", "_sample": { "computed_from": "readings/2026-08-31-settler-frame/settler-census.json", "reading": "PLX-003", "fields_pending": [], "note": "Fact taken verbatim from the settler-frame census; coverage is computed from that scan's persisted chunk manifest." } } } } } } }, "402": { "description": "payment required — the x402 envelope in the v1 body and the v2 PAYMENT-REQUIRED header. accepts[] carries one entry per rail: Base or Solana USDC, same price on either. The body also carries 'preview': the same envelope at tier preview — week-old, headline aggregates of the same fact (exact numbers, preview_fields only), returned free in the 402 body. Sample: https://parallax402.com/samples/window.preview.json", "content": { "application/json": { "schema": { "type": "object", "required": [ "x402Version", "accepts", "preview" ] }, "examples": { "sample": { "summary": "the 402 body: accepts[] beside the free preview", "value": { "x402Version": 1, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "maxAmountRequired": "10000", "resource": "https://parallax402.com/v1/window?from=2026-08-25&to=2026-09-01", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x790fE337b89900028E16fE63Cc087112F7a2BA49", "outputSchema": { "input": { "discoverable": true } } }, { "scheme": "exact", "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "maxAmountRequired": "10000", "resource": "https://parallax402.com/v1/window?from=2026-08-25&to=2026-09-01", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "payTo": "DMrJUdvmorbEXx8pA4R8yZ9kPfH3pUanCGxoG5AoPuTC", "outputSchema": { "input": { "discoverable": true } } } ], "preview": { "as_of": "2026-08-31", "frame": "settler-eip3009-base", "coverage": { "ok": 44, "failed": 0, "ratio": 1.0 }, "method": "readings/2026-08-31-settler-frame/METHOD.md", "attribution": [ "x402-list.com facilitator settler lists and daily figures (CC BY 4.0)", "CDP Bazaar discovery API (public)" ], "fact": { "totals": { "txs": 99837, "purchases": 104159, "usdc": 1392820.311574, "fees": 2608.475556, "buyers": 4382, "sellers": 2272 }, "attributed_share": { "txs": 0.873844, "usdc": 0.022407 } }, "tier": "preview", "stale_by": "≥7 days at serve time", "_sample": { "computed_from": "readings/2026-08-31-settler-frame/settler-census.json", "reading": "PLX-003", "fields_pending": [], "note": "Fact taken verbatim from the settler-frame census; coverage is computed from that scan's persisted chunk manifest." } } } } } } } }, "400": { "description": "malformed input: not served, not charged" } } } }, "/v1/edge/parallax402": { "get": { "operationId": "edge", "summary": "Our own funnel: 402 challenges, crawlers, window shoppers and payers on parallax402.com, by day.", "description": "$0.015 per served fact, paid over x402 (exact scheme, Base or Solana USDC). First buyer: Sellers benchmarking their funnel. Anyone sizing the never-pay layer. Status: live.", "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.015" } }, "parameters": [ { "name": "day", "in": "query", "required": true, "description": "UTC date; default = newest computed day", "schema": { "type": "string" } } ], "responses": { "200": { "description": "the envelope carrying the fact", "content": { "application/json": { "schema": { "type": "object", "required": [ "as_of", "frame", "coverage", "method", "attribution", "fact", "tier" ], "properties": { "as_of": { "type": "string", "description": "ISO-8601 of the reading or scan the fact was computed from" }, "frame": { "type": "string", "enum": [ "bazaar-payto", "settler-eip3009-base" ] }, "coverage": { "type": "object", "description": "{ok, failed, ratio} from the scan manifest" }, "method": { "type": "string", "description": "path to the METHOD.md the numbers follow" }, "attribution": { "type": "array", "items": { "type": "string" } }, "fact": { "type": "object", "description": "day: ISO date; challenges: integer 402s served; paid: integer settled, house settlements excluded; paid_house: integer settled by the house's own drill wallets; never counted as demand; crawlers: integer requests from self-identified monitors/probers/crawlers; window_shoppers: integer callers that took a quote that day and paid nothing; by_ua_class: [{class, requests, paid}]; by_route: [{route, challenges, paid, paid_house}]; by_rail: [{rail, paid}]; rejected: [{reason, n}] — payments presented and refused; free_requests: integer requests served free (the discovery surfaces); requests_total: integer requests, every outcome; ua_class_method: how ua_class is derived, published next to the counts" }, "tier": { "type": "string", "enum": [ "preview", "full" ], "description": "preview | full" } } }, "examples": { "sample": { "summary": "the full response, computed at build time from no reading yet", "value": { "as_of": null, "frame": "parallax402-edge", "coverage": { "ok": null, "failed": null, "ratio": null, "note": "server-side capture on every request since 2026-09-02 05:20 UTC; no sampling" }, "method": "docs/ENDPOINTS.md", "attribution": [ "x402-list.com facilitator settler lists and daily figures (CC BY 4.0)", "CDP Bazaar discovery API (public)" ], "fact": {}, "tier": "preview", "_sample": { "computed_from": null, "reading": null, "fields_pending": [ "day", "challenges", "paid", "paid_house", "crawlers", "window_shoppers", "by_ua_class", "by_route", "by_rail", "rejected", "free_requests", "requests_total", "ua_class_method" ], "note": "Live route, no dated fact yet: the daily cron publishes the first complete UTC day (2026-09-03) at 01:25 UTC on 2026-09-04. Counts only — never ids or addresses." } } } } } } }, "402": { "description": "payment required — the x402 envelope in the v1 body and the v2 PAYMENT-REQUIRED header. accepts[] carries one entry per rail: Base or Solana USDC, same price on either. The body also carries 'preview': the same envelope at tier preview — week-old headline counts of the same funnel (challenges, paid, crawlers, window_shoppers), exact, returned free in the 402 body. The first complete UTC day is 2026-09-03: server-side capture began mid-day on 2026-09-02, so that partial day is never published.. Sample: https://parallax402.com/samples/edge.preview.json", "content": { "application/json": { "schema": { "type": "object", "required": [ "x402Version", "accepts", "preview" ] }, "examples": { "sample": { "summary": "the 402 body: accepts[] beside the free preview", "value": { "x402Version": 1, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "maxAmountRequired": "15000", "resource": "https://parallax402.com/v1/edge/parallax402", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x790fE337b89900028E16fE63Cc087112F7a2BA49", "outputSchema": { "input": { "discoverable": true } } }, { "scheme": "exact", "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "maxAmountRequired": "15000", "resource": "https://parallax402.com/v1/edge/parallax402", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "payTo": "DMrJUdvmorbEXx8pA4R8yZ9kPfH3pUanCGxoG5AoPuTC", "outputSchema": { "input": { "discoverable": true } } } ], "preview": { "as_of": null, "frame": "parallax402-edge", "coverage": { "ok": null, "failed": null, "ratio": null, "note": "server-side capture on every request since 2026-09-02 05:20 UTC; no sampling" }, "method": "docs/ENDPOINTS.md", "attribution": [ "x402-list.com facilitator settler lists and daily figures (CC BY 4.0)", "CDP Bazaar discovery API (public)" ], "fact": {}, "tier": "preview", "stale_by": "≥7 days at serve time", "_sample": { "computed_from": null, "reading": null, "fields_pending": [ "challenges", "paid", "crawlers", "window_shoppers" ], "note": "Live route, no dated fact yet: the daily cron publishes the first complete UTC day (2026-09-03) at 01:25 UTC on 2026-09-04. Counts only — never ids or addresses." } } } } } } } }, "400": { "description": "malformed input: not served, not charged" } } } }, "/v1/wallet": { "get": { "operationId": "wallet", "summary": "Label a payer — organic, operator, infra-caller, self-test, unseen — with evidence, spend, cadence, basket.", "description": "$0.02 per served fact, paid over x402 (exact scheme, Base or Solana USDC). First buyer: Routers. Sellers vetting a payer. Diligence. Status: live. Path alias: GET /v1/wallet/{address} — the same call with the argument in the path; same validation, same fact, same price.", "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.02" } }, "parameters": [ { "name": "address", "in": "query", "required": true, "description": "0x-prefixed 20-byte address", "schema": { "type": "string" } } ], "responses": { "200": { "description": "the envelope carrying the fact", "content": { "application/json": { "schema": { "type": "object", "required": [ "as_of", "frame", "coverage", "method", "attribution", "fact", "tier" ], "properties": { "as_of": { "type": "string", "description": "ISO-8601 of the reading or scan the fact was computed from" }, "frame": { "type": "string", "enum": [ "bazaar-payto", "settler-eip3009-base" ] }, "coverage": { "type": "object", "description": "{ok, failed, ratio} from the scan manifest" }, "method": { "type": "string", "description": "path to the METHOD.md the numbers follow" }, "attribution": { "type": "array", "items": { "type": "string" } }, "fact": { "type": "object", "description": "label: organic | operator | self-test | unseen (infra-caller needs edge data and is never emitted by this chain-only route); confidence: 0..1; evidence: [strings]; first_seen: ISO-8601; last_seen: ISO-8601; usdc: number; purchases: integer; sellers_paid: integer; facilitators: [ids]; cadence: cron | crawler | loyal-worker | sampler | one-shot | mixed; active_days: integer of window days; basket: [{seller, usdc, purchases, category}] top 5; operator_cluster: {wallets: [...], jaccard: number} or null" }, "tier": { "type": "string", "enum": [ "preview", "full" ], "description": "preview | full" } } }, "examples": { "sample": { "summary": "the full response, computed at build time from PLX-002", "value": { "as_of": "2026-09-01T17:14:00Z", "frame": "bazaar-payto", "coverage": { "ok": null, "failed": null, "ratio": null, "note": "Reading #2 predates the persisted manifest; coverage is computed from Reading #3 on" }, "method": "readings/2026-09-01-buyer-census/METHOD.md", "attribution": [ "x402-list.com facilitator settler lists and daily figures (CC BY 4.0)", "CDP Bazaar discovery API (public)" ], "fact": { "address_prefix": "0xa39c469c", "purchases": 27350, "sellers_paid": 1, "usdc": 164.081, "cadence": "loyal-worker", "active_days": 8 }, "tier": "full", "_sample": { "computed_from": "readings/2026-09-01-buyer-census/market-data.json", "reading": "PLX-002", "fields_pending": [ "label", "confidence", "evidence", "first_seen", "last_seen", "facilitators", "basket", "operator_cluster" ], "note": "address_prefix is a TRUNCATED identifier: Reading #2 publishes an 8-hex-digit prefix, not the full address. The live route keys on the full address." } } } } } } }, "402": { "description": "payment required — the x402 envelope in the v1 body and the v2 PAYMENT-REQUIRED header. accepts[] carries one entry per rail: Base or Solana USDC, same price on either. The body also carries 'preview': the same envelope at tier preview — week-old, headline aggregates of the same fact (exact numbers, preview_fields only), returned free in the 402 body. Sample: https://parallax402.com/samples/wallet.preview.json", "content": { "application/json": { "schema": { "type": "object", "required": [ "x402Version", "accepts", "preview" ] }, "examples": { "sample": { "summary": "the 402 body: accepts[] beside the free preview", "value": { "x402Version": 1, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "maxAmountRequired": "20000", "resource": "https://parallax402.com/v1/wallet", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x790fE337b89900028E16fE63Cc087112F7a2BA49", "outputSchema": { "input": { "discoverable": true } } }, { "scheme": "exact", "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "maxAmountRequired": "20000", "resource": "https://parallax402.com/v1/wallet", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "payTo": "DMrJUdvmorbEXx8pA4R8yZ9kPfH3pUanCGxoG5AoPuTC", "outputSchema": { "input": { "discoverable": true } } } ], "preview": { "as_of": "2026-09-01T17:14:00Z", "frame": "bazaar-payto", "coverage": { "ok": null, "failed": null, "ratio": null, "note": "Reading #2 predates the persisted manifest; coverage is computed from Reading #3 on" }, "method": "readings/2026-09-01-buyer-census/METHOD.md", "attribution": [ "x402-list.com facilitator settler lists and daily figures (CC BY 4.0)", "CDP Bazaar discovery API (public)" ], "fact": { "usdc": 164.081, "purchases": 27350, "sellers_paid": 1 }, "tier": "preview", "stale_by": "≥7 days at serve time", "_sample": { "computed_from": "readings/2026-09-01-buyer-census/market-data.json", "reading": "PLX-002", "fields_pending": [ "label", "confidence" ], "note": "address_prefix is a TRUNCATED identifier: Reading #2 publishes an 8-hex-digit prefix, not the full address. The live route keys on the full address." } } } } } } } }, "400": { "description": "malformed input: not served, not charged" } } } }, "/v1/seller": { "get": { "operationId": "seller", "summary": "Your funnel, honestly: purchases, buyers, organic share, retention, facilitator mix, and the gap to the Bazaar counter.", "description": "$0.03 per served fact, paid over x402 (exact scheme, Base or Solana USDC). First buyer: Sellers. Investors. Status: live. Path alias: GET /v1/seller/{addressOrHost} — the same call with the argument in the path; same validation, same fact, same price.", "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.03" } }, "parameters": [ { "name": "seller", "in": "query", "required": true, "description": "payTo address or hostname", "schema": { "type": "string" } } ], "responses": { "200": { "description": "the envelope carrying the fact", "content": { "application/json": { "schema": { "type": "object", "required": [ "as_of", "frame", "coverage", "method", "attribution", "fact", "tier" ], "properties": { "as_of": { "type": "string", "description": "ISO-8601 of the reading or scan the fact was computed from" }, "frame": { "type": "string", "enum": [ "bazaar-payto", "settler-eip3009-base" ] }, "coverage": { "type": "object", "description": "{ok, failed, ratio} from the scan manifest" }, "method": { "type": "string", "description": "path to the METHOD.md the numbers follow" }, "attribution": { "type": "array", "items": { "type": "string" } }, "fact": { "type": "object", "description": "payTo: address; hosts: [hostnames sharing the wallet]; usdc: number; purchases: integer; buyers: integer; organic_share: 0..1 of buyers after exclusions; recurring_buyers: integer active on >=4 of 8 days; half_life_days: number; facilitators: {id: share}; catalogue_delta: {bazaar_calls_30d, chain_purchases_30d, ratio}; category: string" }, "tier": { "type": "string", "enum": [ "preview", "full" ], "description": "preview | full" } } }, "examples": { "sample": { "summary": "the full response, computed at build time from PLX-002", "value": { "as_of": "2026-09-01T17:14:00Z", "frame": "bazaar-payto", "coverage": { "ok": null, "failed": null, "ratio": null, "note": "Reading #2 predates the persisted manifest; coverage is computed from Reading #3 on" }, "method": "readings/2026-09-01-buyer-census/METHOD.md", "attribution": [ "x402-list.com facilitator settler lists and daily figures (CC BY 4.0)", "CDP Bazaar discovery API (public)" ], "fact": { "hosts": [ "api.onesource.io" ], "usdc": 15.09, "purchases": 3740, "buyers": 444, "category": "chain data" }, "tier": "full", "_sample": { "computed_from": "readings/2026-09-01-buyer-census/market-data.json", "reading": "PLX-002", "fields_pending": [ "payTo", "organic_share", "recurring_buyers", "half_life_days", "facilitators", "catalogue_delta" ], "note": "Reading #2 aggregates by payTo wallet and labels shared wallets '+N hosts'; this row is a single-host wallet." } } } } } } }, "402": { "description": "payment required — the x402 envelope in the v1 body and the v2 PAYMENT-REQUIRED header. accepts[] carries one entry per rail: Base or Solana USDC, same price on either. The body also carries 'preview': the same envelope at tier preview — week-old, headline aggregates of the same fact (exact numbers, preview_fields only), returned free in the 402 body. Sample: https://parallax402.com/samples/seller.preview.json", "content": { "application/json": { "schema": { "type": "object", "required": [ "x402Version", "accepts", "preview" ] }, "examples": { "sample": { "summary": "the 402 body: accepts[] beside the free preview", "value": { "x402Version": 1, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "maxAmountRequired": "30000", "resource": "https://parallax402.com/v1/seller", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x790fE337b89900028E16fE63Cc087112F7a2BA49", "outputSchema": { "input": { "discoverable": true } } }, { "scheme": "exact", "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "maxAmountRequired": "30000", "resource": "https://parallax402.com/v1/seller", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "payTo": "DMrJUdvmorbEXx8pA4R8yZ9kPfH3pUanCGxoG5AoPuTC", "outputSchema": { "input": { "discoverable": true } } } ], "preview": { "as_of": "2026-09-01T17:14:00Z", "frame": "bazaar-payto", "coverage": { "ok": null, "failed": null, "ratio": null, "note": "Reading #2 predates the persisted manifest; coverage is computed from Reading #3 on" }, "method": "readings/2026-09-01-buyer-census/METHOD.md", "attribution": [ "x402-list.com facilitator settler lists and daily figures (CC BY 4.0)", "CDP Bazaar discovery API (public)" ], "fact": { "usdc": 15.09, "purchases": 3740, "buyers": 444 }, "tier": "preview", "stale_by": "≥7 days at serve time", "_sample": { "computed_from": "readings/2026-09-01-buyer-census/market-data.json", "reading": "PLX-002", "fields_pending": [], "note": "Reading #2 aggregates by payTo wallet and labels shared wallets '+N hosts'; this row is a single-host wallet." } } } } } } } }, "400": { "description": "malformed input: not served, not charged" } } } }, "/v1/basket": { "get": { "operationId": "basket", "summary": "Where your buyers' money goes next: co-sellers, shared buyers, lift, categories.", "description": "$0.05 per served fact, paid over x402 (exact scheme, Base or Solana USDC). First buyer: Sellers positioning. Routers bundling. Status: live. Path alias: GET /v1/basket/{addressOrHost} — the same call with the argument in the path; same validation, same fact, same price.", "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.05" } }, "parameters": [ { "name": "seller", "in": "query", "required": true, "description": "payTo address or hostname", "schema": { "type": "string" } } ], "responses": { "200": { "description": "the envelope carrying the fact", "content": { "application/json": { "schema": { "type": "object", "required": [ "as_of", "frame", "coverage", "method", "attribution", "fact", "tier" ], "properties": { "as_of": { "type": "string", "description": "ISO-8601 of the reading or scan the fact was computed from" }, "frame": { "type": "string", "enum": [ "bazaar-payto", "settler-eip3009-base" ] }, "coverage": { "type": "object", "description": "{ok, failed, ratio} from the scan manifest" }, "method": { "type": "string", "description": "path to the METHOD.md the numbers follow" }, "attribution": { "type": "array", "items": { "type": "string" } }, "fact": { "type": "object", "description": "buyers: integer; multi_seller_share: 0..1 of this seller's buyers who also pay others; co_sellers: [{seller, shared_buyers, lift, category}] top 10; categories: [{category, usdc_share}]" }, "tier": { "type": "string", "enum": [ "preview", "full" ], "description": "preview | full" } } }, "examples": { "sample": { "summary": "the full response, computed at build time from PLX-002", "value": { "as_of": "2026-09-01T17:14:00Z", "frame": "bazaar-payto", "coverage": { "ok": null, "failed": null, "ratio": null, "note": "Reading #2 predates the persisted manifest; coverage is computed from Reading #3 on" }, "method": "readings/2026-09-01-buyer-census/METHOD.md", "attribution": [ "x402-list.com facilitator settler lists and daily figures (CC BY 4.0)", "CDP Bazaar discovery API (public)" ], "fact": { "scope": "market", "wallets": 400, "multi_seller_share_market": 0.3975 }, "tier": "full", "_sample": { "computed_from": "readings/2026-09-01-buyer-census/market-data.json", "reading": "PLX-002", "fields_pending": [ "buyers", "multi_seller_share", "co_sellers", "categories" ], "note": "Market-level only: Reading #2 holds NO per-seller co-purchase edges. The share is over the 400 wallets in the reading's scatter, a subset of its 1817 payers." } } } } } } }, "402": { "description": "payment required — the x402 envelope in the v1 body and the v2 PAYMENT-REQUIRED header. accepts[] carries one entry per rail: Base or Solana USDC, same price on either. The body also carries 'preview': the same envelope at tier preview — week-old, headline aggregates of the same fact (exact numbers, preview_fields only), returned free in the 402 body. Sample: https://parallax402.com/samples/basket.preview.json", "content": { "application/json": { "schema": { "type": "object", "required": [ "x402Version", "accepts", "preview" ] }, "examples": { "sample": { "summary": "the 402 body: accepts[] beside the free preview", "value": { "x402Version": 1, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "maxAmountRequired": "50000", "resource": "https://parallax402.com/v1/basket", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x790fE337b89900028E16fE63Cc087112F7a2BA49", "outputSchema": { "input": { "discoverable": true } } }, { "scheme": "exact", "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "maxAmountRequired": "50000", "resource": "https://parallax402.com/v1/basket", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "payTo": "DMrJUdvmorbEXx8pA4R8yZ9kPfH3pUanCGxoG5AoPuTC", "outputSchema": { "input": { "discoverable": true } } } ], "preview": { "as_of": "2026-09-01T17:14:00Z", "frame": "bazaar-payto", "coverage": { "ok": null, "failed": null, "ratio": null, "note": "Reading #2 predates the persisted manifest; coverage is computed from Reading #3 on" }, "method": "readings/2026-09-01-buyer-census/METHOD.md", "attribution": [ "x402-list.com facilitator settler lists and daily figures (CC BY 4.0)", "CDP Bazaar discovery API (public)" ], "fact": {}, "tier": "preview", "stale_by": "≥7 days at serve time", "_sample": { "computed_from": "readings/2026-09-01-buyer-census/market-data.json", "reading": "PLX-002", "fields_pending": [ "buyers", "multi_seller_share" ], "note": "Market-level only: Reading #2 holds NO per-seller co-purchase edges. The share is over the 400 wallets in the reading's scatter, a subset of its 1817 payers." } } } } } } } }, "400": { "description": "malformed input: not served, not charged" } } } } }, "x-x402": { "version": 2, "scheme": "exact", "rails": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x790fE337b89900028E16fE63Cc087112F7a2BA49" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "DMrJUdvmorbEXx8pA4R8yZ9kPfH3pUanCGxoG5AoPuTC" } ], "payTo_note": "receive-only CDP server accounts (parallax-evm-payto / parallax-solana-payto, created 2026-09-02); keys custodied by CDP, never in this repo", "discovery": "https://parallax402.com/.well-known/x402", "prices": { "/v1/settlement/{txHash}": "5000", "/v1/window": "10000", "/v1/edge/parallax402": "15000", "/v1/wallet": "20000", "/v1/seller": "30000", "/v1/basket": "50000" }, "tiers": { "preview": { "price": "free", "cadence": "≥7 days old, refreshed with the weekly reading", "fidelity": "high-level aggregates only — totals, counts, shares, exact as measured; no per-entity rows, lists, cohorts or derived stats", "served": "inside the 402 body, the weekly reading, /v1/stats" }, "full": { "price": "per endpoint", "cadence": "≤24h old, daily scan", "fidelity": "granular and derived — per-entity rows, full lists, cohorts, retention, baskets, facilitator splits, any UTC window", "served": "the paid response" }, "note": "Agents pay for recency and granularity. The unpaid 402 carries last week's headline aggregates next to accepts[], so the preview is the lead-in." }, "rules": [ "A number never ships without frame and coverage.", "Every envelope says tier: preview or full. A preview is never served as the fact.", "'unseen' is a served fact and is charged; malformed input is not served and not charged.", "No 'all' or 'every' over data with coverage ratio below 1.", "Prices are unique on the sheet so a settlement attributes to its endpoint by amount alone.", "An endpoint goes live when a published reading produces an inbound request for that fact, not before." ] } }