# Agent Data Tools

> Pay-per-call tools for AI agents: web page text extraction and summaries, screenshots, image generation, speech-to-text, image description, domain and email-auth intelligence, live Base token, wallet and gas lookups, Bitcoin price and fees, currency exchange rates, weather and time zones. No account or API key; pay per request in USDC on Base via x402.

All endpoints are GET, return JSON, and cost a fixed price per successful call. An unpaid request returns HTTP 402 with a PAYMENT-REQUIRED header (x402 v2, exact scheme, USDC on Base). Sign the payment and retry with the PAYMENT-SIGNATURE header. Failed calls (4xx/5xx) are not charged.

Free trial: add trial=1 to any GET request for a free call, up to 10 per caller per day while the daily trial pool lasts. Without it, unpaid requests get the 402 challenge.

## Endpoints

### GET /extract — $0.002
Fetch any public web page and get clean readable text for LLM input: title, meta description, language, canonical URL, H1-H3 headings, main body text with navigation, scripts and boilerplate removed, and the page's outbound links. Use for web scraping, article reading, research and RAG ingestion.
- `url` (string, required): Absolute http(s) URL of the page to fetch
- `maxChars` (integer): Maximum characters of body text to return (500-100000, default 20000)
Example: https://agent-data-tools.revmesh2074.workers.dev/extract?url=https%3A%2F%2Fexample.com

### GET /domain — $0.005
Domain intelligence in one call: DNS records (A, AAAA, CNAME, MX, NS, TXT, CAA), DNSSEC status, registrar, registration and expiry dates with domain age in days (RDAP/WHOIS), and email authentication (SPF and DMARC records and policies, whether the domain accepts mail). Use for lead qualification, phishing and trust checks, and deliverability audits.
- `name` (string, required): Domain name, e.g. cloudflare.com
Example: https://agent-data-tools.revmesh2074.workers.dev/domain?name=cloudflare.com

### GET /domain-report — $0.01
A trust verdict for any domain in one call: high/medium/low trust with named flags for very new registrations, expiry, missing or weak SPF and DMARC, too few nameservers, no web host and non-resolving domains, plus the key facts (registrar, age, nameservers, DNSSEC). Use for lead qualification, phishing and vendor checks, and before an agent sends mail to or trusts a domain. Signals only, not a guarantee.
- `name` (string, required): Domain name, e.g. cloudflare.com
Example: https://agent-data-tools.revmesh2074.workers.dev/domain-report?name=cloudflare.com

### GET /token — $0.01
Live on-chain facts for any ERC-20 token on Base: name, symbol, decimals, total supply, owner address and whether ownership is renounced, paused state, proxy detection (EIP-1967 and minimal proxy) with implementation and admin addresses, and bytecode heuristics for mint, pause, blacklist and fee-setter functions. Use for token due diligence and rug-pull or honeypot screening before a swap.
- `address` (string, required): Token contract address on Base (0x...)
Example: https://agent-data-tools.revmesh2074.workers.dev/token?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

### GET /token-report — $0.02
One call before you buy a Base token: overall risk rating (low/medium/high) with named flags, on-chain facts (owner, renounced, paused, proxy, mint/blacklist/fee-setter heuristics), plus live DEX market data: price, 24h volume and change, total liquidity, FDV, pair count and age, and 24h buys vs sells. Flags no-liquidity, thin liquidity, new pairs and no-sell patterns. Heuristic screening, not a guarantee.
- `address` (string, required): Token contract address on Base (0x...)
Example: https://agent-data-tools.revmesh2074.workers.dev/token-report?address=0x4200000000000000000000000000000000000006

### GET /wallet — $0.005
Live snapshot of any address on Base: ETH balance, balances of major tokens (USDC, WETH, cbBTC, DAI, USDbC, cbETH, AERO, EURC) plus up to 20 extra token addresses you pass, transaction count, and whether the address is an EOA, a smart contract or an EIP-7702 delegated account. Use for portfolio checks, counterparty screening and payment verification.
- `address` (string, required): Wallet or contract address on Base (0x...)
- `tokens` (string): Optional comma-separated extra ERC-20 addresses to check (max 20)
Example: https://agent-data-tools.revmesh2074.workers.dev/wallet?address=0x4200000000000000000000000000000000000006

