> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gauntlet.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get historical token prices

> Returns a USD price timeseries for a token. Query parameters: `address` (required), `chain_id` (required), `start` (required ISO 8601), `end` (required ISO 8601), `granularity` (optional: `raw` | `hour` | `day` | `week` | `month`), `limit` (optional, default 1000, max 5000).



## OpenAPI

````yaml GET /v1/prices/timeseries
openapi: 3.1.0
info:
  title: Gauntlet API
  description: Gauntlet vault data and user positions API.
  contact:
    name: Gauntlet
    url: https://gauntlet.xyz
  license:
    name: ''
  version: 1.0.0
servers:
  - url: https://api.gauntlet.xyz
    description: Production
security: []
tags:
  - name: System
    description: Health checks and Prometheus metrics
  - name: TVL
    description: Aggregate live TVL
  - name: Strategies
    description: Curated strategy groupings with aggregate metrics
  - name: Vaults
    description: Vault listings, details, metrics, timeseries
  - name: Users
    description: Per-wallet position state and timeseries
  - name: Prices
    description: Token price lookups and historical timeseries
paths:
  /v1/prices/timeseries:
    get:
      tags:
        - Prices
      summary: Get historical token prices
      description: >-
        Returns a USD price timeseries for a token. Query parameters: `address`
        (required), `chain_id` (required), `start` (required ISO 8601), `end`
        (required ISO 8601), `granularity` (optional: `raw` | `hour` | `day` |
        `week` | `month`), `limit` (optional, default 1000, max 5000).
      operationId: get_price_history
      responses:
        '200':
          description: Price timeseries
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TimeseriesResponse'
        '422':
          description: Invalid parameters
        '503':
          description: Pricing service not configured
components:
  schemas:
    TimeseriesResponse:
      type: object
      required:
        - data
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/TimeseriesPoint'
    TimeseriesPoint:
      type: object
      required:
        - timestamp
        - price
      properties:
        price:
          $ref: '#/components/schemas/HistoricalPriceValue'
        timestamp:
          type: string
    HistoricalPriceValue:
      type: object
      required:
        - usd
      properties:
        usd:
          type: number
          format: double

````