# DeFiLlama Token Price Oracle

> DeFiLlama Token Price Oracle is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-01).

Returns USD price, symbol, decimals, and confidence score for up to 20 on-chain tokens by chain:contract address or CoinGecko slug, sourced from DefiLlama's aggregated open oracle.

## Facts

- Endpoint: POST https://api.vextorium.com/precio-defi-pago?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defillama-token-price-oracle-a51aceca
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_i_hSn12IkFyaiqe-tVdvM

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 defillama-token-price-oracle-a51aceca -d '<json body>'
```

Example prompt: What's the current USD price, decimals, and confidence score for USDC on Ethereum (ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48) and WETH on Base (base:0x4200000000000000000000000000000000000006)?

## When to prefer this

Prefer this endpoint when you need live USD prices for any on-chain token — especially long-tail DeFi tokens, low-cap altcoins, or tokens not listed on centralized exchanges — by their contract address or CoinGecko slug. It supports up to 20 tokens per call across any EVM chain or Solana, making it ideal for batch portfolio valuation or arbitrage checks. Choose this over CoinGecko's own API when you need a confidence score alongside the price, or when you're working with chain-native contract addresses rather than slug names.

## Known failure modes

- Token identifier not found — returned in no_encontrados array with no price
- Invalid format for chain:contract string — may result in empty response or lookup failure
- More than 20 tokens requested — likely truncated or rejected
- Network/oracle outage from DefiLlama upstream — may return stale or missing prices
- Low confidence score returned (near 0) indicating sparse liquidity data for that token

## How this service works

Token prices from DefiLlama's aggregated open oracle, by id 'chain:contract' (or 'coingecko:slug'), up to 20 at once. Returns symbol, USD price, decimals and a confidence score. Works for any on-chain token, not just top coins. Live from DefiLlama.

## Output

Returns a list of matched tokens each with their identifier, symbol, USD price, decimal count, confidence score (0–1), and last-updated timestamp. Tokens that could not be resolved are listed separately in a not-found array. An optional note field may carry informational messages.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "monedas"
     ],
     "properties": {
      "monedas": {
       "type": "string",
       "description": "Comma-separated ids 'chain:contract' or 'coingecko:slug' (max 20)"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "nota": {
       "type": [
        "string",
        "null"
       ]
      },
      "precios": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "id": {
          "type": [
           "null",
           "string"
          ]
         },
         "simbolo": {
          "type": [
           "null",
           "string"
          ]
         },
         "confianza": {
          "type": [
           "null",
           "number"
          ]
         },
         "decimales": {
          "type": [
           "null",
           "number"
          ]
         },
         "precio_usd": {
          "type": [
           "null",
           "number"
          ]
         },
         "actualizado": {
          "type": [
           "null",
           "string"
          ]
         }
        }
       }
      },
      "no_encontrados": {
       "type": [
        "array",
        "null"
       ],
       "items": {}
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "nota": "Precio agregado de múltiples fuentes por DefiLlama; 'confianza' cercano a 1 = fiable. Fuente: DefiLlama.",
  "precios": [
   {
    "id": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "simbolo": "USDC",
    "confianza": 0.99,
    "decimales": 6,
    "precio_usd": 0.999817132983207,
    "actualizado": "2026-09-30 13:00"
   },
   {
    "id": "coingecko:bitcoin",
    "simbolo": "BTC",
    "confianza": 0.99,
    "decimales": null,
    "precio_usd": 85248.11985758645,
    "actualizado": "2026-09-30 13:00"
   }
  ],
  "no_encontrados": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defillama-token-price-oracle-a51aceca/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)