Skip to main content
GET
/
v1
/
charts
/
history
Charts HTTP API
curl --request GET \
  --url https://charts.snek.fun/v1/charts/history
The charts service exposes read-only HTTP endpoints for candlestick (/v1/charts/...) and market-cap bars (/v1/charts/mcap/...). Prefer WebSocket for live updates. Base URL: https://charts.snek.fun/v1 Auth: Public

Resolution query parameter

All endpoints take resolution — one of: min1, min5, hour1, day1, week1, month1 (see OpenAPI / server enum).

GET /v1/charts/history

OHLCV history for a base / quote pair over a time range.

Query parameters

base
string
required
Base asset id (policy.hex or . for ADA).
quote
string
required
Quote asset id.
from
integer
required
Range start (Unix seconds).
to
integer
required
Range end (Unix seconds).
resolution
string
required
e.g. min1, hour1.

Response

JSON array of bar objects (LastBarWs): pair, time, low, high, open, close, volume (decimals).
curl -sS "https://charts.snek.fun/v1/charts/history?base=…&quote=.&from=1700000000&to=1700086400&resolution=min5"

GET /v1/charts/initial-state

Latest bar (and relevance flag) before subscribing over WebSocket.

Response

{
  "bar": {
    "pair": { "base": "…", "quote": "." },
    "time": 1729459260,
    "low": "0.0998",
    "high": "0.1015",
    "open": "0.1001",
    "close": "0.1009",
    "volume": "345.67"
  },
  "isRelevant": true
}

GET /v1/charts/mcap/history

Market-cap bars over a range (same query shape as charts/history).

GET /v1/charts/mcap/initial-state

Latest market-cap bar snapshot (mCap string, time, pair, isRelevant in the bar payload — see OpenAPI).

OpenAPI

GET /v1/docs/openapi on the same host returns the full YAML spec (includes all routes served by the process).