x402 data feeds
Factline probes every x402 seller in the Coinbase Bazaar and Circle catalogues each night and every public facilitator each hour. The results are free JSON, no key needed. People see the same data on /x402/health and /x402/facilitators.
| Feed (opens an example) | What | Updated |
|---|---|---|
/v1/x402/sellers/all | The whole seller index in one answer (about 1,000 sellers) | daily, about 02:30 UTC |
/v1/x402/sellers | Sellers ranked by 30-day unique payers, paged: follow next_offset until it is null. Filters: q, tag, network | daily |
/v1/x402/seller | One seller: health, probe days, listed payTo wallets, claim status | daily |
/v1/x402/facilitators | Facilitator uptime (7 days), latest probe, verify and supported latency, networks | hourly |
/v1/pay/guard | Pay guard: before an agent pays, checks the payTo against OFAC and the wallets the seller lists, plus uptime and price. allow, review or deny | live |
Polling
Every feed answer carries Last-Modified and an ETag built from its data date. Send If-None-Match with the last ETag and you get a 304 when nothing changed. Pull the seller feeds once a day after 03:00 UTC and the facilitator feed every 15 to 60 minutes. Please cache on your side and stay under 30 requests a minute per IP. Integrations that pull live for their users can send a recognisable user-agent and ask us to lift the limit for it.
Fields worth showing
Sellers: payers_30d, real_payers_30d (payers on Base after removing the seller's own and self-funded wallets), uptime.valid_402_rate, uptime.avg_ms, listed_wallets, networks. Facilitators: uptime_7d, latest.at, avg_ms.verify, networks. Each answer has a cite_as line to use as is.
Reuse
Free to reuse, also commercially, under CC BY 4.0: credit Source: Factline (factline.dev). Fields copied from the Coinbase and Circle catalogues stay under their own terms. The JSON answers carry license, attribution and terms.
Already using them
The Pipeworx gateway serves these feeds as three tools (seller health, seller lookup, facilitator health). Building something on them? Tell us at hello@factline.dev and we will tell you before a field changes.