Skip to main content

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.

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;