List x402 payments, newest first
/v1/chains/{chain}/x402/paymentsLists single x402 payments, newest first, one page at a time. Use it for a payment feed, the payments of one payer, seller or facilitator, or to see which genuine-volume signals fired on a payment.
What you can pass. Every filter is optional and they combine with AND. payer, payee (the seller) and relayer take an address. facilitator takes a registry id, a relayer address or unknown. method is how the payment reached the chain. tier is A (the default), AB, or all, which adds tier X. from and to filter by the UTC day of the block and have no limit on the span. limit is 1 to 200 payments per page (default 50). To get the next page, send the next_cursor of the page you hold as cursor, with the same filters.
What comes back: data (kind x402_payments) has items, the payments in order of block and log index, newest first, and next_cursor when more are left (it is absent on the last page). A cursor page never changes: newer payments only add to the first page. Every payment has all the keys of the payment schema, with null for what is not known. Its id is 143_<block>_<log_index>, amount is in base units of token, tier, facilitator, genuine and rules_fired give Sona's verdict, and gas_cost is what the settling transaction cost in wei of the chain's native coin (MON on Monad, USDC on Arc, ETH on Base).
Path parameters
| Name | Type | Description |
|---|---|---|
chainRequired | string | The chain, as a CAIP-2 chain ID. Only Monad, |
Query parameters
| Name | Type | Description |
|---|---|---|
payer | string | Optional. Only payments from this address, the payer who signed them. |
payee | string | Optional. Only payments to this address, the seller. |
relayer | string | Optional. Only payments whose settling transaction this address sent. |
facilitator | string | Optional. Only payments of this facilitator: a registry id such as |
method | string | Optional. Only payments that reached the chain this way. The payment schema explains each method. |
tier | stringDefault A | Optional. |
from | string | Optional. The first UTC day to include, |
to | string | Optional. The last UTC day to include, |
limit | integerDefault 50 | Optional. The most payments in one page, from 1 to 200. The default is 50. |
cursor | string | Optional. The |
Response
One page of payments, wrapped in the {data, meta, links} envelope. data.kind is x402_payments.
| Field | Type | Description |
|---|---|---|
| chain | string | eip155:143eip155:5042eip155:8453 |
| items | array of objects | The payments, newest first. |
| kind | string | Always |
| next_cursor | string | Send it as |
Cost
1 credit per page.
Errors
| Status | Code |
|---|---|
| 400 | invalid_idinvalid_query |
| 404 | unsupported_chain |
| 429 | rate_limitedcredits_exhausted |
| 500 | internal |
| 503 | upstream_unavailable |
| 504 | deadline_exceeded |
400 invalid_id for a malformed payer, payee, relayer or facilitator (an unknown registry id is refused by the x402 data source and costs the credit). 400 invalid_query for an unknown key, a key sent twice or empty, a bad day, from after to, or a bad method, tier, limit or cursor. 404 unsupported_chain, 503 upstream_unavailable, 504 deadline_exceeded.