# Agent Data Tools: ERC-20 Token Price Lookup via Uniswap v3

> Agent Data Tools: ERC-20 Token Price Lookup via Uniswap v3 is a paid API for AI agents from agent-data-tools.revmesh2074.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-20).

Returns the current USD spot price of an ERC-20 token on Base, Ethereum, Arbitrum, or Optimism by querying the Uniswap v3 pool with the largest USDC or WETH reserve.

## Facts

- Endpoint: GET https://agent-data-tools.revmesh2074.workers.dev/price/token?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-data-tools-erc-20-token-price-lookup-via-uniswap-v3-4b8046b2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hit-4nmc5Yw4S_lYHdulu

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 agent-data-tools-erc-20-token-price-lookup-via-uniswap-v3-4b8046b2
```

Example prompt: What's the current USD price of the cbBTC token at contract address 0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf on Base, and which Uniswap v3 pool is it quoted from?

## When to prefer this

Use this endpoint when you need a real-time, on-chain USD spot price for any ERC-20 token on Base, Ethereum, Arbitrum, or Optimism, sourced directly from Uniswap v3 liquidity pools. It is best for DeFi agents, portfolio trackers, and trading bots that need decentralized, trustless price data rather than centralized exchange quotes. Prefer this over CoinGecko or CoinMarketCap APIs when you want the actual on-chain price a trade would execute at, or when the token is not listed on major CEXes. The thin liquidity flag helps agents avoid acting on unreliable prices for low-cap tokens.

## Known failure modes

- Token contract address not found on the specified chain — returns error or empty result
- No Uniswap v3 pool exists for the token — cannot determine price
- thinLiquidity flag set true — price may be unreliable due to low pool reserves
- Invalid or malformed contract address — request rejected
- Unsupported chain specified — only base, eth, arb, op are valid
- x402 payment failure — call not charged but no result returned

## How this service works

Crypto token USD price by ticker (ETH, BTC, USDC, AERO, ARB, OP, LINK…) or by any ERC-20 0x address on Base, Ethereum, Arbitrum or Optimism, from the deepest Uniswap v3 pool against USDC or WETH, read live from the chain. Returns the pool, its fee tier, the quote reserve and a thin-liquidity flag. Spot price, not a time average. No pool returns 404, uncharged. Use to value a token or check a quote before a swap or payment.

## Output

A JSON object containing: the token's current USD spot price (priceUsd), the token symbol and decimals, the Uniswap v3 pool address and fee tier used for pricing, the pool's USDC reserve size and its USD value, the quote currency (USDC or WETH), the ETH/USD rate used, the current block number, chain name and chain ID, a thinLiquidity boolean warning, and the pricing method description.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "base",
    "eth",
    "arb",
    "op"
   ],
   "type": "string",
   "description": "Network: base (default), eth, arb or op"
  },
  "symbol": {
   "type": "string",
   "description": "Ticker such as ETH, BTC, USDC, AERO, ARB, OP or LINK (instead of address; ETH and BTC mean the wrapped tokens)"
  },
  "address": {
   "type": "string",
   "description": "0x ERC-20 token contract address (instead of symbol)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "pool": {
   "type": "object",
   "properties": {
    "address": {
     "type": "string"
    },
    "feeTier": {
     "type": "number"
    },
    "quoteReserve": {
     "type": "number"
    },
    "quoteReserveUsd": {
     "type": "number"
    }
   }
  },
  "block": {
   "type": "number"
  },
  "chain": {
   "type": "string"
  },
  "token": {
   "type": "object",
   "properties": {
    "symbol": {
     "type": "string"
    },
    "address": {
     "type": "string"
    },
    "decimals": {
     "type": "number"
    }
   }
  },
  "ethUsd": {
   "type": "number"
  },
  "method": {
   "type": "string"
  },
  "chainId": {
   "type": "number"
  },
  "priceUsd": {
   "type": "number"
  },
  "quotedIn": {
   "type": "string"
  },
  "thinLiquidity": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-data-tools-erc-20-token-price-lookup-via-uniswap-v3-4b8046b2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-data-tools.revmesh2074.workers.dev](https://www.zero.xyz/host/agent-data-tools.revmesh2074.workers.dev/llms.txt)