Get candles

Returns OHLCV candles for a market and interval. Use candles for charts, historical price checks, and pre-trade context; use ticker or order book endpoints when you need a current executable view.

GET /partner/exchange/candles

Get candles

cURL

curl --request GET \
  --url https://api.stabyl.com/v1/partner/exchange/candles \
  --header 'X-Api-Key: <api-key>'

200

{
  "data": {
    "candles": [
      {
        "close": "1655.00",
        "high": "1660.00",
        "low": "1648.00",
        "open": "1650.00",
        "timestamp": "2026-05-24T12:00:00Z",
        "trade_count": 42,
        "volume": "1000.00",
        "volume_quote": "1655000.00"
      }
    ],
    "interval": "1h",
    "pair_id": "USD/NGN"
  },
  "status": "success"
}

Authorizations

X-Api-Key · string · header · default: sb_test_your_key · required

API key. Send it in the X-Api-Key header.

Query Parameters

pair_id · string · required

Trading pair identifier returned by GET /partner/exchange/markets, for example USD/NGN.

interval · string · required

Candle interval. Supported values: 1m, 5m, 15m, 1h, 4h, 1d.

before · string<date-time> | null

Return candles before this UTC timestamp. Omit to read from the current server time.

limit · integer<int64> | null

Number of candles to return. Defaults to 100 and is capped by the API.

Response

200

application/json

OHLCV candles

data · object · required

OHLCV candle series for a trading pair and interval.

Show child attributes

status · enum<string> · required

Available options: success