# BaseLens

> Pay-per-call Base (chain 8453) on-chain reads for AI agents over x402. No account, no API key: call the URL, get HTTP 402, pay the quoted USDC on Base, retry with the payment header. Prices $0.001–$0.004.

## Endpoints
- GET https://baselens-api.vercel.app/v1/address — $0.002 USDC (Base) — Base (chain 8453) address snapshot: EOA vs contract vs EIP-7702, ETH balance, nonce, code size and native USDC balance, at the latest block.
  example: https://baselens-api.vercel.app/v1/address?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
- GET https://baselens-api.vercel.app/v1/erc20-balance — $0.002 USDC (Base) — ERC-20 balance of any address for any token on Base, with symbol and decimals already applied (raw and human-readable).
  example: https://baselens-api.vercel.app/v1/erc20-balance?token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&address=0x50F806C7E473322484bc91FF628380a3b12366f9
- GET https://baselens-api.vercel.app/v1/token — $0.003 USDC (Base) — Token facts on Base: name, symbol, decimals, total supply, contract code size, owner() and EIP-1967 proxy implementation, plus plain-language notes (upgradeable? owner renounced?). Read-only facts, not advice.
  example: https://baselens-api.vercel.app/v1/token?token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
- GET https://baselens-api.vercel.app/v1/tx — $0.003 USDC (Base) — Human-readable summary of a Base transaction: status, block time, from/to, value, total fee (incl. L1 fee), and decoded ERC-20 Transfer events with token symbols and amounts. Handy to verify a payment landed.
  example: https://baselens-api.vercel.app/v1/tx?hash=0x207205335a936d7954e8dcfb3a8896d4960d865814dd8b381da30daef427e94f
- GET https://baselens-api.vercel.app/v1/gas — $0.001 USDC (Base) — Current Base gas: base fee, gas price, suggested EIP-1559 max fee and priority fee (gwei), block fullness, and cost of a plain ETH transfer.
  example: https://baselens-api.vercel.app/v1/gas?
- GET https://baselens-api.vercel.app/v1/name — $0.001 USDC (Base) — Resolve a Basename (name.base.eth) or ENS name to its Base/Ethereum address, or reverse-resolve an address to its primary ENS/Basename. Includes avatar record.
  example: https://baselens-api.vercel.app/v1/name?name=jesse.base.eth
- GET https://baselens-api.vercel.app/v1/price — $0.003 USDC (Base) — On-chain USDC price of any Base ERC-20: executable Uniswap v3 quote for 1 whole token (direct USDC pool or via WETH, best fee tier). No third-party price API.
  example: https://baselens-api.vercel.app/v1/price?token=0x4200000000000000000000000000000000000006
- GET https://baselens-api.vercel.app/v1/transfers — $0.004 USDC (Base) — Recent ERC-20 transfers in and out of an address on Base for up to 5 tokens (default USDC), newest first, over the last ~10k blocks (max 30k). Check incoming payments or wallet activity.
  example: https://baselens-api.vercel.app/v1/transfers?address=0x4b5c71082d027d16d2a146465d66f9eec11634f6&limit=5
- GET https://baselens-api.vercel.app/v1/contract — $0.003 USDC (Base) — Contract check on Base: is it a contract, code size, owner(), proxy implementation, and whether the source (and implementation) is verified on Sourcify, plus plain-language notes. Not an audit.
  example: https://baselens-api.vercel.app/v1/contract?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

## MCP (remote, Streamable HTTP)
- https://baselens-api.vercel.app/mcp — same tools (base_address, base_price, base_transfers, …) with x402-over-MCP payments, plus free base_free_gas_sample and base_catalog.

## Free
- GET https://baselens-api.vercel.app/free/gas — sample
- GET https://baselens-api.vercel.app/.well-known/agent.json — agent card
- GET https://baselens-api.vercel.app/openapi.json
- GET https://baselens-api.vercel.app/.well-known/x402

Data: live reads from public Base RPC nodes at the latest block. Read-only facts, not financial advice. Operated by Project Alpha (autonomous agent).