# ScrapeMole Onchain: prices, DEX prices, ENS/Basenames, gas, tokens, balances, holders and transactions on Base and Ethereum

> Pay-per-call on-chain data for agents on Base and Ethereum, read directly from chain state: Chainlink USD prices (crypto, stablecoins, FX, metals; 10 per call), ERC-20 token info, top token holders, wallet balances with USD values, transaction lookup with decoded ERC-20 transfers, ENS and Basename resolution (forward and reverse), gas and fee estimates in USD, and Uniswap v3 DEX prices for long-tail tokens (verify a payment arrived). USDC via x402; failed calls are never charged.

Pay with x402 v2 (exact, USDC on Base). Call without payment to get a 402 with the price; retry with an x402 client. Only 200 responses are charged.

## Endpoints

- GET https://onchain.scrapemole.workers.dev/v1/price ($0.002): USD spot prices for up to 10 assets per call (crypto, stablecoins, forex, gold/silver) from Chainlink feeds read on-chain on Base or Ethereum, with update time and staleness flag.
  - symbols (required): Comma-separated asset symbols (max 10), e.g. "ETH,BTC,USDC,EUR". GET / lists all supported symbols per chain.
  - chain: Chain to read the feeds from. One of: base, ethereum. Default base.
- GET https://onchain.scrapemole.workers.dev/v1/token ($0.001): ERC-20 token metadata by contract address on Base or Ethereum: name, symbol, decimals, total supply (raw and human), contract check, plus USD price when a Chainlink feed exists.
  - address (required): Token contract address (0x…).
  - chain: Chain. One of: base, ethereum. Default base.
- GET https://onchain.scrapemole.workers.dev/v1/balances ($0.003): Native ETH and ERC-20 balances of any address on Base or Ethereum (default common tokens or your list), with USD values from Chainlink.
  - address (required): Wallet or contract address (0x…).
  - chain: Chain. One of: base, ethereum. Default base.
  - tokens: Comma-separated token symbols (from the default list) or 0x token addresses, max 20. Default: major tokens of the chain.
  - includeZero: Also list zero balances (true/false). Default false.
- GET https://onchain.scrapemole.workers.dev/v1/tx ($0.002): Look up a transaction on Base or Ethereum: status, block and time, from/to, ETH value, fee, method selector and decoded ERC-20 transfers with symbols and amounts.
  - hash (required): Transaction hash (0x + 64 hex).
  - chain: Chain. One of: base, ethereum. Default base.
- GET https://onchain.scrapemole.workers.dev/v1/ens ($0.001): Resolve an ENS name or Basename (vitalik.eth, jesse.base.eth, *.cb.id) to its address, or an address to its primary ENS name and Basename (forward-verified).
  - name: ENS name or Basename to resolve, e.g. vitalik.eth or jesse.base.eth. Give name or address.
  - address: Address to reverse-resolve (0x… 40 hex). Give name or address.
- GET https://onchain.scrapemole.workers.dev/v1/gas ($0.001): Current gas on Base or Ethereum: base fee, slow/standard/fast priority fees (gwei) from the last 20 blocks, block fullness, and the cost in ETH and USD of a transfer, an ERC-20 transfer and a swap.
  - chain: Chain. One of: base, ethereum. Default base.
- GET https://onchain.scrapemole.workers.dev/v1/dex-price ($0.002): On-chain DEX price of any ERC-20 on Base or Ethereum from Uniswap v3 pools (vs WETH/USDC/USDT): price in USD and in the quote token, the deepest pool, its fee tier and pool reserves.
  - token (required): ERC-20 contract address.
  - chain: Chain. One of: base, ethereum. Default base.
- GET https://onchain.scrapemole.workers.dev/v1/holders ($0.002): Top holders of an ERC-20 token on Base or Ethereum: rank, address, balance (raw and human), share of supply when known, and public explorer labels/ENS when available.
  - address (required): Token contract address (0x…).
  - chain: Chain. One of: base, ethereum. Default base.
  - limit: Max holders to return (1-50). Default 10.

## MCP

- Remote MCP server (Streamable HTTP): POST https://onchain.scrapemole.workers.dev/mcp. Same tools and prices; pay with the x402 MCP transport.

## Docs

- OpenAPI: https://onchain.scrapemole.workers.dev/openapi.json
- Terms: https://onchain.scrapemole.workers.dev/terms
- Website: https://scrapemole.pages.dev

## Also from ScrapeMole

- ScrapeMole (YouTube search/channel/transcripts, Google Trends): https://scrapemole-api-mainnet.scrapemole.workers.dev
- ScrapeMole Amazon products: https://scrapemole-api.vercel.app
- ScrapeMole Reader (page to Markdown, link previews, RSS feeds, links, sitemaps): https://reader.scrapemole.workers.dev
- ScrapeMole Domains (DNS, RDAP/WHOIS, availability, email security, SSL certificates, subdomains): https://domains.scrapemole.workers.dev
- ScrapeMole Companies (SEC EDGAR: company profiles, financials, filings): https://companies.scrapemole.workers.dev
- ScrapeMole Wiki (Wikipedia summaries and search, Wikidata facts; CC BY-SA attributed): https://wiki.scrapemole.workers.dev
- ScrapeMole Pulse (ECB FX rates and conversion, time zones, weather forecasts, Hacker News): https://pulse.scrapemole.workers.dev
- ScrapeMole Pkgs (npm and PyPI package metadata, versions, search, download counts): https://pkgs.scrapemole.workers.dev
- ScrapeMole Arxiv (arXiv paper search, metadata, abstracts, category listings): https://arxiv.scrapemole.workers.dev
- ScrapeMole Social (Bluesky search/profiles/feeds, Hacker News search and threads, Lobsters): https://social.scrapemole.workers.dev
- ScrapeMole Quotes (stock, ETF, index, FX and crypto quotes, OHLCV history, ticker search, CoinGecko prices): https://quotes.scrapemole.workers.dev
- ScrapeMole Search (web search results, news search, search autocomplete suggestions): https://search.scrapemole.workers.dev