# BaseLens

> Pay-per-call Base chain and web tools for AI agents. No API key or signup: each call is paid in USDC on Base via the x402 protocol (HTTP 402 -> sign -> retry).

Base URL: https://baselens.imac2014ville.workers.dev
OpenAPI: https://baselens.imac2014ville.workers.dev/openapi.json
Source: https://github.com/Imac2014Ville/baselens
Sister service: DepVet, https://depvet.imac2014ville.workers.dev

## Endpoints (GET with query params, or POST with JSON body)
- /token-risk ($0.02): Base ERC-20 scam/honeypot check: simulated sell, owner powers, liquidity, LP burn; verdict + 0-100 risk score. Example: /token-risk?token=0x940181a94A35A4569E4529A3CDfB74e38FD98631
- /new-pools ($0.01): Newly created Base liquidity pools (Uniswap v2/v3/v4, Aerodrome) with price, liquidity and flags. Example: /new-pools?minutes=30&quote=weth
- /fetch ($0.004): Any public web page as clean, LLM-ready markdown. SSRF-safe, 2 MB cap. Example: /fetch?url=https://example.com
- /cloud-prices ($0.02): Live Azure VM/GPU prices by region and SKU, cheapest first. Example: /cloud-prices?gpu=true&region=eastus
- /tx ($0.01): Explain a Base transaction in plain English; verify a payment landed. Example: /tx?hash=0x98023b255a23cf26d93492a6c3c542247cea95fa201dc83ed3fa91d3b6fcb57f
- /wallet ($0.005): Base address snapshot: ETH, nonce, EOA vs contract, major token balances. Example: /wallet?address=0x4200000000000000000000000000000000000006
- /x402check ($0.01): Health-check any x402 endpoint before paying: latency, price, network, spec issues. Example: /x402check?url=https://example.com/paid-endpoint

## How to pay
Call an endpoint without payment to receive HTTP 402 with a PAYMENT-REQUIRED header (base64 JSON: scheme exact, network eip155:8453, asset USDC). Use an x402 client (@x402/fetch, x402-axios, or an MCP x402 wallet) to sign and retry. Malformed requests return 400 and lookups that fail return non-2xx, so they are not charged.