Services

Get service distinct on-chain buyer history

Returns the MEASURED distinct on-chain buyer count for a service over time, one point per UTC day, oldest first. Distinct buyers are counted straight from the raw settlements per day (never summed across a rollup) over the service payTo mapping, USDC settlements only. Like the volume series it is a conservative undercount (only what the settler-attribution monitor observed) and honest-empty until a settlement is observed. Days with no observed settlement are omitted, so the series is sparse (one point per settled UTC day), not a dense daily grid.

get/services/{slug}/buyers

Request

  • Base URL: https://x402-list.com/api/v1
  • URL: https://x402-list.com/api/v1/services/{slug}/buyers
  • Auth: none declared

Path parameters

slugstring required

Query parameters

period'24h' | '7d' | '30d' | '90d' | 'all'

Time window; "all" reads the full recorded history.

Response

Array of daily distinct-buyer points (oldest first)

caveatstring

Fixed in-band note: the series is a conservative undercount and is operator-level (the full payout address), not pro-rata, so do not sum it across services that share a payout address

Example response

{
  "data": [
    {
      "date": "2026-07-06"
    }
  ],
  "provenance": {
    "attribution": "Data: x402-list.com (CC BY 4.0)",
    "cite_as": "https://x402-list.com/services/acme-generate",
    "source": "https://x402-list.com"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.