io.github.printmoneylab/x402watch

Official5 tools

by printmoneylab · TypeScript

Wash-filtered intelligence for x402: categories, services, wash analysis, trends.

Analyze x402 categories, services, and wash trading patterns.

Topics

agentagentic-paymentsaiai-agentsblockchain-analyticscryptocurrencydatadefiinframcppaymentwash-tradingx402x402-agentx402-apix402-payment

Captured live from the server via tools/list.

x402_get_categories

List all 33 x402 service categories with aggregate stats: services count, 24h volume, transaction count, real-volume %, and label distribution. Use this to understand the shape of the x402 ecosystem before drilling into specific services or wallets. Free tier. No payment required. Returns wash-filtered data using the same v2.0 algorithm as the paid endpoints.

No parameters.

x402_get_service

Get the full detail record for one x402 service: name, description, seller address, chain, price, 24h and total transaction stats, 30-day daily volume time series, buyer-label distribution, and top buyers. Use this to evaluate a single service's traffic composition. Free tier. No payment required. Returns wash-filtered data using the same v2.0 algorithm as the paid endpoints.

Parameters (1)

service_idintegerrequired
Numeric x402 service id (visible in /services list and detail URLs).

x402_check_wash

Get the aggregate wash-report dataset: 30-day total active buyers, real-volume %, suspected_wash and self_test counts, full 8-label distribution, 14-day wash percentage time series, and five anonymized case studies (Service A through E) with pattern signals. For per-address real-time wash analysis with full signal breakdown, use the paid POST /api/v1/wash/check HTTP endpoint ($0.05 USDC) — that endpoint speaks x402, agents pay and receive data in a single HTTP round-trip. Free tier. No payment required. Returns wash-filtered data using the same v2.0 algorithm as the paid endpoints.

Parameters (1)

addressstring
Optional wallet or seller address. When provided, the response includes a hint about the paid per-address endpoint.

x402_search_services

Search the index of 36k+ x402 services with filters. Returns a paginated list of matching services with their stats and label mix. Use this to find services by topic, chain, or seller wallet. Free tier. No payment required. Returns wash-filtered data using the same v2.0 algorithm as the paid endpoints.

Parameters (6)

searchstring
Free-text match against name, description, or seller address.
categorystring
Filter to a single category slug (e.g. 'ai_inference', 'wallet_analytics').
chainstring
Filter to one chain: 'base', 'solana', 'arbitrum', 'base-sepolia'.
sortstring
Sort key: tx_24h | volume_24h | tx_total | price | real_pct | wash_pct | first_seen | alpha.
pageinteger
1-indexed page number.
page_sizeinteger
Page size (max 200; default 24).

x402_get_trends

Get the last-24-hour trends snapshot: new services count vs the previous 24h, total transaction count, total USDC volume, active buyer count, daily new-services bar (14 days), recent new services (top 10), category volume movers, and hot services with traffic surges (>= 100 24h tx and >= +50% growth). Refreshed every 5 min. Free tier. No payment required. Returns wash-filtered data using the same v2.0 algorithm as the paid endpoints.

No parameters.

README.md8 KBView on GitHub

x402watch

Wash-filtered intelligence layer for the x402 ecosystem — free public dashboard, daily CC0 datasets, x402-native paid API, and a remote MCP server.

What is x402watch

Public x402 dashboards count transactions. x402watch classifies them.

Every active buyer wallet is tagged with one of eight labels — organic_user, self_test, developer, suspected_wash, ai_agent, analytics_bot, exchange_user, or verifier — using cohort signals + vanity clustering. Real-volume reporting excludes the synthetic categories, so service rankings reflect actual demand instead of self-funded noise.

4-Axis Differentiation

Wash filter — 8-label buyer classification, cohort signal detection (uniform_amount, coordinated_start, uniform_tx_count, time_burst), strict + broad vanity clustering, conservative developer label.
Free public data — every label, every benchmark. Daily CC0 snapshots in printmoneylab/x402watch-data.
AI-native — public REST API, x402-native paid endpoints, llms.txt, OpenAPI spec, RSS, /.well-known/x402, and an MCP server.
Coverage — 36,000+ services indexed across Base, Solana, Polygon, and Arbitrum.

Quick Start

Free API

bash

curl https://api.x402.printmoneylab.com/api/v1/landing-stats
curl https://api.x402.printmoneylab.com/api/v1/categories
curl 'https://api.x402.printmoneylab.com/api/v1/services?search=ai'

Rate limit: 60 req/hour per IP. No API key. CC0-licensed.

MCP server (one command)

bash

smithery mcp add bakyang2/x402watch

Or add to any MCP client manually (Claude Desktop, Cursor, Cline):

json

{
  "mcpServers": {
    "x402watch": {
      "transport": "streamable-http",
      "url": "https://api.x402.printmoneylab.com/mcp"
    }
  }
}

Paid endpoint (x402)

python

