Services

Get service on-chain settlement volume history

Returns the MEASURED on-chain settlement volume for a service over time (USD), one point per UTC day, oldest first. Volume is read directly from the chain by settler-address attribution over the service payTo mapping (USDC settlements only), never self-reported. It is a conservative undercount: only settlements the settler-attribution monitor observed are included, so a service can have real volume this series does not yet see. The series is honest-empty until a settlement is observed, and a service whose payTo sits on a network not under measurement will read empty here (see the assessment.traction status for why). 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}/volume

Request

Base URL: https://x402-list.com/api/v1
URL: https://x402-list.com/api/v1/services/{slug}/volume
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 volume 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.