### GET /summarize — $0.01
Give a URL, get a short summary of the page plus three to six key points, ready to drop into an agent's context. Fetches the page, strips navigation and boilerplate, and summarizes the main text with an LLM. Use for research, news triage, link previews and deciding whether a page is worth reading in full.
- `url` (string, required): Absolute http(s) URL of the page to summarize
Example: https://agent-data-tools.revmesh2074.workers.dev/summarize?url=https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FHTTP_402

### GET /screenshot — $0.02
Render any public web page in a real headless Chrome browser, with JavaScript executed, and get a JPEG screenshot (1280 px wide, base64) plus the final URL, HTTP status and page title. Set fullPage=true to capture up to 4000 px of page height. Use for visual checks, page previews, monitoring and feeding pages to vision models.
- `url` (string, required): Absolute http(s) URL of the page to capture
- `fullPage` (string): Set to true to capture the full page height (max 4000 px) instead of the 1280x800 viewport
Example: https://agent-data-tools.revmesh2074.workers.dev/screenshot?url=https%3A%2F%2Fexample.com

### GET /image — $0.02
Text-to-image generation with FLUX.1 schnell. Send a prompt, get a 1024x1024 JPEG back as base64 in a few seconds. Use for illustrations, thumbnails, mockups, avatars and social media images. Optional steps parameter (1-8, default 4) trades speed for detail.
- `prompt` (string, required): What the image should show (3-800 characters)
- `steps` (integer): Diffusion steps, 1-8 (default 4)
Example: https://agent-data-tools.revmesh2074.workers.dev/image?prompt=a%20lighthouse%20on%20a%20cliff%20at%20sunset%2C%20watercolor

### GET /transcribe — $0.02
Transcribe speech from an audio file at a public URL using Whisper large-v3-turbo. Returns the transcript text, detected language, duration and word count. Accepts common formats such as MP3, WAV, M4A and OGG up to 5 MB. Use for voice notes, podcast clips, meeting snippets and voice messages.
- `url` (string, required): Absolute http(s) URL of an audio file (max 5 MB)
Example: https://agent-data-tools.revmesh2074.workers.dev/transcribe?url=https%3A%2F%2Fcommons.wikimedia.org%2Fwiki%2FSpecial%3AFilePath%2FEn-us-hello.ogg

### GET /describe — $0.01
Vision model for an image at a public URL: get a detailed description including any visible text, or pass a question to ask something specific about the image. Accepts PNG, JPEG, WebP and GIF up to 3 MB. Use for alt text, OCR-style reading of screenshots, chart reading and content checks.
- `url` (string, required): Absolute http(s) URL of a PNG, JPEG, WebP or GIF image (max 3 MB)
- `question` (string): Optional question about the image (max 300 characters); default is a detailed description
Example: https://agent-data-tools.revmesh2074.workers.dev/describe?url=https%3A%2F%2Fupload.wikimedia.org%2Fwikipedia%2Fcommons%2F4%2F47%2FPNG_transparency_demonstration_1.png

### GET /btc-fees — $0.0002
Current Bitcoin network fee rates in sat/vB for next-block, half-hour, one-hour and economy confirmation, the estimated cost in sats of a typical payment, mempool size and total pending fees, and the latest block height. Use before sending a Bitcoin transaction or to decide whether to wait for lower fees.
Example: https://agent-data-tools.revmesh2074.workers.dev/btc-fees?format=json

### GET /btc-address — $0.003
Balance and activity of any Bitcoin mainnet address (legacy, P2SH or bech32): confirmed balance in sats and BTC, unconfirmed pending amount, total received and sent, and transaction counts. Use for payment verification, checking whether a deposit arrived, and wallet monitoring.
- `address` (string, required): Bitcoin mainnet address (1..., 3... or bc1...)
Example: https://agent-data-tools.revmesh2074.workers.dev/btc-address?address=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh

