{"openapi":"3.1.0","info":{"title":"x402 Agent Services","version":"1.0.0","contact":{"name":"x402 Agent Services","url":"https://call402.com/"},"x-guidance":"All /api/* endpoints are pay-per-call via x402 v2 (exact, Base mainnet, USDC). Call any endpoint without payment to receive the live 402 challenge with exact price, network, asset and payTo; the runtime 402 response is authoritative over this document. Pay with any x402 client (e.g. @x402/fetch) and retry with the PAYMENT-SIGNATURE header. Free endpoints: /, /pricing, /stats, /health, /openapi.json, /llms.txt, /.well-known/x402.json, /.well-known/agent.json, and POST /mcp for initialize/tools/list.","description":"USDC pay-per-call APIs for AI agents via the x402 protocol (v2, exact, Base mainnet). Send a request, receive HTTP 402 with payment requirements, pay with @x402/fetch or any x402 client, retry with the PAYMENT-SIGNATURE header."},"servers":[{"url":"https://call402.com"}],"x-x402":{"version":2,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xAc6F1C3C3b17040730F16dC24Ee9993e9565BE4A","facilitator":"https://facilitator.payai.network"},"paths":{"/api/text-to-structure":{"post":{"summary":"Text to strict JSON structure","description":"Turn unstructured text into strict, machine-readable JSON for agent pipelines: a deterministic, reproducible alternative to an LLM extraction call. Extracts emails, URLs, EVM wallet addresses, transaction hashes, ISO-normalized dates, money amounts, percentages, phone numbers and key:value pairs from invoices, emails, messages, logs or documents. Pass fields or a JSON schema to receive exactly the fields you need. Same input, same output, in milliseconds.","operationId":"Text_to_strict_JSON_structure","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xAc6F1C3C3b17040730F16dC24Ee9993e9565BE4A","scheme":"exact"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}},"schema":{"type":"object"}},"required":["text"]}}}},"responses":{"200":{"description":"Success (after x402 payment settles)","content":{"application/json":{"schema":{"type":"object","description":"Tool result payload; per-endpoint fields are documented in the docs page and llms.txt"}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required — x402 v2 challenge in PAYMENT-REQUIRED header","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64-encoded PaymentRequired JSON"}}}}}},"/api/wallet-activity-summary":{"post":{"summary":"Wallet activity summary","description":"Wallet due diligence for any EVM address on Ethereum or Base: native balance, recent transactions with counterparties, top token holdings with USD values when known, plus anomaly flags for burst activity, concentrated outflows and contract wallets. For counterparty screening, airdrop eligibility checks, portfolio snapshots, or checking a wallet before transacting with it. Sources: public indexers (Blockscout, Etherscan) with on-chain RPC fallback; responses state sources and data_quality.","operationId":"Wallet_activity_summary","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xAc6F1C3C3b17040730F16dC24Ee9993e9565BE4A","scheme":"exact"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string"},"chain":{"type":"string","enum":["ethereum","base"]}},"required":["address"]}}}},"responses":{"200":{"description":"Success (after x402 payment settles)","content":{"application/json":{"schema":{"type":"object","description":"Tool result payload; per-endpoint fields are documented in the docs page and llms.txt"}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required — x402 v2 challenge in PAYMENT-REQUIRED header","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64-encoded PaymentRequired JSON"}}}}}},"/api/token-risk-summary":{"post":{"summary":"Token risk summary","description":"Pre-trade token safety check for trading agents, snipers and treasuries: is this ERC-20 a honeypot, what are the buy/sell taxes, can supply be minted, is ownership reclaimable, how deep is the liquidity? One call combines Honeypot.is simulation, GoPlus security audit, DexScreener liquidity, volume and pair age, and on-chain contract checks into a 0-100 risk_score, risk_level and flags for any token on Base or Ethereum. Run it before swaps, listings or purchases. Not financial advice.","operationId":"Token_risk_summary","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xAc6F1C3C3b17040730F16dC24Ee9993e9565BE4A","scheme":"exact"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string"},"chain":{"type":"string","enum":["base","ethereum"]}},"required":["address"]}}}},"responses":{"200":{"description":"Success (after x402 payment settles)","content":{"application/json":{"schema":{"type":"object","description":"Tool result payload; per-endpoint fields are documented in the docs page and llms.txt"}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required — x402 v2 challenge in PAYMENT-REQUIRED header","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64-encoded PaymentRequired JSON"}}}}}},"/api/token-quotes":{"post":{"summary":"Token price quotes","description":"Live DEX price and market snapshot for any token by contract address (Base, Ethereum, Solana, BSC and other DexScreener chains): spot price in USD, liquidity, 24h and 1h volume, buy/sell counts, FDV and market cap for the most liquid pairs. For trading agents, portfolio trackers and quote checks before a swap. Source: DexScreener public data. Not financial advice.","operationId":"Token_price_quotes","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xAc6F1C3C3b17040730F16dC24Ee9993e9565BE4A","scheme":"exact"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string"}},"required":["address"]}}}},"responses":{"200":{"description":"Success (after x402 payment settles)","content":{"application/json":{"schema":{"type":"object","description":"Tool result payload; per-endpoint fields are documented in the docs page and llms.txt"}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required — x402 v2 challenge in PAYMENT-REQUIRED header","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64-encoded PaymentRequired JSON"}}}}}},"/api/trending-pools":{"post":{"summary":"Trending pools","description":"Trending liquidity pools right now on Base, Ethereum, Solana or BSC: pool name and address, base token price, 24h volume, liquidity, buy/sell counts and FDV, in the network's trending order. For trading agents scanning what is moving, market monitors and discovery pipelines. Source: GeckoTerminal public data. Not financial advice.","operationId":"Trending_pools","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xAc6F1C3C3b17040730F16dC24Ee9993e9565BE4A","scheme":"exact"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"network":{"type":"string","enum":["base","ethereum","solana","bsc"]},"limit":{"type":"integer"}},"required":[]}}}},"responses":{"200":{"description":"Success (after x402 payment settles)","content":{"application/json":{"schema":{"type":"object","description":"Tool result payload; per-endpoint fields are documented in the docs page and llms.txt"}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required — x402 v2 challenge in PAYMENT-REQUIRED header","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64-encoded PaymentRequired JSON"}}}}}},"/api/fx-rates":{"post":{"summary":"FX reference rates","description":"Daily foreign-exchange reference rates for the major fiat currencies (USD, EUR, CNY, GBP, JPY, HKD and more) from the European Central Bank via Frankfurter: convert amounts, price in a local currency, or sanity-check a rate before a payment. Give a base currency and optional symbols and amount. Reference rates are published once per working day; they are not live trading quotes.","operationId":"FX_reference_rates","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xAc6F1C3C3b17040730F16dC24Ee9993e9565BE4A","scheme":"exact"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"base":{"type":"string"},"symbols":{"type":"array","items":{"type":"string"}},"amount":{"type":"number"}},"required":[]}}}},"responses":{"200":{"description":"Success (after x402 payment settles)","content":{"application/json":{"schema":{"type":"object","description":"Tool result payload; per-endpoint fields are documented in the docs page and llms.txt"}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required — x402 v2 challenge in PAYMENT-REQUIRED header","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64-encoded PaymentRequired JSON"}}}}}},"/api/weather":{"post":{"summary":"Weather current and forecast","description":"Current weather and a short forecast for any city worldwide: temperature, feels-like, humidity, wind and precipitation probability, from Open-Meteo public weather models. For travel-planning agents, logistics, event planning and location-aware assistants. Give a city name (or latitude/longitude) and get structured weather JSON.","operationId":"Weather_current_and_forecast","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xAc6F1C3C3b17040730F16dC24Ee9993e9565BE4A","scheme":"exact"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"city":{"type":"string"},"latitude":{"type":"number"},"longitude":{"type":"number"},"days":{"type":"integer"}},"required":[]}}}},"responses":{"200":{"description":"Success (after x402 payment settles)","content":{"application/json":{"schema":{"type":"object","description":"Tool result payload; per-endpoint fields are documented in the docs page and llms.txt"}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required — x402 v2 challenge in PAYMENT-REQUIRED header","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64-encoded PaymentRequired JSON"}}}}}},"/api/email-verify":{"post":{"summary":"Email validation","description":"Email address validation for signup screening, lead cleanup and form verification: syntax check, disposable/temporary-domain detection and a live MX-record lookup for the domain. Returns a deliverability verdict (likely_deliverable, risky, undeliverable, invalid_format) with the MX hosts found. Does not probe individual mailboxes, so catch-all domains may still accept addresses that do not exist.","operationId":"Email_validation","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xAc6F1C3C3b17040730F16dC24Ee9993e9565BE4A","scheme":"exact"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"}},"required":["email"]}}}},"responses":{"200":{"description":"Success (after x402 payment settles)","content":{"application/json":{"schema":{"type":"object","description":"Tool result payload; per-endpoint fields are documented in the docs page and llms.txt"}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required — x402 v2 challenge in PAYMENT-REQUIRED header","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64-encoded PaymentRequired JSON"}}}}}},"/health":{"get":{"summary":"Health check (free)","security":[],"responses":{"200":{"description":"OK"}}}},"/pricing":{"get":{"summary":"Pricing catalog (free)","security":[],"responses":{"200":{"description":"OK"}}}},"/stats":{"get":{"summary":"Public call/revenue stats, internal calls excluded (free)","security":[],"responses":{"200":{"description":"OK"}}}},"/mcp":{"post":{"summary":"Minimal MCP endpoint: initialize + tools/list free; tools/call requires x402 payment","security":[],"responses":{"200":{"description":"JSON-RPC result"},"402":{"description":"Payment Required"}}}}}}