# aiworker-data

Deterministic-first data for agents, paid per call in USDC over x402 v2: DeFi yields, Base token and wallet cards, Polymarket odds and backtests, news, fact checks, cited briefs. 20 routes, $0.005-$1. Every /v1 route is paid per call in USDC on Base and Solana over the x402 v2 protocol: send the request, read the price from the PAYMENT-REQUIRED header of the 402, pay it with any x402 client (@x402/fetch, x402-axios, the agentcash MCP) and retry. No account, no API key, no subscription. Nothing is settled unless the request succeeds.

## Routes

- GET /v1/defi/yields ($0.02): DeFi yield pools from DefiLlama, normalized and filterable by chain, project, symbol, stablecoin and min TVL.
- GET /v1/defi/protocol/:slug ($0.01): Snapshot of one DeFi protocol by DefiLlama slug: TVL by chain, category, 1d/7d change, audits, refreshed every 5 minutes from DefiLlama's protocol summary.
- POST /v1/scrape/markdown ($0.02): Fetch one public web page (buyer-supplied URL, no login walls, robots.txt honoured) and return its main content as clean Markdown with title and word count.
- POST /v1/scrape/summary ($0.04): Same as /v1/scrape/markdown plus a structured summary (≤200 words), key points and entities produced by an LLM from the page text.
- POST /v1/defi/yield-report ($0.10): An LLM-written read of DeFi yield pools from DefiLlama matching a filter: a headline verdict, key points, risks, a best-fit pool if any, and caveats, alongside the underlying pool rows.
- POST /v1/check/claims ($0.05): Extract checkable factual claims from buyer-submitted text or a public URL, and verdict each one — supported, contradicted, unsupported or unverifiable — against Wikipedia and any buyer-supplied source URLs, with verbatim quoted evidence and links.
- POST /v1/check/token ($0.05): A deterministic Base token safety card from Blockscout, DexScreener (derived) and Honeypot.is plus the Base RPC: what the contract is, who controls it, who holds it, where it trades, and whether a simulated buy/sell round-trips, with rule-based risk flags and a 0-100 score.
- GET /v1/token/info ($0.005): The cheapest way to look up a Base token: name, symbol, decimals, total supply, holder count, price, liquidity, pool count, largest pool, FDV and 24h volume, from Blockscout and DexScreener.
- POST /v1/check/wallet ($0.05): A deterministic Base wallet card for any address: EOA or contract, ETH balance, first seen and last activity, transaction and token-transfer counts, up to 20 ERC-20 holdings by value, and rule-based flags (fresh wallet under 7 days, dormant over 180 days, no ETH, single token, contract address), from Blockscout and the Base RPC.
- GET /v1/polymarket/resolution ($0.05): Has a Polymarket market resolved, and how? Give a market slug, a 0x condition id, or the question as free text: you get the status (open, resolved, voided, unknown, not_found), the winning outcome and payout vector, when it closed and by which mechanism (UMA status, resolver), how many days after its end date, the last traded price and best bid/ask, and the event's categories, from Polymarket's public Gamma API.
- GET /v1/polymarket/odds ($0.01): The current odds of one Polymarket market and how they moved: give a market slug, a 0x condition id or the question as free text and get the YES and NO prices, the last trade, the implied probability, liquidity and volume, and the 24-hour and 7-day change against the derived store's daily closes, from Polymarket's public Gamma API.
- POST /v1/polymarket/backtest ($0.25): Replay one fixed, published rule over resolved Polymarket markets from a derived store of on-chain daily closes: favorite_hold (buy the side at or above p on its first such day), longshot_hold (buy the side at or below p), late_entry (buy the favourite N days before the end date) or momentum_1w (buy in the direction of a one-week move).
- GET /v1/polymarket/history ($0.02): The daily YES-price history of one Polymarket market from a derived store of on-chain fills (the MIT-licensed dump before 2026-07-21, the public daily API after): give a market slug, a 0x condition id or a numeric id and a number of days (1-365, default 90) and get the series of daily closes with fill counts and volume, plus a summary: open, high, low, last, 1-day and 1-week change, days to the end date and the volume over the window.
- POST /v1/polymarket/screener ($0.05): A ranked list of Polymarket markets from a derived store under deterministic filters: status (open, resolved or all), a category (an event tag with at least 200 resolved markets), a minimum lifetime volume, closing within N days, or the biggest 7-day movers up or down.
- POST /v1/brief/topic ($0.10): A sourced brief on any topic: 150-500 words of Markdown in which every paragraph cites the pages it was written from, plus the key facts as verbatim quotes with the URL each came from.
- POST /v1/token/report ($1.00): Everything an agent needs before touching a Base token, in one call: the deterministic safety card (contract, ownership, holder concentration, market, honeypot simulation, rule-based risk flags and a 0-100 score), the DefiLlama pools its symbol appears in with their TVL and APY, a sourced brief on the project written from its own site and Wikipedia with verbatim quotes (or none, when nothing verifiable is found), and a written verdict — avoid, caution or acceptable — whose reasons must each name a field of this report, checked in code, and whose verdict is overruled when it contradicts the risk score.
- POST /v1/news/search ($0.01): Crypto and markets headlines matching your words, from twelve fixed public RSS/Atom feeds (CoinDesk, The Block, Decrypt, Cointelegraph, The Defiant, DL News, Blockworks, Bankless, Polymarket, CNBC, Bloomberg, Financial Times) refreshed every ten minutes: whole-word, case-insensitive search over titles and summaries within the last 1-168 hours (default 48), newest first, deduplicated, up to 50 items with title, link, publisher, published time and a short summary.
- POST /v1/social/mentions ($0.01): What people are saying about your words on two public forums, deterministic and without an LLM: Hacker News stories and comments (via the Algolia HN Search API) and Polymarket event comments (via the Gamma API) within the last 1-168 hours (default 48), whole-word and case-insensitive, newest first, deduplicated, up to 50 items with the text (at most 300 characters), a link, the author's public handle and the time.
- POST /v1/trade/gate ($0.05): One rule-based verdict before a swap on one Base token: pass, caution or block, with the reasons and the numbers that tripped them — Honeypot.is buy/sell simulation and taxes, pool liquidity and age, holder concentration, contract verification and ownership, and a name-spoof check against the canonical tokens.
- POST /v1/wallet/airdrop-scan ($0.05): Wallet hygiene for one Base address: every token it holds, each marked honeypot, dust, batch-airdropped, name-spoofed, ok or unknown, with the reasons (Honeypot.is simulation per token, capped at 25.
- GET /v1/market/trending ($0.02): Trending tokens on Base right now: the pools GeckoTerminal ranks as trending, with price, 24 h volume, liquidity, 1 h/6 h/24 h price change, buys and sells, and pool age — stablecoin and WETH bases excluded, pools under a liquidity floor excluded (default $10,000).
- POST /v1/market/ta ($0.05): Technical indicators for one Base token from its largest pool's candles (GeckoTerminal OHLCV, hourly or daily, 50–200 periods): RSI 14, EMA 20/50, SMA 20, Bollinger bands 20/2σ, ATR 14, last close, high/low and percentage changes — the textbook arithmetic on past prices, nothing more.

## Free pages (Base)

- Base airdrop-spam watch (batch-airdropped and honeypot tokens seen on Base in the last seven days, with the verdict per token; rebuilt every few hours): https://aiworker.duckdns.org/base/airdrop-spam-watch — JSON twin at https://aiworker.duckdns.org/base/airdrop-spam-watch.json

## Free pages

- Polymarket backtest calibration (hit rate and Brier of the fixed rules over the last year): https://aiworker.duckdns.org/polymarket/calibration
- Polymarket markets resolved this week (the 50 largest by volume): https://aiworker.duckdns.org/polymarket/resolved-this-week
- Polymarket categories (every category with its resolved count): https://aiworker.duckdns.org/polymarket/categories
- Each has a JSON twin at the same path plus .json. Aggregates only, regenerated nightly; history, not a prediction.

## Machine access

- MCP (Streamable HTTP, the same tools at the same prices): https://aiworker.duckdns.org/mcp
- OpenAPI: https://aiworker.duckdns.org/openapi.json
- Catalog: https://aiworker.duckdns.org/catalog.json
- Agent card: https://aiworker.duckdns.org/.well-known/agent.json
- Framework wrappers (LangChain.js, Vercel AI SDK, ElizaOS; one import, each call pays itself): https://github.com/ai-worker227/aiworker-examples
- Free, no payment: https://aiworker.duckdns.org/health and every document in this section.