### GET /ln-invoice — $0.001
Decode a BOLT11 Lightning Network invoice without paying it: network, amount in sats and BTC, description, payment hash, creation time, expiry time and whether it has already expired. Use to check what an invoice asks for before an agent pays it.
- `invoice` (string, required): BOLT11 invoice string starting with ln (lnbc... for mainnet)
Example: https://agent-data-tools.revmesh2074.workers.dev/ln-invoice?invoice=lnbc2500u1pvjluezsp5zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygspp5qqqsyqcyq5rqwzqfqqqsyqcyq5rqwzqfqqqsyqcyq5rqwzqfqypqdq5xysxxatsyp3k7enxv4jsxqzpu9qrsgquk0rl77nj30yxdy8j9vdx85fkpmdla2087ne0xh8nhedh8w27kyke0lp53ut353s06fv3qfegext0eh0ymjpf39tuven09sam30g4vgpfna3rh

### GET /package-audit — $0.01
Check a whole dependency list in one call. Pass up to 10 ecosystem:name pairs (npm, pypi, cargo, go, maven, nuget) and get per-package existence, verdict and flags (not-found, deprecated, known advisories, very new or unmaintained), plus a summary. Catches hallucinated or typosquat package names an AI coding agent might install. Bad input is not charged.
- `packages` (string, required): Comma-separated ecosystem:name pairs, max 10, e.g. npm:left-pad,pypi:requests
Example: https://agent-data-tools.revmesh2074.workers.dev/package-audit?packages=npm%3Aleft-pad%2Cpypi%3Arequests

### GET /wallet-audit — $0.02
Audit a Base wallet address in one call: high/medium/low risk verdict with named flags (no history, single tx, low balance+low activity, contract), token holdings of 4 major tokens (USDC, WETH, cbBTC, DAI), on-chain labels (high ETH holder, active small holder, new address), and transaction count. Use for trader due diligence, suspicious address checks, and before sending a payment or trade to an address.
- `address` (string, required): Base chain wallet address, 0x-prefixed 20-byte hex
Example: https://agent-data-tools.revmesh2074.workers.dev/wallet-audit?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

### GET /contract-risk — $0.02
Audit a smart contract on Base: critical/high/medium/low risk with named flags (proxy pattern, zero supply, bytecode size, uninitialized proxy, suspicious ERC-20 properties). Detects EIP-1967 proxy patterns and reads token properties (name, symbol, decimals, total supply, ownership status). Use for token contract audits, before trading or approving a token, and for rug-pull detection.
- `address` (string, required): Base chain contract address, 0x-prefixed 20-byte hex
Example: https://agent-data-tools.revmesh2074.workers.dev/contract-risk?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

### GET /trade-insight — $0.05
AI-powered trade recommendation combining token risk analysis, wallet on-chain activity, market liquidity/volume, and holder concentration. Returns high-confidence buy/sell, medium recommendations, or high-risk flags with reasoning and confidence score (0-1). Scores token risk, wallet history, trading experience, liquidity, and balance. Use for informed trading decisions, bot detection, and pre-trade due diligence on any token-wallet pair.
- `token` (string, required): Token contract address on Base, 0x-prefixed 20-byte hex
- `wallet` (string, required): Wallet address to evaluate, 0x-prefixed 20-byte hex
Example: https://agent-data-tools.revmesh2074.workers.dev/trade-insight?token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&wallet=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

### GET /liquidity-pool-audit — $0.03
Audit a Base liquidity pool contract: contract type detection (Uniswap V3/V2, Balancer, unknown), activity level (transaction count), bytecode analysis, and risk flags (no code, low activity, unusual bytecode size). Use for DEX trading pair audits, LP investment screening, and pool existence checks before trading or adding liquidity.
- `address` (string, required): Pool contract address on Base, 0x-prefixed 20-byte hex
Example: https://agent-data-tools.revmesh2074.workers.dev/liquidity-pool-audit?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

