# x402 Payment Analytics Reference

Live x402 payment data on Base via The Graph subgraph.
Endpoint: `https://api.studio.thegraph.com/query/1745687/x-402-base/version/latest`
No API key needed for this endpoint.

## Entities

| Entity | Key Fields | Sort By |
|--------|-----------|---------|
| X402Payment | amountDecimal, from, to, facilitator { name }, transferMethod, blockTimestamp | blockTimestamp |
| Facilitator | name, address, totalSettlements, totalVolumeDecimal, isActive | totalSettlements |
| X402DailyStats | date, totalPayments, totalVolumeDecimal, eip3009Payments, permit2Payments | date |
| X402AddressSummary | address, role (PAYER/RECIPIENT), totalPayments, totalVolumeDecimal | totalPayments |

## Example Queries

### Daily stats (last 7 days)
```graphql
{ x402DailyStats_collection(first: 7, orderBy: date, orderDirection: desc) {
    date totalPayments totalVolumeDecimal eip3009Payments permit2Payments
} }
```

### Top facilitators
```graphql
{ facilitators(first: 10, orderBy: totalSettlements, orderDirection: desc) {
    name address totalSettlements totalVolumeDecimal isActive
} }
```

### Recent payments
```graphql
{ x402Payments(first: 10, orderBy: blockTimestamp, orderDirection: desc) {
    amountDecimal from to transferMethod facilitator { name }
} }
```

## Stats (as of April 2026)
- 127M+ total payments on Base
- $40M+ total volume
- 28 facilitators (Coinbase, PayAI, Daydreams, Heurist, Virtuals Protocol, etc.)
- Data from May 2025 to present