x402 Earnings

​

GET /admin/monetization/x402-earnings

​

Authentication

​

Query parameters

​

Example

curl "https://apiv3.droplinked.com/admin/monetization/x402-earnings?page=1&limit=30" \
  -H "Authorization: Bearer <SUPER_ADMIN_JWT>"

​

Response — 200 OK

{
  "rows": [],
  "totalAmountUsdCents": 0,
  "totalSettlements": 0,
  "pagination": {
    "page": 1,
    "limit": 30,
    "total": 0
  },
  "asOf": "2026-06-14T22:58:16.027Z"
}

​

Fields

​

Errors

​

Notes

• X402_ENABLED gating. Until the platform flag X402_ENABLED is set to true, X402SettlementLog accepts no writes and this endpoint always returns rows: [], totalAmountUsdCents: 0, totalSettlements: 0. The endpoint itself is always reachable — the gate is at the write path, not the read path.
• Fail-open semantics. If the underlying X402SettlementLog aggregation throws, the endpoint returns the empty-state envelope (rows: [], totals 0) with 200 OK rather than propagating the error. Inspect server logs / Sentry for the underlying failure.
• Currency. All monetary fields are USD cents, integer. x402 settles natively in USDC on Base; the read path converts at the settlement timestamp’s FX snapshot.
• Pagination. total is the number of merchant rows, not the number of settlements. A merchant with 50 settlements counts as 1 for pagination.

​

Related

• Platform Fee Summary — MRR / ARR / 30d / 365d rollup that includes x402 in revenue30dUsdCents / revenue365dUsdCents.
• Capital Markets Fees — companion fee-schedule preview.
• Set Merchant Acquisition Source — set the activation-source enum surfaced in the platform-fee-summary mix.