# d21 Token Price

> d21 Token Price is a paid API for AI agents from draconic21-x402-api.onrender.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-12).

Returns on-chain token prices for curated majors via Chainlink or any Base ERC-20 via Uniswap V3 pool discovery, with optional batch lookup by symbol or address

## Facts

- Endpoint: POST https://draconic21-x402-api.onrender.com/v1/token_price?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/d21-token-price-b08e809d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EWV7H8B2B3dAWe7WKlBX6

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 d21-token-price-b08e809d -d '<json body>'
```

Example prompt: What are the current on-chain prices for ETH, BTC, and cbETH in USD? Use the Chainlink-backed source so I know the prices come from verified on-chain aggregators.

## When to prefer this

Prefer this endpoint when you need verifiable on-chain token prices rather than centralized price-API feeds, especially for tokens on the Base network including arbitrary ERC-20s not listed on major exchanges. It is the right choice when you need Chainlink-grade reliability for curated majors (ETH, WETH, USDC, DAI, cbETH, cbBTC, BTC) or want automated Uniswap V3 pool discovery for long-tail Base tokens. Choose it over generic price APIs when on-chain provenance and liquidity awareness matter.

## Known failure modes

- No Uniswap V3 pool discoverable for the given address — returns unsupported-token error
- Low liquidity on the discovered pool — price returned with low-liquidity flag set
- Invalid or malformed ERC-20 address — input validation error
- More than 10 tokens in coins batch — rejected with limit error
- Mutually exclusive params (symbol + address, or symbol + coins) used together — input conflict error
- Chainlink feed temporarily unavailable — may return stale or error response

## How this service works

Token Price ($0.003): Base token price derived from on-chain state, not a resold price-API feed. Curated majors (ETH, WETH, USDC, DAI, cbETH, cbBTC, BTC) are priced from Chainlink's own Data Feed aggregator contracts on Base; any other Base ERC-20 address is priced from its deepest discoverable Uniswap V3 pool against USDC (with a liquidity read and a low-liquidity flag), or a clean unsupported-token error if no pool is discoverable. Also accepts { coins }, a comma-separated batch of symbols…

## Output

Returns the token price in USD (or ETH if specified), sourced from Chainlink aggregator contracts for curated majors or the deepest discoverable Uniswap V3 USDC pool for arbitrary Base ERC-20s. Includes a low-liquidity flag when pool depth is thin, or a clean error if no pool is discoverable for the requested address.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "coins": {
   "type": "string",
   "description": "Comma-separated batch of symbols and/or 0x addresses, up to 10 (e.g. 'BTC,ETH,0x...') — same param name the category-leading incumbent uses. Mutually exclusive with symbol/address."
  },
  "quote": {
   "enum": [
    "USD",
    "ETH"
   ],
   "type": "string",
   "description": "Quote currency, default USD."
  },
  "symbol": {
   "type": "string",
   "description": "Curated major token symbol: ETH, WETH, USDC, DAI, CBETH, CBBTC, or BTC. Mutually exclusive with address/coins."
  },
  "address": {
   "type": "string",
   "description": "Any Base ERC-20 contract address (0x...), priced from its deepest live Uniswap V3 USDC pool. Mutually exclusive with symbol/coins."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/d21-token-price-b08e809d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from draconic21-x402-api.onrender.com](https://www.zero.xyz/host/draconic21-x402-api.onrender.com/llms.txt)