# オプション原資産履歴統計
- Python
- Proto
- C#
- Java
- C++
- JavaScript
get_option_underlying_his_statistic(code, index_option_type=IndexOptionType.NORMAL, begin_time=None, end_time=None, page_req_key=None)
説明
オプション原資産の履歴統計データを取得します。取引日単位で該当原資産に対応するオプションの出来高、建玉および Put/Call 比率の時系列を返します。ページネーション対応。
パラメータ
パラメータ 型 説明 code str 原資産銘柄コード 例：'US.AAPL'index_option_type IndexOptionType 指数オプションタイプ NORMAL=通常オプション（デフォルト）、SMALL=ミニ指数オプションbegin_time str 開始日付、フォーマット 'YYYY-MM-DD' 未指定の場合、デフォルトで end_time から364日前end_time str 終了日付、フォーマット 'YYYY-MM-DD' begin_time との期間は最大364日page_req_key bytes ページングリクエストキー 初回は None、続きは前回の戻り値を渡す戻り値
パラメータ 型 説明 ret RET_CODE インターフェース呼び出し結果 data pandas.DataFrame ret == RET_OK の場合、統計データを返す str ret != RET_OK の場合、エラー説明を返す page_req_key bytes 次ページキー、None はデータなし 戻り DataFrame フィールド：
フィールド 型 説明 code str 銘柄コード name str 銘柄名称 time str 取引日時間文字列 timestamp float 取引日タイムスタンプ（Unix 秒） option_volume int オプション総出来高（call_volume + put_volume） call_volume int コールオプション出来高 put_volume int プットオプション出来高 put_call_volume_ratio float Put/Call 出来高比率 option_open_interest int オプション総建玉 call_open_interest int コールオプション建玉（T-1 遅延） put_open_interest int プットオプション建玉（T-1 遅延） put_call_open_interest_ratio float Put/Call 建玉比率 underlying_price float 原資産価格
Example
from futu import *
quote_ctx = OpenQuoteContext(host='127.0.0.1', port=11111)
ret, data, page_req_key = quote_ctx.get_option_underlying_his_statistic(
'US.AAPL',
begin_time='2026-06-01',
end_time='2026-06-15'
)
if ret == RET_OK:
print(data)
else:
print('error:', data)
quote_ctx.close()
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
- Output
code name time timestamp option_volume call_volume put_volume put_call_volume_ratio option_open_interest call_open_interest put_open_interest put_call_open_interest_ratio underlying_price
0 US.AAPL Apple 2026-06-12 1.781237e+09 1273240 782941 490299 0.626227 0 0 0 N/A 291.13
1 US.AAPL Apple 2026-06-11 1.781150e+09 950737 580535 370202 0.637691 5403058 3165108 2237950 0.707069 295.63
2 US.AAPL Apple 2026-06-10 1.781064e+09 1734799 1039630 695169 0.668670 5522747 3270454 2252293 0.688679 291.58
3 US.AAPL Apple 2026-06-09 1.780978e+09 1715749 1024046 691703 0.675461 5405022 3209586 2195436 0.684025 290.55
4 US.AAPL Apple 2026-06-08 1.780891e+09 2179789 1293656 886133 0.684983 5350402 3142828 2207574 0.702416 301.54
...
1
2
3
4
5
6
7
2
3
4
5
6
7
# Qot_GetOptionUnderlyingHisStatistic.proto
説明
オプション原資産の履歴統計データを取得
パラメータ
message C2S
{
required Qot_Common.Security owner = 1; //オプション原資産
optional int32 indexOptionType = 2; //Qot_Common.IndexOptionType
required string beginTime = 3; //開始時間文字列
required string endTime = 4; //終了時間文字列
optional bytes nextPageKey = 5; //ページングリクエストのキー
}
message Request
{
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
- 戻り値
message DailyStatistic
{
required string time = 1; //取引日時間文字列
optional double timestamp = 2; //取引日タイムスタンプ
optional int64 optionVolume = 3; //オプション総出来高
required int64 callVolume = 4; //コールオプション出来高
required int64 putVolume = 5; //プットオプション出来高
optional double putCallVolumeRatio = 6; //Put/Call出来高比率
optional int64 optionOpenInterest = 7; //オプション総建玉
required int64 callOpenInterest = 8; //コールオプション建玉
required int64 putOpenInterest = 9; //プットオプション建玉
optional double putCallOpenInterestRatio = 10; //Put/Call建玉比率
optional double underlyingPrice = 11; //原資産価格
}
message S2C
{
required Qot_Common.Security owner = 1; //オプション原資産
optional string code = 2; //銘柄コード
optional string name = 3; //銘柄名称
repeated DailyStatistic statisticList = 4; //統計データリスト、取引日降順
optional bytes nextPageKey = 5; //ページングリクエストのキー
}
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
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
- インターフェース呼び出し結果、構造は RetType を参照
プロトコル ID
3302
uint GetOptionUnderlyingHisStatistic(Qot_GetOptionUnderlyingHisStatistic.Request req); virtual void OnReply_GetOptionUnderlyingHisStatistic(FTAPI_Conn client, uint nSerialNo, Qot_GetOptionUnderlyingHisStatistic.Response rsp);
説明
オプション原資産の履歴統計データを取得
パラメータ
message C2S
{
required Qot_Common.Security owner = 1; //オプション原資産
optional int32 indexOptionType = 2; //Qot_Common.IndexOptionType
required string beginTime = 3; //開始時間文字列
required string endTime = 4; //終了時間文字列
optional bytes nextPageKey = 5; //ページングリクエストのキー
}
message Request
{
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
- 戻り値
message DailyStatistic
{
required string time = 1; //取引日時間文字列
optional double timestamp = 2; //取引日タイムスタンプ
optional int64 optionVolume = 3; //オプション総出来高
required int64 callVolume = 4; //コールオプション出来高
required int64 putVolume = 5; //プットオプション出来高
optional double putCallVolumeRatio = 6; //Put/Call出来高比率
optional int64 optionOpenInterest = 7; //オプション総建玉
required int64 callOpenInterest = 8; //コールオプション建玉
required int64 putOpenInterest = 9; //プットオプション建玉
optional double putCallOpenInterestRatio = 10; //Put/Call建玉比率
optional double underlyingPrice = 11; //原資産価格
}
message S2C
{
required Qot_Common.Security owner = 1; //オプション原資産
optional string code = 2; //銘柄コード
optional string name = 3; //銘柄名称
repeated DailyStatistic statisticList = 4; //統計データリスト、取引日降順
optional bytes nextPageKey = 5; //ページングリクエストのキー
}
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
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
- インターフェース呼び出し結果、構造は RetType を参照
プロトコル ID
3302
int getOptionUnderlyingHisStatistic(Qot_GetOptionUnderlyingHisStatistic.Request req) onReply_GetOptionUnderlyingHisStatistic(FTAPI_Conn client, int nSerialNo, Qot_GetOptionUnderlyingHisStatistic.Response rsp)
説明
オプション原資産の履歴統計データを取得
パラメータ
message C2S
{
required Qot_Common.Security owner = 1; //オプション原資産
optional int32 indexOptionType = 2; //Qot_Common.IndexOptionType
required string beginTime = 3; //開始時間文字列
required string endTime = 4; //終了時間文字列
optional bytes nextPageKey = 5; //ページングリクエストのキー
}
message Request
{
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
- 戻り値
message DailyStatistic
{
required string time = 1; //取引日時間文字列
optional double timestamp = 2; //取引日タイムスタンプ
optional int64 optionVolume = 3; //オプション総出来高
required int64 callVolume = 4; //コールオプション出来高
required int64 putVolume = 5; //プットオプション出来高
optional double putCallVolumeRatio = 6; //Put/Call出来高比率
optional int64 optionOpenInterest = 7; //オプション総建玉
required int64 callOpenInterest = 8; //コールオプション建玉
required int64 putOpenInterest = 9; //プットオプション建玉
optional double putCallOpenInterestRatio = 10; //Put/Call建玉比率
optional double underlyingPrice = 11; //原資産価格
}
message S2C
{
required Qot_Common.Security owner = 1; //オプション原資産
optional string code = 2; //銘柄コード
optional string name = 3; //銘柄名称
repeated DailyStatistic statisticList = 4; //統計データリスト、取引日降順
optional bytes nextPageKey = 5; //ページングリクエストのキー
}
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
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
- インターフェース呼び出し結果、構造は RetType を参照
プロトコル ID
3302
Futu::u32_t GetOptionUnderlyingHisStatistic(const Qot_GetOptionUnderlyingHisStatistic::Request &stReq);
virtual void OnReply_GetOptionUnderlyingHisStatistic(Futu::u32_t nSerialNo, const Qot_GetOptionUnderlyingHisStatistic::Response &stRsp) = 0;
説明
オプション原資産の履歴統計データを取得
パラメータ
message C2S
{
required Qot_Common.Security owner = 1; //オプション原資産
optional int32 indexOptionType = 2; //Qot_Common.IndexOptionType
required string beginTime = 3; //開始時間文字列
required string endTime = 4; //終了時間文字列
optional bytes nextPageKey = 5; //ページングリクエストのキー
}
message Request
{
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
- 戻り値
message DailyStatistic
{
required string time = 1; //取引日時間文字列
optional double timestamp = 2; //取引日タイムスタンプ
optional int64 optionVolume = 3; //オプション総出来高
required int64 callVolume = 4; //コールオプション出来高
required int64 putVolume = 5; //プットオプション出来高
optional double putCallVolumeRatio = 6; //Put/Call出来高比率
optional int64 optionOpenInterest = 7; //オプション総建玉
required int64 callOpenInterest = 8; //コールオプション建玉
required int64 putOpenInterest = 9; //プットオプション建玉
optional double putCallOpenInterestRatio = 10; //Put/Call建玉比率
optional double underlyingPrice = 11; //原資産価格
}
message S2C
{
required Qot_Common.Security owner = 1; //オプション原資産
optional string code = 2; //銘柄コード
optional string name = 3; //銘柄名称
repeated DailyStatistic statisticList = 4; //統計データリスト、取引日降順
optional bytes nextPageKey = 5; //ページングリクエストのキー
}
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
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
- インターフェース呼び出し結果、構造は RetType を参照
プロトコル ID
3302
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_GetOptionUnderlyingHisStatistic::Request req;
Qot_GetOptionUnderlyingHisStatistic::C2S *c2s = req.mutable_c2s();
// TODO: 按 proto 填充 c2s 字段
m_GetOptionUnderlyingHisStatisticSerialNo = m_pQotApi->GetOptionUnderlyingHisStatistic(req);
}
virtual void OnReply_GetOptionUnderlyingHisStatistic(Futu::u32_t nSerialNo, const Qot_GetOptionUnderlyingHisStatistic::Response &stRsp) {
if (nSerialNo != m_GetOptionUnderlyingHisStatisticSerialNo) return;
string resp_str;
ProtoBufToBodyData(stRsp, resp_str);
cout << UTF8ToLocal(resp_str) << endl;
}
protected:
FTAPI_Qot *m_pQotApi;
Futu::u32_t m_GetOptionUnderlyingHisStatisticSerialNo = 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
getOptionUnderlyingHisStatistic(qotGetOptionUnderlyingHisStatistic)
説明
オプション原資産の履歴統計データを取得
パラメータ
message C2S
{
required Qot_Common.Security owner = 1; //オプション原資産
optional int32 indexOptionType = 2; //Qot_Common.IndexOptionType
required string beginTime = 3; //開始時間文字列
required string endTime = 4; //終了時間文字列
optional bytes nextPageKey = 5; //ページングリクエストのキー
}
message Request
{
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
- 戻り値
message DailyStatistic
{
required string time = 1; //取引日時間文字列
optional double timestamp = 2; //取引日タイムスタンプ
optional int64 optionVolume = 3; //オプション総出来高
required int64 callVolume = 4; //コールオプション出来高
required int64 putVolume = 5; //プットオプション出来高
optional double putCallVolumeRatio = 6; //Put/Call出来高比率
optional int64 optionOpenInterest = 7; //オプション総建玉
required int64 callOpenInterest = 8; //コールオプション建玉
required int64 putOpenInterest = 9; //プットオプション建玉
optional double putCallOpenInterestRatio = 10; //Put/Call建玉比率
optional double underlyingPrice = 11; //原資産価格
}
message S2C
{
required Qot_Common.Security owner = 1; //オプション原資産
optional string code = 2; //銘柄コード
optional string name = 3; //銘柄名称
repeated DailyStatistic statisticList = 4; //統計データリスト、取引日降順
optional bytes nextPageKey = 5; //ページングリクエストのキー
}
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
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
- インターフェース呼び出し結果、構造は RetType を参照
プロトコル ID
3302
Example
import ftWebsocket from "futu-api";
import { Common, Qot_Common } from "futu-api/proto";
import beautify from "js-beautify";
function QotGetOptionUnderlyingHisStatistic(){
const { RetType } = Common
const { QotMarket } = Qot_Common
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: {
owner: { market: QotMarket.QotMarket_US_Security, code: 'AAPL' },
beginTime: '2026-06-01',
endTime: '2026-06-15',
},
};
websocket.GetOptionUnderlyingHisStatistic(req)
.then((res)=>{
let { errCode, retMsg, retType, s2c } = res
console.log("GetOptionUnderlyingHisStatistic: 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);
}
QotGetOptionUnderlyingHisStatistic()
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
GetOptionUnderlyingHisStatistic: errCode 0, retMsg , retType 0
{
"owner": { "market": 1, "code": "AAPL" },
"code": "US.AAPL",
"name": "Apple",
"statisticList": [
{
"time": "2026-06-12",
"timestamp": 1781237000,
"optionVolume": 1273240,
"callVolume": 782941,
"putVolume": 490299,
"putCallVolumeRatio": 0.626227,
"callOpenInterest": 0,
"putOpenInterest": 0,
"underlyingPrice": 291.13
},
{
"time": "2026-06-11",
"timestamp": 1781150000,
"optionVolume": 950737,
"callVolume": 580535,
"putVolume": 370202,
"putCallVolumeRatio": 0.637691,
"optionOpenInterest": 5403058,
"callOpenInterest": 3165108,
"putOpenInterest": 2237950,
"putCallOpenInterestRatio": 0.707069,
"underlyingPrice": 295.63
}
]
}
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
インターフェース制限
- 30秒以内に最大60回のオプション原資産履歴統計インターフェースリクエスト（ページング対応のインターフェースは初回呼び出しのみカウント）
- Python
- Proto
- C#
- Java
- C++
- JavaScript
get_option_underlying_his_statistic(code, index_option_type=IndexOptionType.NORMAL, begin_time=None, end_time=None, page_req_key=None)
説明
オプション原資産の履歴統計データを取得します。取引日単位で該当原資産に対応するオプションの出来高、建玉および Put/Call 比率の時系列を返します。ページネーション対応。
パラメータ
パラメータ 型 説明 code str 原資産銘柄コード 例：'US.AAPL'index_option_type IndexOptionType 指数オプションタイプ NORMAL=通常オプション（デフォルト）、SMALL=ミニ指数オプションbegin_time str 開始日付、フォーマット 'YYYY-MM-DD' 未指定の場合、デフォルトで end_time から364日前end_time str 終了日付、フォーマット 'YYYY-MM-DD' begin_time との期間は最大364日page_req_key bytes ページングリクエストキー 初回は None、続きは前回の戻り値を渡す戻り値
パラメータ 型 説明 ret RET_CODE インターフェース呼び出し結果 data pandas.DataFrame ret == RET_OK の場合、統計データを返す str ret != RET_OK の場合、エラー説明を返す page_req_key bytes 次ページキー、None はデータなし 戻り DataFrame フィールド：
フィールド 型 説明 code str 銘柄コード name str 銘柄名称 time str 取引日時間文字列 timestamp float 取引日タイムスタンプ（Unix 秒） option_volume int オプション総出来高（call_volume + put_volume） call_volume int コールオプション出来高 put_volume int プットオプション出来高 put_call_volume_ratio float Put/Call 出来高比率 option_open_interest int オプション総建玉 call_open_interest int コールオプション建玉（T-1 遅延） put_open_interest int プットオプション建玉（T-1 遅延） put_call_open_interest_ratio float Put/Call 建玉比率 underlying_price float 原資産価格
Example
from moomoo import *
quote_ctx = OpenQuoteContext(host='127.0.0.1', port=11111)
ret, data, page_req_key = quote_ctx.get_option_underlying_his_statistic(
'US.AAPL',
begin_time='2026-06-01',
end_time='2026-06-15'
)
if ret == RET_OK:
print(data)
else:
print('error:', data)
quote_ctx.close()
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
- Output
code name time timestamp option_volume call_volume put_volume put_call_volume_ratio option_open_interest call_open_interest put_open_interest put_call_open_interest_ratio underlying_price
0 US.AAPL Apple 2026-06-12 1.781237e+09 1273240 782941 490299 0.626227 0 0 0 N/A 291.13
1 US.AAPL Apple 2026-06-11 1.781150e+09 950737 580535 370202 0.637691 5403058 3165108 2237950 0.707069 295.63
2 US.AAPL Apple 2026-06-10 1.781064e+09 1734799 1039630 695169 0.668670 5522747 3270454 2252293 0.688679 291.58
3 US.AAPL Apple 2026-06-09 1.780978e+09 1715749 1024046 691703 0.675461 5405022 3209586 2195436 0.684025 290.55
4 US.AAPL Apple 2026-06-08 1.780891e+09 2179789 1293656 886133 0.684983 5350402 3142828 2207574 0.702416 301.54
...
1
2
3
4
5
6
7
2
3
4
5
6
7
# Qot_GetOptionUnderlyingHisStatistic.proto
説明
オプション原資産の履歴統計データを取得
パラメータ
message C2S
{
required Qot_Common.Security owner = 1; //オプション原資産
optional int32 indexOptionType = 2; //Qot_Common.IndexOptionType
required string beginTime = 3; //開始時間文字列
required string endTime = 4; //終了時間文字列
optional bytes nextPageKey = 5; //ページングリクエストのキー
}
message Request
{
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
- 戻り値
message DailyStatistic
{
required string time = 1; //取引日時間文字列
optional double timestamp = 2; //取引日タイムスタンプ
optional int64 optionVolume = 3; //オプション総出来高
required int64 callVolume = 4; //コールオプション出来高
required int64 putVolume = 5; //プットオプション出来高
optional double putCallVolumeRatio = 6; //Put/Call出来高比率
optional int64 optionOpenInterest = 7; //オプション総建玉
required int64 callOpenInterest = 8; //コールオプション建玉
required int64 putOpenInterest = 9; //プットオプション建玉
optional double putCallOpenInterestRatio = 10; //Put/Call建玉比率
optional double underlyingPrice = 11; //原資産価格
}
message S2C
{
required Qot_Common.Security owner = 1; //オプション原資産
optional string code = 2; //銘柄コード
optional string name = 3; //銘柄名称
repeated DailyStatistic statisticList = 4; //統計データリスト、取引日降順
optional bytes nextPageKey = 5; //ページングリクエストのキー
}
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
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
- インターフェース呼び出し結果、構造は RetType を参照
プロトコル ID
3302
uint GetOptionUnderlyingHisStatistic(Qot_GetOptionUnderlyingHisStatistic.Request req); virtual void OnReply_GetOptionUnderlyingHisStatistic(MMAPI_Conn client, uint nSerialNo, Qot_GetOptionUnderlyingHisStatistic.Response rsp);
説明
オプション原資産の履歴統計データを取得
パラメータ
message C2S
{
required Qot_Common.Security owner = 1; //オプション原資産
optional int32 indexOptionType = 2; //Qot_Common.IndexOptionType
required string beginTime = 3; //開始時間文字列
required string endTime = 4; //終了時間文字列
optional bytes nextPageKey = 5; //ページングリクエストのキー
}
message Request
{
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
- 戻り値
message DailyStatistic
{
required string time = 1; //取引日時間文字列
optional double timestamp = 2; //取引日タイムスタンプ
optional int64 optionVolume = 3; //オプション総出来高
required int64 callVolume = 4; //コールオプション出来高
required int64 putVolume = 5; //プットオプション出来高
optional double putCallVolumeRatio = 6; //Put/Call出来高比率
optional int64 optionOpenInterest = 7; //オプション総建玉
required int64 callOpenInterest = 8; //コールオプション建玉
required int64 putOpenInterest = 9; //プットオプション建玉
optional double putCallOpenInterestRatio = 10; //Put/Call建玉比率
optional double underlyingPrice = 11; //原資産価格
}
message S2C
{
required Qot_Common.Security owner = 1; //オプション原資産
optional string code = 2; //銘柄コード
optional string name = 3; //銘柄名称
repeated DailyStatistic statisticList = 4; //統計データリスト、取引日降順
optional bytes nextPageKey = 5; //ページングリクエストのキー
}
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
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
- インターフェース呼び出し結果、構造は RetType を参照
プロトコル ID
3302
int getOptionUnderlyingHisStatistic(Qot_GetOptionUnderlyingHisStatistic.Request req) onReply_GetOptionUnderlyingHisStatistic(MMAPI_Conn client, int nSerialNo, Qot_GetOptionUnderlyingHisStatistic.Response rsp)
説明
オプション原資産の履歴統計データを取得
パラメータ
message C2S
{
required Qot_Common.Security owner = 1; //オプション原資産
optional int32 indexOptionType = 2; //Qot_Common.IndexOptionType
required string beginTime = 3; //開始時間文字列
required string endTime = 4; //終了時間文字列
optional bytes nextPageKey = 5; //ページングリクエストのキー
}
message Request
{
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
- 戻り値
message DailyStatistic
{
required string time = 1; //取引日時間文字列
optional double timestamp = 2; //取引日タイムスタンプ
optional int64 optionVolume = 3; //オプション総出来高
required int64 callVolume = 4; //コールオプション出来高
required int64 putVolume = 5; //プットオプション出来高
optional double putCallVolumeRatio = 6; //Put/Call出来高比率
optional int64 optionOpenInterest = 7; //オプション総建玉
required int64 callOpenInterest = 8; //コールオプション建玉
required int64 putOpenInterest = 9; //プットオプション建玉
optional double putCallOpenInterestRatio = 10; //Put/Call建玉比率
optional double underlyingPrice = 11; //原資産価格
}
message S2C
{
required Qot_Common.Security owner = 1; //オプション原資産
optional string code = 2; //銘柄コード
optional string name = 3; //銘柄名称
repeated DailyStatistic statisticList = 4; //統計データリスト、取引日降順
optional bytes nextPageKey = 5; //ページングリクエストのキー
}
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
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
- インターフェース呼び出し結果、構造は RetType を参照
プロトコル ID
3302
Moomoo::u32_t GetOptionUnderlyingHisStatistic(const Qot_GetOptionUnderlyingHisStatistic::Request &stReq);
virtual void OnReply_GetOptionUnderlyingHisStatistic(Moomoo::u32_t nSerialNo, const Qot_GetOptionUnderlyingHisStatistic::Response &stRsp) = 0;
説明
オプション原資産の履歴統計データを取得
パラメータ
message C2S
{
required Qot_Common.Security owner = 1; //オプション原資産
optional int32 indexOptionType = 2; //Qot_Common.IndexOptionType
required string beginTime = 3; //開始時間文字列
required string endTime = 4; //終了時間文字列
optional bytes nextPageKey = 5; //ページングリクエストのキー
}
message Request
{
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
- 戻り値
message DailyStatistic
{
required string time = 1; //取引日時間文字列
optional double timestamp = 2; //取引日タイムスタンプ
optional int64 optionVolume = 3; //オプション総出来高
required int64 callVolume = 4; //コールオプション出来高
required int64 putVolume = 5; //プットオプション出来高
optional double putCallVolumeRatio = 6; //Put/Call出来高比率
optional int64 optionOpenInterest = 7; //オプション総建玉
required int64 callOpenInterest = 8; //コールオプション建玉
required int64 putOpenInterest = 9; //プットオプション建玉
optional double putCallOpenInterestRatio = 10; //Put/Call建玉比率
optional double underlyingPrice = 11; //原資産価格
}
message S2C
{
required Qot_Common.Security owner = 1; //オプション原資産
optional string code = 2; //銘柄コード
optional string name = 3; //銘柄名称
repeated DailyStatistic statisticList = 4; //統計データリスト、取引日降順
optional bytes nextPageKey = 5; //ページングリクエストのキー
}
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
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
- インターフェース呼び出し結果、構造は RetType を参照
プロトコル ID
3302
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_GetOptionUnderlyingHisStatistic::Request req;
Qot_GetOptionUnderlyingHisStatistic::C2S *c2s = req.mutable_c2s();
// TODO: 按 proto 填充 c2s 字段
m_GetOptionUnderlyingHisStatisticSerialNo = m_pQotApi->GetOptionUnderlyingHisStatistic(req);
}
virtual void OnReply_GetOptionUnderlyingHisStatistic(Moomoo::u32_t nSerialNo, const Qot_GetOptionUnderlyingHisStatistic::Response &stRsp) {
if (nSerialNo != m_GetOptionUnderlyingHisStatisticSerialNo) return;
string resp_str;
ProtoBufToBodyData(stRsp, resp_str);
cout << UTF8ToLocal(resp_str) << endl;
}
protected:
MMAPI_Qot *m_pQotApi;
Moomoo::u32_t m_GetOptionUnderlyingHisStatisticSerialNo = 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
getOptionUnderlyingHisStatistic(qotGetOptionUnderlyingHisStatistic)
説明
オプション原資産の履歴統計データを取得
パラメータ
message C2S
{
required Qot_Common.Security owner = 1; //オプション原資産
optional int32 indexOptionType = 2; //Qot_Common.IndexOptionType
required string beginTime = 3; //開始時間文字列
required string endTime = 4; //終了時間文字列
optional bytes nextPageKey = 5; //ページングリクエストのキー
}
message Request
{
required C2S c2s = 1;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
- 戻り値
message DailyStatistic
{
required string time = 1; //取引日時間文字列
optional double timestamp = 2; //取引日タイムスタンプ
optional int64 optionVolume = 3; //オプション総出来高
required int64 callVolume = 4; //コールオプション出来高
required int64 putVolume = 5; //プットオプション出来高
optional double putCallVolumeRatio = 6; //Put/Call出来高比率
optional int64 optionOpenInterest = 7; //オプション総建玉
required int64 callOpenInterest = 8; //コールオプション建玉
required int64 putOpenInterest = 9; //プットオプション建玉
optional double putCallOpenInterestRatio = 10; //Put/Call建玉比率
optional double underlyingPrice = 11; //原資産価格
}
message S2C
{
required Qot_Common.Security owner = 1; //オプション原資産
optional string code = 2; //銘柄コード
optional string name = 3; //銘柄名称
repeated DailyStatistic statisticList = 4; //統計データリスト、取引日降順
optional bytes nextPageKey = 5; //ページングリクエストのキー
}
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
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
- インターフェース呼び出し結果、構造は RetType を参照
プロトコル ID
3302
Example
import mmWebsocket from "moomoo-api";
import { Common, Qot_Common } from "moomoo-api/proto";
import beautify from "js-beautify";
function QotGetOptionUnderlyingHisStatistic(){
const { RetType } = Common
const { QotMarket } = Qot_Common
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: {
owner: { market: QotMarket.QotMarket_US_Security, code: 'AAPL' },
beginTime: '2026-06-01',
endTime: '2026-06-15',
},
};
websocket.GetOptionUnderlyingHisStatistic(req)
.then((res)=>{
let { errCode, retMsg, retType, s2c } = res
console.log("GetOptionUnderlyingHisStatistic: 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);
}
QotGetOptionUnderlyingHisStatistic()
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
GetOptionUnderlyingHisStatistic: errCode 0, retMsg , retType 0
{
"owner": { "market": 1, "code": "AAPL" },
"code": "US.AAPL",
"name": "Apple",
"statisticList": [
{
"time": "2026-06-12",
"timestamp": 1781237000,
"optionVolume": 1273240,
"callVolume": 782941,
"putVolume": 490299,
"putCallVolumeRatio": 0.626227,
"callOpenInterest": 0,
"putOpenInterest": 0,
"underlyingPrice": 291.13
},
{
"time": "2026-06-11",
"timestamp": 1781150000,
"optionVolume": 950737,
"callVolume": 580535,
"putVolume": 370202,
"putCallVolumeRatio": 0.637691,
"optionOpenInterest": 5403058,
"callOpenInterest": 3165108,
"putOpenInterest": 2237950,
"putCallOpenInterestRatio": 0.707069,
"underlyingPrice": 295.63
}
]
}
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
インターフェース制限
- 30秒以内に最大60回のオプション原資産履歴統計インターフェースリクエスト（ページング対応のインターフェースは初回呼び出しのみカウント）