A股\美股\港股 WebSocket實時行情接口接入
Websocket行情接入
請按照下面的步驟完成滬深、港股或美股的行情接入。
原文地址:https://jvquant.com/wiki.html#websocket-
分配服務器
為實現更好的用戶體驗,系統將自動為您分配合適的服務器。
注意:每次分配的服務器地址會發生變化,連接服務前,請務必調用該接口獲取最新的服務器地址。
分配滬深行情服務器:
分配港股行情服務器:
分配美股行情服務器:
接口參數:
| # | 參數名 | 類型 | 描述 |
|---|---|---|---|
| 1 | market | string | 市場標志,滬深:ab;港股:hk;美股:us |
| 2 | type | string | 接口類別,行情類別為websocket |
| 3 | token | string | jvQuant token |
接口返回:
| # | 參數名 | 類型 | 描述 |
|---|---|---|---|
| 1 | code | string | 請求狀態碼 |
| 2 | server | string | 分配服務器地址及端口號 |
返回示例:
code規范
滬深行情支持共7000只滬深主板、科創板、創業板,股票以及可轉債、ETF基金行情,提供level1和level2逐筆成交數據推送。
港股行情支持共5000只香港主板、渦輪牛熊、ETF基金行情,提供level1十檔行情和level2逐筆數據推送。
美股行情支持紐約交易所、納斯達克交易所、美國交易所共12000只產品行情和超6000只ETF基金行情,提供level1快照行情和level2逐筆數據推送。
訂閱代碼由行情標志和證券代碼組成,用分隔符"_"連接。
如:
lv1_600519,代表貴州茅臺level1行情
lv1_512170,代表醫療ETF level1行情
lv2_127063,代表貴輪轉債level2行情
lv1_00700,代表港股騰訊控股level1行情
lv2_00700,代表港股騰訊控股level2行情
lv1_aapl,代表美股蘋果公司快照行情
lv2_aapl,代表美股蘋果公司逐筆成交行情
| # | 行情標志 | 類型 | 描述 |
|---|---|---|---|
| 1 | lv1 | string | level1行情 |
| 2 | lv2 | string | level2行情 |
連接登錄
獲取分配的服務器地址后,通過websokcet協議連接服務器。
連接Websocket行情服務器:
訂閱行情
連接至websocket行情服務器,輸入以下指令進行行情訂閱:
| # | 指令 | 參數 | 描述 |
|---|---|---|---|
| 1 | add | string | 增加訂閱code |
| 2 | del | string | 刪除訂閱code |
| 3 | all | string | 覆蓋全部code |
| 4 | list | string | 查看全部訂閱code |
| 5 | his | string | (history)查看今日已訂閱的code匯總信息 |
指令后接code參數,用分隔符"="連接,多個code用分隔符","分隔。
例:
add=lv1_600519,lv2_127063 ,表示增加訂閱lv1_600519,lv2_127063行情。
del=lv1_600519,lv2_127063 ,表示刪除訂閱lv1_600519,lv2_127063行情。
all=lv1_600519 ,表示覆蓋全部訂閱code。
all= ,后接參數為空,表示刪除全部訂閱code。
list ,無需參數,表示查看全部訂閱code。
his ,無需參數,查看今日已訂閱的code信息。
*美股、港股行情操作指令同上
解析行情
為提高數據傳輸速率,行情推送采用順序編碼和二進制方式傳輸,請在接收端解壓縮為字符串并解析。
level1(行情快照)
level1行情推送數據以換行符"\n"為分隔,每一行以lv1_xxxxxx=為開頭,代表該類別code對應的行情,數據字段以","為分隔符。
滬深level1推送數據包格式如下:
lv1_證券代碼1=推送時間 ,證券名稱,最新價格,漲幅,成交額,成交量,買五檔[掛單數量,掛單價格],賣五檔[掛單數量,掛單價格]...lv1_證券代碼2=推送時間,證券名稱,最新價格,漲幅,成交額,成交量,買五檔[掛單數量,掛單價格],賣五檔[掛單數量,掛單價格]...
港股level1推送數據包格式如下:
lv1_證券代碼1=推送時間 ,證券名稱(英),證券名稱(中),最新價格,漲幅,成交額,成交量,買十檔[掛單數量,掛單價格],賣十檔[掛單數量,掛單價格]...lv1_證券代碼2=推送時間,證券名稱(英),證券名稱(中),最新價格,漲幅,成交額,成交量,買十檔[掛單數量,掛單價格],賣十檔[掛單數量,掛單價格]...
美股快照行情推送數據包格式如下:
lv1_證券代碼1=美股代碼,最新價格,漲幅,成交額,成交量,行情時間...lv1_證券代碼2=美股代碼,最新價格,漲幅,成交額,成交量,行情時間...
level2(逐筆明細)
level2行情推送數據以換行符"\n"為分隔,每一行以lv2_xxxxxx=為開頭,代表該類別code對應的行情。
同一時刻會存在多筆交易,以"|"為分隔符,數據字段以","為分隔符。
滬深level2推送數據包格式如下:
lv2_證券代碼1=成交時間1,成交編號1,成交價格1,成交數量1|成交時間2,成交編號2,成交價格2,成交數量2... lv2_證券代碼2=成交時間1,成交編號1,成交價格1,成交數量1|成交時間2,成交編號2,成交價格2,成交數量2...
港股level2推送數據包格式如下:
lv2_證券代碼1=成交時間1,成交編號1,成交價格1,成交數量1...|成交時間2,成交編號2,成交價格2,成交數量2... lv2_證券代碼2=成交時間1,成交編號1,成交價格1,成交數量1...|成交時間2,成交編號2,成交價格2,成交數量2...
美股逐筆明細推送數據包格式如下:
lv2_證券代碼1=成交時間1,時段類別1,成交編號1,成交價格1,成交數量1,成交價格2,成交數量2...|成交時間2,時段類別2,成交編號2,成交價格2,成交數量2... lv2_證券代碼1=成交時間1,時段類別1,成交編號1,成交價格1,成交數量1,成交價格2,成交數量2...|成交時間2,時段類別2,成交編號2,成交價格2,成交數量2...
| # | 美股時段標志 | 類別 |
|---|---|---|
| 1 | PRE | 盤前交易 |
| 2 | RTH | 盤中交易 |
| 3 | AFT | 盤后交易 |
行情在線測試
CN滬深實時行情測試 HK港股實時行情測試 US美股實時行情測試
浙公網安備 33010602011771號