# オプション契約ランキング
- Python
- Proto
- C#
- Java
- C++
- JavaScript
get_option_rank(option_market, sort_type, count=None, trading_date=None, sort_direction=None, page=None, filter_list=None)
説明
オプション契約ランキングリストを取得します。出来高、建玉、増玉、減玉、IV、騰落率等の次元でのソートに対応。
パラメータ
パラメータ 型 説明 option_market OptionMarket オプション市場タイプ US_SECURITY=米国株式オプション、US_INDEX=米国指数オプション、HK_SECURITY=香港株式オプション、HK_INDEX=香港指数オプションsort_type OptionRankType ソートタイプ VOLUME=出来高、TURNOVER=売買代金、OPEN_INTEREST=建玉、OI_INCREMENT=増玉、OI_DECREMENT=減玉、OI_MARKET_CAP_INCREMENT=増玉額、OI_MARKET_CAP_DECREMENT=減玉額、IV=インプライドボラティリティ、CHANGE_RATE=騰落率count int 返却数量 範囲 [1,200]、デフォルト 200trading_date str 取引日 フォーマット yyyy-MM-dd、未指定の場合は最新ランキングを返すsort_direction int ソート方向 0=降順(デフォルト)、1=昇順page str ページングカーソル 初回リクエストは未指定、以降は next_page を渡すfilter_list list[OptionRankFilter] フィルタ条件リスト 複数条件は AND 関係戻り値
パラメータ 型 説明 ret RET_CODE インターフェース呼び出し結果 data pandas.DataFrame ret == RET_OK の場合、ランキングデータを返す。ret != RET_OK の場合、エラー説明文字列を返す next_page str 次ページカーソル。データがない場合は None all_count int 総数 data DataFrame フィールド：
フィールド 型 説明 code str オプション契約コード name str オプション名称 option_type str オプションタイプ CALL、PUToi_increment int 増玉 oi_decrement int 減玉 oi_market_cap_increment float 増玉額 oi_market_cap_decrement float 減玉額 volume int 出来高 turnover float 売買代金 open_interest int 建玉 open_interest_market_cap float 建玉額 iv float インプライドボラティリティ（パーセント） option_price float オプション最新価格 change_ratio float 騰落率（パーセント） mid_price float 中間価格 bid_price float 買い価格 bid_volume int 買い数量 ask_price float 売り価格 ask_volume int 売り数量 delta float Delta gamma float Gamma theta float Theta vega float Vega rho float Rho trading_date str 取引日 trading_timestamp float 取引タイムスタンプ
Example
from futu import *
quote_ctx = OpenQuoteContext(host='127.0.0.1', port=11111)
ret, data, next_page, all_count = quote_ctx.get_option_rank(
OptionMarket.US_SECURITY,
OptionRankType.VOLUME,
count=5
)
if ret == RET_OK:
print(data)
print('all_count:', all_count)
else:
print('error:', data)
quote_ctx.close()
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
- Output
code name option_type oi_increment oi_decrement oi_market_cap_increment oi_market_cap_decrement volume turnover open_interest open_interest_market_cap iv option_price change_ratio mid_price bid_price bid_volume ask_price ask_volume delta gamma theta vega rho trading_date trading_timestamp
0 US.SPY260612C742000 SPY 260612 742.00C CALL 1816 N/A 105328.0 N/A 730160 91928623.0 7449 432042.0 146.507 0.58 -67.688 0.580 0.56 28 0.60 1 0.43674 0.27447 -455.46028 0.00385 0.0 2026-06-12 1.781237e+09
1 US.SPY260612C745000 SPY 260612 745.00C CALL 5416 N/A 5416.0 N/A 617981 44479304.0 17013 17013.0 87.067 0.01 -98.958 0.015 0.01 708 0.02 500 0.02438 0.03501 -18.52310 0.00107 0.0 2026-06-12 1.781237e+09
2 US.SPY260612C743000 SPY 260612 743.00C CALL 5438 N/A 48942.0 N/A 606769 64419534.0 7426 66834.0 59.082 0.09 -93.898 0.095 0.09 208 0.10 118 0.13412 0.19487 -50.92453 0.00405 0.0 2026-06-12 1.781237e+09
3 US.SPY260612P740000 SPY 260612 740.00P PUT 1223 N/A 1223.0 N/A 566915 69291991.0 15291 15291.0 53.083 0.01 -99.790 0.015 0.01 447 0.02 407 -0.03761 0.08224 -16.47701 0.00153 0.0 2026-06-12 1.781237e+09
4 US.SPY260612C741000 SPY 260612 741.00C CALL 2924 N/A 423980.0 N/A 506505 88981079.0 6229 903205.0 224.448 1.45 -33.179 1.520 1.46 12 1.58 23 0.63754 0.17055 -662.49947 0.00367 0.0 2026-06-12 1.781237e+09
all_count: 1955829
1
2
3
4
5
6
7
2
3
4
5
6
7
# Qot_GetOptionRank.proto
説明
オプション契約ランキングリストを取得
パラメータ
message C2S
{
required int32 optionMarket = 1; //コーポレートアクションタイプ
required int32 sortType = 2; //Qot_OptionCommon.OptionRankType
optional int32 count = 3; //返却数量[1,200]、デフォルト200
optional string tradingDate = 4; //取引日、フォーマットyyyy-MM-dd
optional bool isAsc = 5; //昇順かどうか、デフォルトfalse
optional string page = 6; //ページングカーソル
repeated Qot_OptionCommon.OptionRankIndicator filterList = 7;
}
message Request
{
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
- 戻り値
message OptionRankItem
{
required Qot_Common.Security option = 1;
optional string name = 2;
optional int32 optionType = 3;
optional int64 oiIncrement = 4;
optional int64 oiDecrement = 5;
optional double oiMarketCapIncrement = 6;
optional double oiMarketCapDecrement = 7;
optional int64 volume = 8;
optional double turnover = 9;
optional int64 openInterest = 10;
optional double openInterestMarketCap = 11;
optional double iv = 12;
optional double optionPrice = 13;
optional double changeRate = 14;
optional double midPrice = 15;
optional double bidPrice = 16;
optional int64 bidVolume = 17;
optional double askPrice = 18;
optional int64 askVolume = 19;
optional double delta = 20;
optional double gamma = 21;
optional double theta = 22;
optional double vega = 23;
optional double rho = 24;
}
message S2C
{
required int32 optionMarket = 1;
required int32 sortType = 2;
optional string tradingDate = 3;
optional double tradingTimestamp = 4;
repeated OptionRankItem rankList = 5;
optional string nextPage = 6;
optional int32 allCount = 7;
}
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
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
41
42
43
44
45
46
- インターフェース呼び出し結果、構造は RetType を参照
プロトコル ID
3306
uint GetOptionRank(Qot_GetOptionRank.Request req); virtual void OnReply_GetOptionRank(FTAPI_Conn client, uint nSerialNo, Qot_GetOptionRank.Response rsp);
説明
オプション契約ランキングリストを取得
パラメータ
message C2S
{
required int32 optionMarket = 1; //コーポレートアクションタイプ
required int32 sortType = 2; //Qot_OptionCommon.OptionRankType
optional int32 count = 3; //返却数量[1,200]、デフォルト200
optional string tradingDate = 4; //取引日、フォーマットyyyy-MM-dd
optional bool isAsc = 5; //昇順かどうか、デフォルトfalse
optional string page = 6; //ページングカーソル
repeated Qot_OptionCommon.OptionRankIndicator filterList = 7;
}
message Request
{
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
- 戻り値
message OptionRankItem
{
required Qot_Common.Security option = 1;
optional string name = 2;
optional int32 optionType = 3;
optional int64 oiIncrement = 4;
optional int64 oiDecrement = 5;
optional double oiMarketCapIncrement = 6;
optional double oiMarketCapDecrement = 7;
optional int64 volume = 8;
optional double turnover = 9;
optional int64 openInterest = 10;
optional double openInterestMarketCap = 11;
optional double iv = 12;
optional double optionPrice = 13;
optional double changeRate = 14;
optional double midPrice = 15;
optional double bidPrice = 16;
optional int64 bidVolume = 17;
optional double askPrice = 18;
optional int64 askVolume = 19;
optional double delta = 20;
optional double gamma = 21;
optional double theta = 22;
optional double vega = 23;
optional double rho = 24;
}
message S2C
{
required int32 optionMarket = 1;
required int32 sortType = 2;
optional string tradingDate = 3;
optional double tradingTimestamp = 4;
repeated OptionRankItem rankList = 5;
optional string nextPage = 6;
optional int32 allCount = 7;
}
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
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
41
42
43
44
45
46
- インターフェース呼び出し結果、構造は RetType を参照
プロトコル ID
3306
Example
public class Program : FTSPI_Qot, FTSPI_Conn
{
FTAPI_Qot qot = new FTAPI_Qot();
public Program()
{
qot.SetClientInfo("csharp", 1);
qot.SetConnCallback(this);
qot.SetQotCallback(this);
}
public void Start()
{
qot.InitConnect("127.0.0.1", (ushort)11111, false);
}
public void OnInitConnect(FTAPI_Conn client, long errCode, String desc)
{
if (errCode != 0) return;
var c2s = Qot_GetOptionRank.C2S.CreateBuilder()
// TODO: 按 proto 填充 c2s 字段
.Build();
var req = Qot_GetOptionRank.Request.CreateBuilder().SetC2S(c2s).Build();
uint seqNo = qot.GetOptionRank(req);
Console.Write("Send GetOptionRank: {0}\n", seqNo);
}
public void OnReply_GetOptionRank(FTAPI_Conn client, uint nSerialNo, Qot_GetOptionRank.Response rsp)
{
Console.Write("Reply: {0} {1}\n", nSerialNo, rsp.ToString());
}
public static void Main(String[] args)
{
FTAPI.Init();
new Program().Start();
while (true) Thread.Sleep(1000 * 600);
}
}
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
- Output
Send GetOptionRank: 1
Reply: 1 { "market": 1, "code": "SPY260612C745000" },
"name": "SPY 260612 745.00C",
"optionType": 1,
"oiIncrement": 5416,
"volume": 617981,
"turnover": 44479304,
"openInterest": 17013,
"iv": 87.067,
"optionPrice": 0.01,
"changeRate": -98.958,
"midPrice": 0.015,
"bidPrice": 0.01,
"bidVolume": 708,
"askPrice": 0.02,
"askVolume": 500,
"delta": 0.02438,
"gamma": 0.03501,
"theta": -18.5231,
"vega": 0.00107,
"rho": 0
}
],
"allCount": 1955829
}
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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
int getOptionRank(Qot_GetOptionRank.Request req) onReply_GetOptionRank(FTAPI_Conn client, int nSerialNo, Qot_GetOptionRank.Response rsp)
説明
オプション契約ランキングリストを取得
パラメータ
message C2S
{
required int32 optionMarket = 1; //コーポレートアクションタイプ
required int32 sortType = 2; //Qot_OptionCommon.OptionRankType
optional int32 count = 3; //返却数量[1,200]、デフォルト200
optional string tradingDate = 4; //取引日、フォーマットyyyy-MM-dd
optional bool isAsc = 5; //昇順かどうか、デフォルトfalse
optional string page = 6; //ページングカーソル
repeated Qot_OptionCommon.OptionRankIndicator filterList = 7;
}
message Request
{
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
- 戻り値
message OptionRankItem
{
required Qot_Common.Security option = 1;
optional string name = 2;
optional int32 optionType = 3;
optional int64 oiIncrement = 4;
optional int64 oiDecrement = 5;
optional double oiMarketCapIncrement = 6;
optional double oiMarketCapDecrement = 7;
optional int64 volume = 8;
optional double turnover = 9;
optional int64 openInterest = 10;
optional double openInterestMarketCap = 11;
optional double iv = 12;
optional double optionPrice = 13;
optional double changeRate = 14;
optional double midPrice = 15;
optional double bidPrice = 16;
optional int64 bidVolume = 17;
optional double askPrice = 18;
optional int64 askVolume = 19;
optional double delta = 20;
optional double gamma = 21;
optional double theta = 22;
optional double vega = 23;
optional double rho = 24;
}
message S2C
{
required int32 optionMarket = 1;
required int32 sortType = 2;
optional string tradingDate = 3;
optional double tradingTimestamp = 4;
repeated OptionRankItem rankList = 5;
optional string nextPage = 6;
optional int32 allCount = 7;
}
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
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
41
42
43
44
45
46
- インターフェース呼び出し結果、構造は RetType を参照
プロトコル ID
3306
Example
public class Program implements FTSPI_Qot, FTSPI_Conn {
private FTAPI_Conn_Qot qot = new FTAPI_Conn_Qot();
public Program() {
qot.setClientInfo("java", 1);
qot.setConnCallback(this);
qot.setQotCallback(this);
}
public void start() {
qot.initConnect("127.0.0.1", (short) 11111, false);
}
@Override
public void onInitConnect(FTAPI_Conn client, long errCode, String desc) {
if (errCode != 0) return;
Qot_GetOptionRank.C2S c2s = Qot_GetOptionRank.C2S.newBuilder()
// TODO: 按 proto 填充 c2s 字段
.build();
Qot_GetOptionRank.Request req = Qot_GetOptionRank.Request.newBuilder()
.setC2S(c2s).build();
int seqNo = qot.getOptionRank(req);
System.out.println("Send getOptionRank: " + seqNo);
}
@Override
public void onReply_GetOptionRank(FTAPI_Conn client, int nSerialNo, Qot_GetOptionRank.Response rsp) {
System.out.println("Reply: " + nSerialNo + " " + rsp.toString());
}
public static void main(String[] args) {
FTAPI.init();
new Program().start();
while (true) {
try { Thread.sleep(1000 * 600); } catch (InterruptedException e) {}
}
}
}
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
- Output
Send getOptionRank: 1
Reply: 1 { "market": 1, "code": "SPY260612C745000" },
"name": "SPY 260612 745.00C",
"optionType": 1,
"oiIncrement": 5416,
"volume": 617981,
"turnover": 44479304,
"openInterest": 17013,
"iv": 87.067,
"optionPrice": 0.01,
"changeRate": -98.958,
"midPrice": 0.015,
"bidPrice": 0.01,
"bidVolume": 708,
"askPrice": 0.02,
"askVolume": 500,
"delta": 0.02438,
"gamma": 0.03501,
"theta": -18.5231,
"vega": 0.00107,
"rho": 0
}
],
"allCount": 1955829
}
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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
Futu::u32_t GetOptionRank(const Qot_GetOptionRank::Request &stReq);
virtual void OnReply_GetOptionRank(Futu::u32_t nSerialNo, const Qot_GetOptionRank::Response &stRsp) = 0;
説明
オプション契約ランキングリストを取得
パラメータ
message C2S
{
required int32 optionMarket = 1; //コーポレートアクションタイプ
required int32 sortType = 2; //Qot_OptionCommon.OptionRankType
optional int32 count = 3; //返却数量[1,200]、デフォルト200
optional string tradingDate = 4; //取引日、フォーマットyyyy-MM-dd
optional bool isAsc = 5; //昇順かどうか、デフォルトfalse
optional string page = 6; //ページングカーソル
repeated Qot_OptionCommon.OptionRankIndicator filterList = 7;
}
message Request
{
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
- 戻り値
message OptionRankItem
{
required Qot_Common.Security option = 1;
optional string name = 2;
optional int32 optionType = 3;
optional int64 oiIncrement = 4;
optional int64 oiDecrement = 5;
optional double oiMarketCapIncrement = 6;
optional double oiMarketCapDecrement = 7;
optional int64 volume = 8;
optional double turnover = 9;
optional int64 openInterest = 10;
optional double openInterestMarketCap = 11;
optional double iv = 12;
optional double optionPrice = 13;
optional double changeRate = 14;
optional double midPrice = 15;
optional double bidPrice = 16;
optional int64 bidVolume = 17;
optional double askPrice = 18;
optional int64 askVolume = 19;
optional double delta = 20;
optional double gamma = 21;
optional double theta = 22;
optional double vega = 23;
optional double rho = 24;
}
message S2C
{
required int32 optionMarket = 1;
required int32 sortType = 2;
optional string tradingDate = 3;
optional double tradingTimestamp = 4;
repeated OptionRankItem rankList = 5;
optional string nextPage = 6;
optional int32 allCount = 7;
}
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
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
41
42
43
44
45
46
- インターフェース呼び出し結果、構造は RetType を参照
プロトコル ID
3306
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_GetOptionRank::Request req;
Qot_GetOptionRank::C2S *c2s = req.mutable_c2s();
// TODO: 按 proto 填充 c2s 字段
m_GetOptionRankSerialNo = m_pQotApi->GetOptionRank(req);
}
virtual void OnReply_GetOptionRank(Futu::u32_t nSerialNo, const Qot_GetOptionRank::Response &stRsp) {
if (nSerialNo != m_GetOptionRankSerialNo) return;
string resp_str;
ProtoBufToBodyData(stRsp, resp_str);
cout << UTF8ToLocal(resp_str) << endl;
}
protected:
FTAPI_Qot *m_pQotApi;
Futu::u32_t m_GetOptionRankSerialNo = 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
getOptionRank(qotGetOptionRank)
説明
オプション契約ランキングリストを取得
パラメータ
message C2S
{
required int32 optionMarket = 1; //コーポレートアクションタイプ
required int32 sortType = 2; //Qot_OptionCommon.OptionRankType
optional int32 count = 3; //返却数量[1,200]、デフォルト200
optional string tradingDate = 4; //取引日、フォーマットyyyy-MM-dd
optional bool isAsc = 5; //昇順かどうか、デフォルトfalse
optional string page = 6; //ページングカーソル
repeated Qot_OptionCommon.OptionRankIndicator filterList = 7;
}
message Request
{
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
- 戻り値
message OptionRankItem
{
required Qot_Common.Security option = 1;
optional string name = 2;
optional int32 optionType = 3;
optional int64 oiIncrement = 4;
optional int64 oiDecrement = 5;
optional double oiMarketCapIncrement = 6;
optional double oiMarketCapDecrement = 7;
optional int64 volume = 8;
optional double turnover = 9;
optional int64 openInterest = 10;
optional double openInterestMarketCap = 11;
optional double iv = 12;
optional double optionPrice = 13;
optional double changeRate = 14;
optional double midPrice = 15;
optional double bidPrice = 16;
optional int64 bidVolume = 17;
optional double askPrice = 18;
optional int64 askVolume = 19;
optional double delta = 20;
optional double gamma = 21;
optional double theta = 22;
optional double vega = 23;
optional double rho = 24;
}
message S2C
{
required int32 optionMarket = 1;
required int32 sortType = 2;
optional string tradingDate = 3;
optional double tradingTimestamp = 4;
repeated OptionRankItem rankList = 5;
optional string nextPage = 6;
optional int32 allCount = 7;
}
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
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
41
42
43
44
45
46
- インターフェース呼び出し結果、構造は RetType を参照
プロトコル ID
3306
Example
import ftWebsocket from "futu-api";
import { Common, Qot_OptionCommon } from "futu-api/proto";
import beautify from "js-beautify";
function QotGetOptionRank(){
const { RetType } = Common
const { OptionMarket, OptionRankType } = Qot_OptionCommon
let [addr, port, enable_ssl, key] = ["127.0.0.1", 11112, false, ''];
let websocket = new ftWebsocket();
websocket.onlogin = (ret, msg)=>{
if (ret) {
const req = {
c2s: {
optionMarket: OptionMarket.OptionMarket_US_Security,
sortType: OptionRankType.OptionRankType_Volume,
count: 5,
},
};
websocket.GetOptionRank(req)
.then((res)=>{
let { errCode, retMsg, retType, s2c } = res
console.log("GetOptionRank: 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);
}
QotGetOptionRank()
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
GetOptionRank: errCode 0, retMsg , retType 0
{
"optionMarket": 1,
"sortType": 1,
"tradingDate": "2026-06-12",
"tradingTimestamp": 1781237000,
"rankList": [
{
"option": { "market": 1, "code": "SPY260612C742000" },
"name": "SPY 260612 742.00C",
"optionType": 1,
"oiIncrement": 1816,
"volume": 730160,
"turnover": 91928623,
"openInterest": 7449,
"iv": 146.507,
"optionPrice": 0.58,
"changeRate": -67.688,
"midPrice": 0.58,
"bidPrice": 0.56,
"bidVolume": 28,
"askPrice": 0.6,
"askVolume": 1,
"delta": 0.43674,
"gamma": 0.27447,
"theta": -455.46028,
"vega": 0.00385,
"rho": 0
},
{
"option": { "market": 1, "code": "SPY260612C745000" },
"name": "SPY 260612 745.00C",
"optionType": 1,
"oiIncrement": 5416,
"volume": 617981,
"turnover": 44479304,
"openInterest": 17013,
"iv": 87.067,
"optionPrice": 0.01,
"changeRate": -98.958,
"midPrice": 0.015,
"bidPrice": 0.01,
"bidVolume": 708,
"askPrice": 0.02,
"askVolume": 500,
"delta": 0.02438,
"gamma": 0.03501,
"theta": -18.5231,
"vega": 0.00107,
"rho": 0
}
],
"allCount": 1955829
}
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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
インターフェース制限
- 30秒以内に最大60回のオプション契約ランキングインターフェースリクエスト（ページング対応のインターフェースは初回呼び出しのみカウント）
- Python
- Proto
- C#
- Java
- C++
- JavaScript
get_option_rank(option_market, sort_type, count=None, trading_date=None, sort_direction=None, page=None, filter_list=None)
説明
オプション契約ランキングリストを取得します。出来高、建玉、増玉、減玉、IV、騰落率等の次元でのソートに対応。
パラメータ
パラメータ 型 説明 option_market OptionMarket オプション市場タイプ US_SECURITY=米国株式オプション、US_INDEX=米国指数オプション、HK_SECURITY=香港株式オプション、HK_INDEX=香港指数オプションsort_type OptionRankType ソートタイプ VOLUME=出来高、TURNOVER=売買代金、OPEN_INTEREST=建玉、OI_INCREMENT=増玉、OI_DECREMENT=減玉、OI_MARKET_CAP_INCREMENT=増玉額、OI_MARKET_CAP_DECREMENT=減玉額、IV=インプライドボラティリティ、CHANGE_RATE=騰落率count int 返却数量 範囲 [1,200]、デフォルト 200trading_date str 取引日 フォーマット yyyy-MM-dd、未指定の場合は最新ランキングを返すsort_direction int ソート方向 0=降順(デフォルト)、1=昇順page str ページングカーソル 初回リクエストは未指定、以降は next_page を渡すfilter_list list[OptionRankFilter] フィルタ条件リスト 複数条件は AND 関係フィルタ（OptionRankFilter）
OptionRankFilter でフィルタ条件を構築します。複数条件は AND 関係です。
OptionRankFilter(indicator_type, value_list=None, interval_min=None, interval_max=None, min_inclusive=True, max_inclusive=True, security_list=None)1
2パラメータ 型 説明 indicator_type OptionRankIndicatorType フィルタ因子タイプ value_list list 確定値リスト（列挙値または整数） interval_min float 区間下限 interval_max float 区間上限 min_inclusive bool 下限を閉区間にするか、デフォルト True max_inclusive bool 上限を閉区間にするか、デフォルト True security_list list[str] 証券コードリスト フィルタ因子（完全な列挙は OptionRankIndicatorType を参照）、フィルタ方式別グループ：
フィルタ方式 使用パラメータ 適用因子 意味 security_list security_listOWNER_LIST指定標的の契約のみ value_list value_listSTOCK_CATEGORY、OPTION_TYPE、IN_THE_MONEY列挙値集合に一致 範囲 interval_min/interval_maxIV、IV_RANK、IV_PERCENTILE、UNDERLYING_IV、UNDERLYING_HV、MARKET_CAP、VOLUME、OPEN_INTEREST、LEFT_DAYS、DELTA、GAMMA、THETA、VEGA、RHO区間内 百分比の因子（IV_RANK、IV_PERCENTILE など）は小数を直接入力、0.2 は 20% を表します。1 つの条件は 1 つのフィルタ方式のみを担い、3 方式は互いに排他です。`STOCK_CATEGORY` は [StockCategory.ETF]、`OPTION_TYPE` は [1](Call)/[2](Put)、`IN_THE_MONEY` は [0](アウトオブザマネー)/[1](インザマネー) を渡します。
戻り値
パラメータ 型 説明 ret RET_CODE インターフェース呼び出し結果 data pandas.DataFrame ret == RET_OK の場合、ランキングデータを返す。ret != RET_OK の場合、エラー説明文字列を返す next_page str 次ページカーソル。データがない場合は None all_count int 総数 data DataFrame フィールド：
フィールド 型 説明 code str オプション契約コード name str オプション名称 option_type str オプションタイプ CALL、PUToi_increment int 増玉 oi_decrement int 減玉 oi_market_cap_increment float 増玉額 oi_market_cap_decrement float 減玉額 volume int 出来高 turnover float 売買代金 open_interest int 建玉 open_interest_market_cap float 建玉額 iv float インプライドボラティリティ（パーセント） option_price float オプション最新価格 change_ratio float 騰落率（パーセント） mid_price float 中間価格 bid_price float 買い価格 bid_volume int 買い数量 ask_price float 売り価格 ask_volume int 売り数量 delta float Delta gamma float Gamma theta float Theta vega float Vega rho float Rho trading_date str 取引日 trading_timestamp float 取引タイムスタンプ
Example
from moomoo import *
quote_ctx = OpenQuoteContext(host='127.0.0.1', port=11111)
# フィルタ使用ガイド（必要に応じてコメント解除、構築後 filter_list に渡す、複数条件は AND 関係）：
# # ① 標的リストフィルタ — 指定標的の契約のみ
# f_owner = OptionRankFilter(OptionRankIndicatorType.OWNER_LIST,
# security_list=['US.TSLA', 'US.AAPL'])
# # ② 確定値フィルタ — ETF 標的 + PUT のみ + アウトオブザマネー契約
# f_cat = OptionRankFilter(OptionRankIndicatorType.STOCK_CATEGORY, value_list=[StockCategory.ETF])
# f_type = OptionRankFilter(OptionRankIndicatorType.OPTION_TYPE, value_list=[2]) # 2=Put
# f_itm = OptionRankFilter(OptionRankIndicatorType.IN_THE_MONEY, value_list=[0]) # 0=OTM
# # ③ 範囲フィルタ — 満期まで 1~30 日、Delta が -0.5 ~ -0.2
# f_days = OptionRankFilter(OptionRankIndicatorType.LEFT_DAYS, interval_min=1, interval_max=30)
# f_delta = OptionRankFilter(OptionRankIndicatorType.DELTA, interval_min=-0.5, interval_max=-0.2)
ret, data, next_page, all_count = quote_ctx.get_option_rank(
OptionMarket.US_SECURITY,
OptionRankType.VOLUME,
count=5
# filter_list=[f_cat, f_type, f_itm, f_days, f_delta] # 複数条件 AND、上で構築したフィルタを渡す
)
if ret == RET_OK:
print(data)
print('all_count:', all_count)
else:
print('error:', data)
quote_ctx.close()
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
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
- Output
code name option_type oi_increment oi_decrement oi_market_cap_increment oi_market_cap_decrement volume turnover open_interest open_interest_market_cap iv option_price change_ratio mid_price bid_price bid_volume ask_price ask_volume delta gamma theta vega rho trading_date trading_timestamp
0 US.SPY260612C742000 SPY 260612 742.00C CALL 1816 N/A 105328.0 N/A 730160 91928623.0 7449 432042.0 146.507 0.58 -67.688 0.580 0.56 28 0.60 1 0.43674 0.27447 -455.46028 0.00385 0.0 2026-06-12 1.781237e+09
1 US.SPY260612C745000 SPY 260612 745.00C CALL 5416 N/A 5416.0 N/A 617981 44479304.0 17013 17013.0 87.067 0.01 -98.958 0.015 0.01 708 0.02 500 0.02438 0.03501 -18.52310 0.00107 0.0 2026-06-12 1.781237e+09
2 US.SPY260612C743000 SPY 260612 743.00C CALL 5438 N/A 48942.0 N/A 606769 64419534.0 7426 66834.0 59.082 0.09 -93.898 0.095 0.09 208 0.10 118 0.13412 0.19487 -50.92453 0.00405 0.0 2026-06-12 1.781237e+09
3 US.SPY260612P740000 SPY 260612 740.00P PUT 1223 N/A 1223.0 N/A 566915 69291991.0 15291 15291.0 53.083 0.01 -99.790 0.015 0.01 447 0.02 407 -0.03761 0.08224 -16.47701 0.00153 0.0 2026-06-12 1.781237e+09
4 US.SPY260612C741000 SPY 260612 741.00C CALL 2924 N/A 423980.0 N/A 506505 88981079.0 6229 903205.0 224.448 1.45 -33.179 1.520 1.46 12 1.58 23 0.63754 0.17055 -662.49947 0.00367 0.0 2026-06-12 1.781237e+09
all_count: 1955829
1
2
3
4
5
6
7
2
3
4
5
6
7
# Qot_GetOptionRank.proto
説明
オプション契約ランキングリストを取得
パラメータ
message C2S
{
required int32 optionMarket = 1; //コーポレートアクションタイプ
required int32 sortType = 2; //Qot_OptionCommon.OptionRankType
optional int32 count = 3; //返却数量[1,200]、デフォルト200
optional string tradingDate = 4; //取引日、フォーマットyyyy-MM-dd
optional bool isAsc = 5; //昇順かどうか、デフォルトfalse
optional string page = 6; //ページングカーソル
repeated Qot_OptionCommon.OptionRankIndicator filterList = 7;
}
message Request
{
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
- 戻り値
message OptionRankItem
{
required Qot_Common.Security option = 1;
optional string name = 2;
optional int32 optionType = 3;
optional int64 oiIncrement = 4;
optional int64 oiDecrement = 5;
optional double oiMarketCapIncrement = 6;
optional double oiMarketCapDecrement = 7;
optional int64 volume = 8;
optional double turnover = 9;
optional int64 openInterest = 10;
optional double openInterestMarketCap = 11;
optional double iv = 12;
optional double optionPrice = 13;
optional double changeRate = 14;
optional double midPrice = 15;
optional double bidPrice = 16;
optional int64 bidVolume = 17;
optional double askPrice = 18;
optional int64 askVolume = 19;
optional double delta = 20;
optional double gamma = 21;
optional double theta = 22;
optional double vega = 23;
optional double rho = 24;
}
message S2C
{
required int32 optionMarket = 1;
required int32 sortType = 2;
optional string tradingDate = 3;
optional double tradingTimestamp = 4;
repeated OptionRankItem rankList = 5;
optional string nextPage = 6;
optional int32 allCount = 7;
}
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
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
41
42
43
44
45
46
- インターフェース呼び出し結果、構造は RetType を参照
プロトコル ID
3306
uint GetOptionRank(Qot_GetOptionRank.Request req); virtual void OnReply_GetOptionRank(MMAPI_Conn client, uint nSerialNo, Qot_GetOptionRank.Response rsp);
説明
オプション契約ランキングリストを取得
パラメータ
message C2S
{
required int32 optionMarket = 1; //コーポレートアクションタイプ
required int32 sortType = 2; //Qot_OptionCommon.OptionRankType
optional int32 count = 3; //返却数量[1,200]、デフォルト200
optional string tradingDate = 4; //取引日、フォーマットyyyy-MM-dd
optional bool isAsc = 5; //昇順かどうか、デフォルトfalse
optional string page = 6; //ページングカーソル
repeated Qot_OptionCommon.OptionRankIndicator filterList = 7;
}
message Request
{
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
- 戻り値
message OptionRankItem
{
required Qot_Common.Security option = 1;
optional string name = 2;
optional int32 optionType = 3;
optional int64 oiIncrement = 4;
optional int64 oiDecrement = 5;
optional double oiMarketCapIncrement = 6;
optional double oiMarketCapDecrement = 7;
optional int64 volume = 8;
optional double turnover = 9;
optional int64 openInterest = 10;
optional double openInterestMarketCap = 11;
optional double iv = 12;
optional double optionPrice = 13;
optional double changeRate = 14;
optional double midPrice = 15;
optional double bidPrice = 16;
optional int64 bidVolume = 17;
optional double askPrice = 18;
optional int64 askVolume = 19;
optional double delta = 20;
optional double gamma = 21;
optional double theta = 22;
optional double vega = 23;
optional double rho = 24;
}
message S2C
{
required int32 optionMarket = 1;
required int32 sortType = 2;
optional string tradingDate = 3;
optional double tradingTimestamp = 4;
repeated OptionRankItem rankList = 5;
optional string nextPage = 6;
optional int32 allCount = 7;
}
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
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
41
42
43
44
45
46
- インターフェース呼び出し結果、構造は RetType を参照
プロトコル ID
3306
Example
public class Program : MMSPI_Qot, MMSPI_Conn
{
MMAPI_Qot qot = new MMAPI_Qot();
public Program()
{
qot.SetClientInfo("csharp", 1);
qot.SetConnCallback(this);
qot.SetQotCallback(this);
}
public void Start()
{
qot.InitConnect("127.0.0.1", (ushort)11111, false);
}
public void OnInitConnect(MMAPI_Conn client, long errCode, String desc)
{
if (errCode != 0) return;
var c2s = Qot_GetOptionRank.C2S.CreateBuilder()
// TODO: 按 proto 填充 c2s 字段
.Build();
var req = Qot_GetOptionRank.Request.CreateBuilder().SetC2S(c2s).Build();
uint seqNo = qot.GetOptionRank(req);
Console.Write("Send GetOptionRank: {0}\n", seqNo);
}
public void OnReply_GetOptionRank(MMAPI_Conn client, uint nSerialNo, Qot_GetOptionRank.Response rsp)
{
Console.Write("Reply: {0} {1}\n", nSerialNo, rsp.ToString());
}
public static void Main(String[] args)
{
MMAPI.Init();
new Program().Start();
while (true) Thread.Sleep(1000 * 600);
}
}
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
- Output
Send GetOptionRank: 1
Reply: 1 { "market": 1, "code": "SPY260612C745000" },
"name": "SPY 260612 745.00C",
"optionType": 1,
"oiIncrement": 5416,
"volume": 617981,
"turnover": 44479304,
"openInterest": 17013,
"iv": 87.067,
"optionPrice": 0.01,
"changeRate": -98.958,
"midPrice": 0.015,
"bidPrice": 0.01,
"bidVolume": 708,
"askPrice": 0.02,
"askVolume": 500,
"delta": 0.02438,
"gamma": 0.03501,
"theta": -18.5231,
"vega": 0.00107,
"rho": 0
}
],
"allCount": 1955829
}
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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
int getOptionRank(Qot_GetOptionRank.Request req) onReply_GetOptionRank(MMAPI_Conn client, int nSerialNo, Qot_GetOptionRank.Response rsp)
説明
オプション契約ランキングリストを取得
パラメータ
message C2S
{
required int32 optionMarket = 1; //コーポレートアクションタイプ
required int32 sortType = 2; //Qot_OptionCommon.OptionRankType
optional int32 count = 3; //返却数量[1,200]、デフォルト200
optional string tradingDate = 4; //取引日、フォーマットyyyy-MM-dd
optional bool isAsc = 5; //昇順かどうか、デフォルトfalse
optional string page = 6; //ページングカーソル
repeated Qot_OptionCommon.OptionRankIndicator filterList = 7;
}
message Request
{
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
- 戻り値
message OptionRankItem
{
required Qot_Common.Security option = 1;
optional string name = 2;
optional int32 optionType = 3;
optional int64 oiIncrement = 4;
optional int64 oiDecrement = 5;
optional double oiMarketCapIncrement = 6;
optional double oiMarketCapDecrement = 7;
optional int64 volume = 8;
optional double turnover = 9;
optional int64 openInterest = 10;
optional double openInterestMarketCap = 11;
optional double iv = 12;
optional double optionPrice = 13;
optional double changeRate = 14;
optional double midPrice = 15;
optional double bidPrice = 16;
optional int64 bidVolume = 17;
optional double askPrice = 18;
optional int64 askVolume = 19;
optional double delta = 20;
optional double gamma = 21;
optional double theta = 22;
optional double vega = 23;
optional double rho = 24;
}
message S2C
{
required int32 optionMarket = 1;
required int32 sortType = 2;
optional string tradingDate = 3;
optional double tradingTimestamp = 4;
repeated OptionRankItem rankList = 5;
optional string nextPage = 6;
optional int32 allCount = 7;
}
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
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
41
42
43
44
45
46
- インターフェース呼び出し結果、構造は RetType を参照
プロトコル ID
3306
Example
public class Program implements MMSPI_Qot, MMSPI_Conn {
private MMAPI_Conn_Qot qot = new MMAPI_Conn_Qot();
public Program() {
qot.setClientInfo("java", 1);
qot.setConnCallback(this);
qot.setQotCallback(this);
}
public void start() {
qot.initConnect("127.0.0.1", (short) 11111, false);
}
@Override
public void onInitConnect(MMAPI_Conn client, long errCode, String desc) {
if (errCode != 0) return;
Qot_GetOptionRank.C2S c2s = Qot_GetOptionRank.C2S.newBuilder()
// TODO: 按 proto 填充 c2s 字段
.build();
Qot_GetOptionRank.Request req = Qot_GetOptionRank.Request.newBuilder()
.setC2S(c2s).build();
int seqNo = qot.getOptionRank(req);
System.out.println("Send getOptionRank: " + seqNo);
}
@Override
public void onReply_GetOptionRank(MMAPI_Conn client, int nSerialNo, Qot_GetOptionRank.Response rsp) {
System.out.println("Reply: " + nSerialNo + " " + rsp.toString());
}
public static void main(String[] args) {
MMAPI.init();
new Program().start();
while (true) {
try { Thread.sleep(1000 * 600); } catch (InterruptedException e) {}
}
}
}
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
- Output
Send getOptionRank: 1
Reply: 1 { "market": 1, "code": "SPY260612C745000" },
"name": "SPY 260612 745.00C",
"optionType": 1,
"oiIncrement": 5416,
"volume": 617981,
"turnover": 44479304,
"openInterest": 17013,
"iv": 87.067,
"optionPrice": 0.01,
"changeRate": -98.958,
"midPrice": 0.015,
"bidPrice": 0.01,
"bidVolume": 708,
"askPrice": 0.02,
"askVolume": 500,
"delta": 0.02438,
"gamma": 0.03501,
"theta": -18.5231,
"vega": 0.00107,
"rho": 0
}
],
"allCount": 1955829
}
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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
Moomoo::u32_t GetOptionRank(const Qot_GetOptionRank::Request &stReq);
virtual void OnReply_GetOptionRank(Moomoo::u32_t nSerialNo, const Qot_GetOptionRank::Response &stRsp) = 0;
説明
オプション契約ランキングリストを取得
パラメータ
message C2S
{
required int32 optionMarket = 1; //コーポレートアクションタイプ
required int32 sortType = 2; //Qot_OptionCommon.OptionRankType
optional int32 count = 3; //返却数量[1,200]、デフォルト200
optional string tradingDate = 4; //取引日、フォーマットyyyy-MM-dd
optional bool isAsc = 5; //昇順かどうか、デフォルトfalse
optional string page = 6; //ページングカーソル
repeated Qot_OptionCommon.OptionRankIndicator filterList = 7;
}
message Request
{
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
- 戻り値
message OptionRankItem
{
required Qot_Common.Security option = 1;
optional string name = 2;
optional int32 optionType = 3;
optional int64 oiIncrement = 4;
optional int64 oiDecrement = 5;
optional double oiMarketCapIncrement = 6;
optional double oiMarketCapDecrement = 7;
optional int64 volume = 8;
optional double turnover = 9;
optional int64 openInterest = 10;
optional double openInterestMarketCap = 11;
optional double iv = 12;
optional double optionPrice = 13;
optional double changeRate = 14;
optional double midPrice = 15;
optional double bidPrice = 16;
optional int64 bidVolume = 17;
optional double askPrice = 18;
optional int64 askVolume = 19;
optional double delta = 20;
optional double gamma = 21;
optional double theta = 22;
optional double vega = 23;
optional double rho = 24;
}
message S2C
{
required int32 optionMarket = 1;
required int32 sortType = 2;
optional string tradingDate = 3;
optional double tradingTimestamp = 4;
repeated OptionRankItem rankList = 5;
optional string nextPage = 6;
optional int32 allCount = 7;
}
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
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
41
42
43
44
45
46
- インターフェース呼び出し結果、構造は RetType を参照
プロトコル ID
3306
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_GetOptionRank::Request req;
Qot_GetOptionRank::C2S *c2s = req.mutable_c2s();
// TODO: 按 proto 填充 c2s 字段
m_GetOptionRankSerialNo = m_pQotApi->GetOptionRank(req);
}
virtual void OnReply_GetOptionRank(Moomoo::u32_t nSerialNo, const Qot_GetOptionRank::Response &stRsp) {
if (nSerialNo != m_GetOptionRankSerialNo) return;
string resp_str;
ProtoBufToBodyData(stRsp, resp_str);
cout << UTF8ToLocal(resp_str) << endl;
}
protected:
MMAPI_Qot *m_pQotApi;
Moomoo::u32_t m_GetOptionRankSerialNo = 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
getOptionRank(qotGetOptionRank)
説明
オプション契約ランキングリストを取得
パラメータ
message C2S
{
required int32 optionMarket = 1; //コーポレートアクションタイプ
required int32 sortType = 2; //Qot_OptionCommon.OptionRankType
optional int32 count = 3; //返却数量[1,200]、デフォルト200
optional string tradingDate = 4; //取引日、フォーマットyyyy-MM-dd
optional bool isAsc = 5; //昇順かどうか、デフォルトfalse
optional string page = 6; //ページングカーソル
repeated Qot_OptionCommon.OptionRankIndicator filterList = 7;
}
message Request
{
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
- 戻り値
message OptionRankItem
{
required Qot_Common.Security option = 1;
optional string name = 2;
optional int32 optionType = 3;
optional int64 oiIncrement = 4;
optional int64 oiDecrement = 5;
optional double oiMarketCapIncrement = 6;
optional double oiMarketCapDecrement = 7;
optional int64 volume = 8;
optional double turnover = 9;
optional int64 openInterest = 10;
optional double openInterestMarketCap = 11;
optional double iv = 12;
optional double optionPrice = 13;
optional double changeRate = 14;
optional double midPrice = 15;
optional double bidPrice = 16;
optional int64 bidVolume = 17;
optional double askPrice = 18;
optional int64 askVolume = 19;
optional double delta = 20;
optional double gamma = 21;
optional double theta = 22;
optional double vega = 23;
optional double rho = 24;
}
message S2C
{
required int32 optionMarket = 1;
required int32 sortType = 2;
optional string tradingDate = 3;
optional double tradingTimestamp = 4;
repeated OptionRankItem rankList = 5;
optional string nextPage = 6;
optional int32 allCount = 7;
}
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
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
41
42
43
44
45
46
- インターフェース呼び出し結果、構造は RetType を参照
プロトコル ID
3306
Example
import mmWebsocket from "moomoo-api";
import { Common, Qot_OptionCommon } from "moomoo-api/proto";
import beautify from "js-beautify";
function QotGetOptionRank(){
const { RetType } = Common
const { OptionMarket, OptionRankType } = Qot_OptionCommon
let [addr, port, enable_ssl, key] = ["127.0.0.1", 11112, false, ''];
let websocket = new mmWebsocket();
websocket.onlogin = (ret, msg)=>{
if (ret) {
const req = {
c2s: {
optionMarket: OptionMarket.OptionMarket_US_Security,
sortType: OptionRankType.OptionRankType_Volume,
count: 5,
},
};
websocket.GetOptionRank(req)
.then((res)=>{
let { errCode, retMsg, retType, s2c } = res
console.log("GetOptionRank: 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);
}
QotGetOptionRank()
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
GetOptionRank: errCode 0, retMsg , retType 0
{
"optionMarket": 1,
"sortType": 1,
"tradingDate": "2026-06-12",
"tradingTimestamp": 1781237000,
"rankList": [
{
"option": { "market": 1, "code": "SPY260612C742000" },
"name": "SPY 260612 742.00C",
"optionType": 1,
"oiIncrement": 1816,
"volume": 730160,
"turnover": 91928623,
"openInterest": 7449,
"iv": 146.507,
"optionPrice": 0.58,
"changeRate": -67.688,
"midPrice": 0.58,
"bidPrice": 0.56,
"bidVolume": 28,
"askPrice": 0.6,
"askVolume": 1,
"delta": 0.43674,
"gamma": 0.27447,
"theta": -455.46028,
"vega": 0.00385,
"rho": 0
},
{
"option": { "market": 1, "code": "SPY260612C745000" },
"name": "SPY 260612 745.00C",
"optionType": 1,
"oiIncrement": 5416,
"volume": 617981,
"turnover": 44479304,
"openInterest": 17013,
"iv": 87.067,
"optionPrice": 0.01,
"changeRate": -98.958,
"midPrice": 0.015,
"bidPrice": 0.01,
"bidVolume": 708,
"askPrice": 0.02,
"askVolume": 500,
"delta": 0.02438,
"gamma": 0.03501,
"theta": -18.5231,
"vega": 0.00107,
"rho": 0
}
],
"allCount": 1955829
}
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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
インターフェース制限
- 30秒以内に最大60回のオプション契約ランキングインターフェースリクエスト（ページング対応のインターフェースは初回呼び出しのみカウント）