### GET /mev-simulator — $0.04
Estimate transaction costs under different market conditions (standard, high MEV risk, low gas): base/priority/max fees in gwei, and estimated gas costs in ETH + USD for a simple swap, complex swap, and liquidity add. Includes MEV risk assessment (low/medium/high) and recommendations for MEV protection. Use for trading cost analysis, MEV risk evaluation, and timing decisions.
- `scenario` (string): One of standard, high-mev, low-gas (default: standard)
Example: https://agent-data-tools.revmesh2074.workers.dev/mev-simulator?format=json

### GET /package — $0.0002
Check a software package before installing it: whether it exists at all (AI coding assistants sometimes invent names), latest version and release date, package age, number of versions, weekly downloads (npm), licenses, deprecation, and known security advisories with severity. Returns a verdict of ok, caution or not-found with the reasons. Covers npm, PyPI, Cargo, Go, Maven and NuGet. Use before adding a dependency or running an install command.
- `ecosystem` (string, required): One of npm, pypi, cargo, go, maven, nuget
- `name` (string, required): Exact package name, e.g. lodash or @scope/name
Example: https://agent-data-tools.revmesh2074.workers.dev/package?ecosystem=npm&name=lodash

### GET /email — $0.001
Validate an email address before using it: syntax, whether the domain exists and accepts mail (MX records), disposable or throwaway provider detection, role addresses such as info@ or support@, free-provider detection, and SPF and DMARC presence. Returns a verdict of likely-deliverable, risky, undeliverable or invalid with reasons. No message is sent and the mail server is not contacted. Use for sign-up checks, lead list cleaning and contact enrichment.
- `address` (string, required): The email address to check
Example: https://agent-data-tools.revmesh2074.workers.dev/email?address=support%40cloudflare.com

### GET /papers — $0.003
Search scholarly literature across journals, conferences, preprints and books: title, authors, year, venue, citation count, DOI link and abstract where available. Optional fromYear filter and up to 20 results per call. Use for research agents, literature reviews, fact-checking a claim against published work, and finding the DOI for a citation.
- `query` (string, required): Search terms, a title or a research question (3-300 characters)
- `limit` (integer): Number of results, 1-20 (default 5)
- `fromYear` (integer): Only works published in or after this year
Example: https://agent-data-tools.revmesh2074.workers.dev/papers?query=CRISPR%20off-target%20effects

### GET /fx — $0.001
Foreign exchange rates from the European Central Bank for about 30 major currencies (USD, EUR, GBP, JPY, CHF, SEK, CAD, AUD, CNY, INR, BRL and more). Give a base currency, optionally the target currencies and an amount, and get the rates, the converted amounts and the date the rates apply to. Use for currency conversion, invoice and price calculations, and reporting in another currency.
- `from` (string, required): Base currency as a three-letter ISO 4217 code, e.g. USD
- `to` (string): Optional comma-separated target currency codes, e.g. EUR,GBP; default is all available currencies
- `amount` (number): Optional amount of the base currency to convert (default 1)
Example: https://agent-data-tools.revmesh2074.workers.dev/fx?from=USD

### GET /btc-price — $0.001
Current Bitcoin (BTC) spot price in USD, EUR, GBP, CAD, CHF, AUD and JPY, averaged across major exchanges, with the number of satoshis per US dollar and the time of the price. Use to convert between sats and fiat, to value a Bitcoin or Lightning payment, or to check the BTC price before a trade.
Example: https://agent-data-tools.revmesh2074.workers.dev/btc-price?format=json

