# blockrun.ai Token Price Lookup

> blockrun.ai Token Price Lookup is a paid API for AI agents from blockrun.ai, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Fetches current prices for one or more crypto tokens using DefiLlama price identifiers (CoinGecko slugs or EVM contract addresses).

## Facts

- Endpoint: GET https://blockrun.ai/api/v1/defillama/prices/coingecko:optimism,coingecko:avalanche-2
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-ai-token-price-lookup-bf11ba70
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FM3JD-_KgjexcSeesTvyC

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 blockrun-ai-token-price-lookup-bf11ba70
```

Example prompt: What are the current prices for Optimism and Avalanche? Look them up using their CoinGecko IDs: coingecko:optimism and coingecko:avalanche-2.

## When to prefer this

Use this endpoint when you need current spot prices for one or more crypto tokens and can identify them by CoinGecko slug or EVM contract address. Ideal for DeFi portfolio valuation, arbitrage checks, or enriching on-chain data with USD prices. Prefer over exchange-specific endpoints when you need aggregated/cross-market pricing via DefiLlama.

## Known failure modes

- Invalid or unrecognized coin identifier returns empty or error result
- Comma-separated list with one bad identifier may cause partial or full failure
- Rate limiting or payment failure returns 402
- Network timeout or DefiLlama upstream unavailability causes 5xx error
- Malformed path parameter (missing prefix like 'coingecko:') returns no price data

## How this service works

Token price lookup. Pass coin identifiers as `/v1/defillama/prices/{coins}` (e.g. `coingecko:bitcoin`, `ethereum:0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2`). Supports comma-separated lists.

## Output

Returns current USD price data for each requested coin identifier, keyed by the coin identifier string (e.g. coingecko:optimism). Includes price and likely timestamp/confidence metadata from DefiLlama's price feed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "query": {
     "type": "object",
     "required": [],
     "properties": {}
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "type": "object",
     "properties": {
      "data": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}
```

## More

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