基本面
鑑權
簽名方式:每個請求用 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 business-segments AAPL.US --history
longbridge business-segments AAPL.US --history --report qf
請求
查詢參數
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
symbol | string | 必填 | 證券代碼,例如 `AAPL.US` |
report | string | 可選 | 報告類型:`qf`(季報)/ `saf`(半年報)/ `af`(年報) |
cate | string | 可選 | 分部類別過濾 |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
historical | object[] | 可選 | 歷史報告期列表 |
└ total | string | 可選 | 當期總收入 |
└ currency | string | 可選 | 貨幣代碼 |
└ date | string | 可選 | 報告期,格式 YYYYMMDD,例如 `20260331` |
└ report | string | 可選 | 報告期代碼(如 `af` = 年報) |
└ report_txt | string | 可選 | 報告期標籤(如 `FY2024`、`Q1 2024`) |
└ fp_start | string | 可選 | 財政期開始日期,格式 `YYYY.MM.DD` |
└ fp_end | string | 可選 | 報告期結束時間戳 |
└ rpt_date | string | 可選 | 財報發布日期 |
└ business | object[] | 可選 | 業務分部列表 |
└ ∟ name | string | 可選 | 業務分部名稱 |
└ ∟ percent | string | 可選 | 收入佔比(百分比,例如 `40.80`) |
└ ∟ value | string | 可選 | 絕對收入數值 |
└ ∟ id | string | 可選 | 新創建提醒的 ID |
└ ∟ yoy | string | 可選 | 同比增長率 |
└ regionals | array | 可選 | 地區分部列表(當前通常為空數組) |
└ bus_ids | array | 可選 | 業務分部 ID 列表。 |
└ reg_ids | array | 可選 | 區域分部 ID 列表。 |
└ yoy | string | 可選 | 同比增長率 |
bus_ids | array | 可選 | 業務分部 ID 列表。 |
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"historical": [
{
"date": "20260331",
"total": "124300000000",
"currency": "USD",
"business": [
{
"name": "Americas",
"percent": "40.80",
"value": "31968000000"
},
{
"name": "Europe",
"percent": "23.64",
"value": "18521000000"
},
{
"name": "Greater China",
"percent": "20.72",
"value": "16233000000"
}
],
"regionals": []
}
]
}
}錯誤碼
參見錯誤碼文檔。