Fundamental

Macroeconomic Indicators

GEThttps://openapi.longbridge.com/v2/quote/macrodata/{indicator_id}

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=.

List macroeconomic indicators available through Longbridge, optionally filtered by country.

>_ CLI
# List all indicators
longbridge macrodata
# Filter by US indicators
longbridge macrodata --country US

Request

Query parameters

NameTypeRequiredDescription
countrystringOptionalFilter by country. Omit for all countries.
keywordstringOptionalFuzzy search by indicator name (case-insensitive)
offsetintegerOptionalPagination offset. Default: 0
limitintegerOptionalMax records per page. Default: 100, max: 1000

Response

Response properties

NameTypeRequiredDescription
indicatorobjectRequiredIndicator detail
indicator.indicator_idintegerOptionalIndicator ID
indicator.indicator_namestringOptionalIndicator name
indicator.unitstringOptionalValue unit
indicator.descriptionstringOptionalIndicator description
indicator.marketstringOptionalMarket / country code
indicator.frequencestringOptionalRelease frequency, e.g. `day`, `month`
indicator.importanceintegerOptionalImportance level (1 = Low, 2 = Medium, 3 = High)
indicator.indicator_dataobject[]OptionalTime-series data points
indicator.indicator_data[].actual_datastringOptionalActual value
indicator.indicator_data[].previous_datastringOptionalPrevious value
indicator.indicator_data[].estimated_datastringOptionalForecast value
indicator.indicator_data[].published_timestringOptionalPublish time (ISO 8601)
indicator.indicator_data[].observation_datestringOptionalObservation date (YYYY-MM-DD)
totalintegerOptionalTotal number of matching indicators

Response JSON example

{
  "count": 619,
  "list": [
    {
      "indicator_code": "61744",
      "country": "US",
      "name": "Non-Farm Payroll",
      "periodicity": "Monthly",
      "describe": "Employment situation report...",
      "importance": 3
    }
  ]
}

Error code

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