# AgentToll Token Price Lookup

> AgentToll Token Price Lookup is a paid API for AI agents from agenttoll.app, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-07).

Returns the current USD price of any ERC-20 token on Base blockchain, looked up by its contract address

## Facts

- Endpoint: GET https://agenttoll.app/api/base/token/%7Baddress%7D?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-07
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenttoll-token-price-lookup-267293a8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QRqEVckJWM23z64oc6pdD

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 agenttoll-token-price-lookup-267293a8
```

Example prompt: What's the current USD price of the token at contract address 0x4200000000000000000000000000000000000006 on Base?

## When to prefer this

Use this endpoint when you need a quick, lightweight USD price for a specific ERC-20 token on Base by its contract address, especially in agent workflows that require no API key setup and support x402 micropayments. Prefer this over broader market data APIs when you specifically need Base-native onchain pricing sourced from DEX pools rather than centralized exchange data.

## Known failure modes

- Token contract address not found on Base — returns error or null price
- Invalid or malformed contract address — returns 400-level error
- Token has no liquidity or DEX pool — price unavailable
- GeckoTerminal upstream unavailable — stale or missing data
- Payment not fulfilled via x402 — request blocked with 402 response

## How this service works

Base-native onchain data for AI agents — gas, token prices by contract, address analytics, DEX pools, new-token radar. From $0.001 a call in USDC via x402. No API keys. Open source.

## Output

A JSON object containing the timestamp of the price snapshot, the USD price as a float, the chain identifier ('base'), the token contract address queried, and the data source (e.g. 'geckoterminal').

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "at": "2026-08-05T13:31:58.678Z",
  "usd": 1867.28,
  "chain": "base",
  "token": "0x4200000000000000000000000000000000000006",
  "source": "geckoterminal"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenttoll-token-price-lookup-267293a8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agenttoll.app](https://www.zero.xyz/host/agenttoll.app/llms.txt)