Aggregate Bars

Get aggregate bars for a stock over a time range with customizable time spans (second, minute, hour, day, week, month, quarter, year). Returns OHLCV data with volume-weighted average price.

Use Case: Build candlestick charts and technical analysis tools with historical price data at any time interval.

GET /v1/stocks/aggs

Get Aggregate Bars

cURL

curl --request GET \
  --url https://api.aries.com/v1/stocks/aggs \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "adjusted": true,
  "queryCount": 21,
  "requestId": "633a048bfb27b7a72181b65f0bb88cb0",
  "results": [
    {
      "c": 185.64,
      "h": 188.44,
      "l": 183.885,
      "n": 1008871,
      "o": 187.15,
      "t": 1704171600000,
      "v": 81964874,
      "vw": 185.9465
    },
    {
      "c": 184.4,
      "h": 187.095,
      "l": 184.35,
      "n": 679844,
      "o": 187.04,
      "t": 1706677200000,
      "v": 55467803,
      "vw": 185.3525
    }
  ],
  "resultsCount": 21,
  "status": "OK",
  "ticker": "AAPL"
}

Authorizations

Authorization · string · header · required

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

Query Parameters

ticker · string · required

Stock ticker symbol, such as AAPL. Use the exact ticker for the company you want to research.

Example:

"AAPL"

multiplier · integer · required

Size of each aggregate time window. Enter 1 or greater, such as 1 day or 5 minutes depending on timespan.

Required range: x >= 1

Example:

1

timespan · enum<string> · required

Time span unit for each aggregate bar, such as minute, hour, day, week, month, quarter, or year when supported.

Available options: second, minute, hour, day, week, month, quarter, year

Example:

"day"

from · string · required

Start date in YYYY-MM-DD format. Enter the first date to include in the research window. or timestamp

Example:

"2024-01-01"

to · string · required

End date in YYYY-MM-DD format. Enter the last date to include in the research window. or timestamp

Example:

"2024-01-31"

adjusted · boolean

Whether to adjust historical prices for stock splits. Use true for normalized charting and false for raw market data.

Example:

true

sort · enum<string>

Sort direction for aggregate bars. Use asc for oldest first or desc for newest first.

Available options: asc, desc

limit · integer

Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits.

Required range: 1 <= x <= 50000

Example:

1000

next · string

Pagination cursor from the previous response. Omit it on the first request, then send the returned cursor to fetch the next page.

Response

200

application/json

Successful response

adjusted · boolean

Whether or not the results are adjusted for splits

queryCount · integer

Number of results returned

requestId · string

Unique request ID

results · object[]

Array of aggregate bars

Show child attributes

resultsCount · integer

Total number of results

status · string

Status string from the upstream data provider — typically OK for a successful response. Treat any other value as an error indicator alongside the HTTP status code.

ticker · string

Stock ticker symbol, such as AAPL. Use the exact ticker for the company you want to research.

nextUrl · string

URL for next page of results