Get one x402 facilitator, seller or payer day by day

GET/v1/chains/{chain}/x402/{kind}/{id}/daily

curl -s "https://api.sonaintel.com/v1/chains/eip155:143/x402/facilitators/monad-foundation/daily?from=2026-10-05&to=2026-10-07"

Response200

{
  "data": {
    "chain": "eip155:143",
    "entity": "facilitators",
    "from": "2026-10-05",
    "id": "monad-foundation",
    "items": [
      {
        "day": "2026-10-05",
        "gas_cost": "20604360006957522296",
        "genuine_payments": 5,
        "genuine_volume": "122000",
        "raw_payers": 462,
        "raw_payments": 1371,
        "raw_sellers": 5,
        "raw_volume": "13782000",
        "tier": "A"
      },
      {
        "day": "2026-10-06",
        "gas_cost": "446920380152442558754",
        "genuine_payments": 4,
        "genuine_volume": "202000",
        "raw_payers": 9921,
        "raw_payments": 29736,
        "raw_sellers": 3,
        "raw_volume": "297522000",
        "tier": "A"
      },
      {
        "day": "2026-10-07",
        "gas_cost": "4138582773176786635833",
        "genuine_payments": 6369,
        "genuine_volume": "63672000",
        "raw_payers": 2181,
        "raw_payments": 275337,
        "raw_sellers": 4,
        "raw_volume": "90568800",
        "tier": "A"
      }
    ],
    "kind": "x402_daily",
    "tier": "A",
    "to": "2026-10-07"
  },
  "links": {
    "self": "/v1/chains/eip155:143/x402/facilitators/monad-foundation/daily?from=2026-10-05&to=2026-10-07"
  },
  "meta": {
    "as_of": {
      "eip155:143": {
        "block": 112779145,
        "block_time": "2026-10-12T14:31:00Z"
      }
    },
    "finality": "finalized",
    "missing": [],
    "partial": false
  }
}

Returns the activity of one facilitator, seller or payer for each UTC day of a window. Use it to draw a chart of payments and volume over time, raw and genuine side by side.

What you can pass. {kind} is facilitators, sellers or payers. {id} is a registry id such as monad-foundation, a relayer address or unknown for a facilitator, and an address for a seller or a payer. from, to and tier work as on the leaderboards: the default window is the 30 days that end on the day of the newest data, at most 366 days, and tier is A (the default) or AB.

What comes back: data (kind x402_daily) has the entity kind, the id (lowercase when it is an address), the resolved from and to, tier, and items in ascending order of day, one per day and tier with at least one payment. Each item has raw_payments, raw_volume, genuine_payments and genuine_volume, and the figures that fit the entity: raw_payers, raw_sellers and gas_cost for a facilitator, raw_payers for a seller, raw_sellers for a payer. These counts of distinct addresses cannot be added up across days, which is why the leaderboards leave them out. An entity with payments, but none in the window, has empty items.

Path parameters

Name	Type	Description
chainRequired	string	The chain, as a CAIP-2 chain ID. Only Monad, `eip155:143`, Arc, `eip155:5042`, and Base, `eip155:8453`, have x402 data. A malformed ID answers 400 `invalid_id`, and any other well-formed ID, Ethereum's `eip155:1` included, answers 404 `unsupported_chain`.
kindRequired	string	Which kind of entity. `facilitators` settle payments (a registry id for tier A, the relayer address for tier B), `sellers` are the addresses that were paid, and `payers` are the addresses that paid. Anything else answers 400 `invalid_id`.
idRequired	string	The entity to read. For `facilitators`, a registry id such as `monad-foundation` (`/registry` lists them), a relayer address, or `unknown` for payments with no relayer. For `sellers` and `payers`, an address. An address is `0x` and 40 hex digits in lowercase, uppercase or EIP-55 mixed case; a mixed-case address with a wrong checksum answers 400 `invalid_id`. Answers use the lowercase form. A registry id is lowercase letters, digits and hyphens, at most 64 characters.

Query parameters

Name	Type	Description
from	string	Optional. The first UTC day to include, `YYYY-MM-DD`, inclusive. On the leaderboards and daily series, without it the window starts 29 days before `to`. On the payment list it filters by the day of the block, and without it the list has no start.
to	string	Optional. The last UTC day to include, `YYYY-MM-DD`, inclusive. On the leaderboards and daily series, without it the window ends on the day of the newest data. On the payment list, without it the list has no end. It must not be before `from`.
tier	stringDefault A	Optional. `A` (the default) counts the payments of listed facilitators only. `AB` adds tier B, the payments of relayers that are no listed facilitator.

Response

The days of the entity, wrapped in the {data, meta, links} envelope. data.kind is x402_daily.

