# BlockRun DeFiLlama Token Price Lookup

> BlockRun DeFiLlama 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-14).

Fetches current token prices for one or more crypto assets using CoinGecko IDs or ERC-20 contract addresses via the DeFiLlama pricing API

## Facts

- Endpoint: GET https://blockrun.ai/api/v1/defillama/prices/coingecko:chainlink,coingecko:uniswap
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-defillama-token-price-lookup-ca7e2fb5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Jt7GYE9wIcG0_Kbt9TMvS

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-defillama-token-price-lookup-ca7e2fb5
```

Example prompt: What are the current prices of Chainlink and Uniswap? Look them up using their CoinGecko IDs — coingecko:chainlink and coingecko:uniswap.

## When to prefer this

Use this endpoint when you need real-time or near-real-time token prices for CoinGecko-listed assets or ERC-20 tokens identified by contract address, especially when you want to query multiple tokens in a single call. Prefer this over CEX ticker endpoints when dealing with DeFi tokens that may not be listed on centralized exchanges. The DeFiLlama backend aggregates prices across multiple DEX sources, making it reliable for long-tail tokens.

## Known failure modes

- Invalid or unrecognized coin identifier returns an error or empty entry for that token
- Malformed coin ID format (missing coingecko: prefix or invalid contract address) may cause parsing error
- DeFiLlama upstream outage causes stale or unavailable price data
- Too many tokens in a single comma-separated list may result in timeout or partial response
- Payment failure (insufficient USDC balance) prevents call from completing

## 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 the requested tokens, keyed by their coin identifiers (CoinGecko slugs or contract addresses). Each entry includes the token's current price and possibly metadata like symbol and timestamp.

## 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-defillama-token-price-lookup-ca7e2fb5/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)