# 查詢異動提醒
- Python
- Proto
- C#
- Java
- C++
- JavaScript
get_option_event_alert(count=200, page=None)
介紹
查詢已設置的期權異動提醒列表，支持分頁。
參數
參數 類型 說明 count int 每頁數量 範圍 [1,500]，默認 200page str 分頁標記 首次傳 None，翻頁傳 next_page返回
參數 類型 說明 ret RET_CODE 接口調用結果 data dict 當 ret == RET_OK，返回告警數據 str 當 ret != RET_OK，返回錯誤描述 data 字典包含：
字段 類型 說明 alert_list pandas.DataFrame 提醒設置列表 next_page str 下一頁標記（空字符串表示無下一頁） all_count int 告警項總數 alert_list DataFrame 各列字段：
字段 類型 說明 key int 告警唯一標識 enable bool 告警開關 option_market str 市場品類（OptionMarket 枚舉值） watchlist_group_name str 自選股分組名稱 underlying str 指定標的代碼 option_type str 期權類型（CALL/PUT） side_type_list list 成交方向列表（EventTickerType 枚舉值） order_type_list list 訂單類型列表（AlertOrderType 枚舉值） market_cap_range_min float 標的市值下限 market_cap_range_max float 標的市值上限 market_cap_min_inclusive bool 標的市值下限是否閉區間 market_cap_max_inclusive bool 標的市值上限是否閉區間 expiry_days_range_min float 距到期天數下限 expiry_days_range_max float 距到期天數上限 expiry_days_min_inclusive bool 距到期天數下限是否閉區間 expiry_days_max_inclusive bool 距到期天數上限是否閉區間 price_range_min float 異動成交價下限 price_range_max float 異動成交價上限 price_min_inclusive bool 異動成交價下限是否閉區間 price_max_inclusive bool 異動成交價上限是否閉區間 size_range_min float 異動成交量下限（張） size_range_max float 異動成交量上限（張） size_min_inclusive bool 異動成交量下限是否閉區間 size_max_inclusive bool 異動成交量上限是否閉區間 premium_range_min float 異動成交額下限 premium_range_max float 異動成交額上限 premium_min_inclusive bool 異動成交額下限是否閉區間 premium_max_inclusive bool 異動成交額上限是否閉區間 iv_range_min float 隱含波動率下限（%） iv_range_max float 隱含波動率上限（%） iv_min_inclusive bool 隱含波動率下限是否閉區間 iv_max_inclusive bool 隱含波動率上限是否閉區間 earnings_date_begin str 財報時間篩選起始日期（yyyy-MM-dd） earnings_date_end str 財報時間篩選截止日期（yyyy-MM-dd） note str 備註
Example
from futu import *
quote_ctx = OpenQuoteContext(host='127.0.0.1', port=11111)
ret, data = quote_ctx.get_option_event_alert()
if ret == RET_OK:
print(data['alert_list'])
print('all_count:', data['all_count'])
else:
print('error:', data)
quote_ctx.close()
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
- Output
key enable option_market watchlist_group_name underlying option_type side_type_list order_type_list market_cap_range_min market_cap_range_max market_cap_min_inclusive market_cap_max_inclusive expiry_days_range_min expiry_days_range_max expiry_days_min_inclusive expiry_days_max_inclusive price_range_min price_range_max price_min_inclusive price_max_inclusive size_range_min size_range_max size_min_inclusive size_max_inclusive premium_range_min premium_range_max premium_min_inclusive premium_max_inclusive iv_range_min iv_range_max iv_min_inclusive iv_max_inclusive earnings_date_begin earnings_date_end note
0 14743 False US_SECURITY N/A N/A CALL N/A [SWEEP] N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A 100.0 N/A True N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A test
all_count: 1
1
2
3
2
3
# Qot_GetOptionEventAlert.proto
介紹
查詢已設置的期權異動提醒列表
參數
message C2S {
optional int32 count = 1;
optional string page = 2;
}
message Request {
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
- 返回
message EventAlertItem {
optional int64 key = 1;
optional bool enable = 2;
optional int32 optionMarket = 10;
optional string watchlistGroupName = 11;
optional Qot_Common.Security underlying = 12;
optional int32 optionType = 20;
repeated int32 sideTypeList = 21;
repeated int32 orderTypeList = 22;
optional Qot_OptionCommon.Interval marketCapRange = 30;
optional Qot_OptionCommon.Interval expiryDaysRange = 31;
optional Qot_OptionCommon.Interval priceRange = 32;
optional Qot_OptionCommon.Interval sizeRange = 33;
optional Qot_OptionCommon.Interval premiumRange = 34;
optional Qot_OptionCommon.Interval ivRange = 35;
optional string earningsDateBegin = 41;
optional string earningsDateEnd = 42;
optional string note = 50;
}
message S2C {
repeated EventAlertItem alertList = 1;
optional string nextPage = 2;
optional int32 allCount = 3;
}
message Response {
required int32 retType = 1 [default = -400]; //RetType，返回結果
optional string retMsg = 2;
optional int32 errCode = 3;
optional S2C s2c = 4;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
- 接口調用結果，結構參見 RetType
協議 ID
3308
uint GetOptionEventAlert(Qot_GetOptionEventAlert.Request req); virtual void OnReply_GetOptionEventAlert(FTAPI_Conn client, uint nSerialNo, Qot_GetOptionEventAlert.Response rsp);
介紹
查詢已設置的期權異動提醒列表
參數
message C2S {
optional int32 count = 1;
optional string page = 2;
}
message Request {
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
- 返回
message EventAlertItem {
optional int64 key = 1;
optional bool enable = 2;
optional int32 optionMarket = 10;
optional string watchlistGroupName = 11;
optional Qot_Common.Security underlying = 12;
optional int32 optionType = 20;
repeated int32 sideTypeList = 21;
repeated int32 orderTypeList = 22;
optional Qot_OptionCommon.Interval marketCapRange = 30;
optional Qot_OptionCommon.Interval expiryDaysRange = 31;
optional Qot_OptionCommon.Interval priceRange = 32;
optional Qot_OptionCommon.Interval sizeRange = 33;
optional Qot_OptionCommon.Interval premiumRange = 34;
optional Qot_OptionCommon.Interval ivRange = 35;
optional string earningsDateBegin = 41;
optional string earningsDateEnd = 42;
optional string note = 50;
}
message S2C {
repeated EventAlertItem alertList = 1;
optional string nextPage = 2;
optional int32 allCount = 3;
}
message Response {
required int32 retType = 1 [default = -400]; //RetType，返回結果
optional string retMsg = 2;
optional int32 errCode = 3;
optional S2C s2c = 4;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
- 接口調用結果，結構參見 RetType
協議 ID
3308
int getOptionEventAlert(Qot_GetOptionEventAlert.Request req) onReply_GetOptionEventAlert(FTAPI_Conn client, int nSerialNo, Qot_GetOptionEventAlert.Response rsp)
介紹
查詢已設置的期權異動提醒列表
參數
message C2S {
optional int32 count = 1;
optional string page = 2;
}
message Request {
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
- 返回
message EventAlertItem {
optional int64 key = 1;
optional bool enable = 2;
optional int32 optionMarket = 10;
optional string watchlistGroupName = 11;
optional Qot_Common.Security underlying = 12;
optional int32 optionType = 20;
repeated int32 sideTypeList = 21;
repeated int32 orderTypeList = 22;
optional Qot_OptionCommon.Interval marketCapRange = 30;
optional Qot_OptionCommon.Interval expiryDaysRange = 31;
optional Qot_OptionCommon.Interval priceRange = 32;
optional Qot_OptionCommon.Interval sizeRange = 33;
optional Qot_OptionCommon.Interval premiumRange = 34;
optional Qot_OptionCommon.Interval ivRange = 35;
optional string earningsDateBegin = 41;
optional string earningsDateEnd = 42;
optional string note = 50;
}
message S2C {
repeated EventAlertItem alertList = 1;
optional string nextPage = 2;
optional int32 allCount = 3;
}
message Response {
required int32 retType = 1 [default = -400]; //RetType，返回結果
optional string retMsg = 2;
optional int32 errCode = 3;
optional S2C s2c = 4;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
- 接口調用結果，結構參見 RetType
協議 ID
3308
Futu::u32_t GetOptionEventAlert(const Qot_GetOptionEventAlert::Request &stReq);
virtual void OnReply_GetOptionEventAlert(Futu::u32_t nSerialNo, const Qot_GetOptionEventAlert::Response &stRsp) = 0;
介紹
查詢已設置的期權異動提醒列表
參數
message C2S {
optional int32 count = 1;
optional string page = 2;
}
message Request {
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
- 返回
message EventAlertItem {
optional int64 key = 1;
optional bool enable = 2;
optional int32 optionMarket = 10;
optional string watchlistGroupName = 11;
optional Qot_Common.Security underlying = 12;
optional int32 optionType = 20;
repeated int32 sideTypeList = 21;
repeated int32 orderTypeList = 22;
optional Qot_OptionCommon.Interval marketCapRange = 30;
optional Qot_OptionCommon.Interval expiryDaysRange = 31;
optional Qot_OptionCommon.Interval priceRange = 32;
optional Qot_OptionCommon.Interval sizeRange = 33;
optional Qot_OptionCommon.Interval premiumRange = 34;
optional Qot_OptionCommon.Interval ivRange = 35;
optional string earningsDateBegin = 41;
optional string earningsDateEnd = 42;
optional string note = 50;
}
message S2C {
repeated EventAlertItem alertList = 1;
optional string nextPage = 2;
optional int32 allCount = 3;
}
message Response {
required int32 retType = 1 [default = -400]; //RetType，返回結果
optional string retMsg = 2;
optional int32 errCode = 3;
optional S2C s2c = 4;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
- 接口調用結果，結構參見 RetType
協議 ID
3308
Example
class Program : public FTSPI_Qot, public FTSPI_Conn
{
public:
Program() {
m_pQotApi = FTAPI::CreateQotApi();
m_pQotApi->RegisterQotSpi(this);
m_pQotApi->RegisterConnSpi(this);
}
~Program() {
if (m_pQotApi != nullptr) {
m_pQotApi->UnregisterQotSpi();
m_pQotApi->UnregisterConnSpi();
FTAPI::ReleaseQotApi(m_pQotApi);
m_pQotApi = nullptr;
}
}
void Start() {
m_pQotApi->InitConnect("127.0.0.1", 11111, false);
}
virtual void OnInitConnect(FTAPI_Conn* pConn, Futu::i64_t nErrCode, const char* strDesc) {
Qot_GetOptionEventAlert::Request req;
Qot_GetOptionEventAlert::C2S *c2s = req.mutable_c2s();
// TODO: 按 proto 填充 c2s 字段
m_GetOptionEventAlertSerialNo = m_pQotApi->GetOptionEventAlert(req);
}
virtual void OnReply_GetOptionEventAlert(Futu::u32_t nSerialNo, const Qot_GetOptionEventAlert::Response &stRsp) {
if (nSerialNo != m_GetOptionEventAlertSerialNo) return;
string resp_str;
ProtoBufToBodyData(stRsp, resp_str);
cout << UTF8ToLocal(resp_str) << endl;
}
protected:
FTAPI_Qot *m_pQotApi;
Futu::u32_t m_GetOptionEventAlertSerialNo = 0;
};
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
getOptionEventAlert(qotGetOptionEventAlert)
介紹
查詢已設置的期權異動提醒列表
參數
message C2S {
optional int32 count = 1;
optional string page = 2;
}
message Request {
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
- 返回
message EventAlertItem {
optional int64 key = 1;
optional bool enable = 2;
optional int32 optionMarket = 10;
optional string watchlistGroupName = 11;
optional Qot_Common.Security underlying = 12;
optional int32 optionType = 20;
repeated int32 sideTypeList = 21;
repeated int32 orderTypeList = 22;
optional Qot_OptionCommon.Interval marketCapRange = 30;
optional Qot_OptionCommon.Interval expiryDaysRange = 31;
optional Qot_OptionCommon.Interval priceRange = 32;
optional Qot_OptionCommon.Interval sizeRange = 33;
optional Qot_OptionCommon.Interval premiumRange = 34;
optional Qot_OptionCommon.Interval ivRange = 35;
optional string earningsDateBegin = 41;
optional string earningsDateEnd = 42;
optional string note = 50;
}
message S2C {
repeated EventAlertItem alertList = 1;
optional string nextPage = 2;
optional int32 allCount = 3;
}
message Response {
required int32 retType = 1 [default = -400]; //RetType，返回結果
optional string retMsg = 2;
optional int32 errCode = 3;
optional S2C s2c = 4;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
- 接口調用結果，結構參見 RetType
協議 ID
3308
Example
import ftWebsocket from "futu-api";
import { Common, Qot_Common, Qot_OptionCommon } from "futu-api/proto";
import beautify from "js-beautify";
function QotGetOptionEventAlert(){
const { RetType } = Common
const { OptionMarket } = Qot_OptionCommon
const { OptionType } = Qot_Common
let [addr, port, enable_ssl, key] = ["127.0.0.1", 33333, false, '7522027ccf5a06b1'];
let websocket = new ftWebsocket();
websocket.onlogin = (ret, msg)=>{
if (ret) {
const req = {
c2s: {
count: 10,
page: "",
},
};
websocket.GetOptionEventAlert(req)
.then((res)=>{
let { errCode, retMsg, retType, s2c } = res
console.log("GetOptionEventAlert: errCode %d, retMsg %s, retType %d", errCode, retMsg, retType);
if(retType == RetType.RetType_Succeed){
let data = beautify(JSON.stringify(s2c), { indent_size: 2, space_in_empty_paren: true });
console.log(data);
}
})
.catch((error)=>{ console.log("error:", error); });
} else {
console.log("start error", msg);
}
};
websocket.start(addr, port, enable_ssl, key);
setTimeout(()=>{ websocket.stop(); process.exit(); }, 5000);
}
QotGetOptionEventAlert()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
- Output
GetOptionEventAlert: errCode 0, retMsg , retType 0
{
"alertList": [
{
"key": "1700000000001",
"enable": true,
"optionMarket": 0,
"optionType": 1,
"orderTypeList": [1],
"sizeRange": { "filterMin": { "value": 100, "includes": true } },
"note": "test"
}
],
"nextPage": "",
"allCount": 1
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
接口限制
- 30 秒內最多請求 60 次查詢異動提醒接口（支持分頁的接口，僅首次調用納入統計）
- Python
- Proto
- C#
- Java
- C++
- JavaScript
get_option_event_alert(count=200, page=None)
介紹
查詢已設置的期權異動提醒列表，支持分頁。
參數
參數 類型 說明 count int 每頁數量 範圍 [1,500]，默認 200page str 分頁標記 首次傳 None，翻頁傳 next_page返回
參數 類型 說明 ret RET_CODE 接口調用結果 data dict 當 ret == RET_OK，返回告警數據 str 當 ret != RET_OK，返回錯誤描述 data 字典包含：
字段 類型 說明 alert_list pandas.DataFrame 提醒設置列表 next_page str 下一頁標記（空字符串表示無下一頁） all_count int 告警項總數 alert_list DataFrame 各列字段：
字段 類型 說明 key int 告警唯一標識 enable bool 告警開關 option_market str 市場品類（OptionMarket 枚舉值） watchlist_group_name str 自選股分組名稱 underlying str 指定標的代碼 option_type str 期權類型（CALL/PUT） side_type_list list 成交方向列表（EventTickerType 枚舉值） order_type_list list 訂單類型列表（AlertOrderType 枚舉值） market_cap_range_min float 標的市值下限 market_cap_range_max float 標的市值上限 market_cap_min_inclusive bool 標的市值下限是否閉區間 market_cap_max_inclusive bool 標的市值上限是否閉區間 expiry_days_range_min float 距到期天數下限 expiry_days_range_max float 距到期天數上限 expiry_days_min_inclusive bool 距到期天數下限是否閉區間 expiry_days_max_inclusive bool 距到期天數上限是否閉區間 price_range_min float 異動成交價下限 price_range_max float 異動成交價上限 price_min_inclusive bool 異動成交價下限是否閉區間 price_max_inclusive bool 異動成交價上限是否閉區間 size_range_min float 異動成交量下限（張） size_range_max float 異動成交量上限（張） size_min_inclusive bool 異動成交量下限是否閉區間 size_max_inclusive bool 異動成交量上限是否閉區間 premium_range_min float 異動成交額下限 premium_range_max float 異動成交額上限 premium_min_inclusive bool 異動成交額下限是否閉區間 premium_max_inclusive bool 異動成交額上限是否閉區間 iv_range_min float 隱含波動率下限（%） iv_range_max float 隱含波動率上限（%） iv_min_inclusive bool 隱含波動率下限是否閉區間 iv_max_inclusive bool 隱含波動率上限是否閉區間 earnings_date_begin str 財報時間篩選起始日期（yyyy-MM-dd） earnings_date_end str 財報時間篩選截止日期（yyyy-MM-dd） note str 備註
Example
from moomoo import *
quote_ctx = OpenQuoteContext(host='127.0.0.1', port=11111)
ret, data = quote_ctx.get_option_event_alert()
if ret == RET_OK:
print(data['alert_list'])
print('all_count:', data['all_count'])
else:
print('error:', data)
quote_ctx.close()
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
- Output
key enable option_market watchlist_group_name underlying option_type side_type_list order_type_list market_cap_range_min market_cap_range_max market_cap_min_inclusive market_cap_max_inclusive expiry_days_range_min expiry_days_range_max expiry_days_min_inclusive expiry_days_max_inclusive price_range_min price_range_max price_min_inclusive price_max_inclusive size_range_min size_range_max size_min_inclusive size_max_inclusive premium_range_min premium_range_max premium_min_inclusive premium_max_inclusive iv_range_min iv_range_max iv_min_inclusive iv_max_inclusive earnings_date_begin earnings_date_end note
0 14743 False US_SECURITY N/A N/A CALL N/A [SWEEP] N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A 100.0 N/A True N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A test
all_count: 1
1
2
3
2
3
# Qot_GetOptionEventAlert.proto
介紹
查詢已設置的期權異動提醒列表
參數
message C2S {
optional int32 count = 1;
optional string page = 2;
}
message Request {
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
- 返回
message EventAlertItem {
optional int64 key = 1;
optional bool enable = 2;
optional int32 optionMarket = 10;
optional string watchlistGroupName = 11;
optional Qot_Common.Security underlying = 12;
optional int32 optionType = 20;
repeated int32 sideTypeList = 21;
repeated int32 orderTypeList = 22;
optional Qot_OptionCommon.Interval marketCapRange = 30;
optional Qot_OptionCommon.Interval expiryDaysRange = 31;
optional Qot_OptionCommon.Interval priceRange = 32;
optional Qot_OptionCommon.Interval sizeRange = 33;
optional Qot_OptionCommon.Interval premiumRange = 34;
optional Qot_OptionCommon.Interval ivRange = 35;
optional string earningsDateBegin = 41;
optional string earningsDateEnd = 42;
optional string note = 50;
}
message S2C {
repeated EventAlertItem alertList = 1;
optional string nextPage = 2;
optional int32 allCount = 3;
}
message Response {
required int32 retType = 1 [default = -400]; //RetType，返回結果
optional string retMsg = 2;
optional int32 errCode = 3;
optional S2C s2c = 4;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
- 接口調用結果，結構參見 RetType
協議 ID
3308
uint GetOptionEventAlert(Qot_GetOptionEventAlert.Request req); virtual void OnReply_GetOptionEventAlert(MMAPI_Conn client, uint nSerialNo, Qot_GetOptionEventAlert.Response rsp);
介紹
查詢已設置的期權異動提醒列表
參數
message C2S {
optional int32 count = 1;
optional string page = 2;
}
message Request {
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
- 返回
message EventAlertItem {
optional int64 key = 1;
optional bool enable = 2;
optional int32 optionMarket = 10;
optional string watchlistGroupName = 11;
optional Qot_Common.Security underlying = 12;
optional int32 optionType = 20;
repeated int32 sideTypeList = 21;
repeated int32 orderTypeList = 22;
optional Qot_OptionCommon.Interval marketCapRange = 30;
optional Qot_OptionCommon.Interval expiryDaysRange = 31;
optional Qot_OptionCommon.Interval priceRange = 32;
optional Qot_OptionCommon.Interval sizeRange = 33;
optional Qot_OptionCommon.Interval premiumRange = 34;
optional Qot_OptionCommon.Interval ivRange = 35;
optional string earningsDateBegin = 41;
optional string earningsDateEnd = 42;
optional string note = 50;
}
message S2C {
repeated EventAlertItem alertList = 1;
optional string nextPage = 2;
optional int32 allCount = 3;
}
message Response {
required int32 retType = 1 [default = -400]; //RetType，返回結果
optional string retMsg = 2;
optional int32 errCode = 3;
optional S2C s2c = 4;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
- 接口調用結果，結構參見 RetType
協議 ID
3308
int getOptionEventAlert(Qot_GetOptionEventAlert.Request req) onReply_GetOptionEventAlert(MMAPI_Conn client, int nSerialNo, Qot_GetOptionEventAlert.Response rsp)
介紹
查詢已設置的期權異動提醒列表
參數
message C2S {
optional int32 count = 1;
optional string page = 2;
}
message Request {
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
- 返回
message EventAlertItem {
optional int64 key = 1;
optional bool enable = 2;
optional int32 optionMarket = 10;
optional string watchlistGroupName = 11;
optional Qot_Common.Security underlying = 12;
optional int32 optionType = 20;
repeated int32 sideTypeList = 21;
repeated int32 orderTypeList = 22;
optional Qot_OptionCommon.Interval marketCapRange = 30;
optional Qot_OptionCommon.Interval expiryDaysRange = 31;
optional Qot_OptionCommon.Interval priceRange = 32;
optional Qot_OptionCommon.Interval sizeRange = 33;
optional Qot_OptionCommon.Interval premiumRange = 34;
optional Qot_OptionCommon.Interval ivRange = 35;
optional string earningsDateBegin = 41;
optional string earningsDateEnd = 42;
optional string note = 50;
}
message S2C {
repeated EventAlertItem alertList = 1;
optional string nextPage = 2;
optional int32 allCount = 3;
}
message Response {
required int32 retType = 1 [default = -400]; //RetType，返回結果
optional string retMsg = 2;
optional int32 errCode = 3;
optional S2C s2c = 4;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
- 接口調用結果，結構參見 RetType
協議 ID
3308
Moomoo::u32_t GetOptionEventAlert(const Qot_GetOptionEventAlert::Request &stReq);
virtual void OnReply_GetOptionEventAlert(Moomoo::u32_t nSerialNo, const Qot_GetOptionEventAlert::Response &stRsp) = 0;
介紹
查詢已設置的期權異動提醒列表
參數
message C2S {
optional int32 count = 1;
optional string page = 2;
}
message Request {
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
- 返回
message EventAlertItem {
optional int64 key = 1;
optional bool enable = 2;
optional int32 optionMarket = 10;
optional string watchlistGroupName = 11;
optional Qot_Common.Security underlying = 12;
optional int32 optionType = 20;
repeated int32 sideTypeList = 21;
repeated int32 orderTypeList = 22;
optional Qot_OptionCommon.Interval marketCapRange = 30;
optional Qot_OptionCommon.Interval expiryDaysRange = 31;
optional Qot_OptionCommon.Interval priceRange = 32;
optional Qot_OptionCommon.Interval sizeRange = 33;
optional Qot_OptionCommon.Interval premiumRange = 34;
optional Qot_OptionCommon.Interval ivRange = 35;
optional string earningsDateBegin = 41;
optional string earningsDateEnd = 42;
optional string note = 50;
}
message S2C {
repeated EventAlertItem alertList = 1;
optional string nextPage = 2;
optional int32 allCount = 3;
}
message Response {
required int32 retType = 1 [default = -400]; //RetType，返回結果
optional string retMsg = 2;
optional int32 errCode = 3;
optional S2C s2c = 4;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
- 接口調用結果，結構參見 RetType
協議 ID
3308
Example
class Program : public MMSPI_Qot, public MMSPI_Conn
{
public:
Program() {
m_pQotApi = MMAPI::CreateQotApi();
m_pQotApi->RegisterQotSpi(this);
m_pQotApi->RegisterConnSpi(this);
}
~Program() {
if (m_pQotApi != nullptr) {
m_pQotApi->UnregisterQotSpi();
m_pQotApi->UnregisterConnSpi();
MMAPI::ReleaseQotApi(m_pQotApi);
m_pQotApi = nullptr;
}
}
void Start() {
m_pQotApi->InitConnect("127.0.0.1", 11111, false);
}
virtual void OnInitConnect(MMAPI_Conn* pConn, Moomoo::i64_t nErrCode, const char* strDesc) {
Qot_GetOptionEventAlert::Request req;
Qot_GetOptionEventAlert::C2S *c2s = req.mutable_c2s();
// TODO: 按 proto 填充 c2s 字段
m_GetOptionEventAlertSerialNo = m_pQotApi->GetOptionEventAlert(req);
}
virtual void OnReply_GetOptionEventAlert(Moomoo::u32_t nSerialNo, const Qot_GetOptionEventAlert::Response &stRsp) {
if (nSerialNo != m_GetOptionEventAlertSerialNo) return;
string resp_str;
ProtoBufToBodyData(stRsp, resp_str);
cout << UTF8ToLocal(resp_str) << endl;
}
protected:
MMAPI_Qot *m_pQotApi;
Moomoo::u32_t m_GetOptionEventAlertSerialNo = 0;
};
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
getOptionEventAlert(qotGetOptionEventAlert)
介紹
查詢已設置的期權異動提醒列表
參數
message C2S {
optional int32 count = 1;
optional string page = 2;
}
message Request {
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
- 返回
message EventAlertItem {
optional int64 key = 1;
optional bool enable = 2;
optional int32 optionMarket = 10;
optional string watchlistGroupName = 11;
optional Qot_Common.Security underlying = 12;
optional int32 optionType = 20;
repeated int32 sideTypeList = 21;
repeated int32 orderTypeList = 22;
optional Qot_OptionCommon.Interval marketCapRange = 30;
optional Qot_OptionCommon.Interval expiryDaysRange = 31;
optional Qot_OptionCommon.Interval priceRange = 32;
optional Qot_OptionCommon.Interval sizeRange = 33;
optional Qot_OptionCommon.Interval premiumRange = 34;
optional Qot_OptionCommon.Interval ivRange = 35;
optional string earningsDateBegin = 41;
optional string earningsDateEnd = 42;
optional string note = 50;
}
message S2C {
repeated EventAlertItem alertList = 1;
optional string nextPage = 2;
optional int32 allCount = 3;
}
message Response {
required int32 retType = 1 [default = -400]; //RetType，返回結果
optional string retMsg = 2;
optional int32 errCode = 3;
optional S2C s2c = 4;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
- 接口調用結果，結構參見 RetType
協議 ID
3308
Example
import mmWebsocket from "moomoo-api";
import { Common, Qot_Common, Qot_OptionCommon } from "moomoo-api/proto";
import beautify from "js-beautify";
function QotGetOptionEventAlert(){
const { RetType } = Common
const { OptionMarket } = Qot_OptionCommon
const { OptionType } = Qot_Common
let [addr, port, enable_ssl, key] = ["127.0.0.1", 33333, false, '7522027ccf5a06b1'];
let websocket = new mmWebsocket();
websocket.onlogin = (ret, msg)=>{
if (ret) {
const req = {
c2s: {
count: 10,
page: "",
},
};
websocket.GetOptionEventAlert(req)
.then((res)=>{
let { errCode, retMsg, retType, s2c } = res
console.log("GetOptionEventAlert: errCode %d, retMsg %s, retType %d", errCode, retMsg, retType);
if(retType == RetType.RetType_Succeed){
let data = beautify(JSON.stringify(s2c), { indent_size: 2, space_in_empty_paren: true });
console.log(data);
}
})
.catch((error)=>{ console.log("error:", error); });
} else {
console.log("start error", msg);
}
};
websocket.start(addr, port, enable_ssl, key);
setTimeout(()=>{ websocket.stop(); process.exit(); }, 5000);
}
QotGetOptionEventAlert()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
- Output
GetOptionEventAlert: errCode 0, retMsg , retType 0
{
"alertList": [
{
"key": "1700000000001",
"enable": true,
"optionMarket": 0,
"optionType": 1,
"orderTypeList": [1],
"sizeRange": { "filterMin": { "value": 100, "includes": true } },
"note": "test"
}
],
"nextPage": "",
"allCount": 1
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
接口限制
- 30 秒內最多請求 60 次查詢異動提醒接口（支持分頁的接口，僅首次調用納入統計）