Sign in
x402

x402 income/spend analytics. (admin access required)

Aggregates settled inbound (income) and signed outbound (spend) x402 flows over a window, bucketed by day and month and split by chain and asset.

post/x402/analytics

Request

  • Base URL: ./../api/v1/ (relative, and the document was published on a file host, not at the API’s origin)
  • URL: ./../api/v1/x402/analytics
  • Auth: API key in header token

Request body

startDatestring date-time nullable

Window start (defaults to 30 days ago)

endDatestring date-time nullable

Window end (defaults to now)

caip2Networkstring

Restrict to a single chain

timeZonestring

IANA timezone for day/month bucketing (default Etc/UTC)

Example request

{
  "timeZone": "Etc/UTC"
}

Response

x402 analytics

status'success' required

Example response

{
  "status": "success",
  "data": {
    "periodStart": "2026-05-09T12:00:00.000Z",
    "periodEnd": "2026-06-02T12:00:00.000Z",
    "incomeCount": 2,
    "spendCount": 1,
    "TotalIncome": [
      {
        "caip2Network": "eip155:8453",
        "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "amount": "1500000"
      }
    ],
    "TotalSpend": [
      {
        "caip2Network": "eip155:8453",
        "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "amount": "200000"
      }
    ],
    "Daily": [
      {
        "year": 2026,
        "month": 6,
        "day": 2,
        "Income": [
          {
            "caip2Network": "eip155:8453",
            "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
            "amount": "1500000"
          }
        ],
        "Spend": [
          {
            "caip2Network": "eip155:8453",
            "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
            "amount": "200000"
          }
        ]
      }
    ],
    "Monthly": [
      {
        "year": 2026,
        "month": 6,
        "Income": [
          {
            "caip2Network": "eip155:8453",
            "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
            "amount": "1500000"
          }
        ],
        "Spend": [
          {
            "caip2Network": "eip155:8453",
            "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
            "amount": "200000"
          }
        ]
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 50 revisions of this API.