Bars
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 (ISO Format, ex: '2019-04-15T09:30:00-04:00')
Filter bars equal to or after this time.
Cannot be used with
after.end
timestamp (ISO Format, ex: '2019-04-15T09:30:00-04:00')
Filter bars equal to or before this time.
Cannot be used with
until.after
timestamp (ISO Format, ex: '2019-04-15T09:30:00-04:00')
Filter bars after this time.
Cannot be used with
start.until
timestamp (ISO Format, ex: '2019-04-15T09:30:00-04:00')
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 beginning 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