---
title: "Get token price snapshots"
method: GET
path: "/v1/prices"
tags: ["V1"]
---

# Get token price snapshots

`GET /v1/prices`

Returns cached token price snapshots for one token or up to 50 requested token entries. Stale prices are returned immediately and marked with `stale` and `refreshing` metadata when a background refresh is scheduled.

## Query parameters

- `chainId` string
- `token` string
- `tokens` string

## Headers

- `x-api-key` string

## Response `200`

Token price snapshot response.

- TokenPricesResponseDto
  - `prices` TokenPriceResultDto[], required
    - `chainId` number, required
    - `token` string, required
    - `priceUSD` string — Cached USD price as a decimal string, when available.
    - `source` string — Price source used for this cached value, when available.
    - `updatedAt` string — Timestamp of the cached token price, when available.
    - `stale` boolean, required — Whether this cached value is outside Delora's freshness window.
    - `tier` 'hot' | 'cold', required — Price refresh tier. `hot` entries are prioritized for fresher cached prices; `cold` entries refresh less aggressively.
    - `refreshing` boolean, required — Whether a background refresh for this price is scheduled or already running.

## Other responses

- `400` — Invalid request parameters.
- `429` — Rate limit exceeded.

## Changes

- **2026-07-26** `fa9617c7c0a9` — 4 warning
  - added the new `AMOUNT_TOO_LOW` enum value to the `code` response property for the response status `400`
  - added the new `AMOUNT_TOO_LOW` enum value to the `code` response property for the response status `429`
  - added the new `SLIPPAGE_EXCEEDED` enum value to the `code` response property for the response status `400`
  - added the new `SLIPPAGE_EXCEEDED` enum value to the `code` response property for the response status `429`
- **2026-06-22** `85b3d9b4fd84` — 1 info
  - endpoint added

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

---

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