Historical bars

The historical bars API provides aggregates for a list of symbols between the specified times.

Bars are not adjusted after splits or dividends. Symbol mapping is also not supported: in case of a name change the symbol active at the time must be used. Bars may include prints that were later corrected or cancelled. Corrections and cancel/error events are not applied.

Daily, weekly and monthly bars start at midnight in the market's time zone. Weekly bars start on the market's first trading day of the week.

The bars of each symbol are sorted by timestamp. The order of symbols is not guaranteed. Continue with next_page_token.

Path Params
string
enum
required

The source feed of the data. All feeds require a subscription.

  • euroctp: EuroCTP, the official EU consolidated tape, covering trades from all EU trading venues
  • xetr: Xetra, the electronic trading venue of the Frankfurt Stock Exchange (Deutsche Börse)
  • xhkg: Hong Kong Stock Exchange (HKEX)
  • xlon: London Stock Exchange (LSE)
  • xsau: Saudi Exchange (Tadawul)
Allowed:
Query Params
string
required

A comma-separated list of symbols with a limit of 1000.
Each symbol must be in TICKER:MIC format, where MIC is the ISO 10383 defined code of the symbol's primary market.
The market must be one the feed covers, e.g. XETR on xetr; euroctp accepts any market.

string
required

The timeframe represented by each bar in aggregation.
You can use any of the following values:

  • [1-59]Min or [1-59]T, e.g. 5Min or 5T creates 5-minute aggregations
  • [1-23]Hour or [1-23]H, e.g. 12Hour or 12H creates 12-hour aggregations
  • 1Day or 1D creates 1-day aggregations
  • 1Week or 1W creates 1-week aggregations
  • [1,2,3,4,6,12]Month or [1,2,3,4,6,12]M, e.g. 3Month or 3M creates 3-month aggregations
required

The inclusive start of the interval. Format: RFC-3339 or YYYY-MM-DD.
A date means the start of that day in the market's time zone.

The inclusive end of the interval. A data point is returned when start <= t <= end. Format: RFC-3339 or YYYY-MM-DD.
A date means the end of that day in the market's time zone.
Defaults to the current time if not specified.

string
enum
Defaults to asc

Sort the data points of each symbol by timestamp in ascending or descending order.

Allowed:
integer
1 to 10000
Defaults to 1000

The maximum number of data points to return in the response page.
The page_size applies to the total number of data points across all symbols, not per symbol.
The API may return fewer, even if more data points exist in the requested interval.
Always check next_page_token for more pages.

string

The pagination token from which to continue. The value to pass here is returned in specific requests when more data is available, usually because of a response result limit.

Responses

401

Authentication headers are missing or invalid. Make sure you authenticate your request with a valid API key.

403

The requested resource is forbidden, for example because the subscription does not cover the requested data.

404

The requested resource was not found, for example because the requested feed does not exist.

500

Internal server error. We recommend retrying these later. If the issue persists, please contact us on Slack or on the Community Forum.

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*