### GET /base-gas — $0.001
Live gas prices on Base (chain 8453) read from the latest block: base fee and priority fee in gwei, suggested maxFeePerGas and maxPriorityFeePerGas in wei for an EIP-1559 transaction, how full the latest block is, and the estimated execution fee in ETH for an ETH transfer and an ERC-20 transfer. Use before sending a transaction on Base or to decide whether to wait for lower fees.
Example: https://agent-data-tools.revmesh2074.workers.dev/base-gas?format=json

### GET /base-tx — $0.003
Look up any transaction on Base by hash: whether it succeeded, reverted or is still pending, sender and receiver, ETH value, called method id, block number and time, number of confirmations, gas used, gas price and the execution fee paid, and whether it created a contract. Use to confirm that a payment or contract call went through before acting on it.
- `hash` (string, required): Transaction hash on Base: 0x followed by 64 hex characters
Example: https://agent-data-tools.revmesh2074.workers.dev/base-tx?hash=0x7d108fa131ed949c76d50caf2e7dfe25fc9903b9d276c40a0446d8afbdfe86b0

### GET /base-allowance — $0.002
Check how much of a wallet's ERC-20 token a spender contract is approved to move on Base: the raw and formatted allowance, the token symbol and decimals, and whether the approval is unlimited. Use before a swap or deposit to see if an approve transaction is needed, and to audit a wallet for risky unlimited approvals.
- `token` (string, required): ERC-20 token contract address on Base (0x...)
- `owner` (string, required): Wallet address that holds the token (0x...)
- `spender` (string, required): Address allowed to spend, usually a router or protocol contract (0x...)
Example: https://agent-data-tools.revmesh2074.workers.dev/base-allowance?token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&owner=0x4200000000000000000000000000000000000006&spender=0x000000000022D473030F116dDEE9F6B43aC78BA3

### GET /ens — $0.002
Resolve an Ethereum Name Service name such as vitalik.eth to its wallet address and avatar, or look up the primary ENS name of an address (reverse resolution). Read live from Ethereum mainnet. Use to turn a human-readable name into a payable address, or to show a readable name for a counterparty address.
- `name` (string, required): An ENS name such as vitalik.eth, or an address (0x...) for reverse lookup
Example: https://agent-data-tools.revmesh2074.workers.dev/ens?name=vitalik.eth

### GET /weather — $0.002
Weather for any point on Earth by latitude and longitude: current temperature in Celsius, conditions (clear, cloudy, rain, snow), precipitation in mm, wind speed and direction, humidity, cloud cover and air pressure, plus an hourly forecast for up to 48 hours. Data from the Norwegian Meteorological Institute. Use for travel and event planning, logistics, agriculture and any agent that needs the weather.
- `lat` (number, required): Latitude in decimal degrees, -90 to 90
- `lon` (number, required): Longitude in decimal degrees, -180 to 180
- `hours` (integer): Hours of hourly forecast to return, 1-48 (default 12)
Example: https://agent-data-tools.revmesh2074.workers.dev/weather?lat=59.33&lon=18.07

### GET /time — $0.001
The exact current date and time in any IANA time zone, with UTC offset, weekday, abbreviation and Unix timestamp, daylight saving time handled. Optionally convert a given moment into up to 10 other time zones in the same call. Use when an agent needs to know what time it is, to schedule a meeting across time zones, or to turn a timestamp into local time.
- `zone` (string, required): IANA time zone name, e.g. Europe/Stockholm or America/New_York
- `at` (string): Optional moment to convert, as ISO 8601 with an offset (default: now)
- `to` (string): Optional comma-separated time zones to convert the same moment into (max 10)
Example: https://agent-data-tools.revmesh2074.workers.dev/time?zone=Europe%2FStockholm

### GET /pair-analyzer — $0.03
Analyze a Uniswap liquidity pair for trading risk: liquidity USD, 24h trading volume, price impact estimates (1%, 5%, 10% swaps), fee tier, transaction count, liquidity trend (increasing/decreasing/stable). Combines contract risk (token0/token1 properties) with pool activity to assess slippage and impermanent loss risk. Use for large order planning, LP due diligence, and identifying low-activity pools.
- `pairAddress` (string, required): Uniswap pool contract address (0x...)
- `chain` (string): Blockchain: ethereum, polygon, arbitrum, optimism (default ethereum)
Example: https://agent-data-tools.revmesh2074.workers.dev/pair-analyzer?pairAddress=0x8ad599c3a0ff1de082011efddc58f1908762f2f

