Tool detail

DefiLlama DeFi TVL & Yields

Returns DefiLlama historical USD prices for many chain:address or coingecko:id coins at many unix timestamps in one batch call.

Categories: Market prices, Defi

Use when

get historical USD prices for many tokens at many past timestamps
backfill price history for a portfolio of coins at specific times

Not for

not for current/live prices — use a current-price endpoint instead
not for TVL or yield data — prices only

Inputs

GET query params: coins (string, JSON map of chain:address/coingecko:id to timestamp array, required); searchWidth (string, e.g. 4h, optional)

Admitted input schema

{
  "type": "object",
  "properties": {
    "coins": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Required JSON object mapping each {chain}:{address} or coingecko:{id} coin to an array of unix timestamps"
    },
    "searchWidth": {
      "type": "string",
      "minLength": 0,
      "maxLength": 200,
      "description": "Optional time range to search for each price (e.g. 4h)"
    }
  },
  "required": [
    "coins"
  ],
  "additionalProperties": false
}

Endpoint

Method: GET
URL: https://defillama.use.x402atlas.com/batch-historical

Payment

Protocol: x402
Listed price: 0.005 USDC per call on Base
Payment method: exact
Network: eip155:8453
Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Directory: Coinbase x402 Bazaar
Record: GET https://defillama.use.x402atlas.com/batch-historical
Retrieved: 2026-09-30T20:37:07.382Z
Catalog file SHA-256: 6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built: 2026-09-30T22:31:58.034Z