基本面
鑑權
簽名方式:每個請求用 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=。 |
獲取機構共識預測,包括營收、EPS 和淨利潤預測。
請求
查詢參數
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
symbol | string | 必填 | 證券代碼,例如 `TSLA.US` |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
list | object[] | 可選 | 共識預測期列表, |
└ fiscal_year | integer | 可選 | 財年 |
└ fiscal_period | string | 可選 | 財年內的財季序號 |
└ period_text | string | 可選 | 展示用週期標籤(如 Q1 2027) |
└ details | object[] | 可選 | 財務指標詳情列表 |
└ ∟ key | string | 可選 | 指標鍵(如 `eps`、`revenue`) |
└ ∟ name | string | 可選 | 標的名稱。 |
└ ∟ description | string | 可選 | 完整描述 |
└ ∟ estimate | string | 可選 | 一致預期值 |
└ ∟ is_released | boolean | 可選 | 實際值是否已公佈 |
└ ∟ actual | string | 可選 | 實際披露值 |
└ ∟ comp_value | string | 可選 | 對比百分比值 |
└ ∟ comp_desc | string | 可選 | 對比描述 |
└ ∟ comp | string | 可選 | 對比結果(如 `beat`、`miss`) |
current_index | integer | 可選 | 當前週期在 opt_periods 中的索引 |
currency | string | 可選 | 報告貨幣 |
opt_periods | array | 可選 | 可選週期選項 |
current_period | string | 可選 | 當前週期代碼(如 `qf`) |
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"currency": "USD",
"current_index": 3,
"current_period": "qf",
"opt_periods": [
"qf",
"af",
"saf"
],
"list": [
{
"fiscal_year": 2026,
"fiscal_period": "Q2 FY2026",
"period_text": "Q2 FY2026",
"details": [
{
"key": "revenue",
"name": "Revenue",
"estimate": "95000000000",
"actual": "",
"comp": "",
"comp_value": null,
"comp_desc": "",
"description": "",
"is_released": false
}
]
}
]
}
}錯誤碼
參見錯誤碼文檔。