基本面
鑑權
簽名方式:每個請求用 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=。 |
獲取任意上市公司的利潤表、資產負債表和現金流量表。
請求
查詢參數
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
symbol | string | 必填 | 證券代碼,例如 `AAPL.US` |
kind | string | 必填 | 報表類型:`IncomeStatement`(利潤表)、`BalanceSheet`(資產負債表)、`CashFlow`(現金流量表)、`All`(全部) |
period | string | 必填 | 報告期:`Annual`(年報)、`SemiAnnual`(中報)、`Q1`/`Q2`/`Q3`/`ThreeQ`(季報)、`QuarterlyFull`(累計季報) |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
list | object | 必填 | 按報表類型分組的數據(key 為報表類型代碼,如 `IS`、`BS`、`CF`) |
title | string | 可選 | 指標標題 |
short_title | string | 可選 | 短標題 |
currency | string | 可選 | 貨幣 |
has_yoy | boolean | 可選 | 是否有同比數據 |
entry | string | 可選 | 條目標識符 |
periods | string[] | 可選 | 可用報告期列表 |
accounts | object[] | 可選 | 財務科目列表, |
field | string | 必填 | 字段標識符 |
percent | boolean | 可選 | 是否為百分比值 |
tip | string | 可選 | 提示說明 |
values | object[] | 可選 | 按報告期的歷史數值, |
period | string | 必填 | 報告期標簽(如 `FY 2024`) |
year | integer | 可選 | 財政年度 |
fp_end | string | 可選 | 報告期結束時間戳 |
value | string | 可選 | 報告值 |
ratio | string | 可選 | 比率值 |
yoy | string | 可選 | 同比增長率 |
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"list": {
"IS": {
"indicators": [
{
"title": "Income Statement",
"short_title": "IS",
"currency": "USD",
"has_yoy": true,
"entry": "IS",
"periods": [
"FY2025",
"FY2024"
],
"accounts": [
{
"field": "EPS",
"name": "Earnings Per Share(USD)",
"percent": false,
"tip": "",
"values": [
{
"period": "FY 2025",
"year": 2025,
"fp_end": "1758945600",
"value": "7.46",
"ratio": "",
"yoy": "0.227"
}
]
}
]
}
]
}
}
}
}錯誤碼
參見錯誤碼文檔。