Rank which x402 facilitator pays out to which seller
/v1/chains/{chain}/x402/flowsRanks the pairs of a facilitator and a seller (the payee) by the payments and the USDC volume that went through them over a window of UTC days. Use it for a "who settles for whom" view, such as a flow from facilitators to sellers, with raw and genuine numbers side by side.
What you can pass. from, to, tier, order and limit work as on the leaderboards: the default window is the 30 days that end on the day of the newest data, at most 90 days, tier is A (the default) or AB, order is genuine_volume (the default), raw_volume, genuine_payments or raw_payments, and limit is 1 to 100, 25 by default. {chain} is eip155:143 or eip155:8453.
What comes back: data (kind x402_flows) has window, the resolved from and to, and items, best first. Each item has the facilitator (a registry id, or the relayer address when it is unlisted), its name (null when unlisted), the payee, the tier, raw_payments and genuine_payments, and raw_volume and genuine_volume as amounts with raw base units, decimals and a decimal value. Volume is USDC only. A window with no payment is not an error: items is empty. On Base the totals include days whose payment rows were pruned. meta.as_of names the newest block served.
Path parameters
| Name | Type | Description |
|---|---|---|
chainRequired | string | The chain, as a CAIP-2 chain ID. Only Monad, |
Query parameters
| Name | Type | Description |
|---|---|---|
from | string | Optional. The first UTC day to include, |
to | string | Optional. The last UTC day to include, |
tier | stringDefault A | Optional. |
order | stringDefault genuine_volume | Optional. The figure to rank by, highest first: |
limit | integerDefault 25 | Optional. The most items to return, from 1 to 100. The default is 25. |
Response
The facilitator to seller flows, wrapped in the {data, meta, links} envelope. data.kind is x402_flows.
| Field | Type | Description |
|---|---|---|
| items | array of objects | The flows, at most |
| kind | string | Always |
| window | object | The window of days as resolved. |
Cost
1 credit.
Errors
| Status | Code |
|---|---|
| 400 | invalid_queryinvalid_id |
| 404 | unsupported_chain |
| 429 | rate_limitedcredits_exhausted |
| 500 | internal |
| 503 | upstream_unavailable |
| 504 | deadline_exceeded |
400 invalid_query for an unknown key, a key sent twice or empty, a day that does not exist, from after to, a window of both days longer than 90 days, or a bad tier, order or limit (tier is A or AB); these cost nothing. A window with only one end that reaches over 90 days is refused by the x402 data source with 400 invalid_query and costs the credit. 400 invalid_id for a malformed chain, 404 unsupported_chain, 503 upstream_unavailable, 504 deadline_exceeded.