Count the payments each genuine-volume signal fired for, day by day
/v1/chains/{chain}/x402/rules/dailyReturns, for each UTC day of a window, how many payments each genuine-volume signal fired for. Use it to chart how much of the traffic looks generated and which signal catches it.
What you can pass. from and to set the window as on the leaderboards: inclusive days written YYYY-MM-DD, 30 days that end on the day of the newest data by default, 366 days at most. {chain} is eip155:143 or eip155:8453.
What comes back: data (kind x402_rules_daily) has window, the resolved from and to, and items ordered by day and then by rule. Each item has the day, the rule (one of the five signals the x402 section explains) the count of tier A and B payments it fired for that day and payments, how many tier A and B payments were checked that day. One payment can fire several signals, so the counts of a day do not add up to its payments. A day on which a signal did not fire has no item for it. On Base the counts include days whose payment rows were pruned.
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, |
Response
The daily counts, wrapped in the {data, meta, links} envelope. data.kind is x402_rules_daily.
| Field | Type | Description |
|---|---|---|
| items | array of objects | One item per day and signal that fired, by day and then by rule. |
| 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 or from after to; these cost nothing. A window longer than 366 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.