---
title: "Get chart historical series"
method: GET
path: "/api/v1/charts/{slug}/history"
tags: ["Bitcoin Charts"]
---

# Get chart historical series

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

## Request

- Base URL: `https://tradingstrategies.work`
- URL: `https://tradingstrategies.work/api/v1/charts/{slug}/history`
- Auth: HTTP bearer

Time-series `{ slug, kind, fields, from, to, count, history: [{ date, ...fields }] }`. Uniform multi-field payload (see /latest). Daily charts honor `days`/`from`/`to` with tier-staggered range cap; monthly/yearly/projection charts (e.g. monthly-returns, cycle-overlay, yearly-lows) return their full natural window. `view` selects an alternative alignment where a chart offers one — currently cycle-overlay only: `view=halving` (one row per cycle and day since halving: cycle, day, multiple of the halving-day close) and `view=bear` (one row per bear market and day since the cycle high: cycle, day, drawdown_pct). Both return `kind=table` plus a `meta` block with the per-cycle summary (peak / trough, days, provisional flag for the open cycle) and the mechanical rule; the open cycle's high is the highest close so far and is NOT a top signal. Any other slug rejects `view` with invalid_input. [Free tier]

## Path parameters

- `slug` string, required

## Query parameters

- `days` integer
- `view` 'halving' | 'bear'

## Response `200`

History series.

## Other responses

- `400`: Invalid input — fehlt Pflichtfeld oder Wert außerhalb des erlaubten Bereichs.
- `401`: Unauthenticated — kein gültiger Bearer-Token im Authorization-Header.
- `403`: Tier-Insufficient — Endpoint braucht höheren API-Tier. Response enthält upgrade_url.
- `404`: Not-Found — Resource existiert nicht oder gehört nicht dem aktuellen User.
- `429`: Rate-Limit überschritten — Tier-Quota (hourly/daily) oder Per-Endpoint-Quota erreicht. Retry-After-Header gesetzt.
- `500`: Internal Error.
- `503`: Upstream-Failure — Datenquelle nicht erreichbar (Binance, EODHD, etc.).

---

[API](https://skmtc.dev/tradingstrategies/apis/backtesting-arena-public-api.md) · [All operations](https://skmtc.dev/tradingstrategies/apis/backtesting-arena-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tradingstrategies/apis/backtesting-arena-public-api/revisions/f82e8d6eecd7?raw)