{"openapi":"3.1.0","info":{"title":"Crypto & Web Data API for AI agents (pay-per-call, from $0.003)","description":"Crypto market data and web tools for autonomous agents: read web pages, PDFs and YouTube transcripts, check domains and tokens. Every `/api/v1/*` call is paid per call: **$0.003** for simple reads, **$0.005-$0.01** for aggregates, **$0.02-$0.03** for token risk checks and reports (USDC or USDT). Each route's price is in `x-payment-info`.\n\n**x402 agents:** pay automatically. The 402 response carries a standard `PAYMENT-REQUIRED` header (x402 v2, USDC on Base or Solana, USDT on Solana); retry with `PAYMENT-SIGNATURE`.\n\n**Manual (legacy) flow:** call the endpoint, read `pay_to`, `asset` and the endpoint's price from the free `GET /api/v1/pricing`, send the USDT transfer, then repeat the call with header `X-Payment-Tx: <signature>`. One signature pays for one call; signatures older than the `max_tx_age_seconds` value are rejected.\n\nMachine-readable spec: `/openapi.json`. LLM summary: `/llms.txt`. MCP server: `POST /mcp`.","contact":{"name":"API support","url":"https://api.agent-data.workers.dev/"},"version":"2.0.0"},"paths":{"/health":{"get":{"tags":["free"],"summary":"Liveness check","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/pricing":{"get":{"tags":["free"],"summary":"Price and payment details (free)","operationId":"pricing_api_v1_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/price":{"get":{"tags":["market"],"summary":"Spot price of a Binance pair","description":"Last price for a Binance spot symbol such as BTCUSDT, ETHUSDT, SOLUSDT. Cached up to 5 s.","operationId":"price_api_v1_price_get","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Z0-9]{5,20}$","examples":["ETHUSDT"],"default":"BTCUSDT","title":"Symbol"}},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceOut"}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}}}},"/api/v1/news":{"get":{"tags":["news"],"summary":"Latest 5 CoinDesk headlines","description":"Parsed from CoinDesk RSS. Cached 5 min.","operationId":"news_api_v1_news_get","parameters":[{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsOut"}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}}}},"/api/v1/gas":{"get":{"tags":["onchain"],"summary":"Ethereum and Solana network fees","description":"Cached 15 s.","operationId":"gas_api_v1_gas_get","parameters":[{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GasOut"}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}}}},"/api/v1/arbitrage":{"get":{"tags":["market"],"summary":"BTC/USDT spread across Binance, Bybit, OKX, Kraken and Coinbase","description":"Compares best bid/ask on every exchange that answers, picks the best buy/sell pair and estimates profit after taker fees. Cached 3 s.","operationId":"arbitrage_api_v1_arbitrage_get","parameters":[{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArbOut"}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.010"}}}},"/api/v1/prices":{"get":{"tags":["market"],"summary":"Consensus prices for up to 20 coins from 5 exchanges","description":"Binance, Bybit, OKX, Kraken (vs USDT) and Coinbase (vs USD) in one call, with the median and the max deviation between venues. Cached 5 s.","operationId":"prices_api_v1_prices_get","parameters":[{"name":"symbols","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9]{2,15}(,[A-Za-z0-9]{2,15}){0,19}$","description":"Comma-separated coin tickers, up to 20","examples":["BTC,ETH,SOL"],"default":"BTC,ETH,SOL","title":"Symbols"},"description":"Comma-separated coin tickers, up to 20"},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.010"}}}},"/api/v1/funding":{"get":{"tags":["derivatives"],"summary":"Perpetual funding rates on Binance, Bybit, OKX and Hyperliquid","description":"Current funding rate, next funding time and open interest for a perpetual on up to four venues, normalised to 8 hours, plus the spread and the funding-arbitrage direction. Cached 30 s.","operationId":"funding_api_v1_funding_get","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9]{2,15}$","description":"Coin ticker","examples":["BTC"],"default":"BTC","title":"Symbol"},"description":"Coin ticker"},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.010"}}}},"/api/v1/candles":{"get":{"tags":["market"],"summary":"OHLCV candles with RSI, SMA, ATR and trend","description":"Binance spot candles plus indicators computed over the last 200 candles: RSI14, SMA20, SMA50, ATR14, volatility and a simple trend label. Cached 30 s.","operationId":"candles_api_v1_candles_get","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Z0-9]{5,20}$","examples":["ETHUSDT"],"default":"BTCUSDT","title":"Symbol"}},{"name":"interval","in":"query","required":false,"schema":{"type":"string","description":"One of 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w","examples":["1h"],"default":"1h","title":"Interval"},"description":"One of 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"How many candles to return","default":50,"title":"Limit"},"description":"How many candles to return"},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.010"}}}},"/api/v1/token/price":{"get":{"tags":["solana"],"summary":"USD price, liquidity and volume of any Solana token by mint","description":"Jupiter aggregated price plus the deepest DEX pool from DexScreener: liquidity, 24h volume, 24h change, FDV, pool age. Works for new and meme tokens. Cached 15-30 s.","operationId":"token_price_api_v1_token_price_get","parameters":[{"name":"mint","in":"query","required":true,"schema":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Token mint address","examples":["DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"],"title":"Mint"},"description":"Token mint address"},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}}}},"/api/v1/token/risk":{"get":{"tags":["solana"],"summary":"Rug / scam check for a Solana token","description":"On-chain checks: mint authority (can print more), freeze authority (can freeze holders), Token-2022 extensions such as permanent delegate or transfer fees, top-10 holder share, plus DEX liquidity and pool age. Returns flags and an overall risk level. Cached 60 s.","operationId":"token_risk_api_v1_token_risk_get","parameters":[{"name":"mint","in":"query","required":true,"schema":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Token mint address","examples":["DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"],"title":"Mint"},"description":"Token mint address"},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.020"}}}},"/api/v1/wallet":{"get":{"tags":["solana"],"summary":"Solana wallet portfolio with USD values","description":"SOL and every SPL / Token-2022 balance of a wallet, priced via Jupiter, sorted by USD value (top 50). Cached 15 s.","operationId":"wallet_api_v1_wallet_get","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Wallet address","examples":["vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg"],"title":"Address"},"description":"Wallet address"},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.020"}}}},"/api/v1/fetch":{"get":{"tags":["web"],"summary":"Read a web page as clean Markdown","description":"Fetches a public URL and returns the main content as Markdown without menus, scripts or ads, plus title, description, language and up to 50 links. HTML, plain text and JSON. Cached 5 min.","operationId":"web_fetch_api_v1_fetch_get","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","minLength":8,"maxLength":2048,"description":"http(s) URL of the page","examples":["https://en.wikipedia.org/wiki/Bitcoin"],"title":"Url"},"description":"http(s) URL of the page"},{"name":"max_chars","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":500,"description":"Truncate the text to this length","default":20000,"title":"Max Chars"},"description":"Truncate the text to this length"},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}}}},"/api/v1/pdf":{"get":{"tags":["web"],"summary":"Extract text from a PDF by URL","description":"Downloads a public PDF (up to 15 MB) and returns its text page by page with title, author and page count. Scanned PDFs without a text layer return little text. Cached 1 h.","operationId":"pdf_text_api_v1_pdf_get","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","minLength":8,"maxLength":2048,"description":"http(s) URL of the PDF","examples":["https://bitcoin.org/bitcoin.pdf"],"title":"Url"},"description":"http(s) URL of the PDF"},{"name":"max_pages","in":"query","required":false,"schema":{"type":"integer","maximum":300,"minimum":1,"default":50,"title":"Max Pages"}},{"name":"max_chars","in":"query","required":false,"schema":{"type":"integer","maximum":200000,"minimum":500,"default":50000,"title":"Max Chars"}},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.010"}}}},"/api/v1/youtube/transcript":{"get":{"tags":["web"],"summary":"YouTube video transcript as text","description":"Subtitles of a YouTube video (manual or auto-generated) as plain text, optionally with timestamps, plus title and channel. Picks the requested language or the best available. Cached 6 h.","operationId":"youtube_transcript_api_v1_youtube_transcript_get","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","description":"Video URL or 11-character id","examples":["https://www.youtube.com/watch?v=jNQXAC9IVRw"],"title":"Url"},"description":"Video URL or 11-character id"},{"name":"lang","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-zA-Z-]{2,10}(,[a-zA-Z-]{2,10}){0,4}$","description":"Preferred languages, comma-separated","default":"en","title":"Lang"},"description":"Preferred languages, comma-separated"},{"name":"timestamps","in":"query","required":false,"schema":{"type":"boolean","description":"Include segments with start times","default":false,"title":"Timestamps"},"description":"Include segments with start times"},{"name":"max_chars","in":"query","required":false,"schema":{"type":"integer","maximum":200000,"minimum":500,"default":50000,"title":"Max Chars"}},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.010"}}}},"/api/v1/domain":{"get":{"tags":["web"],"summary":"Domain check: WHOIS/RDAP, DNS, SSL, age and phishing flags","description":"Registrar, creation and expiry dates (RDAP), A/AAAA/MX/NS/TXT records, SPF and DMARC, the HTTPS certificate and simple risk flags such as a very young domain. Cached 1 h.","operationId":"domain_check_api_v1_domain_get","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","maxLength":253,"pattern":"^([a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,63}$","description":"Domain name without scheme","examples":["coinbase.com"],"title":"Name"},"description":"Domain name without scheme"},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}}}},"/api/v1/evm/token/risk":{"get":{"tags":["evm"],"summary":"Scam / honeypot check for an EVM token (Base, Ethereum, BSC, Arbitrum...)","description":"Honeypot and sell simulation, buy/sell tax, mintable, proxy, hidden owner, blacklist, pausable transfers, open source, holder concentration, LP lock and DEX liquidity, merged from GoPlus, honeypot.is and DexScreener into flags and a risk level. Cached 60 s.","operationId":"evm_token_risk_api_v1_evm_token_risk_get","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Token contract","examples":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"title":"Address"},"description":"Token contract"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","description":"One of arbitrum, avalanche, base, bsc, eth, ethereum, optimism, polygon","default":"base","title":"Chain"},"description":"One of arbitrum, avalanche, base, bsc, eth, ethereum, optimism, polygon"},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.020"}}}},"/api/v1/tokens/trending":{"get":{"tags":["market"],"summary":"Trending and newly promoted tokens with price, volume and liquidity","description":"Tokens currently promoted or newly listed on DexScreener (Solana, Base, Ethereum, BSC...), enriched with price, 1h/24h change, volume, liquidity, FDV, pool age and links, sorted by 24h volume. Cached 60 s.","operationId":"tokens_trending_api_v1_tokens_trending_get","parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string","description":"One of solana, base, ethereum, bsc, arbitrum, polygon, all","default":"solana","title":"Chain"},"description":"One of solana, base, ethereum, bsc, arbitrum, polygon, all"},{"name":"source","in":"query","required":false,"schema":{"type":"string","description":"boosted, latest_boosts or new_profiles","default":"boosted","title":"Source"},"description":"boosted, latest_boosts or new_profiles"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":1,"default":20,"title":"Limit"}},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.010"}}}},"/api/v1/evm/balance":{"get":{"tags":["evm"],"summary":"EVM wallet balances on one or all chains","description":"Native coin plus USDC, USDT, DAI and wrapped native balances of an address on Base, Ethereum, Arbitrum, BSC, Polygon, Optimism and Avalanche (chain=all checks every chain at once), with USD values. On a single chain you can add your own ERC-20 contracts. Cached 15 s.","operationId":"evm_balance_api_v1_evm_balance_get","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Wallet address","examples":["0x2a991f1cf788ff7fb5df8f9d507cfc98b5b1bd4e"],"title":"Address"},"description":"Wallet address"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","description":"all or one of ethereum, base, arbitrum, bsc, polygon, optimism, avalanche","default":"all","title":"Chain"},"description":"all or one of ethereum, base, arbitrum, bsc, polygon, optimism, avalanche"},{"name":"tokens","in":"query","required":false,"schema":{"type":"string","pattern":"^(0x[a-fA-F0-9]{40}(,0x[a-fA-F0-9]{40}){0,9})?$","description":"Extra ERC-20 contracts, comma-separated (single chain only)","default":"","title":"Tokens"},"description":"Extra ERC-20 contracts, comma-separated (single chain only)"},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.003"}}}},"/api/v1/evm/tx":{"get":{"tags":["evm"],"summary":"EVM transaction status, fee and token transfers","description":"Status (pending, success, failed), confirmations, block time, fee and decoded ERC-20 transfers of a transaction. Leave chain empty to search all supported chains. Use to verify a payment arrived. Cached 10 s.","operationId":"evm_tx_api_v1_evm_tx_get","parameters":[{"name":"hash","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"Transaction hash","title":"Hash"},"description":"Transaction hash"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","description":"Optional: ethereum, base, arbitrum, bsc, polygon, optimism, avalanche","default":"","title":"Chain"},"description":"Optional: ethereum, base, arbitrum, bsc, polygon, optimism, avalanche"},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.003"}}}},"/api/v1/polymarket":{"get":{"tags":["markets"],"summary":"Polymarket prediction markets: odds, volume, liquidity","description":"Active Polymarket markets matching a query (all words must appear in the question), or the most traded ones, with outcome probabilities, 24h volume, liquidity, 24h change and end date. Cached 60 s.","operationId":"polymarket_api_v1_polymarket_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":100,"description":"Search words, e.g. 'bitcoin 2026'","examples":["bitcoin"],"default":"","title":"Q"},"description":"Search words, e.g. 'bitcoin 2026'"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Limit"}},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.010"}}}},"/api/v1/defi/yields":{"get":{"tags":["markets"],"summary":"Best DeFi yields (APY) by chain, token and TVL","description":"Top DeFi pools from DefiLlama filtered by chain, token symbol, stablecoin-only and minimum TVL, sorted by APY, with base vs reward APY, 30-day mean, IL risk and TVL. Outliers removed. Cached 15 min.","operationId":"defi_yields_api_v1_defi_yields_get","parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string","maxLength":30,"description":"e.g. Base, Ethereum, Solana, Arbitrum","default":"","title":"Chain"},"description":"e.g. Base, Ethereum, Solana, Arbitrum"},{"name":"symbol","in":"query","required":false,"schema":{"type":"string","maxLength":30,"description":"Token symbol contained, e.g. USDC","default":"","title":"Symbol"},"description":"Token symbol contained, e.g. USDC"},{"name":"stablecoin","in":"query","required":false,"schema":{"type":"boolean","description":"Only stablecoin pools","default":false,"title":"Stablecoin"},"description":"Only stablecoin pools"},{"name":"min_tvl","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"Minimum TVL in USD","default":1000000,"title":"Min Tvl"},"description":"Minimum TVL in USD"},{"name":"project","in":"query","required":false,"schema":{"type":"string","maxLength":40,"description":"e.g. aave-v3, morpho-blue","default":"","title":"Project"},"description":"e.g. aave-v3, morpho-blue"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.010"}}}},"/api/v1/market/overview":{"get":{"tags":["market"],"summary":"Crypto market overview: fear & greed, market cap, dominance, top movers","description":"Fear & Greed index (today and yesterday), total market cap and volume, BTC and ETH dominance, 24h market cap change, and the top 5 gainers and losers among liquid Binance USDT pairs. Cached 2 min.","operationId":"market_overview_api_v1_market_overview_get","parameters":[{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}}}},"/api/v1/token/report":{"get":{"tags":["solana"],"summary":"Full Solana token report in one call: risk + price + liquidity","description":"Everything /token/risk and /token/price return, in one paid call: rug flags and risk level, mint/freeze authority, holders, USD price, deepest pool, liquidity, volume and FDV.","operationId":"token_report_api_v1_token_report_get","parameters":[{"name":"mint","in":"query","required":true,"schema":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Token mint address","examples":["DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"],"title":"Mint"},"description":"Token mint address"},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.030"}}}},"/api/v1/rss":{"get":{"tags":["web"],"summary":"Any RSS or Atom feed as clean JSON","description":"Fetches an RSS 2.0, RSS 1.0 or Atom feed and returns title, link, publish date and a plain-text summary for each item. For news and monitoring agents. Cached 5 min.","operationId":"rss_api_v1_rss_get","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","minLength":8,"maxLength":2048,"examples":["https://hnrss.org/frontpage"],"title":"Url"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.003"}}}},"/api/v1/fx":{"get":{"tags":["market"],"summary":"Currency conversion: fiat (ECB, NBU incl. UAH) and major crypto","description":"Converts an amount between ~60 fiat currencies (ECB reference rates plus National Bank of Ukraine rates) and major cryptocurrencies (Binance, vs USDT). Cached 30 min for fiat, 5 s for crypto.","operationId":"fx_api_v1_fx_get","parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z]{3,5}$","examples":["USD"],"default":"USD","title":"From"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z]{3,5}(,[A-Za-z]{3,5}){0,9}$","examples":["EUR,UAH,BTC"],"default":"EUR","title":"To"}},{"name":"amount","in":"query","required":false,"schema":{"type":"number","maximum":1000000000000,"exclusiveMinimum":0,"default":1,"title":"Amount"}},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.003"}}}},"/api/v1/wikipedia":{"get":{"tags":["web"],"summary":"Wikipedia summary or full article text in any language","description":"Finds the best matching Wikipedia article for a query and returns title, short description, summary, URL and thumbnail; full=true adds the plain-text article. Cached 1 h.","operationId":"wikipedia_api_v1_wikipedia_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"examples":["Ethereum"],"title":"Q"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z]{2,3}(-[a-z]{2,4})?$","default":"en","title":"Lang"}},{"name":"full","in":"query","required":false,"schema":{"type":"boolean","description":"Include the full article text","default":false,"title":"Full"},"description":"Include the full article text"},{"name":"max_chars","in":"query","required":false,"schema":{"type":"integer","maximum":200000,"minimum":500,"default":20000,"title":"Max Chars"}},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.003"}}}},"/api/v1/email/check":{"get":{"tags":["web"],"summary":"Email address check: syntax, MX, disposable, role, free provider","description":"Validates the syntax, checks that the domain has mail servers (MX), and flags disposable domains (100k+ list), role accounts (info@, admin@) and free providers. No SMTP probing. Cached 1 h.","operationId":"email_check_api_v1_email_check_get","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string","minLength":6,"maxLength":254,"examples":["vitalik@ethereum.org"],"title":"Email"}},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}}}},"/api/v1/search":{"get":{"tags":["web"],"summary":"Web search: top results with title, URL and snippet","description":"Searches the public web and returns up to 20 organic results (title, URL, snippet, domain) without ads. Several engines with automatic fallback. Pair with /api/v1/fetch to read a result as Markdown. Cached 10 min.","operationId":"web_search_api_v1_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":300,"description":"Search query","examples":["x402 payment protocol"],"title":"Q"},"description":"Search query"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":10,"title":"Limit"}},{"name":"region","in":"query","required":false,"schema":{"type":"string","pattern":"^([a-z]{2}-[a-z]{2})?$","description":"Optional region such as us-en, uk-en, de-de, ua-uk","default":"","title":"Region"},"description":"Optional region such as us-en, uk-en, de-de, ua-uk"},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}}}},"/api/v1/news/search":{"get":{"tags":["news"],"summary":"Search recent news on any topic, company or token","description":"Latest news articles for a query (headline, source, link, publish time) from Google News with GDELT and Bing News as fallbacks. Filter by language, country and age (when=1h, 1d, 7d, 30d). Cached 5 min.","operationId":"news_search_api_v1_news_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"examples":["solana ETF"],"title":"Q"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z]{2}$","default":"en","title":"Lang"}},{"name":"country","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z]{2}$","default":"US","title":"Country"}},{"name":"when","in":"query","required":false,"schema":{"type":"string","pattern":"^(\\d{1,3}[hd])?$","description":"Max age, e.g. 1h, 1d, 7d","default":"","title":"When"},"description":"Max age, e.g. 1h, 1d, 7d"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.003"}}}},"/api/v1/company":{"get":{"tags":["web"],"summary":"Company profile from a domain: name, description, socials, contacts, tech, age","description":"Enriches a company or project domain in one call: name and description, logo, social profiles (X/Twitter, LinkedIn, GitHub, Telegram, Discord...), public emails and phones, address and founding date from schema.org, website technologies, email provider (MX) and domain age (RDAP). For lead research, due diligence and KYB. Cached 6 h.","operationId":"company_api_v1_company_get","parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string","maxLength":253,"pattern":"^([a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,63}$","description":"Domain without scheme","examples":["stripe.com"],"title":"Domain"},"description":"Domain without scheme"},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.010"}}}},"/api/v1/ens":{"get":{"tags":["evm"],"summary":"ENS: resolve name.eth to an address or an address to its primary name","description":"Forward (name -> address) and verified reverse (address -> primary .eth name) ENS resolution on Ethereum mainnet, plus profile text records: avatar, url, description, email, X/Twitter, GitHub, Telegram, Discord. Give either name or address. Cached 10 min.","operationId":"ens_api_v1_ens_get","parameters":[{"name":"name","in":"query","required":false,"schema":{"type":"string","maxLength":255,"pattern":"^([^\\s./]+\\.)+[a-zA-Z]{2,}$|^$","examples":["vitalik.eth"],"default":"","title":"Name"}},{"name":"address","in":"query","required":false,"schema":{"type":"string","pattern":"^(0x[a-fA-F0-9]{40})?$","default":"","title":"Address"}},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.002"}}}},"/api/v1/evm/call":{"get":{"tags":["evm"],"summary":"Read any smart contract function (eth_call) on Base, Ethereum and 5 more chains","description":"Calls a view function by its signature, e.g. sig=balanceOf(address)&args=0x...&returns=uint256, on Base, Ethereum, Arbitrum, BSC, Polygon, Optimism or Avalanche. Arguments: address, bool, bytes32, uintN, intN. Return types: those plus string and bytes (comma-separated for several static values). Returns raw hex and decoded values. Not cached.","operationId":"evm_call_api_v1_evm_call_get","parameters":[{"name":"to","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Contract address","examples":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"title":"To"},"description":"Contract address"},{"name":"sig","in":"query","required":true,"schema":{"type":"string","maxLength":200,"examples":["totalSupply()"],"title":"Sig"}},{"name":"args","in":"query","required":false,"schema":{"type":"string","maxLength":2000,"description":"Comma-separated argument values","default":"","title":"Args"},"description":"Comma-separated argument values"},{"name":"returns","in":"query","required":false,"schema":{"type":"string","maxLength":200,"pattern":"^[a-z0-9, ]*$","description":"Comma-separated return types, e.g. uint256 or string","default":"","title":"Returns"},"description":"Comma-separated return types, e.g. uint256 or string"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","description":"One of ethereum, base, arbitrum, bsc, polygon, optimism, avalanche","default":"base","title":"Chain"},"description":"One of ethereum, base, arbitrum, bsc, polygon, optimism, avalanche"},{"name":"block","in":"query","required":false,"schema":{"type":"string","pattern":"^(latest|0x[0-9a-fA-F]{1,16}|\\d{1,12})$","default":"latest","title":"Block"}},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}}}},"/api/v1/evm/token/balance":{"get":{"tags":["evm"],"summary":"Balance of one ERC-20 token for one wallet (cheapest balance check)","description":"Raw and human-readable balance of any ERC-20 token for a wallet on Base, Ethereum, Arbitrum, BSC, Polygon, Optimism or Avalanche, with the token symbol and decimals. Use to confirm a deposit or check funds before paying. Cached 10 s.","operationId":"evm_token_balance_api_v1_evm_token_balance_get","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","examples":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"title":"Token"}},{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","examples":["0x2a991f1cf788ff7fb5df8f9d507cfc98b5b1bd4e"],"title":"Address"}},{"name":"chain","in":"query","required":false,"schema":{"type":"string","default":"base","title":"Chain"}},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}}}},"/api/v1/evm/address":{"get":{"tags":["evm"],"summary":"Is this address a wallet or a contract? Nonce and native balance per chain","description":"For one address on one or all EVM chains (Base, Ethereum, Arbitrum, BSC, Polygon, Optimism, Avalanche): wallet vs contract vs EIP-7702 delegated account, bytecode size, transaction count (nonce) and native balance. Use before sending funds or to sanity-check a counterparty. Cached 15 s.","operationId":"evm_address_api_v1_evm_address_get","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","examples":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"title":"Address"}},{"name":"chain","in":"query","required":false,"schema":{"type":"string","default":"all","title":"Chain"}},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alternative to the X-Payment-Tx header","title":"Tx"},"description":"Alternative to the X-Payment-Tx header"},{"name":"x-payment-tx","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Solana tx signature of the USDT payment for this call","title":"X-Payment-Tx"},"description":"Solana tx signature of the USDT payment for this call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment required: pay the route's price (x402, or USDT on Solana) and retry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}}}},"/mcp":{"post":{"tags":["free"],"summary":"MCP server (Streamable HTTP) exposing every paid tool","description":"Model Context Protocol endpoint. tools/list is free; tools/call is paid per call via x402 (params._meta['x402/payment']).","operationId":"mcp_endpoint_mcp_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"ArbOut":{"properties":{"symbol":{"type":"string","title":"Symbol","default":"BTCUSDT"},"venues":{"additionalProperties":true,"type":"object","title":"Venues","description":"Best bid/ask per exchange that answered: binance, bybit, okx, kraken, coinbase"},"binance":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Binance"},"bybit":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Bybit"},"best_direction":{"type":"string","title":"Best Direction","description":"e.g. 'buy_binance_sell_kraken' or 'none'"},"gross_spread_pct":{"type":"number","title":"Gross Spread Pct"},"net_spread_pct_after_fees":{"type":"number","title":"Net Spread Pct After Fees","description":"After taker fees on both exchanges"},"opportunity":{"type":"boolean","title":"Opportunity"},"ts":{"type":"integer","title":"Ts"}},"type":"object","required":["venues","best_direction","gross_spread_pct","net_spread_pct_after_fees","opportunity","ts"],"title":"ArbOut"},"GasOut":{"properties":{"ethereum":{"additionalProperties":true,"type":"object","title":"Ethereum","description":"gas_price_gwei, base_fee_gwei, priority_fee_gwei, transfer_cost_eth"},"solana":{"additionalProperties":true,"type":"object","title":"Solana","description":"base_fee_lamports, median_priority_fee_micro_lamports, transfer_cost_sol"},"ts":{"type":"integer","title":"Ts"}},"type":"object","required":["ethereum","solana","ts"],"title":"GasOut"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"NewsItem":{"properties":{"title":{"type":"string","title":"Title"},"link":{"type":"string","title":"Link"},"published":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Published"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"}},"type":"object","required":["title","link"],"title":"NewsItem"},"NewsOut":{"properties":{"source":{"type":"string","title":"Source","default":"coindesk"},"items":{"items":{"$ref":"#/components/schemas/NewsItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"NewsOut"},"PaymentRequired":{"properties":{"error":{"type":"string","title":"Error","default":"payment_required"},"x402Version":{"type":"integer","title":"X402 Version","description":"Present when x402 is available"},"message":{"type":"string","title":"Message"},"resource":{"type":"string","title":"Resource"},"accepts":{"type":"array","items":{"additionalProperties":true,"type":"object"},"title":"Accepts","description":"x402 v2 payment requirements, the same as in the PAYMENT-REQUIRED header"},"docs":{"type":"string","title":"Docs"},"price":{"additionalProperties":true,"type":"object","title":"Price","description":"Only when x402 is temporarily unavailable"},"network":{"type":"string","title":"Network","description":"Only when x402 is temporarily unavailable"},"asset":{"type":"string","title":"Asset","description":"Only when x402 is temporarily unavailable"},"pay_to":{"type":"string","title":"Pay To","description":"Only when x402 is temporarily unavailable"},"retry_header":{"type":"string","title":"Retry Header","default":"X-Payment-Tx","description":"Only when x402 is temporarily unavailable"}},"type":"object","required":["message","resource"],"title":"PaymentRequired"},"PriceOut":{"properties":{"symbol":{"type":"string","title":"Symbol","examples":["ETHUSDT"]},"price":{"type":"string","title":"Price","description":"Last trade price on Binance spot","examples":["3521.40"]},"source":{"type":"string","title":"Source","default":"binance"},"ts":{"type":"integer","title":"Ts","description":"Unix time the price was fetched"}},"type":"object","required":["symbol","price","ts"],"title":"PriceOut"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"tags":[{"name":"market","description":"Prices and arbitrage"},{"name":"onchain","description":"Network fees"},{"name":"derivatives","description":"Perpetual futures funding and open interest"},{"name":"solana","description":"Solana tokens and wallets: price, rug check, portfolio"},{"name":"news","description":"Crypto news headlines"},{"name":"web","description":"Read web pages, PDFs and YouTube transcripts; check domains"},{"name":"evm","description":"EVM chains (Base, Ethereum, BSC...): balances, transactions, token scam checks"},{"name":"markets","description":"Prediction markets and DeFi yields"},{"name":"free","description":"No payment required"}],"servers":[{"url":"https://api.agent-data.workers.dev"}]}