# 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://api.cdp.coinbase.com/platform/v2/x402 | Network: eip155:8453 | USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 | payTo: 0xAc6F1C3C3b17040730F16dC24Ee9993e9565BE4A
Support: support@call402.com | Status: https://call402.com/health | Catalog: https://call402.com/pricing | Live stats: https://call402.com/stats

## MLOC x402 pilot
Provider: MLOC (mloc.ai). Storefront: call402.
- GPT model gpt-6.1-sol ($0.0180) per call: POST https://call402.com/v1/chat/completions.
- Claude model claude-opus-5-5 ($0.0432) per call: POST https://call402.com/messages.
- DeepSeek models deepseek-flash ($0.0048), deepseek-v4-pro ($0.0185) per call, provider DeepSeek (official direct): POST https://call402.com/v1/chat/completions.
- Kimi, Qwen and GLM are planned / not yet available.
- Gemini image model gemini-3.1-flash-image ($0.0402) per image (1K): POST https://call402.com/v1/images/generations. Gemini on MLOC is image generation only; no Gemini chat model is offered.

## Paid APIs (POST, x402)
- Catalog: https://call402.com/catalog
- https://call402.com/api/text-to-structure — $0.002 — Natural language text -> strict JSON (deterministic extractor: entities, dates, money, key-values, per-field/schema extraction).
- 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/email-verify — $0.005 — Email validation: syntax, disposable-domain detection and live MX lookup with a deliverability verdict. No mailbox probing.
- https://call402.com/api/phone-lookup — $0.005 — Local numbering-plan parsing via libphonenumber; data_source = "numbering plan (libphonenumber)". Current network assignment and subscriber status are not queried.
- https://call402.com/api/wallet-lookup — $0.005 — Base wallet balance lookup read directly from chain state via public RPC (self-hosted reader): native ETH plus a curated 195-token list, with recent-transfer discovery over a monitored contract set. Response includes a coverage field: tokens outside the list with no transfers in the discovery window (default about 28 hours) are not reported. Balances only, no USD valuation.
- https://call402.com/api/fear-greed-index — $0.005 — Crypto Fear & Greed Index (alternative.me, published for commercial use with attribution): current sentiment value/classification plus up to 30 days of history for trading and risk agents.
- https://call402.com/api/text-extract — $0.005 — Readable main-content extraction for any public web page (Mozilla Readability on our own servers): title, excerpt and clean body text for RAG, summarization and research.
- https://call402.com/api/ssl-check — $0.005 — TLS certificate check by direct handshake: issuer, SANs, expiry and days remaining, chain verification result.
- https://call402.com/api/domain-lookup — $0.005 — Domain one-stop lookup: live DNS records plus RDAP registration data (registrar, created/expires, status).
- https://call402.com/api/qr-code — $0.005 — QR code image generation (SVG or base64 PNG) for payment addresses, URLs and any text, rendered on our own servers.
- https://call402.com/api/sec-company-facts — $0.005 — Latest public SEC EDGAR Revenue, NetIncomeLoss and Assets by ticker, CIK or company name, with filing dates and fiscal periods.
- https://call402.com/api/language-detect — $0.005 — Fully local language detection for 10 languages with language code, name, confidence and alternatives.
- https://call402.com/api/timestamp-convert — $0.005 — Convert Unix seconds, milliseconds or ISO dates to UTC and Asia/Shanghai; omit input to get current time.
- https://call402.com/api/hash-tools — $0.005 — Local SHA-256/SHA-512, Base64 encode/decode and UUID v4 utilities.
- https://call402.com/dex-quote — $0.005 — Self-computed long-tail token USD quotes from public on-chain DEX pools on Base, BNB Smart Chain and Ethereum; majors excluded, V3 depth estimated.
- https://call402.com/api/x402-integration-pack — $0.005 — Production buyer kit for x402 v2 on Base: complete TypeScript and Python buyer code, settlement verification, failure-reason table and budget-guard patterns.


## Example requests
- POST https://call402.com/api/text-to-structure - request: {"text":"Invoice 1042 from Acme Corp. Total due: $1,250.00 by 2026-11-15. Questions: billing@acme.com","fields":["total","due_date","email"]} -> response fields: total, due_date, email
- POST https://call402.com/api/agent-jobs - request: {} -> response fields: jobs, sources, disclaimer
- POST https://call402.com/api/fx-rates - request: {"base":"USD","symbols":["EUR","CNY"],"amount":100} -> response fields: base, date, amount, rates
- POST https://call402.com/api/email-verify - request: {"email":"support@call402.com"} -> response fields: email, syntax_valid, disposable, mx_found, verdict
- POST https://call402.com/api/phone-lookup - request: {"number":"+14155552671","country":"US"} -> response fields: number, valid, country, carrier_type, data_source
- POST https://call402.com/api/wallet-lookup - request: {"address":"0xAc6F1C3C3b17040730F16dC24Ee9993e9565BE4A"} -> response fields: address, balances, coverage
- POST https://call402.com/api/fear-greed-index - request: {"limit":1} -> response fields: value, value_classification, timestamp, source
- POST https://call402.com/api/text-extract - request: {"url":"https://example.com/some-article"} -> response fields: url, title, excerpt, text
- POST https://call402.com/api/ssl-check - request: {"host":"call402.com"} -> response fields: host, issuer, subject, sans, not_after, days_remaining, chain_valid
- POST https://call402.com/api/domain-lookup - request: {"domain":"call402.com"} -> response fields: domain, dns, rdap
- POST https://call402.com/api/qr-code - request: {"text":"https://call402.com","format":"svg","size":512} -> response fields: format, size, data
- POST https://call402.com/api/sec-company-facts - request: {"ticker":"AAPL"} -> response fields: ticker, company, cik, facts
- POST https://call402.com/api/language-detect - request: {"text":"Bonjour le monde, ceci est un exemple"} -> response fields: language, name, confidence, alternatives
- POST https://call402.com/api/timestamp-convert - request: {"timestamp":1793707469} -> response fields: unix_seconds, utc, asia_shanghai
- POST https://call402.com/api/hash-tools - request: {"text":"hello","op":"hash"} -> response fields: op, algorithm, sha256
- POST https://call402.com/api/x402-integration-pack - request: {} -> response fields: pack, contents
- POST https://call402.com/dex-quote - request: {"chain":"base","token":"0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed"} -> response fields: chain, token, symbol, price_usd, pool, note

## When to use which
- 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.
- Before sizing a crypto trade, or when gauging market mood: call fear-greed-index for the current sentiment value and classification.
- When an agent needs the full text of one specific page (article, docs, product page) rather than search results: call text-extract with the URL and get clean readable text back for reading, summarizing or RAG ingestion.

- For everyday reference data: call fx-rates for currency conversion rates, email-verify to check that an email domain can receive mail, ssl-check and domain-lookup for counterparty site checks, or qr-code when a human needs to scan a payment address or link.
- For US public-company filing metrics use sec-company-facts; for text classification use language-detect; for time normalization use timestamp-convert; for local digest and encoding operations use hash-tools.

## Guides
- https://call402.com/learn/x402-explained — x402 explained with a live worked example (free).

## 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.