---
title: "DEX OHLCV price chart (on-demand GeckoTerminal proxy, 30s cache)"
method: GET
path: "/v1/prices/ohlcv"
---

# DEX OHLCV price chart (on-demand GeckoTerminal proxy, 30s cache)

`GET /v1/prices/ohlcv`

## Request

- Base URL: `https://api.spiralstake.xyz`
- URL: `https://api.spiralstake.xyz/v1/prices/ohlcv`
- Auth: none declared

USD candles from the deepest DEX pool holding `token`, for collateral with no CoinGecko/TradingView chart. `stale: true` means the upstream failed and the previous candles (≤10 min old) are being served.

## Query parameters

- `chainId` integer
- `token` string, required
- `timeframe` 'minute' | 'hour' | 'day'
- `aggregate` integer
- `limit` integer

## Response `200`

OK

## Other responses

- `400`: Bad request
- `404`: No DEX pool indexed for the token
- `503`: Upstream unavailable

---

[API](https://skmtc.dev/spiralstake/apis/spiral-stake-read-api-v1.md) · [All operations](https://skmtc.dev/spiralstake/apis/spiral-stake-read-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/spiralstake/apis/spiral-stake-read-api-v1/revisions/e58af20cd747?raw)