Field	Type	Description
chain	string	`eip155:143eip155:5042eip155:8453`
entity	string	`facilitatorssellerspayers`
from	string	The first day of the window as resolved.
id	string	The entity, in lowercase when it is an address.
items	array of objects	The days with at least one payment, ascending, one item per day and tier.
kind	string	Always `x402_daily`. It names the shape of this object.
tier	string	`AAB`
to	string	The last day of the window as resolved.

Cost

1 credit.

Errors

Status	Code
400	`invalid_idinvalid_query`
404	`not_foundunsupported_chain`
429	`rate_limitedcredits_exhausted`
500	`internal`
503	`upstream_unavailable`
504	`deadline_exceeded`

400 invalid_id for a kind that is none of the three or a malformed id (including a mixed-case address with a wrong checksum). 400 invalid_query as on the leaderboards. 404 not_found when the entity never had a payment (an unknown registry id also answers 400 invalid_id from the x402 data source); both cost the credit. 404 unsupported_chain, 503 upstream_unavailable, 504 deadline_exceeded.

{ "data": { "chain": "eip155:143", "entity": "facilitators", "from": "2026-10-05", "id": "monad-foundation", "items": [ { "day": "2026-10-05", "gas_cost": "20604360006957522296", "genuine_payments": 5, "genuine_volume": "122000", "raw_payers": 462, "raw_payments": 1371, "raw_sellers": 5, "raw_volume": "13782000", "tier": "A" }, { "day": "2026-10-06", "gas_cost": "446920380152442558754", "genuine_payments": 4, "genuine_volume": "202000", "raw_payers": 9921, "raw_payments": 29736, "raw_sellers": 3, "raw_volume": "297522000", "tier": "A" }, { "day": "2026-10-07", "gas_cost": "4138582773176786635833", "genuine_payments": 6369, "genuine_volume": "63672000", "raw_payers": 2181, "raw_payments": 275337, "raw_sellers": 4, "raw_volume": "90568800", "tier": "A" } ], "kind": "x402_daily", "tier": "A", "to": "2026-10-07" }, "links": { "self": "/v1/chains/eip155:143/x402/facilitators/monad-foundation/daily?from=2026-10-05&to=2026-10-07" }, "meta": { "as_of": { "eip155:143": { "block": 112779145, "block_time": "2026-10-12T14:31:00Z" } }, "finality": "finalized", "missing": [], "partial": false } }

Path parameters

Name	Type	Description
chainRequired	string	The chain, as a CAIP-2 chain ID. Only Monad, `eip155:143`, Arc, `eip155:5042`, and Base, `eip155:8453`, have x402 data. A malformed ID answers 400 `invalid_id`, and any other well-formed ID, Ethereum's `eip155:1` included, answers 404 `unsupported_chain`.
kindRequired	string	Which kind of entity. `facilitators` settle payments (a registry id for tier A, the relayer address for tier B), `sellers` are the addresses that were paid, and `payers` are the addresses that paid. Anything else answers 400 `invalid_id`.
idRequired	string	The entity to read. For `facilitators`, a registry id such as `monad-foundation` (`/registry` lists them), a relayer address, or `unknown` for payments with no relayer. For `sellers` and `payers`, an address. An address is `0x` and 40 hex digits in lowercase, uppercase or EIP-55 mixed case; a mixed-case address with a wrong checksum answers 400 `invalid_id`. Answers use the lowercase form. A registry id is lowercase letters, digits and hyphens, at most 64 characters.

Query parameters

Name	Type	Description
from	string	Optional. The first UTC day to include, `YYYY-MM-DD`, inclusive. On the leaderboards and daily series, without it the window starts 29 days before `to`. On the payment list it filters by the day of the block, and without it the list has no start.
to	string	Optional. The last UTC day to include, `YYYY-MM-DD`, inclusive. On the leaderboards and daily series, without it the window ends on the day of the newest data. On the payment list, without it the list has no end. It must not be before `from`.
tier	stringDefault A	Optional. `A` (the default) counts the payments of listed facilitators only. `AB` adds tier B, the payments of relayers that are no listed facilitator.

Response

The days of the entity, wrapped in the {data, meta, links} envelope. data.kind is x402_daily.

Field	Type	Description
chain	string	`eip155:143eip155:5042eip155:8453`
entity	string	`facilitatorssellerspayers`
from	string	The first day of the window as resolved.
id	string	The entity, in lowercase when it is an address.
items	array of objects	The days with at least one payment, ascending, one item per day and tier.
kind	string	Always `x402_daily`. It names the shape of this object.
tier	string	`AAB`
to	string	The last day of the window as resolved.

Errors

Status	Code
400	`invalid_idinvalid_query`
404	`not_foundunsupported_chain`
429	`rate_limitedcredits_exhausted`
500	`internal`
503	`upstream_unavailable`
504	`deadline_exceeded`

Path parameters#

Query parameters#

Response#

Cost#

Errors#

Path parameters#

Query parameters#

Response#

Cost#

Errors#

Path parameters

Query parameters

Response

Cost

Errors

Path parameters

Query parameters

Response

Cost

Errors