{"uid":"cap_hfO2wx4H4r8hpvODzu4nM","slug":"parallax-x402-economy-window-census-2fd8aa86","name":"Parallax x402 Economy Window Census","description":"Settler-frame census of the x402 economy for any UTC window: per-facilitator txs, USDC, buyers and sellers, the unattributed residual, breadth, and coverage computed from the scan manifest.","url":"https://parallax402.com/v1/window","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","const":"GET"},"queryParams":{"type":"object","required":["from","to"],"properties":{"to":{"type":"string","description":"last UTC day of the window, YYYY-MM-DD, EXCLUSIVE; at most 31 days and no later than today UTC (so the newest sellable day is yesterday)"},"from":{"type":"string","description":"first UTC day of the window, YYYY-MM-DD, inclusive"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type","format"],"properties":{"type":{"type":"string","const":"json"},"format":{"type":"string","const":"application/json","description":"the census envelope: as_of, frame, coverage, method, attribution, tier, and a fact carrying one row per day plus summed totals, the residual, the recomputed attributed share and the days that were missing"},"example":{"type":"object","description":"a worked response, shortened — the shape a full answer has"}},"additionalProperties":false}}},"responseSchema":{"type":"json","format":"application/json","example":{"fact":{"days":[{"day":"2026-08-25","totals":{"txs":12,"usdc":16447.693817,"purchases":15}}],"totals":{"txs":24,"usdc":32895.387634,"purchases":30},"days_missing":[],"attributed_share":{"txs":0.75,"usdc":0.999909}},"tier":"full","as_of":"2026-08-26","frame":"settler-eip3009-base","coverage":{"ok":86,"ratio":0.977273,"failed":2}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_57Hq_RoOQjrulIkz3ycrg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a settler-frame census of the x402 micropayment economy for a specified UTC date window, including per-facilitator transaction counts, USDC volume, buyer/seller counts, unattributed residual, breadth, and scan coverage.","exampleAgentPrompt":"Pull the Parallax settler-frame census for the x402 economy from June 1 to June 30, 2026 — I want to see the daily USDC volume, transaction counts, attributed share, and coverage ratio.","exampleUseCases":[{"title":"Monthly x402 economic health report","prompt":"Give me a full breakdown of x402 network activity for all of May 2026 — total USDC settled, transaction counts, how much is attributed vs residual, and whether any days had scan gaps."},{"title":"Weekly facilitator activity snapshot","prompt":"What did x402 facilitator activity look like last week, from July 14 to July 20, 2026? I want the per-day totals and the overall attributed share."},{"title":"Year-end x402 volume audit","prompt":"Run a 31-day Parallax census for December 1 through December 31, 2025 — I need the USDC totals, purchase counts, coverage ratio, and which days were missing from the scan manifest."}],"resultDescription":"A JSON envelope containing: an as_of timestamp, the settler frame identifier, a coverage object (ok count, failed count, ratio), attribution method, tier (e.g. 'full'), and a fact payload with one row per day (day, txs, USDC, purchases), summed totals across the window, a list of any missing days, the attributed share of txs and USDC, and the unattributed residual.","failureModes":["Date range exceeds 31 days — request rejected","'to' date is today or in the future — only yesterday and earlier are available","'from' or 'to' not in YYYY-MM-DD format — parse error","'from' is after 'to' — invalid window","Coverage ratio below 1.0 if some facilitator nodes failed during scan — partial data returned with failed count noted","Missing required query parameters — 400 error"],"whenToPreferThis":"Choose this endpoint when you need aggregate economic statistics for the x402 micropayment network over a multi-day window — particularly for trend analysis, reporting, auditing USDC flows, or monitoring network health over time. It is the canonical source for settler-frame census data derived from the x402 settlement graph, providing attribution and coverage metadata that raw blockchain queries lack. Prefer it over point-in-time or single-seller endpoints when the question is about macro-level network activity across all facilitators.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:40:08.909Z","isFirstParty":false}