基本面
鑑權
簽名方式:每個請求用 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=。 |
列出 Longbridge 支持的宏觀經濟指標,可按國家/地區篩選。
# List all indicators
longbridge macrodata
# Filter by US indicators
longbridge macrodata --country US
請求
查詢參數
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
country | string | 可選 | 按國家篩選。省略則返回所有國家。 |
keyword | string | 可選 | 按指標名稱模糊搜索(不區分大小寫) |
offset | integer | 可選 | 分頁偏移量。默認:0 |
limit | integer | 可選 | 每頁最大記錄數。默認:100,最大:1000 |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
indicator | object | 必填 | 指標詳情 |
indicator.indicator_id | integer | 可選 | 指標 ID |
indicator.indicator_name | string | 可選 | 指標名稱 |
indicator.unit | string | 可選 | 數值單位 |
indicator.description | string | 可選 | 指標描述 |
indicator.market | string | 可選 | 市場/國家代碼 |
indicator.frequence | string | 可選 | 發佈頻率,如 `day`、`month` |
indicator.importance | integer | 可選 | 重要程度(1=低,2=中,3=高) |
indicator.indicator_data | object[] | 可選 | 時間序列數據點 |
indicator.indicator_data[].actual_data | string | 可選 | 實際值 |
indicator.indicator_data[].previous_data | string | 可選 | 前值 |
indicator.indicator_data[].estimated_data | string | 可選 | 預期值 |
indicator.indicator_data[].published_time | string | 可選 | 發佈時間(ISO 8601) |
indicator.indicator_data[].observation_date | string | 可選 | 觀測日期(YYYY-MM-DD) |
total | integer | 可選 | 匹配的指標總數 |
響應 JSON 示例
{
"count": 619,
"list": [
{
"indicator_code": "61744",
"country": "US",
"name": "Non-Farm Payroll",
"periodicity": "Monthly",
"describe": "Employment situation report...",
"importance": 3
}
]
}錯誤碼
參見錯誤碼文檔。