Skip to main content
GET
Get Historical Chart Data

Authorizations

Authorization
string
header
required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

FlowAuthorization Code
Authorization URL
https://app.aries.com/oauth2/authorize
Token URL
https://api.aries.com/v1/oauth2/token
Refresh URL
https://api.aries.com/v1/oauth2/token
FlowClient Credentials
Token URL
https://api.aries.com/v1/oauth2/token
Refresh URL
https://api.aries.com/v1/oauth2/token
Scopes1
market:information
Access live and historical market data

Query Parameters

symbol
string
required

Symbol to fetch bars for. Use the exact symbol returned by symbol search, such as AAPL for equities or the selected chart symbol for futures/options.

resolution
enum<string>
required

Candle size. Use minute values such as 1, 5, or 60 for intraday charts, D or 1D for daily charts, W or 1W for weekly charts, and M, 1M, 3M, 6M, or 12M for monthly views. How long each candle/bar on the chart should cover. Two families of values are supported:

Intraday (minute bars) — 1, 3, 5, 15, 30, 45, 60, 120, 180, 240 — the number is the bar's length in minutes (e.g. 5 = five-minute bars, 60 = hourly).

Daily and longer — D / 1D = daily, W / 1W = weekly, M / 1M = monthly, 3M / 6M / 12M = three-/six-/twelve-month bars.

For tick-based bars (bars that close every N trades instead of every N minutes), use Tick-Based Chart Data instead — tick resolutions are also accepted here; use tick-history for countback and cursor pagination.

Available options:
1,
3,
5,
15,
30,
45,
60,
120,
180,
240,
D,
W,
M,
1D,
1W,
1M,
3M,
6M,
12M,
1T,
5T,
10T,
25T,
50T,
100T,
250T,
500T,
1000T
Example:

"D"

from
integer<int64>
required

Start of the chart window as a Unix timestamp. Send seconds; millisecond timestamps are accepted and converted automatically. Negative timestamps are clamped to the Unix epoch.

to
integer<int64>
required

End of the chart window as a Unix timestamp. Must be greater than from. Send seconds; millisecond timestamps are accepted and converted automatically. A range entirely before the Unix epoch returns no_data.

firstDataRequest
string

TradingView compatibility flag. Omit or send a non-zero value for the first chart request; send 0 for follow-up history requests.

includeExtended
boolean
default:false

Set to true when the chart should include eligible pre-market and after-hours bars. Leave false for regular session charts.

Response

Historical bars in TradingView UDF format. Check s: ok = data in t, o, h, l, c, v; no_data = no bars; error = provider or processing error. Invalid query parameters or time ranges return HTTP 400.

Historical chart data returned as parallel arrays. Values at the same index belong to the same bar, so t[0], o[0], h[0], l[0], c[0], and v[0] describe one candle.

s
enum<string>
required

Response status. ok means chart arrays are usable; no_data means the symbol or range returned no bars; error means read errmsg.

Available options:
ok,
no_data,
error
c
number[]

Close price for each bar. Use the value at the same index as t for chart candles and performance calculations.

errmsg
string

Human-readable error message. Present only when s is error or no_data; show it when no chart can be rendered.

h
number[]

Highest traded price during each bar interval. Use it for candle wicks and intraperiod range.

l
number[]

Lowest traded price during each bar interval. Use it for candle wicks and intraperiod range.

nextTime
integer<int64>

Next available bar timestamp when the requested range has more data. Use it for pagination or loading older chart data.

nextTo
string

Opaque pagination cursor for the next chart request when provided.

o
number[]

Open price for each bar interval. Use the value at the same index as t for candle bodies.

t
integer<int64>[]

Bar timestamps in Unix seconds. Each timestamp index lines up with open, high, low, close, and volume arrays.

v
number[]

Trading volume for each bar interval. Use the value at the same index as t for volume charts.