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

---

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