Skip to main content
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

TableDescription
x402_transfersIndividual x402 token transfer events across all chains
x402_metrics_dailyDaily aggregated metrics by chain and facilitator
x402_overviewLifetime and rolling window (7d/30d/90d) metrics
x402_facilitatorsFacilitator registry across all chains

​
Data Schema

crosschain.agents.x402_transfers
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

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;