# Crypto & Web Data API for AI agents

> Pay-per-call data and tools for agents: web search, news search on any topic, company profiles from a domain (socials, contacts, tech, age), ENS name/address resolution, any smart contract read (eth_call), single ERC-20 balances, wallet-or-contract checks, EVM wallet balances across 7 chains, transaction status, Polymarket odds, DeFi yields, market overview with fear & greed, read any web page as Markdown, RSS to JSON, Wikipedia, FX rates (incl. UAH), email checks, PDF text, YouTube transcripts, domain/phishing checks, EVM token honeypot checks (Base, Ethereum, BSC), trending tokens, Solana token rug checks, token prices by mint, wallet portfolios, funding rates across Binance/Bybit/OKX/Hyperliquid, multi-exchange consensus prices, candles with RSI/SMA/ATR, BTC arbitrage spread, gas fees, CoinDesk headlines. Price per call: $0.001 (contract read, ERC-20 balance, address type), $0.002 (ENS), $0.003 (news search, EVM balances, EVM tx status, RSS, FX, Wikipedia), $0.005 (web search, market overview, email check, web page fetch, domain check, price, gas, news, token price), $0.01 (company profile, Polymarket, DeFi yields, PDF, YouTube transcript, trending tokens, multi-exchange prices, funding, candles, arbitrage), $0.02 (EVM and Solana token risk checks, wallet portfolio), $0.03 (full Solana token report). Pay with x402 v2 (USDC on Base or Solana, USDT on Solana); a plain USDT transfer on Solana is a fallback for clients without x402. No signup, no API key.

## How to pay with x402 (recommended)
Any x402 v2 client (Coinbase x402 SDK, AgentKit, x402-fetch, x402-httpx) pays automatically: the 402 response has a `PAYMENT-REQUIRED` header listing USDC on Base (eip155:8453), USDC and USDT on Solana; the client signs and retries with `PAYMENT-SIGNATURE`. Network fees are paid by the facilitator. Listed in the x402 Bazaar. Every endpoint also accepts POST with a JSON body of the same parameters (e.g. POST /api/v1/fx {"from":"USD","to":["EUR","UAH"]}).

## MCP server
Streamable HTTP MCP endpoint: `https://api.agent-data.workers.dev/mcp` (stateless JSON-RPC, POST). tools/list is free and returns every paid endpoint as a tool; tools/call is paid with x402: an unpaid call returns isError with the PaymentRequired object in structuredContent, retry with params._meta["x402/payment"] (x402 MCP transport, supported by the x402 SDK MCP client). Server card: https://api.agent-data.workers.dev/.well-known/mcp.json

