基本面
鑑權
簽名方式:每個請求用 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` |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
overview | object | 必填 | 當前估值概覽 |
overview.metrics | object | 可選 | 按指標(pe/pb/ps)分組的指標映射 |
overview.metrics.pe | object | 可選 | 所請求指標的數據塊 |
overview.metrics.pe.metric | string | 可選 | 當前值,如 14.85x |
overview.metrics.pe.industry_median | string | 可選 | 行業中位數 |
overview.metrics.pe.desc | string | 可選 | 可讀描述 |
overview.indicator | string | 可選 | 請求的指標鍵 |
overview.range | integer | 可選 | 回溯年數 |
overview.date | string | 可選 | 數據日期 |
overview.ccy_symbol | string | 可選 | 貨幣符號 |
history | object | 必填 | 歷史時間序列 |
history.metrics.pe | object | 可選 | 該指標的歷史數據塊 |
history.metrics.pe.low | string | 可選 | 歷史低值 |
history.metrics.pe.median | string | 可選 | 歷史中位數 |
history.metrics.pe.high | string | 可選 | 歷史高值 |
history.metrics.pe.list | object[] | 可選 | 歷史數據點列表 |
history.metrics.pe.list[].timestamp | string | 可選 | Unix 秒(字串) |
history.metrics.pe.list[].value | string | 可選 | 該點數值 |
peers | object | 可選 | 行業可比公司 |
peers.pe.industry_median | string | 可選 | 同業中位數 |
peers.pe.list | object[] | 可選 | 同業公司列表 |
peers.pe.list[].symbol | string | 可選 | 標的代碼,如 9626.HK |
peers.pe.list[].name | string | 可選 | 標的名稱 |
peers.pe.list[].value | string | 可選 | 指標值 |
layouts | object | 可選 | 用於繪圖的分佈分組 |
symbols | object | 可選 | 以 symbol 為鍵的映射 -> { name, market_cap } |
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"history": {
"metrics": {
"pe": {
"desc": "P/E Ratio",
"high": "35.2",
"low": "18.1",
"median": "26.5",
"list": [
{
"timestamp": "1622520000",
"value": "28.5"
}
]
},
"pb": null,
"ps": null
}
}
}
}錯誤碼
參見錯誤碼文檔。