---
title: "Get historical candlestick data for token by id"
method: GET
path: "/tokens/prices/{tokenId}"
tags: ["Tokens"]
---

# Get historical candlestick data for token by id

`GET /tokens/prices/{tokenId}`

## Path parameters

- `tokenId` string, required

## Query parameters

- `from` integer, required
- `to` integer, required
- `interval` 'FIVEMIN' | 'HOUR' | 'DAY' | 'WEEK', required

## Headers

- `x-api-key` string, required

## Response `200`

Successful response

- TokenCandlestickData[]
  - `tokenId` string, required — Token id (shard.realm.num)
  - `open` integer, required — The open price of the token in tinybars (i.e. first minutely observation over the INTERVAL)
  - `openUsd` number, float, required — The open price of the token in USD (i.e. first minutely observation over the INTERVAL)
  - `high` integer, required — The high price of the token over the INTERVAL, in tinybars
  - `highUsd` number, float, required — The high price of the token over the INTERVAL, in USD
  - `low` integer, required — The low price of the token over the INTERVAL, in tinybars
  - `lowUsd` number, float, required — The low price of the token over the INTERVAL, in USD
  - `close` integer, required — The close price of the token over the INTERVAL, in tinybars
  - `closeUsd` number, float, required — The close price of the token over the INTERVAL, in USD
  - `avg` number, float, required — The (minutely) avg price of the token over the INTERVAL, in tinybars
  - `avgUsd` number, float, required — The (minutely) avg price of the token over the INTERVAL, in USD
  - `volume` string, required — The sum of total volume traded of the token over the INTERVAL, in tinybars
  - `liquidity` string, required — The point in time liquidity of the token, as of timestampSeconds (the end timestamp of the INTERVAL), in tinybars
  - `volumeUsd` number, float, required — The sum of total volume traded of the token over the INTERVAL, in USD
  - `liquidityUsd` unknown, required
  - `timestampSeconds` integer, required — The end unix timestamp of the INTERVAL, in seconds
  - `startTimestampSeconds` integer, required — The start unix timestamp of the INTERVAL, in seconds

---

[API](https://skmtc.net/saucerswap/apis/saucerswap-rest-api.md) · [All operations](https://skmtc.net/saucerswap/apis/saucerswap-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/saucerswap/saucerswap-rest-api/revisions/6c4d55a0e793/schema)