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

# Get the latest candlestick data for token by id

`GET /tokens/prices/latest/{tokenId}`

## Request

- Base URL: `https://api.saucerswap.finance`
- URL: `https://api.saucerswap.finance/tokens/prices/latest/{tokenId}`
- Auth: none required
- TypeScript: <https://skmtc.dev/saucerswap/apis/saucerswap-rest-api/docs/tokens/prices/latest/:tokenId/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `tokenId` string, required

## Query parameters

- `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.dev/saucerswap/apis/saucerswap-rest-api.md) - [All operations](https://skmtc.dev/saucerswap/apis/saucerswap-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/saucerswap/apis/saucerswap-rest-api/revisions/6c4d55a0e793?raw)