基本面
鑑權
簽名方式:每個請求用 App Key / Secret 簽名。請求頭如下:
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
Authorization | string · header | 必填 | OpenAPI 後台 上的賬戶 Access Token,作為原始 token 傳入(不帶 Bearer 前綴),並參與簽名計算。 |
X-Api-Key | string · header | 必填 | 你的 App Key。 |
X-Timestamp | string · header | 必填 | 請求時間戳,單位秒(Unix 時間)。 |
X-Api-Signature | string · header | 必填 | HMAC-SHA256 簽名。格式:HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=。 |
獲取指定宏觀經濟指標的歷史發布數據,包括實際值、預測值、前值和下次發布時間。
# Historical data for Non-Farm Payroll
longbridge macrodata 61744
# Date range filter
longbridge macrodata 61744 --start 2024-01-01 --end 2024-12-31
請求
查詢參數
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
indicator_code | string | 必填 | 來自 `macroeconomic_indicators` 的指標代碼 |
start_date | string | 可選 | 開始日期,`YYYY-MM-DD` 格式 |
end_date | string | 可選 | 結束日期,`YYYY-MM-DD` 格式 |
offset | integer | 可選 | 分頁偏移量。默認:0 |
limit | integer | 可選 | 最大記錄數。默認:100,最大:100 |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
info | MacroeconomicIndicator | 必填 | 指標元數據 |
data | Macroeconomic[] | 必填 | 歷史數據點 |
count | int | 必填 | 數據點總數 |
period | string | 必填 | 統計週期(如 `2024-12-01`、`2024-Q4`) |
release_at | int | 可選 | 發佈時間的 Unix 時間戳 |
actual_value | string | 必填 | 實際公佈值 |
previous_value | string | 必填 | 上一週期值 |
forecast_value | string | 必填 | 市場一致預期 |
響應 JSON 示例
{
"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"
}
]
}錯誤碼
參見錯誤碼文檔。