Skip to main content
The polygon.agents schema provides analytics for the x402 micropayment protocol on Polygon. 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
x402_metrics_dailyDaily aggregated metrics by facilitator
x402_overviewLifetime and rolling window (7d/30d/90d) metrics
x402_facilitatorsFacilitator registry with supported tokens

​
Data Schema

polygon.agents.x402_transfers
polygon.agents.x402_metrics_daily
polygon.agents.x402_overview
polygon.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
  • 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 
  activity_date,
  facilitator_name,
  total_volume_usd,
  transfer_count
FROM polygon.agents.x402_metrics_daily
WHERE activity_date >= CURRENT_DATE - INTERVAL '7 days'
ORDER BY activity_date DESC;