Skip to main content

Documentation Index

Fetch the complete documentation index at: https://orderly.network/docs/llms.txt

Use this file to discover all available pages before exploring further.

OHLCV candles for a symbol and interval. Weight: 2

​
Request

{
  "type": "candles",
  "symbol": "PERP_BTC_USDC",
  "interval": "1h",
  "start_time": 1716100000000,
  "end_time": 1716200000000,
  "limit": 500
}
FieldTypeRequiredDefaultNotes
symbolstringYes—Trading pair
intervalstringYes—1m / 5m / 15m / 30m / 1h / 4h / 1d / 1w
start_timeint64No—ms epoch; filters open_time ≥ start_time
end_timeint64No—ms epoch; filters open_time ≤ end_time
limitintNo5001..5000
cursorstringNo—Opaque cursor — pass through

​
Response

FieldTypeNotes
open, high, low, closestringDecimal price
volumestringBase-asset volume during the candle
timestampint64Candle open time (ms epoch)

​
Notes

  • 60s cache keyed by (symbol, interval, time-range, cursor)
{
  "success": true,
  "data": {
    "rows": [
      {
        "open": "12345.67",
        "high": "12400.00",
        "low": "12300.00",
        "close": "12350.50",
        "volume": "1234.56",
        "timestamp": 1716192000000
      }
    ],
    "next_cursor": null
  },
  "ts": 1779269143700
}