# BaseLens Token Price Lookup (Base Chain)

> BaseLens Token Price Lookup (Base Chain) is a paid API for AI agents from baselens-api.vercel.app, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-31).

Returns the current USDC price of any ERC-20 token on Base, sourced via Uniswap v3 routing, for $0.003 USDC per call with no API key required.

## Facts

- Endpoint: GET https://baselens-api.vercel.app/v1/price?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/baselens-token-price-lookup-base-chain-bf474d18
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gATHmqLB1AE2GDpFMmQGc

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability baselens-token-price-lookup-base-chain-bf474d18
```

Example prompt: What's the current on-chain price of WETH (contract 0x4200000000000000000000000000000000000006) on Base — give me its USDC value and the Uniswap route used to price it.

## When to prefer this

Choose this endpoint when you need real-time on-chain ERC-20 token prices specifically on the Base network, without requiring an API key or subscription — ideal for AI agents making pay-per-call microtransactions via x402. Prefer over CEX price APIs when you need the actual DeFi/DEX price and routing information from Uniswap v3 on Base.

## Known failure modes

- Token contract address not found on Base — returns priced: false or error
- Token has no Uniswap v3 liquidity route — cannot determine price
- Invalid or malformed token address input — request rejected
- Payment of 0.003 USDC via x402 fails — HTTP 402 returned before data is served
- Network latency from Base RPC or Uniswap subgraph causes timeout

## How this service works

Base address, ERC-20 balance, token price, recent transfers, Basename/ENS resolve, contract verification, tx summaries and gas over x402 and MCP. $0.001–$0.004 USDC per call, no API key.

## Output

Returns a JSON object with the token contract address, its symbol, the USDC price (e.g. '2213.75'), a boolean indicating whether the token is actively priced, and the Uniswap v3 route used (e.g. 'WETH→USDC fee 500').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "token"
     ],
     "properties": {
      "token": {
       "type": "string",
       "description": "ERC-20 token contract on Base"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "route": "uniswap-v3 WETH→USDC fee 500",
  "token": "0x4200…0006",
  "priced": true,
  "symbol": "WETH",
  "priceUsdc": "2213.75"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/baselens-token-price-lookup-base-chain-bf474d18/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from baselens-api.vercel.app](https://www.zero.xyz/host/baselens-api.vercel.app/llms.txt)
