Cascade
Markets

Get Candles

Retrieve OHLCV data for a market

GET
/candles/{symbol}

Path Parameters

symbolstring

Identifies the market for which OHLCV data is desired

Query Parameters

interval?string

Time interval for the candles. Should be one of the supported intervals in minutes (m) hours (h) or days (d).

Value in"1m" | "3m" | "5m" | "15m" | "30m" | "1h" | "2h" | "4h" | "8h" | "12h" | "1d"
from?integer

Limit to candles which started on or after this timestamp

Formatint64
to?integer

Limit to candles which started before this timestamp

Formatint64
limitinteger

Maximum number of candles to return (discarding oldest)

Range1 <= value <= 5000

Response Body

application/json

text/plain

text/plain

curl -X GET "https://matcher.cascade.xyz/candles/ETH?interval=1h&from=1751932800000&to=1752192000000&limit=50"
[
  {
    "close": "2495.12347",
    "funding_rate": "0.000123",
    "high": "2500.12347",
    "low": "2490.12347",
    "open": "2498.12347",
    "time": 1751932800,
    "volume": "120.12347"
  },
  {
    "close": "2500.12347",
    "funding_rate": "0.000456",
    "high": "2505.12347",
    "low": "2492.12347",
    "open": "2495.12347",
    "time": 1751936400,
    "volume": "150.12347"
  }
]
"Market ETH not found"
"Internal server error: Database connection failed"