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 base.agents schema provides analytics for the x402 micropayment protocol on Base. 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

base.agents.x402_transfers
base.agents.x402_metrics_daily
base.agents.x402_overview
base.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 base.agents.x402_metrics_daily
WHERE activity_date >= CURRENT_DATE - INTERVAL '7 days'
ORDER BY activity_date DESC;