Historical charts & data

Specify both ends of the window

{
  "market": {
    "symbol": "BINANCE:BTCUSDT",
    "interval": "240",
    "range": {
      "from": "2023-01-01T00:00:00Z",
      "to": "2023-02-01T00:00:00Z"
    }
  }
}

Dates must be RFC3339 timestamps with a timezone. We use a half-open interval: from is included; to is excluded. Candles whose close falls after the cutoff are excluded, even when their opening timestamp lies inside the window.

Request an instrument from the connected feed

{
  "market": {
    "symbol": "NASDAQ:AAPL",
    "interval": "D",
    "source": "workspace",
    "range": {
      "from": "2023-01-01T00:00:00Z",
      "to": "2023-02-01T00:00:00Z"
    }
  }
}

The connected feed anchors its query to your cutoff and checks every expected completed candle against the provider’s reported session calendar. Missing first, interior or final candles are rejected. Availability depends on the instrument and provider. Regular-session, split-adjusted candles use the provider’s exchange timezone, holidays and corrected session closes, including early closes. Closed sessions are not filled with synthetic bars.

Use your own market data

For licensed equities, alternate feeds or research fixtures, send your own sorted OHLCV candles. They are validated and rendered as supplied; no alternate provider silently replaces them.

{
  "market": {
    "symbol": "NASDAQ:AAPL",
    "interval": "D",
    "source": "provided",
    "dataSource": "My historical feed",
    "range": {
      "bars": 2
    },
    "bars": [
      {
        "time": 1704153600,
        "open": 187.15,
        "high": 188.44,
        "low": 183.89,
        "close": 185.64,
        "volume": 82488700
      },
      {
        "time": 1704240000,
        "open": 184.22,
        "high": 185.88,
        "low": 183.43,
        "close": 184.25,
        "volume": 58414500
      }
    ]
  }
}

Coverage is part of the result

Inspect market.requestedRange, actualRange, source and data metadata. Unsupported, empty or incomplete windows fail explicitly. Binance’s fixed public endpoint supplies BTC, ETH and SOL spot history. The connected feed supplies provider-dependent historical windows, not only recent snapshots.

In market.actualRange, lastCandle is the final candle’s opening timestamp and to is its closing boundary. completedCandlesOnly reports that the returned candles were established as closed by the adapter. Your requested cutoff may be later than the last market session’s close.

Check market.data.requestedSymbol, resolvedSymbol, feed, adjustment and calendar. For example, a request for NASDAQ:AAPL can resolve to BATS:AAPL; that is not a consolidated Nasdaq feed. A different ticker is rejected. Coverage is checked against the provider-reported calendar, not independently exchange-certified or a redistribution license. Supply your own data when you need a particular licensed feed.