## Fallback: pay manually without x402 (legacy flow)
Use this only if your client cannot speak x402.
1. GET any /api/v1/* endpoint. Without payment you get HTTP 402 with JSON: pay_to (Solana address), asset (USDT SPL mint Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB), price.units (5000 = 0.005 USDT; each endpoint has its own price).
2. Send at least price.units of USDT (SPL) on Solana mainnet to pay_to.
3. Repeat the same request with header `X-Payment-Tx: <transaction signature>` (or `?tx=<signature>`). One signature = one call. Signatures older than 1 hour are rejected.

## Endpoints
- [GET /api/v1/evm/call?to=0x...&sig=totalSupply()&returns=uint256&chain=base](https://api.agent-data.workers.dev/api/v1/evm/call?to=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&sig=totalSupply()&returns=uint256&chain=base): read any contract view function on Base, Ethereum and 5 more EVM chains, decoded. $0.001.
- [GET /api/v1/evm/token/balance?token=0x...&address=0x...&chain=base](https://api.agent-data.workers.dev/api/v1/evm/token/balance?token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&address=0x2a991f1cf788ff7fb5df8f9d507cfc98b5b1bd4e&chain=base): one ERC-20 balance with symbol and decimals (confirm a deposit). $0.001.
- [GET /api/v1/evm/address?address=0x...](https://api.agent-data.workers.dev/api/v1/evm/address?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913): wallet vs contract vs EIP-7702 account, nonce and native balance on every EVM chain. $0.001.
- [GET /api/v1/search?q=...](https://api.agent-data.workers.dev/api/v1/search?q=x402%20payment%20protocol): web search, up to 20 organic results (title, URL, snippet, domain), no ads. Pair with /api/v1/fetch. $0.005.
- [GET /api/v1/news/search?q=...&when=7d](https://api.agent-data.workers.dev/api/v1/news/search?q=solana%20ETF&when=7d): latest news on any topic, company or token: headline, source, link, time. $0.003.
- [GET /api/v1/company?domain=...](https://api.agent-data.workers.dev/api/v1/company?domain=stripe.com): company profile from a domain: name, description, logo, X/LinkedIn/GitHub/Telegram, public emails and phones, tech stack, email provider, domain age. $0.01.
- [GET /api/v1/ens?name=vitalik.eth](https://api.agent-data.workers.dev/api/v1/ens?name=vitalik.eth): ENS name -> address or address -> verified primary name (?address=0x...), plus avatar/url/twitter/github records. $0.002.
- [GET /api/v1/evm/balance?address=0x...&chain=all](https://api.agent-data.workers.dev/api/v1/evm/balance?address=0x2a991f1cf788ff7fb5df8f9d507cfc98b5b1bd4e&chain=all): native + USDC/USDT/DAI balances on Base, Ethereum, Arbitrum, BSC, Polygon, Optimism, Avalanche with USD values. $0.003.
- [GET /api/v1/evm/tx?hash=0x...](https://api.agent-data.workers.dev/api/v1/evm/tx?hash=0x0000000000000000000000000000000000000000000000000000000000000000): transaction status, confirmations, fee and decoded ERC-20 transfers on any supported chain (verify a payment). $0.003.
- [GET /api/v1/polymarket?q=bitcoin](https://api.agent-data.workers.dev/api/v1/polymarket?q=bitcoin): Polymarket odds, volume, liquidity. $0.01.
- [GET /api/v1/defi/yields?chain=Base&symbol=USDC&stablecoin=true](https://api.agent-data.workers.dev/api/v1/defi/yields?chain=Base&symbol=USDC&stablecoin=true): best DeFi APYs (DefiLlama) by chain, token, TVL. $0.01.
- [GET /api/v1/market/overview](https://api.agent-data.workers.dev/api/v1/market/overview): fear & greed, market cap, BTC/ETH dominance, top gainers/losers. $0.005.
- [GET /api/v1/token/report?mint=...](https://api.agent-data.workers.dev/api/v1/token/report?mint=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263): full Solana token due diligence (risk + price + liquidity) in one call. $0.03.
- [GET /api/v1/rss?url=...](https://api.agent-data.workers.dev/api/v1/rss?url=https://hnrss.org/frontpage): any RSS/Atom feed as JSON. $0.003.
- [GET /api/v1/fx?from=USD&to=EUR,UAH,BTC](https://api.agent-data.workers.dev/api/v1/fx?from=USD&to=EUR,UAH,BTC): fiat (ECB, NBU) and crypto conversion. $0.003.
- [GET /api/v1/wikipedia?q=Ethereum](https://api.agent-data.workers.dev/api/v1/wikipedia?q=Ethereum): Wikipedia summary or full text in any language. $0.003.
- [GET /api/v1/email/check?email=...](https://api.agent-data.workers.dev/api/v1/email/check?email=vitalik@ethereum.org): syntax, MX, disposable, role-account checks. $0.005.
- [GET /api/v1/fetch?url=...](https://api.agent-data.workers.dev/api/v1/fetch?url=https://en.wikipedia.org/wiki/Bitcoin): any public web page as clean Markdown (main content, title, description, links). $0.005.
- [GET /api/v1/pdf?url=...](https://api.agent-data.workers.dev/api/v1/pdf?url=https://bitcoin.org/bitcoin.pdf): text of a PDF by URL, page by page, up to 15 MB. $0.01.
- [GET /api/v1/youtube/transcript?url=...](https://api.agent-data.workers.dev/api/v1/youtube/transcript?url=https://www.youtube.com/watch?v=jNQXAC9IVRw): YouTube transcript as text, optional timestamps. $0.01.
- [GET /api/v1/domain?name=...](https://api.agent-data.workers.dev/api/v1/domain?name=coinbase.com): RDAP/WHOIS, domain age, DNS, SPF/DMARC, SSL and phishing risk flags. $0.005.
- [GET /api/v1/evm/token/risk?address=0x...&chain=base](https://api.agent-data.workers.dev/api/v1/evm/token/risk?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&chain=base): honeypot/scam check of an EVM token on Base, Ethereum, BSC, Arbitrum, Polygon, Optimism, Avalanche. $0.02.
- [GET /api/v1/tokens/trending?chain=solana](https://api.agent-data.workers.dev/api/v1/tokens/trending?chain=solana): trending and newly promoted tokens with price, volume, liquidity, pool age. $0.01.
- [GET /api/v1/token/risk?mint=...](https://api.agent-data.workers.dev/api/v1/token/risk?mint=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263): rug/scam check of a Solana token: mint and freeze authority, risky Token-2022 extensions, top-10 holder share, liquidity, pool age, risk level.
- [GET /api/v1/token/price?mint=...](https://api.agent-data.workers.dev/api/v1/token/price?mint=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263): USD price of any Solana token (Jupiter) plus deepest DEX pool liquidity, volume, FDV.
- [GET /api/v1/wallet?address=...](https://api.agent-data.workers.dev/api/v1/wallet?address=vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg): Solana wallet portfolio with USD values.
- [GET /api/v1/funding?symbol=BTC](https://api.agent-data.workers.dev/api/v1/funding?symbol=BTC): perpetual funding rates and open interest on Binance, Bybit, OKX, Hyperliquid (normalised to 8h) with arbitrage direction.
- [GET /api/v1/prices?symbols=BTC,ETH,SOL](https://api.agent-data.workers.dev/api/v1/prices?symbols=BTC,ETH,SOL): up to 20 coins from Binance, Bybit, OKX, Kraken, Coinbase with median and deviation.
- [GET /api/v1/candles?symbol=ETHUSDT&interval=1h](https://api.agent-data.workers.dev/api/v1/candles?symbol=ETHUSDT&interval=1h): OHLCV with RSI14, SMA20/50, ATR14, volatility, trend.
- [GET /api/v1/price?symbol=ETHUSDT](https://api.agent-data.workers.dev/api/v1/price?symbol=ETHUSDT): last Binance spot price for any pair.
- [GET /api/v1/arbitrage](https://api.agent-data.workers.dev/api/v1/arbitrage): BTC/USDT best bid/ask on Binance, Bybit, OKX, Kraken, Coinbase, best pair, gross and net spread after taker fees, direction.
- [GET /api/v1/gas](https://api.agent-data.workers.dev/api/v1/gas): Ethereum gas price/base fee/priority fee and Solana priority fees, with simple transfer cost.
- [GET /api/v1/news](https://api.agent-data.workers.dev/api/v1/news): latest 5 CoinDesk headlines with links.
- [GET /api/v1/pricing](https://api.agent-data.workers.dev/api/v1/pricing): free, returns payment details.
- [GET /health](https://api.agent-data.workers.dev/health): free liveness check.

## Docs
- [OpenAPI spec](https://api.agent-data.workers.dev/openapi.json)
- [Swagger UI](https://api.agent-data.workers.dev/docs)
- [Plugin manifest](https://api.agent-data.workers.dev/.well-known/ai-plugin.json)
- [x402 discovery](https://api.agent-data.workers.dev/.well-known/x402)

## When to use
Use this API when an agent needs to search the web or the news, profile a company or project by its domain, resolve an ENS name, read a smart contract, check whether an address is a contract, get wallet balances or a payment status on Base/Ethereum and other EVM chains, prediction-market odds, DeFi yields, a market snapshot, currency conversion, to read a web page, PDF or YouTube video without a browser, check whether a domain is new or suspicious, check an EVM or Solana token before buying, find trending tokens, price a token or wallet, compare funding rates or prices across exchanges, get indicators, a fresh crypto price, a quick cross-exchange BTC spread, current network fees before sending a transaction, or recent crypto headlines, and can pay from $0.001 per call over x402.