# 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 3 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 /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 /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.002
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 — $0.002
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

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