> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allium.so/llms.txt
> Use this file to discover all available pages before exploring further.

# x402

> Cross-chain x402 protocol analytics

The `crosschain.agents` schema provides analytics for the x402 micropayment protocol across all supported chains. x402 enables AI agents and developers to pay for API calls with USDC — no API key, no registration, just a wallet.

## Available Tables

| Table                                                              | Description                                                                                  |
| ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
| [x402\_transfers](/historical-data/agents/x402/transfers)          | Individual x402 token transfer events across all chains                                      |
| [x402\_metrics\_daily](/historical-data/agents/x402/metrics-daily) | Daily aggregated metrics by chain and facilitator                                            |
| [x402\_overview](/historical-data/agents/x402/metrics-overview)    | Lifetime and rolling window (7d/30d/90d) metrics                                             |
| [x402\_servers](/historical-data/agents/x402/servers)              | Server registry — maps payment addresses to service origins, categories, and accepted tokens |
| [x402\_facilitators](/historical-data/agents/x402/facilitators)    | Facilitator registry across all chains                                                       |

## Data Schema

```
crosschain.agents.x402_transfers
crosschain.agents.x402_servers
crosschain.agents.x402_metrics_daily
crosschain.agents.x402_overview
crosschain.agents.x402_facilitators
```

## Key Concepts

### Facilitators

Facilitators are entities that process x402 payments on behalf of users. Each facilitator has:

* A unique identifier (e.g., `coinbase`, `polygon`)
* One or more wallet addresses per chain
* Supported tokens (typically USDC)
* Access type (public, gated, or gated\_paid)

### Transfer Context

In x402 transfers:

* **from\_address** - The buyer (paying for API access)
* **to\_address** - The seller (API provider receiving payment)
* **transaction\_from\_address** - The facilitator processing the payment

## Sample Query

```sql theme={null}
SELECT 
  chain,
  activity_date,
  SUM(total_volume_usd) AS total_volume_usd,
  SUM(transfer_count) AS total_transfers
FROM crosschain.agents.x402_metrics_daily
WHERE activity_date >= CURRENT_DATE - INTERVAL '7 days'
GROUP BY chain, activity_date
ORDER BY activity_date DESC;
```
