基本面
鑑權
簽名方式:每個請求用 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 香港 / 新加坡賬戶
此方法僅支援 Longbridge 香港 / 新加坡賬戶,可查詢任意標的,包括美股。
按財報期獲取經營數據及核心財務指標摘要。
請求
查詢參數
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
symbol | string | 必填 | 證券代碼,例如 `AAPL.US` |
period | string | 可選 | 財報期篩選,如 `q1`、`q2`、`q3`、`q4`、`annual` |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
list | object[] | 可選 | 經營數據報告列表, |
└ id | string | 可選 | 內部報告 ID |
└ report | string | 可選 | 報告期代碼(如 `af` = 年報) |
└ title | string | 可選 | 報告標題 |
└ txt | string | 可選 | 管理層討論文本 |
└ latest | boolean | 可選 | 是否為最新報告 |
└ web_url | string | 可選 | 完整報告頁面連結 |
└ keywords | array | 可選 | 關鍵詞。 |
└ financial | object | 可選 | 關鍵財務指標 |
└ ∟ symbol | string | 可選 | 證券代碼 |
└ ∟ name | string | 可選 | 標的名稱。 |
└ ∟ region | string | 可選 | 市場地區 |
└ ∟ code | string | 可選 | 股票代碼 |
└ ∟ currency | string | 可選 | 報告貨幣 |
└ ∟ report | string | 可選 | 報告期代碼(如 `af` = 年報) |
└ ∟ report_txt | string | 可選 | 報告期標籤(如 `FY2024`、`Q1 2024`) |
└ ∟ indicators | object[] | 可選 | 財務指標列表, |
└ ∟ ∟ field_name | string | 可選 | 欄位名稱(如 `operating_revenue`) |
└ ∟ ∟ indicator_name | string | 可選 | 顯示名稱 |
└ ∟ ∟ indicator_value | string | 可選 | 格式化數值 |
└ ∟ ∟ yoy | string | 可選 | 同比變化率 |
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"list": [
{
"id": "12345",
"report": "af",
"title": "FY2025 Annual Report Summary",
"txt": "Management discussion...",
"latest": true,
"web_url": "https://longbridge.com/wiki/...",
"financial": {
"code": "700",
"currency": "HKD",
"name": "Tencent",
"region": "HK",
"report": "af",
"indicators": [
{
"field_name": "operating_revenue",
"indicator_name": "Revenue",
"indicator_value": "678.6B",
"yoy": "0.0800"
}
]
}
}
]
}
}錯誤碼
參見錯誤碼文檔。