--- name: x402scan-j55w7ornb-merit-systems.vercel.app description: x402scan-j55w7ornb-merit-systems.vercel.app provides aggregated on-chain analytics for the x402 payment network, covering wallets, merchants, facilitators, and network-wide activity. All four skills return summary statistics rather than individual transaction records or real-time streams. The host is oriented toward Base and Solana networks as supported by the x402 protocol. host: x402scan-j55w7ornb-merit-systems.vercel.app --- # x402scan-j55w7ornb-merit-systems.vercel.app This host serves agents that need a structured, aggregate view of x402 payment network participants — wallets, merchants, and facilitators — without requiring access to raw transaction logs. It is useful for due diligence, network health checks, and integration research. It does not offer real-time event feeds, per-transaction detail, or cross-chain coverage beyond what the x402 facilitator directory explicitly supports. ## When to use this host Use this host when an agent needs aggregate, summary-level analytics about x402 network participants — wallets, merchants, or facilitators — on Base or Solana. It is the right choice for network health checks, facilitator discovery, merchant vetting, or wallet profiling at a statistical level. Do not use it for real-time transaction monitoring, per-transaction status lookups, or streaming payment events; those use cases require a dedicated transaction indexer or event stream. Do not use it to retrieve individual payment records or to query chains outside of what the x402 facilitator directory explicitly covers. If per-transaction detail is needed, look for a block explorer or transaction history API instead. ## Capabilities ### Network-Level Aggregates Provides a top-down snapshot of the entire x402 facilitator network, including total transaction volume, cumulative payment amounts, and distinct buyer/seller counts across all facilitators. - **`fetch-facilitator-stats`** — Returns aggregated network facilitator statistics including total transaction count, total volume, unique buyer/seller counts, and latest block timestamp. ### Facilitator Directory and Profiles Enumerates known x402 facilitators with per-facilitator statistics, on-chain addresses by chain, and metadata such as docs URLs and branding, enabling facilitator discovery and comparison. - **`fetch-on-chain-facilitators`** — Returns a list of verified x402 payment facilitators with on-chain addresses, transaction statistics, and metadata for Base and Solana networks. ### Merchant Analytics Returns aggregated on-chain metrics for a specific merchant address on Base, including transaction count, total revenue, unique buyer count, and most recent activity timestamp. - **`fetch-merchant-stats`** — Returns aggregated on-chain merchant metrics including transaction count, total revenue amount, unique buyer/seller counts, and latest block timestamp for a given merchant address. ### Wallet Activity Summary Returns aggregate on-chain activity for any wallet address, covering transaction count, total amount sent, unique recipient count, and which chains the wallet has been active on. - **`fetch-wallet-stats`** — Returns transaction count, total amount, unique recipient count, and active chains for a given wallet address. ## Workflows ### Facilitator Due Diligence *Use when an agent needs to evaluate a specific x402 facilitator — first identifying it in the directory, then benchmarking its activity against network-wide totals.* 1. **`fetch-on-chain-facilitators`** — Retrieve the full facilitator directory to identify the target facilitator's on-chain addresses, transaction counts, and metadata. 2. **`fetch-facilitator-stats`** — Fetch network-level aggregate stats to contextualize the individual facilitator's volume and buyer/seller counts relative to the whole network. ### Merchant and Wallet Cross-Check *Use when an agent needs to verify that a merchant address shows consistent activity both as a merchant on Base and as a general wallet across chains.* 1. **`fetch-merchant-stats`** — Retrieve aggregated merchant metrics for the address on Base, including transaction count, revenue, and unique buyers. 2. **`fetch-wallet-stats`** — Fetch the wallet-level summary for the same address to confirm multi-chain activity, recipient diversity, and overall transaction volume. ## Skill reference ### `fetch-wallet-stats` **Wallet Stats API** — Returns transaction count, total amount, unique recipient count, and active chains for a given wallet address. *Use when:* Use when an agent needs a summary of on-chain activity for a specific wallet address, including transaction volume, recipient diversity, and which chains the wallet has been active on. *Not for:* Do not use for real-time transaction streaming or full transaction history; this returns aggregate stats only, not individual transaction records. **Inputs:** - `address` (string, required) — The wallet address to retrieve stats for, supplied as a path parameter in the URL. **Returns:** Returns a data object with total_transactions, total_amount, unique_recipients, and a chains array listing active networks for the queried wallet. **Example:** `GET https://x402scan-j55w7ornb-merit-systems.vercel.app/api/data/wallets/0x2EC4545f96A24876764bF2B04D54E66A1351bE71/stats` --- ### `fetch-on-chain-facilitators` **On-Chain Facilitators Directory** — Returns a list of verified x402 payment facilitators with on-chain addresses, transaction statistics, and metadata for Base and Solana networks. *Use when:* Use when an agent needs to enumerate known x402 facilitators, resolve a facilitator's on-chain addresses by chain, check transaction volume or buyer/seller counts, or retrieve docs URLs and branding metadata for payment integration. *Not for:* Do not use for real-time transaction lookup or individual payment status checks; this returns aggregate facilitator-level data, not per-transaction records. **Returns:** Returns a data array where each entry contains a facilitator's id, name, docs URL, per-chain on-chain addresses, transaction count, total amount processed, unique buyer/seller counts, and latest block timestamp. **Example:** `GET https://x402scan-j55w7ornb-merit-systems.vercel.app/api/data/facilitators` --- ### `fetch-merchant-stats` **x402 Merchant Insights** — Returns aggregated on-chain merchant metrics including transaction count, total revenue amount, unique buyer/seller counts, and latest block timestamp for a given merchant address. *Use when:* Use when an agent needs a summary of a merchant's on-chain activity on Base — total transactions, cumulative payment volume, unique buyer count, and most recent activity timestamp — given a wallet address. *Not for:* Do not use for per-transaction detail or real-time streaming data; this returns aggregate stats only. Not suitable for non-Base chains without confirming multi-chain support. **Inputs:** - `chain` (string, required) — Blockchain network identifier for the merchant. Use 'base' for Base mainnet. - `address` (string, required) — EVM wallet address of the merchant whose stats are being queried. **Returns:** Returns a data object with total_transactions (12,375,513), total_amount in atomic units, unique_buyers (12,827), unique_sellers (1), and latest_block_timestamp for the queried merchant address. **Example:** `GET https://x402scan-j55w7ornb-merit-systems.vercel.app/api/data/merchants/0x7e571E959cC7C75Ccdd2eAC24f8775ea2eAa2F09/stats?chain=base` --- ### `fetch-facilitator-stats` **Facilitator Insights** — Returns aggregated network facilitator statistics including total transaction count, total volume, unique buyer/seller counts, and latest block timestamp. *Use when:* Use when an agent needs a current snapshot of network-wide facilitator activity, such as total transactions processed, cumulative volume, or the number of distinct buyers and sellers on the network. *Not for:* Do not use for per-facilitator breakdowns or individual facilitator performance metrics; this endpoint returns only network-level aggregates. **Returns:** Returns a data object with total_transactions, total_amount in atomic units, unique_buyers, unique_sellers, and latest_block_timestamp as an ISO 8601 string. **Example:** `GET https://x402scan-j55w7ornb-merit-systems.vercel.app/api/data/facilitators/stats` ---