Fundamental
Authorization
Signed mode: every request is signed with your App Key/Secret. Header set:
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string · header | Required | The account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation. |
X-Api-Key | string · header | Required | Your App Key. |
X-Timestamp | string · header | Required | Request timestamp in seconds (Unix epoch). |
X-Api-Signature | string · header | Required | HMAC-SHA256 signature. Format: HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=. |
List macroeconomic indicators available through Longbridge, optionally filtered by country.
# List all indicators
longbridge macrodata
# Filter by US indicators
longbridge macrodata --country US
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
country | string | Optional | Filter by country. Omit for all countries. |
keyword | string | Optional | Fuzzy search by indicator name (case-insensitive) |
offset | integer | Optional | Pagination offset. Default: 0 |
limit | integer | Optional | Max records per page. Default: 100, max: 1000 |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
indicator | object | Required | Indicator detail |
indicator.indicator_id | integer | Optional | Indicator ID |
indicator.indicator_name | string | Optional | Indicator name |
indicator.unit | string | Optional | Value unit |
indicator.description | string | Optional | Indicator description |
indicator.market | string | Optional | Market / country code |
indicator.frequence | string | Optional | Release frequency, e.g. `day`, `month` |
indicator.importance | integer | Optional | Importance level (1 = Low, 2 = Medium, 3 = High) |
indicator.indicator_data | object[] | Optional | Time-series data points |
indicator.indicator_data[].actual_data | string | Optional | Actual value |
indicator.indicator_data[].previous_data | string | Optional | Previous value |
indicator.indicator_data[].estimated_data | string | Optional | Forecast value |
indicator.indicator_data[].published_time | string | Optional | Publish time (ISO 8601) |
indicator.indicator_data[].observation_date | string | Optional | Observation date (YYYY-MM-DD) |
total | integer | Optional | Total 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.