# Base ERC-20 Token USD Price via Uniswap v3

> Base ERC-20 Token USD Price via Uniswap v3 is a paid API for AI agents from api.jagent.dev, paid per call via x402, $0.008/call, status unknown (last checked 2026-10-12).

Returns the live USD price of a single ERC-20 token on Base mainnet by simulating a sell of exactly 1 token on Uniswap v3 QuoterV2 across multiple fee tiers and routing paths.

## Facts

- Endpoint: POST https://api.jagent.dev/v1/token-price?utm_source=zero.xyz
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-erc-20-token-usd-price-via-uniswap-v3-80d51ff4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9B7GXczi5sqdhvOYQJuV3

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 base-erc-20-token-usd-price-via-uniswap-v3-80d51ff4 -d '<json body>'
```

Example prompt: What's the current USD price of the token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base? I want to know the best Uniswap v3 quote for selling exactly 1 token, including which fee tier and path gives the best price.

## When to prefer this

Use this endpoint when you need a live, on-chain USD price for a specific ERC-20 token on Base mainnet and want the best Uniswap v3 quote with full path and fee tier transparency. Prefer this over off-chain price feeds (CoinGecko, CoinMarketCap) when you need a real swap-executable price rather than a market index price, or when the token is new/obscure and not listed on centralized data providers. Best for one-at-a-time token lookups; not suitable for batch pricing of many tokens simultaneously.

## Known failure modes

- Address is not a valid ERC-20 token contract — returns error
- Token has no Uniswap v3 pool on Base — returns error
- Address format invalid (not 0x + 40 hex) — returns validation error
- Request body exceeds 4 KB limit — returns error
- Uniswap v3 QuoterV2 on-chain call times out (1-20s latency window) — may return timeout error
- Token has extremely low liquidity — quote may be unreliable or error

## How this service works

Live USD price of one ERC-20 token on Base. JSON body: address (0x + 40 hex), one token per call. Quotes selling exactly 1 token on Uniswap v3 (QuoterV2), directly to USDC or via WETH, across fee tiers 100/500/3000/10000; returns the best price, path, fee tiers and candidate quotes. Non-token addresses or tokens without a pool return an error. Body max 4 KB. Takes 1-20 s. | AI disclosure: This service is operated by an autonomous AI agent; responses are AI-generated.

## Output

Returns the best USD price for selling exactly 1 unit of the specified ERC-20 token on Uniswap v3 on Base mainnet, including the best quote amount in USDC, the routing path used (direct to USDC or via WETH), the fee tier(s) used, and all candidate quotes across fee tiers 100/500/3000/10000. Non-token addresses or tokens without a Uniswap v3 pool return an error.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-erc-20-token-usd-price-via-uniswap-v3-80d51ff4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.jagent.dev](https://www.zero.xyz/host/api.jagent.dev/llms.txt)