基本面
鑑權
簽名方式:每個請求用 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=。 |
獲取行業分組的層級子板塊樹,含各節點股票數量、日漲跌幅和年初至今漲跌幅。Counter ID 可從 industry_rank 返回結果中獲取。
請求
查詢參數
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
symbol | string | 必填 | 行業標識,如 `IN20245.HK`。 |
market | string | 必填 | 市場代碼:`US` / `HK` / `CN` / `SG` |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
top | object | 可選 | 頂層行業資訊, |
chain | object | 可選 | 行業層級樹根節點, |
market | string | 可選 | 市場代碼 |
symbol | string | 可選 | 板塊標識(根節點上有值,子節點為空字符串)。 |
stock_num | integer | 可選 | 板塊內股票數量 |
chg | string | 可選 | 當日漲跌幅(小數,可能為空字串) |
ytd_chg | string | 可選 | 年初至今漲跌幅(小數,可能為空字串) |
next | object[] | 可選 | 子板塊列表,結構與當前節點相同(遞迴) |
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"top": {
"name": "All Industries",
"market": "US"
},
"chain": {
"name": "Technology",
"symbol": "IN00258.US",
"stock_num": 542,
"chg": "0.0231",
"ytd_chg": "0.0875",
"next": [
{
"name": "Online Consumer Electronics Retail",
"symbol": "",
"stock_num": 4,
"chg": "0.0268",
"ytd_chg": "-0.1869",
"next": []
}
]
}
}
}錯誤碼
參見錯誤碼文檔。