---
title: "Get historical token prices"
method: GET
path: "/v1/prices/timeseries"
tags: ["Prices"]
---

# Get historical token prices

`GET /v1/prices/timeseries`

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).

## Response `200`

Price timeseries

- TimeseriesResponse
  - `data` TimeseriesPoint[], required
    - `price` HistoricalPriceValue, required
      - `usd` number, double, required
    - `timestamp` string, required

## Other responses

- `422` — Invalid parameters
- `503` — Pricing service not configured

## Changes

- **2026-08-27** `4452dcc4d7b3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/gauntlet/apis/gauntlet-api/changes/v1/prices/timeseries/get.md)

---

[API](https://skmtc.dev/gauntlet/apis/gauntlet-api.md) · [All operations](https://skmtc.dev/gauntlet/apis/gauntlet-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gauntlet/gauntlet-api/revisions/4452dcc4d7b3/schema)