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=. |
Get historical releases for a specific macroeconomic indicator — actual values, forecasts, previous values, and next release dates.
# 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
| Name | Type | Required | Description |
|---|---|---|---|
indicator_code | string | Required | Indicator code from `macroeconomic_indicators` |
start_date | string | Optional | Start date in `YYYY-MM-DD` format |
end_date | string | Optional | End date in `YYYY-MM-DD` format |
offset | integer | Optional | Pagination offset. Default: 0 |
limit | integer | Optional | Max records. Default: 100, max: 100 |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
info | MacroeconomicIndicator | Required | Indicator metadata |
data | Macroeconomic[] | Required | Historical data points |
count | int | Required | Total number of data points |
period | string | Required | Statistical period (e.g. `2024-12-01`, `2024-Q4`) |
release_at | int | Optional | Unix timestamp of release datetime |
actual_value | string | Required | Actual released value |
previous_value | string | Required | Previous period value |
forecast_value | string | Required | Market 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.