Fundamental

Macroeconomic Historical Data

GEThttps://openapi.longbridge.com/v2/quote/macrodata

Authorization

Signed mode: every request is signed with your App Key/Secret. Header set:

NameTypeRequiredDescription
Authorizationstring · headerRequiredThe account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation.
X-Api-Keystring · headerRequiredYour App Key.
X-Timestampstring · headerRequiredRequest timestamp in seconds (Unix epoch).
X-Api-Signaturestring · headerRequiredHMAC-SHA256 signature. Format: HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=.

Get historical releases for a specific macroeconomic indicator — actual values, forecasts, previous values, and next release dates.

>_ CLI
# Historical data for Non-Farm Payroll
longbridge macrodata 61744
# Date range filter
longbridge macrodata 61744 --start 2024-01-01 --end 2024-12-31

Request

Query parameters

NameTypeRequiredDescription
indicator_codestringRequiredIndicator code from `macroeconomic_indicators`
start_datestringOptionalStart date in `YYYY-MM-DD` format
end_datestringOptionalEnd date in `YYYY-MM-DD` format
offsetintegerOptionalPagination offset. Default: 0
limitintegerOptionalMax records. Default: 100, max: 100

Response

Response properties

NameTypeRequiredDescription
infoMacroeconomicIndicatorRequiredIndicator metadata
dataMacroeconomic[]RequiredHistorical data points
countintRequiredTotal number of data points
periodstringRequiredStatistical period (e.g. `2024-12-01`, `2024-Q4`)
release_atintOptionalUnix timestamp of release datetime
actual_valuestringRequiredActual released value
previous_valuestringRequiredPrevious period value
forecast_valuestringRequiredMarket consensus forecast

Response JSON example

{
  "count": 24,
  "info": {
    "indicator_code": "61744",
    "country": "US",
    "name": "Non-Farm Payroll",
    "periodicity": "Monthly",
    "describe": "...",
    "importance": 3
  },
  "data": [
    {
      "period": "2024-12-01",
      "release_at": 1735900200,
      "actual_value": "256000",
      "previous_value": "212000",
      "forecast_value": "165000"
    }
  ]
}

Error code

See the Error Codes page for the full list of error codes.