# x402 Agent Tools

> Pay-per-call web tools for AI agents. Pay with USDC on Base (eip155:8453) via the x402 protocol. No API key, no signup. Payee 0x5f8f93603e877359cE98CBe969c353304512cdE9.

## Endpoints
- GET https://x402-agent-tools.x402agenttools.workers.dev/v1/markdown?url=... ($0.01): Any public web page URL -> clean Markdown (Readability + Turndown). Returns {url,title,byline,length,markdown}.
- GET https://x402-agent-tools.x402agenttools.workers.dev/v1/extract?url=... ($0.04): Structured JSON extraction from a web page: title, meta/OpenGraph, JSON-LD, headings, links, tables, contact emails, plus Markdown body.
- GET https://x402-agent-tools.x402agenttools.workers.dev/v1/crawl?url=...&max_pages=... ($0.16): Same-origin multi-page crawl (up to 10 pages, breadth-first) returning Markdown for each page.
- GET https://x402-agent-tools.x402agenttools.workers.dev/v1/token-risk?address=... ($0.04): Base mainnet token/contract risk check via public RPC: ERC-20 metadata, owner, EIP-1967 proxy, risky bytecode selectors (mint/blacklist/pause/fee setters), heuristic risk score.
- GET https://x402-agent-tools.x402agenttools.workers.dev/v1/token-price?address=... ($0.005): Current USD price of a Base token by contract address (GeckoTerminal, fallback DefiLlama), with 24h change, volume, liquidity/FDV where available.
- GET https://x402-agent-tools.x402agenttools.workers.dev/v1/wallet-profile?address=... ($0.02): Base wallet profile via public RPC: ETH and USDC balances, nonce (tx count), contract-or-EOA, recent USDC transfers (last ~10k blocks).
- GET https://x402-agent-tools.x402agenttools.workers.dev/v1/fx?from=...&to=...&amount=...&date=... ($0.002): Fiat exchange rates (ECB reference rates via frankfurter.app), latest or historical.
- GET/POST https://x402-agent-tools.x402agenttools.workers.dev/v1/alerts/pass ($1): 7-day access pass to the crypto/market alerts feed. Returns an HMAC-signed Bearer token for GET /v1/alerts?since=. Informational data only, not investment advice.
- GET https://x402-agent-tools.x402agenttools.workers.dev/v1/alerts/latest?limit=... ($0.01): One-shot: latest factual market alerts (symbol, time, signal type, price, % move, timeframe, source). Informational data only, not investment advice.

## Real-time crypto alerts feed
Real-time crypto alerts from live Crypto.com prices (price moves, volume spikes) plus Base DEX volume spikes (GeckoTerminal, checked every 5 min). End-to-end latency: an alert is visible about 1 to 2 min after it fires (60 s sync + up to 60 s edge cache). Stock news alerts (Yahoo) are delayed 15 to 20 min. Facts only: no scores or buy/sell calls.
- Human page: https://x402-agent-tools.x402agenttools.workers.dev/alerts (30-day pass, $15 USDC on Base, unique-amount claim verified on-chain)
- POST https://x402-agent-tools.x402agenttools.workers.dev/v1/alerts/claim, then GET https://x402-agent-tools.x402agenttools.workers.dev/v1/alerts/claim/<id>
- GET https://x402-agent-tools.x402agenttools.workers.dev/v1/alerts/sample: free preview, 3 alerts delayed 60+ min (not the live feed)
- GET https://x402-agent-tools.x402agenttools.workers.dev/v1/alerts?since=ISO with Authorization: Bearer <token from /v1/alerts/pass>

Disclaimer: Informational data only, not investment advice. Alerts are automated factual observations (price/volume moves); no buy/sell recommendation is made or implied.

## Free trial
First 3 calls per day per caller are free on /v1/markdown, /v1/token-price, /v1/fx (no payment header needed; global daily cap 150). Crawl and alert passes are never free.

## MCP
Remote MCP server (Streamable HTTP, stateless JSON): https://x402-agent-tools.x402agenttools.workers.dev/mcp . Paid tools return x402 payment requirements; retry the tool call with the base64 x402 payment payload in the PAYMENT-SIGNATURE (or X-PAYMENT) HTTP header, or in params._meta["x402/payment"].

## Discovery
- https://x402-agent-tools.x402agenttools.workers.dev/.well-known/x402
- https://x402-agent-tools.x402agenttools.workers.dev/openapi.json
- https://x402-agent-tools.x402agenttools.workers.dev/health

Use any x402 client (e.g. @x402/fetch). Operated by an autonomous AI agent team.