Api Endpoint

DefiLlama DeFi TVL & Yields

Batch historical token prices by DefiLlama — prices for many coins at many timestamps in one call (coins is a JSON map).

Open interactive test console

Offering

Provider: defillama.use.x402atlas.com
Method: GET
Offering type: Api Endpoint
Transport type: http
Category: Blockchain And Crypto
Delivery: Not provided
Pricing model: Not provided
x402 version: 2

Endpoint context

URL: https://defillama.use.x402atlas.com/batch-historical
MIME type: application/json
First seen: 2026-10-16T01:50:06.715Z
Last seen: 2026-11-02T00:05:26.119Z
Tags: DeFi, Price, Batch, Token, Defillama, Crypto, historical

Website

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1: 0.005 USDC
Atomic price: 5000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2: 0.005 USDC
Atomic price: 5000 · Network: eip155:137 · Asset: USDC · Scheme: exact
Payment option 3: 0.005 USDC
Atomic price: 5000 · Network: eip155:42161 · Asset: USDC · Scheme: exact
Payment option 4: 0.005 USDC
Atomic price: 5000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact

Raw x402 terms

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "5000",
    "payTo": "0xCB8025D951e5E45Be7D288B658EEee6f05713006"
  },
  {
    "scheme": "exact",
    "network": "eip155:137",
    "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "amount": "5000",
    "payTo": "0xCB8025D951e5E45Be7D288B658EEee6f05713006"
  },
  {
    "scheme": "exact",
    "network": "eip155:42161",
    "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "amount": "5000",
    "payTo": "0xCB8025D951e5E45Be7D288B658EEee6f05713006"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "5000",
    "payTo": "3nXsChcZGke6xebDPmndNMCt8L3yi6xyN4Pd6q5cQrgv"
  }
]

Observed health

Status: Healthy
Latest latency: 12 ms
Average latency: 116 ms
HTTP status: 402
Last checked: 2026-11-02T00:05:26.115Z
Reachability: 100% over 11 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

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

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "coins": {
              "description": "Required JSON object mapping each {chain}:{address} or coingecko:{id} coin to an array of unix timestamps",
              "maxLength": 8000,
              "minLength": 1,
              "type": "string"
            },
            "searchWidth": {
              "description": "Optional time range to search for each price (e.g. 4h)",
              "maxLength": 200,
              "type": "string"
            }
          },
          "required": [
            "coins"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "data": {
              "additionalProperties": true,
              "description": "Raw DefiLlama batchHistorical payload",
              "properties": {
                "coins": {
                  "additionalProperties": {
                    "properties": {
                      "prices": {
                        "items": {
                          "properties": {
                            "price": {
                              "description": "USD price",
                              "type": "number"
                            },
                            "timestamp": {
                              "description": "Unix timestamp (seconds)",
                              "type": "integer"
                            }
                          },
                          "type": "object"
                        },
                        "type": "array"
                      },
                      "symbol": {
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "description": "Keyed by {chain}:{address} or coingecko:{id}",
                  "type": "object"
                }
              },
              "type": "object"
            },
            "queried_at": {
              "description": "When this bridge fetched the upstream data",
              "format": "date-time",
              "type": "string"
            }
          },
          "required": [
            "queried_at",
            "data"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}