---
title: "Candle history"
method: GET
path: "/api/v1/coins/{slug}/history"
tags: ["Coins"]
---

# Candle history

`GET /api/v1/coins/{slug}/history`

Per-coin OHLC + volume + marketcap time series. Pick `interval`: minutely,
half-hourly, hourly or daily. Retention is a hard property of the rollup
pipeline — minutely 8 days, half-hourly 3 months, hourly 6 months, daily forever;
requests beyond a window return what exists. When a `limit` is set you get the
MOST RECENT N rows in the window, emitted oldest-first. Prices are decimal
strings.

## Query parameters

- `interval` string — minutely, half-hourly, hourly or daily (default daily).
- `start` string — ISO date/time lower bound.
- `end` string — ISO date/time upper bound (a date-only value means through that day).
- `limit` integer — Max rows (1–2000, default 1000).

## Response `200`

- object
  - `data` object[]
    - `time` string
    - `price` string
    - `open` string
    - `high` string
    - `low` string
    - `close` string
    - `volume_24h` integer
    - `marketcap` number
  - `meta` object
    - `coin` string
    - `interval` string
    - `count` integer
    - `retention` string

## Other responses

- `404`

---

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