基本面
鑑權
簽名方式:每個請求用 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 | 必填 | 證券代碼,例如 `TSLA.US` |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
evaluate | object | 可選 | 評級分佈歷史 |
└ list | object[] | 可選 | 每日持倉歷史紀錄, |
└ ∟ strong_buy | integer | 可選 | 強烈買入評級數量 |
└ ∟ buy | integer | 可選 | 買入評級數量 |
└ ∟ hold | integer | 可選 | 持有評級數量 |
└ ∟ sell | integer | 可選 | 賣出評級數量 |
└ ∟ under | integer | 可選 | 跑輸市場評級數量 |
└ ∟ date | string | 可選 | 日期 |
target | object | 可選 | 目標價歷史 |
└ updated_at | string | 可選 | 最近更新時間,Unix 時間戳(秒) |
└ prediction_accuracy | string | 可選 | 預測準確率。 |
└ list | object[] | 可選 | 每日持倉歷史紀錄, |
└ ∟ timestamp | string | 可選 | Unix 時間戳 |
└ ∟ price | string | 可選 | 當日收盤價 |
└ ∟ meet | boolean | 可選 | 價格是否達到目標 |
└ ∟ avg_target | string | 可選 | 平均目標價 |
└ ∟ min_target | string | 可選 | 最低目標價 |
└ ∟ max_target | string | 可選 | 最高目標價 |
└ ∟ date | string | 可選 | 日期 |
└ data_percent | string | 可選 | 數據完整度百分比。 |
ccy_symbol | string | 可選 | 貨幣符號 |
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"ccy_symbol": "$",
"evaluate": {
"list": [
{
"date": "2021/05/14",
"buy": 3,
"hold": 11,
"sell": 2,
"strong_buy": 9,
"under": 6
}
]
},
"target": {
"list": [
{
"broker_name": "Goldman Sachs",
"date": "2026-04-30",
"rating": "Buy",
"target_price": "250.00"
}
]
}
}
}錯誤碼
參見錯誤碼文檔。