import asyncio, os
from eth_account import Account
from x402 import x402Client
from x402.mechanisms.evm.exact import ExactEvmClientScheme
from x402.http.clients.httpx import x402HttpxClient

async def main():
    acct = Account.from_key(os.environ["PRIVATE_KEY"])
    payer = x402Client()
    payer.register("eip155:8453", ExactEvmClientScheme(acct))
    async with x402HttpxClient(payer, base_url="https://api.x402.printmoneylab.com") as c:
        r = await c.post("/api/v1/wash/check", json={"address": "0x..."})
        print(r.json()["label"])

asyncio.run(main())

The 402 round-trip pays USDC on Base mainnet via the CDP facilitator, retries with the signed payment header, and returns 200 with the data — no signup, no API keys.

API Endpoints

Free (60 req/hour per IP)

Endpoint	Description
`GET /api/v1/landing-stats`	Real-time market overview (services, transactions, real volume %)
`GET /api/v1/categories`	All 33 x402 service categories with stats
`GET /api/v1/categories/{slug}`	Category detail + 30-day time series + top services
`GET /api/v1/services`	Paginated service list with filters
`GET /api/v1/services/{id}`	Service detail: stats, time series, top buyers, label distribution
`GET /api/v1/trends`	24-hour ecosystem trends
`GET /api/v1/wash-report`	Aggregate wash patterns + anonymized case studies

Paid (x402, USDC on Base)

Endpoint	Price	Use case
`GET /api/v1/services/{id}/wash-detail`	$0.005	Operator audit — top 50 buyers + signal breakdown
`GET /api/v1/buyers/{address}/profile`	$0.005	Wallet research
`GET /api/v1/services/{id}/transactions`	$0.01	Custom analysis — raw 30-day transactions
`GET /api/v1/categories/{slug}/full-history`	$0.02	Longitudinal research — 365-day hourly series
`POST /api/v1/wash/check`	$0.05	Real-time wash analysis for any address

Settled via the Coinbase Developer Platform x402 facilitator. Bazaar discovery extensions declared per route.

Full reference: /api · Swagger UI

MCP Tools

Listed on the official MCP Registry as io.github.printmoneylab/x402watch. Streamable-http at https://api.x402.printmoneylab.com/mcp. Five read-only tools:

Tool	What it returns
`x402_get_categories`	All 33 categories with services count, 24h volume, real-volume %, label distribution
`x402_get_service`	One service's full record: stats, 30-day daily volume, top buyers, label mix
`x402_check_wash`	Aggregate wash-report dataset (per-address analysis is the paid `POST /wash/check` endpoint)
`x402_search_services`	Search 36k+ services with filters (category, chain, sort, page)
`x402_get_trends`	24h trends: new services, hot services, category volume movers

Architecture

Layer	Stack
Frontend	Next.js 16 (App Router) + Tailwind v4 + Recharts
Backend	FastAPI + PostgreSQL (TimescaleDB) + Redis (5-min cache)
Indexing	Bazaar discovery + EVM RPC (Alchemy) + Solana RPC (Helius)
Wash detection	NetworkX cohort signals, vanity clustering (strict + broad), single-buyer concentration analysis
AI classification	Claude Haiku 4.5 (per-service categorization), Claude Sonnet 4.5 (cross-validation)
Payments	x402 SDK 2.8.0, CDP facilitator on Base mainnet (USDC)
MCP server	FastMCP 3.x, streamable-http transport
Hosting	Oracle ARM (backend, free tier) + Vercel (frontend) + Cloudflare DNS

Methodology

Open, version-controlled, deterministic from public on-chain data:

→ https://x402.printmoneylab.com/docs/methodology

Covers 8-label priority order, cohort signal thresholds, vanity-cluster math, and the conservative developer label. Source markdown lives in content/methodology.md.

Resources

🌐 Site: https://x402.printmoneylab.com
📡 API: https://api.x402.printmoneylab.com/api/v1 · Swagger
🤖 MCP: https://api.x402.printmoneylab.com/mcp
📦 Open dataset: printmoneylab/x402watch-data
🤝 Smithery · MCP Registry · Glama
🐦 Twitter: @printmoneylab

Repository Layout

This repo holds the public Next.js site under src/. The methodology markdown lives in content/methodology.md and is rendered at /docs/methodology. The FastAPI backend and indexers live on a separate Oracle host.

Contributing

Pull requests welcome. For methodology questions, dispute a label, or report a misclassified service, please open a GitHub Issue — labels are deterministic and reproducible from public on-chain data, so we'll walk through the signals that triggered the classification.

License

Code: Apache 2.0 (see LICENSE)
Data: CC0 (public domain), published daily to x402watch-data

Status

Phase 1 MVP — actively developed. 9 systemd services running on the Oracle backend (api, mcp, 7 indexer/labeller/stats jobs). Daily snapshots commit to the data repo at 04:00 UTC.

Built by PrintMoneyLab.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "x402watch": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.x402.printmoneylab.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.