Bars API

The bars API provides time-aggregated price and volume data.

[GET] Get a list of bars

GET/v1/bars/{timeframe}

Retrieves a list of bars for each requested symbol. It is guaranteed all bars are in ascending order by time.

Currently, no “incomplete” bars are returned. For example, a 1 minute bar for 09:30 will not be returned until 09:31.

Parameters

Path Parameters

timeframe
string
One of minute, 1Min, 5Min, 15Min, day or 1D. minute is an alias of 1Min. Similarly, day is of 1D.

Query Parameters

symbols
stringRequired
One or more (max 200) symbol names split by commas (“,”).
limit
integer
The maximum number of bars to be returned for each symbol. It can be between 1 and 1000. Default is 100 if parameter is unspecified or 0.
start
timestamp
Filter bars equal to or after this time. Cannot be used with after.
end
timestamp
Filter bars equal to or before this time. Cannot be used with until.
after
timestamp
Filter bars after this time. Cannot be used with start.
until
timestamp
Filter bars before this time. Cannot be used with end.

Response

An object with a key for each symbol and the Bars object as the values.

Note that it returns status 200 with an empty object if no requested symbol is found.

Errors

422 Unprocessable
The parameters are not well formed.

Bars Entity

Example

{
  "AAPL": [
    {
      "t": 1544129220,
      "o": 172.26,
      "h": 172.3,
      "l": 172.16,
      "c": 172.18,
      "v": 3892,
    }
  ]
}

Properties

t
int
the beginnig time of this bar as a Unix epoch in seconds
o
number
open price
h
number
high price
l
number
low price
c
number
close price
v
number
volume