Historical Economic Indicator Data

Retrieve historical time-series data for economic indicators such as unemployment rates, inflation metrics, GDP growth, and other macro variables. Analyze long-term economic trends and correlations with market performance.

Use Case: Chart historical CPI data over 10 years to visualize inflation trends and correlate with stock market returns.

GET /v1/calendars/historical/{symbol}

Get Historical Economic Data

cURL

curl --request GET \
  --url https://api.aries.com/v1/calendars/historical/{symbol} \
  --header 'Authorization: Bearer <token>'

200

Example

[
  {
    "category": "Employment",
    "country": "US",
    "dateTime": "2026-01-15T08:30:00Z",
    "frequency": "monthly",
    "historicalDataSymbol": "USURTOT",
    "lastUpdate": "2026-01-15T08:30:00Z",
    "value": 3.7
  }
]

Authorizations

Authorization · string · header · required

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

Path Parameters

symbol · string · required

Economic indicator code from the upstream calendar provider. These codes are not a fixed enum on our side — fetch GET /v1/calendars/economics to see the codes attached to recent calendar entries, then use that code here for the historical series. Common examples:

• USURTOT — United States Unemployment Rate (total).
• UNITEDSTACONJOBCLA — U.S. Continuing Jobless Claims.
• UNITEDSTACONCRE — U.S. Consumer Credit.

Example:

"USURTOT"

Response

200

application/json

Economic indicator historical data retrieved successfully

category · string

Category label for the economic event/indicator (e.g. GDP, Inflation, Employment). Format depends on the upstream data source.

country · string

Country code or name

dateTime · string

Date and time of the data point

frequency · string

Data frequency (e.g., monthly, quarterly, yearly)

historicalDataSymbol · string

Symbol identifier for the historical data

lastUpdate · string

Last update timestamp

value · number

Indicator value

Example:

[
  {
    "category": "Employment",
    "country": "US",
    "dateTime": "2026-01-15T08:30:00Z",
    "frequency": "monthly",
    "historicalDataSymbol": "USURTOT",
    "lastUpdate": "2026-01-15T08:30:00Z",
    "value": 3.7
  }
]