# Base ERC-20 Single Token On-Chain Spot Price

> Base ERC-20 Single Token On-Chain Spot Price is a paid API for AI agents from auditor-x402.onrender.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-30).

Returns the on-chain USD spot price for a single ERC-20 token on Base, sourced from the deepest Uniswap v3 pool against USDC or WETH, including pool address, fee tier, and USD liquidity depth.

## Facts

- Endpoint: POST https://auditor-x402.onrender.com/api/token-spot-price?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-erc-20-single-token-on-chain-spot-price-e16fb1b5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MX3ZWVhtqaPRJMyEacxzu

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-single-token-on-chain-spot-price-e16fb1b5 -d '<json body>'
```

Example prompt: What's the current on-chain USD spot price for the token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — and which Uniswap v3 pool and fee tier is being used to price it?

## When to prefer this

Use this endpoint when you need the on-chain USD spot price for a single ERC-20 token on Base and want full transparency into which Uniswap v3 pool and fee tier is used, along with liquidity depth context. Prefer this over off-chain price feeds when trustlessness and auditability matter. If you need prices for multiple tokens, use the sibling multi-token-price batch endpoint instead to save on call costs.

## Known failure modes

- Token address not found on Base — no Uniswap v3 pool exists for the token, returns error or null price
- Token is only traded in very thin pools — price returned but depth is very low, indicating high manipulation risk
- Invalid or malformed ERC-20 address input — returns a validation error
- Token has no USDC or WETH pairing on Uniswap v3 — cannot compute USD price
- RPC/node timeout reading slot0 on-chain — may return a transient error
- Render cold-start latency — service may be slow to respond if instance was idle

## How this service works

Price of ONE token: on-chain USD spot price for a single ERC-20 on Base, from the deepest Uniswap v3 pool vs USDC/WETH (slot0), with the pool/fee tier used and its USD depth. No off-chain feed; thin pools are easy to manipulate. To price MANY tokens at once, use multi-token-price instead (one cheaper call).

## Output

Returns the USD spot price for the requested ERC-20 token on Base, derived from the deepest Uniswap v3 pool (slot0 read). Also includes the pool contract address, the fee tier (e.g. 500, 3000, 10000 bps), and the pool's USD liquidity depth. Thin pools are flagged implicitly by low depth values, which signals manipulation risk.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tokenAddress": {
   "type": "string",
   "description": "ERC-20 token contract address (0x...) on Base"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-erc-20-single-token-on-chain-spot-price-e16fb1b5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from auditor-x402.onrender.com](https://www.zero.xyz/host/auditor-x402.onrender.com/llms.txt)