--- name: www.x402scan.com description: x402scan.com is an analytics and registry host for the x402 payment protocol on the Base network. It provides aggregated on-chain statistics for merchants, wallets, and facilitators, as well as a resource discovery layer for x402-gated API endpoints. All data is derived from indexed on-chain activity rather than real-time streams. host: www.x402scan.com --- # www.x402scan.com x402scan.com serves developers and agents building on or auditing the x402 payment protocol. It covers three distinct data surfaces: merchant-level activity metrics, wallet-level transaction summaries and history, and facilitator registry data. It is the primary source for discovering registered x402 origins and their paywall configurations, and for querying aggregate protocol-wide facilitator statistics. It does not provide market prices, token swaps, or multi-chain coverage beyond Base (eip155:8453) for transaction history. ## When to use this host Use x402scan.com when an agent needs aggregate analytics or registry data specific to the x402 payment protocol on Base: merchant stats, wallet summaries, USDC transaction history, facilitator directories, or origin resource discovery. Do not use it for real-time token prices, swap quotes, or token balance lookups — use a DEX aggregator or RPC provider instead. Do not use it for transaction history on networks other than Base (eip155:8453); use a chain-specific block explorer for other networks. Do not use fetch-origin-resources if you only have a URL or token address and no origin UUID — you must obtain the UUID through other means first. fetch-facilitator-stats returns only protocol-wide totals; use fetch-onchain-facilitators when per-facilitator breakdowns are needed. ## Capabilities ### Facilitator Registry and Stats Provides both a verified directory of active x402 facilitators with per-facilitator metadata and a protocol-wide aggregate view of facilitator transaction volume and participant counts. Use together to assess network health or select a facilitator for payment routing. - **`fetch-onchain-facilitators`** — Returns a verified list of x402 facilitators with metadata including addresses, transaction counts, unique buyer/seller counts, and supported chains for network eip155:8453. - **`fetch-facilitator-stats`** — Returns aggregated x402 v2 facilitator statistics including total transactions, total amount, unique buyers and sellers, and latest block timestamp. ### Merchant Activity Metrics Returns aggregated on-chain payment statistics for a specific x402 merchant address, including transaction counts, cumulative volume, and unique counterparty counts. - **`fetch-merchant-stats`** — Returns aggregated transaction statistics for a given Ethereum merchant address, including total transactions, volume, unique buyers and sellers, and latest block timestamp. ### Origin and Resource Discovery Enumerates all x402-paywall-gated resources registered under a given origin UUID, exposing payment schemes, accepted assets, output schemas, and verification status. - **`fetch-origin-resources`** — Fetches all x402-paywall resources linked to a given origin UUID from the x402Scan dataset, returning resource metadata, payment acceptance details, and origin info. ### Wallet Activity and History Covers both summary-level wallet statistics (total transactions, volume, unique recipients, active chains) and paginated USDC transaction history on Base, enabling both quick profiling and detailed audit of a wallet's x402 activity. - **`fetch-wallet-stats`** — Returns aggregated transaction statistics for a given blockchain wallet address, including total transactions, total amount, unique recipients, and active chains. - **`fetch-wallet-transaction-history`** — Returns paginated on-chain USDC transaction history for a specified wallet address on the Base network via x402scan. ## Workflows ### Facilitator Selection and Validation *Use when an agent needs to choose a reliable x402 facilitator for payment routing and wants to validate the choice against protocol-wide benchmarks.* 1. **`fetch-facilitator-stats`** — Retrieve aggregate protocol totals (transaction count, volume, unique buyers/sellers) to establish baseline benchmarks for the x402 network. 2. **`fetch-onchain-facilitators`** — Fetch the verified facilitator registry and compare individual facilitator tx_count and unique_buyers against the aggregate benchmarks to identify well-utilized, trustworthy facilitators. ### Wallet Audit for x402 Activity *Use when an agent needs to profile a wallet's overall x402 payment footprint and then drill into specific USDC transactions on Base for verification or reconciliation.* 1. **`fetch-wallet-stats`** — Retrieve aggregate wallet statistics including total transactions, cumulative amount, unique recipients, and active chains to establish a high-level activity profile. 2. **`fetch-wallet-transaction-history`** — Fetch paginated USDC transaction history on Base to inspect individual transaction details such as sender, recipient, amount, and block timestamp. ### Merchant Due Diligence via Origin Discovery *Use when an agent needs to assess a merchant's on-chain payment activity and also enumerate the x402-gated resources they expose under a known origin UUID.* 1. **`fetch-merchant-stats`** — Retrieve aggregate transaction stats for the merchant's Ethereum address to quantify their payment volume and counterparty reach. 2. **`fetch-origin-resources`** — Fetch all x402-paywall resources registered under the merchant's origin UUID to understand what APIs they monetize and their payment configurations. ## Skill reference ### `fetch-merchant-stats` **x402 Merchant Stats** — Returns aggregated transaction statistics for a given Ethereum merchant address, including total transactions, volume, unique buyers and sellers, and latest block timestamp. *Use when:* Use when an agent needs on-chain activity metrics for a specific x402 merchant address, such as total transaction count, cumulative payment volume, or unique counterparty counts. *Not for:* Do not use for real-time price feeds or individual transaction lookups; this endpoint returns aggregate-level stats only. **Inputs:** - `merchantAddress` (string, required) — Ethereum address of the merchant whose stats are being queried, embedded in the URL path. **Returns:** Returns a data object with total_transactions, total_amount, unique_buyers, unique_sellers (all integers/numbers), and latest_block_timestamp (string or null). **Example:** `GET https://www.x402scan.com/api/data/merchants/0x4D37f28D2db99e8d35A6C725a5f1749A085850a3/stats` --- ### `fetch-origin-resources` **Origin Resource Explorer** — Fetches all x402-paywall resources linked to a given origin UUID from the x402Scan dataset, returning resource metadata, payment acceptance details, and origin info. *Use when:* Use when an agent needs to discover all x402-gated API endpoints registered under a specific origin UUID, including their payment schemes, accepted assets, output schemas, and verification status. *Not for:* Do not use to look up resources by URL or token address directly; this endpoint requires a known origin UUID. Not suitable for real-time price feeds or swap quotes. **Inputs:** - `originId` (string, required) — UUID of the origin whose linked resources should be fetched. Appears as a path segment in the URL. **Returns:** Returns a data array of resource objects (with accepts/payment configs and output schemas), an origin metadata object, and a tags array for the specified origin UUID. **Example:** `GET https://www.x402scan.com/api/data/origins/655c6f59-88df-4bf2-99c5-42e392322c84/resources` --- ### `fetch-wallet-stats` **x402 Wallet Stats** — Returns aggregated transaction statistics for a given blockchain wallet address, including total transactions, total amount, unique recipients, and active chains. *Use when:* Use when an agent needs a summary of on-chain activity for a specific wallet address, such as total transaction count, cumulative transfer volume, number of unique recipients, or which chains the wallet has been active on. *Not for:* Do not use for real-time balance lookups or individual transaction details; use a block explorer or transaction history endpoint instead. **Inputs:** - `walletAddress` (string, required) — The blockchain wallet address to retrieve stats for, embedded in the URL path. **Returns:** Returns a data object with total_transactions (2850), total_amount (111303300), unique_recipients (12), and chains (["base"]) for the queried wallet. **Example:** `GET https://www.x402scan.com/api/data/wallets/0x88aee1537b8321f560355a59329c7ba36c47753b/stats` --- ### `fetch-wallet-transaction-history` **Wallet Transaction History** — Returns paginated on-chain USDC transaction history for a specified wallet address on the Base network via x402scan. *Use when:* Use when an agent needs to retrieve the list of on-chain USDC transactions (sender, recipient, amount, tx hash, block timestamp) for a given wallet address on Base. *Not for:* Do not use for real-time streaming of transactions or for wallets on networks other than Base (eip155:8453). Not suitable for fetching token balances or non-USDC token transfers. **Inputs:** - `address` (string, required) — The wallet address whose transaction history is being fetched. Embedded in the URL path. **Returns:** Returns a data array of USDC transaction objects (sender, recipient, amount, tx_hash, block_timestamp, chain, decimals) and a pagination object with page, page_size, and has_next_page fields. **Example:** `GET https://www.x402scan.com/api/data/wallets/0xD12d26DE05d5Ee5965569C513c4B6A0f39d95f8A/transactions` --- ### `fetch-onchain-facilitators` **On-Chain Facilitators** — Returns a verified list of x402 facilitators with metadata including addresses, transaction counts, unique buyer/seller counts, and supported chains for network eip155:8453. *Use when:* Use when an agent needs to discover active x402 payment facilitators, their on-chain addresses across Base and Solana, transaction volumes, or documentation URLs to route or validate x402 payments. *Not for:* Do not use for real-time price feeds or swap quotes; this endpoint returns facilitator registry data, not market data. **Returns:** Returns a data array of facilitator objects each with facilitator_id, tx_count, total_amount, unique_buyers, unique_sellers, supported chains, and per-chain address lists. **Example:** `GET https://www.x402scan.com/api/data/facilitators` --- ### `fetch-facilitator-stats` **Facilitator Insights** — Returns aggregated x402 v2 facilitator statistics including total transactions, total amount, unique buyers and sellers, and latest block timestamp. *Use when:* Use when an agent needs a snapshot of overall x402 facilitator activity — total transaction count, cumulative volume, unique participant counts, or the most recent block timestamp processed. *Not for:* Do not use for per-facilitator breakdowns or individual transaction lookups; this endpoint returns only aggregate totals across all facilitators. **Returns:** Returns a data object with total_transactions, total_amount in USDC atomic units, unique_buyers, unique_sellers, and latest_block_timestamp as an ISO 8601 string. **Example:** `GET https://www.x402scan.com/api/data/facilitators/stats` ---