市場
鑑權
簽名方式:每個請求用 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=。 |
根據排行榜標籤 key 獲取股票排行。key 來自 rank_categories 的 second_tags[].key,例如 hot_all-us(美股總熱度)。
請求
查詢參數
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
key | string | 必填 | 排行榜標籤鍵值,來自 `rank_categories` 的 `second_tags[].key` |
need_article | boolean | 可選 | 是否返回關聯文章,默認 `false` |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
bmp | boolean | 可選 | 是否為盤前預覽數據 |
lists | object[] | 可選 | 排行榜股票列表 |
└ code | string | 可選 | 股票代碼(如 `MU`) |
└ symbol | string | 可選 | 標的代碼,格式為 `代碼。市場`(如 `MU.US`) |
└ name | string | 可選 | 證券名稱 |
└ last_done | string | 可選 | 最新成交價 |
└ chg | string | 可選 | 漲跌幅(小數比率,如 `0.0252` 表示 2.52%) |
└ change | string | 可選 | 價格漲跌額(如 `17.200`) |
└ inflow | string | 可選 | 淨流入資金(單位:所屬市場貨幣) |
└ market_cap | string | 可選 | 市值 |
└ industry | string | 可選 | 行業分類 |
└ pre_post_price | string | 可選 | 盤前/盤後價格 |
└ pre_post_chg | string | 可選 | 盤前/盤後漲跌幅(小數比率) |
└ amplitude | string | 可選 | 振幅(小數比率) |
└ five_day_chg | string | 可選 | 5 日漲跌幅(小數比率) |
└ turnover_rate | string | 可選 | 換手率(小數比率) |
└ volume_rate | string | 可選 | 量比 |
└ pb_ttm | string | 可選 | 市淨率(TTM) |
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"bmp": false,
"lists": [
{
"code": "MU",
"symbol": "MU.US",
"name": "Micron Technology",
"last_done": "698.740",
"chg": "0.0252",
"change": "17.200",
"inflow": "-347041642",
"market_cap": "787992890796",
"industry": "Semiconductor Manufacturers",
"pre_post_price": "726.600",
"pre_post_chg": "0.0399",
"amplitude": "0.1082",
"five_day_chg": "-0.0885",
"turnover_rate": "0.0550",
"volume_rate": "1.11",
"pb_ttm": "32.68"
}
]
}
}錯誤碼
參見錯誤碼文檔。