### GET /wallet-history — $0.02
Analyze a wallet's transaction history to distinguish bots from humans and identify wash trading signatures: transaction count, wallet age, pattern frequency (burst vs. regular), token diversity, transaction timing variance, and historical analysis (all-time, last 30 days, last 7 days). Returns bot probability score (0-1), wash trading indicators, and specific risk flags. Use for counterparty due diligence, liquidity provider validation, and bot detection.
- `address` (string, required): Wallet address to analyze (0x...)
- `chain` (string): Blockchain: ethereum, polygon, arbitrum, optimism (default ethereum)
Example: https://agent-data-tools.revmesh2074.workers.dev/wallet-history?address=0x742d35cc6634c0532925a3b844bc57e94f4e75ee

### GET /airdrop-scanner — $0.03
Analyze a wallet for airdrop eligibility based on transaction history, holdings, and on-chain labels. Returns list of eligible airdrops with estimated rewards, historical eligibility patterns, wallet age signals, activity level scoring, and risk flags for eligibility (e.g., young wallet, low activity). Helps traders maximize airdrop income and understand which future airdrops they may qualify for. Use before claiming or coordinating airdrop strategies.
- `address` (string, required): Wallet address to analyze (0x...)
- `chain` (string): Blockchain: ethereum, polygon, arbitrum, optimism (default ethereum)
Example: https://agent-data-tools.revmesh2074.workers.dev/airdrop-scanner?address=0x742d35cc6634c0532925a3b844bc57e94f4e75ee

### GET /liquidity-return-analyzer — $0.02
Analyze a liquidity provider position ROI: entry and exit prices, liquidity provided, current value, fees earned, impermanent loss calculation (IL), total return percentage, and whether the position is actually profitable. Helps LPs understand true ROI accounting for IL, track fees earned, and make hold/rebalance/exit decisions. Returns ROI recommendation (positive/neutral/negative) and specific risk warnings.
- `poolAddress` (string, required): Pool address (0x...)
- `lpAddress` (string, required): Your wallet address (0x...)
- `chain` (string): Blockchain: ethereum, polygon, arbitrum, optimism (default ethereum)
Example: https://agent-data-tools.revmesh2074.workers.dev/liquidity-return-analyzer?poolAddress=0x8ad599c3a0ff1de082011efddc58f1908eb6e6d8&lpAddress=0x742d35cc6634c0532925a3b844bc57e94f4e75ee

### GET /token-holder-analysis — $0.02
Analyze a token's holder distribution to assess rug-pull risk and whale concentration: top 10/100 holders and their percentages, Gini coefficient (concentration metric), whale activity (recent large transfers), and rug-risk score (0-1). Returns risk level (low/medium/high), specific risk flags, and recommendations for trading or investing. Use for due diligence before buying, trading, or providing liquidity.
- `tokenAddress` (string, required): Token contract address (0x...)
- `chain` (string): Blockchain: ethereum, polygon, arbitrum, optimism (default ethereum)
Example: https://agent-data-tools.revmesh2074.workers.dev/token-holder-analysis?tokenAddress=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48

## Machine-readable

- MCP server (streamable HTTP, same tools and prices): https://agent-data-tools.revmesh2074.workers.dev/mcp
- [OpenAPI 3.1](https://agent-data-tools.revmesh2074.workers.dev/openapi.json)
- [Service card](https://agent-data-tools.revmesh2074.workers.dev/)
- [x402 resource list](https://agent-data-tools.revmesh2074.workers.dev/.well-known/x402)
- [Store: x402 Seller Kit, a template and guide for building a service like this](https://agent-data-tools.revmesh2074.workers.dev/store)