# x402 Agent Services

Pay-per-call APIs for AI agents, settled in USDC on Base mainnet via the x402 protocol (v2, exact scheme).
Facilitator: https://facilitator.payai.network | Network: eip155:8453 | USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 | payTo: 0xAc6F1C3C3b17040730F16dC24Ee9993e9565BE4A

## Paid APIs (POST, x402)
- https://call402.com/api/text-to-structure — $0.01 — Natural language text -> strict JSON (deterministic extractor: entities, dates, money, key-values, per-field/schema extraction).
- https://call402.com/api/wallet-activity-summary — $0.05 — Wallet due diligence: native balance, recent activity, top token holdings, anomaly flags (Ethereum and Base; Blockscout/Etherscan indexers with on-chain RPC fallback).
- https://call402.com/api/token-risk-summary — $0.05 — Pre-trade token safety check: risk score 0-100 with honeypot/tax simulation, GoPlus security audit, liquidity and volume. Not financial advice.
- https://call402.com/api/token-quotes — $0.005 — Live DEX price and market snapshot for any token address: USD price, liquidity, 24h/1h volume, buy/sell counts, FDV and market cap (DexScreener). Not financial advice.
- https://call402.com/api/trending-pools — $0.005 — Trending liquidity pools on Base, Ethereum, Solana or BSC with prices, volume, liquidity and buy/sell counts (GeckoTerminal). Not financial advice.
- https://call402.com/api/fx-rates — $0.005 — Daily fiat FX reference rates for 30 currencies (ECB via Frankfurter), with optional amount conversion. Daily reference rates, not live trading quotes.
- https://call402.com/api/weather — $0.005 — Current weather and up to 7-day forecast for any city: temperature, feels-like, humidity, wind, precipitation probability (Open-Meteo).
- https://call402.com/api/email-verify — $0.005 — Email validation: syntax, disposable-domain detection and live MX lookup with a deliverability verdict. No mailbox probing.


## When to use which
- Before a swap, snipe or token purchase: call token-risk-summary on the token contract to screen for honeypots, high taxes, mintable supply and thin liquidity.
- Before sending funds to, or transacting with, an unfamiliar address: call wallet-activity-summary to check its balance, history, holdings and anomaly flags.
- When a pipeline needs fields out of raw text (invoice, email, message, log) without an LLM call: call text-to-structure with fields or a JSON schema and get deterministic JSON back.

- For a live token price before quoting or swapping: call token-quotes; to see what is trending on a chain right now: call trending-pools.
- For everyday reference data: call fx-rates for currency conversion rates, weather for a city forecast, or email-verify to check that an email domain can receive mail.

## Guides
- https://call402.com/guides/token-risk-api — Token Risk Summary API for AI agents: honeypot/tax checks, risk score 0-100, $0.05/call.
- https://call402.com/guides/wallet-activity-api — Wallet Activity Summary API for AI agents: balances, activity, anomaly flags, $0.05/call.

## How to pay
1. POST without payment -> HTTP 402 with a PAYMENT-REQUIRED header (base64 PaymentRequired JSON).
2. Pay with an x402 client, e.g. @x402/fetch wrapFetchWithPayment(fetch, x402Client), which signs an EIP-3009 USDC authorization.
3. Retry the request; the PAYMENT-SIGNATURE header is verified and settled by the facilitator, then the API result is returned with a PAYMENT-RESPONSE header.

## Free endpoints
- GET https://call402.com/health — health check
- GET https://call402.com/pricing — JSON pricing catalog
- GET https://call402.com/stats — public stats (internal calls excluded)
- GET https://call402.com/openapi.json — OpenAPI 3.1 document
- GET https://call402.com/.well-known/x402.json — x402 resource manifest
- POST https://call402.com/mcp — MCP: initialize and tools/list are free; tools/call requires the same x402 payment per tool.