# BlockNotify Token Price Lookup

> BlockNotify Token Price Lookup is a paid API for AI agents from x402.blocknotify.com, paid per call via x402, $0.0011/call, status unknown (last checked 2026-09-14).

Returns real-time ERC-20 token price, market cap, volume, supply, and historical percentage changes for a given contract address on an EVM chain.

## Facts

- Endpoint: POST https://x402.blocknotify.com/v1/token-price
- Price: $0.0011/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blocknotify-token-price-lookup-485eb0fd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_M4Lzt7gIotsLaxQ2BK3Gb

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 blocknotify-token-price-lookup-485eb0fd -d '<json body>'
```

Example prompt: What's the current USD price and market cap of the token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum, and how much has it changed in the last 24 hours and 7 days?

## When to prefer this

Choose this endpoint when you need comprehensive token market data — price, market cap, supply, volume, and historical changes — for a known ERC-20 contract address on a supported EVM chain (Ethereum, Polygon, Arbitrum, Optimism, Base). Prefer this over on-chain RPC calls when you want aggregated market data (not just on-chain state) and when the ~7-minute cache latency is acceptable. Use this instead of general crypto price APIs when you already have the contract address and want structured multi-metric output in a single call.

## Known failure modes

- Invalid or non-ERC-20 contract address returns an error or empty result
- Unsupported chain value outside the allowed enum causes a validation error
- Token with no price feed or very low liquidity may return null/missing price fields
- Unsupported quote currency may return an error or fall back to USD
- Payment failure (insufficient USDC balance) blocks the request under x402 protocol

## How this service works

Get real-time token price, market cap and more. Pass an EVM chain plus ERC-20 contract address; returns current price (USD or any quote currency), 24h/7d/30d percentage changes, market cap, fully diluted valuation, 24h volume, all-time high/low, total / circulating / max supply, and basic community stats. Cached server-side for ~7 minutes for low-cost agent lookups.

## Output

Returns a JSON object containing the token's current price in the requested quote currency, percentage price changes over 24h, 7d, and 30d windows, market cap, fully diluted valuation, 24h trading volume, all-time high and low prices, total/circulating/max supply figures, and basic community statistics. Data is cached server-side for approximately 7 minutes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "ethereum",
    "polygon",
    "arbitrum",
    "optimism",
    "base"
   ],
   "type": "string",
   "description": "Target EVM chain. The merchant maps this to the appropriate RPC for simulation."
  },
  "address": {
   "type": "string",
   "pattern": "^0x[a-fA-F0-9]{40}$",
   "description": "ERC-20 contract address of the token to price."
  },
  "currency": {
   "type": "string",
   "default": "USD",
   "maxLength": 10,
   "minLength": 3,
   "description": "Fiat or crypto quote currency (ISO-style code, e.g. \"USD\", \"EUR\", \"BTC\", \"ETH\"). Defaults to USD."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blocknotify-token-price-lookup-485eb0fd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.blocknotify.com](https://www.zero.xyz/host/x402.blocknotify.com/llms.txt)