GET api/Candles?start={start}&end={end}&symbolId={symbolId}&period={period}

Gets complete candles for the given time span and the given market. Candles may not be recorded for all periods of time, so the returned candles may not be contiguous. Requests that would result in excessively large data sets will be rejected with a status code of 400. Return data is ordered from oldest to newest.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
start

The inclusive start of the time period for which candles should be returned (in UTC)

date

Required

end

The inclusive end of the time period for which candles should be returned (in UTC). If omitted, the returned candles with cover the time period up until now. Note, if a candle starts before "end" it will be returned, even if it finishes after "end".

date

Required

symbolId

The symbol for which candles should be returned

integer

Required

period

The period of time (in minutes) that each returned candle should represent

integer

Required

Body Parameters

None

Response Information

Resource Description

CandleResponse
NameDescriptionTypeAdditional information
Content

A collection of candles sorted by start time ascending

Collection of Candle

None

Response Formats

application/json, text/json

Sample:
{
  "Content": [
    {
      "Time": "2000-01-01T00:00:00",
      "Key": "123",
      "Open": 100.0,
      "Close": 200.0,
      "High": 250.0,
      "Low": 50.0
    },
    {
      "Time": "2000-01-01T00:01:00",
      "Key": "123",
      "Open": 100.0,
      "Close": 200.0,
      "High": 250.0,
      "Low": 50.0
    }
  ]
}