Moomoo Open API

https://openapi.moomoo.com/moomoo-api-doc
Admin
This project provides comprehensive documentation for the Moomoo API, offering robust market and...
Tokens:801,699
Snippets:2,046
Trust Score:9.7
Update:1 week ago
Show doc for...
Tokens:
Raw
### Output of futu package path

Source: https://openapi.moomoo.com/moomoo-api-doc/qa/other.html

Example output from running the previous code, showing the installation path of the futu package.

```text
C:\Users\ceciliali\Anaconda3\lib\site-packages\futu\__init__.py
```

--------------------------------

### Example output of Qot_GetFinancialsStatements

Source: https://openapi.moomoo.com/moomoo-api-doc/quote/get-financials-statements.html

Shows a sample response from the Qot_GetFinancialsStatements API, including connection setup, request send, and response with structure list, report list, and nextKey.

```protobuf
Qot onInitConnect: ret=0 desc= connID=7459213508733962245
Send Qot_GetFinancialsStatements: 2
Receive Qot_GetFinancialsStatements: retType: 0
retMsg: ""
errCode: 0
s2c {
  structureList {
    fieldId: 5001
    displayName: "营业总收入"
  }
  structureList {
    //...
  }
  reportList {
    dateTime: 1767110400
    dateTimeStr: "2025-12-31"
    fiscalYear: 2025
    financialType: F10Type_Annual
    periodText: "2025/FY"
    itemList {
      fieldId: 5001
      data: 7.51766E11
      yoy: 13.859603154529221
    }
    itemList {
      //...
    }
    currencyInfo: "人民币"
    accountingStandards: "国际会计准则"
    auditorReport: "无保留意见"
    currencyCode: "CNY"
  }
  reportList {
    //...
  }
  nextKey: "1711814401,2024_1"
}
```

--------------------------------

### C# example: Qot_GetFutureInfo request setup

Source: https://openapi.moomoo.com/moomoo-api-doc/quote/get-future-info.html

Initializes the FTAPI_Qot client, sets client info and callbacks, connects to 127.0.0.1:11111, and builds a QotGetFutureInfo request for the HSImain security on the HK market. The OnInitConnect callback prints the connection result and returns early on error.

```csharp
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)
    {
        Console.Write("Qot onInitConnect: ret={0} desc={1} connID={2}\n", errCode, desc, client.GetConnectID());
        if (errCode != 0)
            return;

        QotCommon.Security sec = QotCommon.Security.CreateBuilder()
                .SetMarket((int)QotCommon.QotMarket.QotMarket_HK_Security)
                .SetCode("HSImain")
                .Build();
        QotGetFutureInfo.C2S c2s = QotGetFutureInfo.C2S.CreateBuilder()
                .AddSecurityList(sec)
            .Build();
        QotGetFutureInfo.Request req = QotGetFutureInfo.Request.CreateBuilder().SetC2S(c2s).Build();
        uint seqNo = qot.GetFutureInfo(req);
        Console.WriteLine(
```

--------------------------------

### Get current Python interpreter path (futu)

Source: https://openapi.moomoo.com/moomoo-api-doc/qa/other.html

Run this Python code to print the path of the current interpreter. Use the printed path in the pip install command to install futu-api in the correct environment.

```python
import sys
print(sys.executable)
```

--------------------------------

### Java client example for Qot_GetOptionStrategy

Source: https://openapi.moomoo.com/moomoo-api-doc/quote/get-option-strategy.html

Shows how to initialize the MMAPI connection, build a request for a straddle strategy on HK stock 00700, send it, and handle the reply. The example prints the sequence number and the response JSON.

```java
public class QotDemo implements MMSPI_Qot, MMSPI_Conn {
    MMAPI_Conn_Qot qot = new MMAPI_Conn_Qot();

    public QotDemo() {
        qot.setClientInfo("javaclient", 1);
        qot.setConnSpi(this);
        qot.setQotSpi(this);
    }

    public void start() {
        qot.initConnect("127.0.0.1", (short)11111, false);
    }

    @Override
    public void onInitConnect(MMAPI_Conn client, long errCode, String desc)
    {
        System.out.printf("Qot onInitConnect: ret=%b desc=%s connID=%d\n", errCode, desc, client.getConnectID());
        if (errCode != 0)
            return;

        QotCommon.Security owner = QotCommon.Security.newBuilder()
                .setMarket(QotCommon.QotMarket.QotMarket_HK_Security_VALUE)
                .setCode("00700")
                .build();
        QotGetOptionStrategy.C2S c2s = QotGetOptionStrategy.C2S.newBuilder()
                .setOwner(owner)
                .setOptionStrategy(QotCommon.OptionStrategyType.OptionStrategyType_Straddle_VALUE)
            .build();
        QotGetOptionStrategy.Request req = QotGetOptionStrategy.Request.newBuilder().setC2S(c2s).build();
        int seqNo = qot.getOptionStrategy(req);
        System.out.printf("Send QotGetOptionStrategy: %d\n", seqNo);
    }

    @Override
    public void onDisconnect(MMAPI_Conn client, long errCode) {
        System.out.printf("Qot onDisConnect: %d\n", errCode);
    }

    @Override
    public void onReply_GetOptionStrategy(MMAPI_Conn client, int nSerialNo, QotGetOptionStrategy.Response rsp) {
        if (rsp.getRetType() != 0) {
            System.out.printf("QotGetOptionStrategy failed: %s\n", rsp.getRetMsg());
        }
        else {
            try {
                String json = JsonFormat.printer().print(rsp);
                System.out.printf("Receive QotGetOptionStrategy: %s\n", json);
            } catch (InvalidProtocolBufferException e) {
                e.printStackTrace();
            }
        }
    }

    public static void main(String[] args) {
        MMAPI.init();
        QotDemo qot = new QotDemo();
        qot.start();

        while (true) {
            try {
                Thread.sleep(1000 * 600);
            } catch (InterruptedException exc) {

            }
        }
    }
}

```

--------------------------------

### JavaScript example: QotGetOptionQuote using moomoo-api

Source: https://openapi.moomoo.com/moomoo-api-doc/quote/get-option-quote.html

Shows how to connect to OpenD, log in, fetch an option strategy, and then get option quotes for that strategy. The example closes the connection after 5 seconds and notes the 128-connection limit.

```javascript
import mmWebsocket from "moomoo-api";
import { mmCmdID } from "moomoo-api";
import { Common, Qot_Common } from "moomoo-api/proto";
import beautify from "js-beautify";

function QotGetOptionQuote(){
    const { RetType } = Common
    const { QotMarket, OptionStrategyType } = 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) { // 登录成功
            // 先获取期权策略，取其中一组组合腿
            websocket.GetOptionStrategy({
                c2s: {
                    owner: { market: QotMarket.QotMarket_HK_Security, code: "00700" },
                    optionStrategy: OptionStrategyType.OptionStrategyType_Straddle,
                },
            })
            .then((res) => {
                let { retType, s2c: { strategyList } } = res
                if(retType == RetType.RetType_Succeed && strategyList.length > 0){
                    const req = {
                        c2s: {
                            multiLegs: strategyList[0].multiLegs,
                        },
                    };

                    websocket.GetOptionQuote(req)
                    .then((res) => {
                        let { errCode, retMsg, retType, s2c } = res
                        console.log("GetOptionQuote: 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);
                    });
                }
            })
            .catch((error) => {
                console.log("GetOptionStrategy error:", error);
            });
        } else {
            console.log("start error", msg);
        }
    };

    websocket.start(addr, port, enable_ssl, key);

    //关闭行情连接，连接不再使用之后，要关闭，否则占用不必要资源
    //同时OpenD也限制了最多128条连接
    //也可以一个页面或者一个项目维护一条连接，这里范例请求一次创建一条连接
    setTimeout(()=>{ 
        websocket.stop();
        console.log("stop");
    }, 5000); // 5秒后断开
}
```

--------------------------------

### Qot_UpdateKL Java Example

Source: https://openapi.moomoo.com/moomoo-api-doc/quote/update-kl.html

Complete Java example demonstrating how to initialize the connection, subscribe to K-line data, and handle the UpdateKL push callback.

```java
public class QotDemo implements MMSPI_Qot, MMSPI_Conn {
    MMAPI_Conn_Qot qot = new MMAPI_Conn_Qot();

    public QotDemo() {
        qot.setClientInfo("javaclient", 1);  //设置客户端信息
        qot.setConnSpi(this);  //设置连接回调
        qot.setQotSpi(this);   //设置交易回调
    }

    public void start() {
        qot.initConnect("127.0.0.1", (short)11111, false);
    }

    @Override
    public void onInitConnect(MMAPI_Conn client, long errCode, String desc)
    {
        System.out.printf("Qot onInitConnect: ret=%b desc=%s connID=%d\n", errCode, desc, client.getConnectID());
        if (errCode != 0)
            return;

        QotCommon.Security sec = QotCommon.Security.newBuilder()
                .setMarket(QotCommon.QotMarket.QotMarket_HK_Security_VALUE)
                .setCode("00700")
                .build();
        QotSub.C2S c2s = QotSub.C2S.newBuilder()
                .addSecurityList(sec)
                .addSubTypeList(QotCommon.SubType.SubType_KL_1Min_VALUE)
                .setIsSubOrUnSub(true)
                .setIsRegOrUnRegPush(true)
                .build();
        QotSub.Request req = QotSub.Request.newBuilder().setC2S(c2s).build();
        int seqNo = qot.sub(req);
        System.out.printf("Send QotSub: %d\n", seqNo);
    }

    @Override
    public void onDisconnect(MMAPI_Conn client, long errCode) {
        System.out.printf("Qot onDisConnect: %d\n", errCode);
    }

    @Override
    public void onReply_Sub(MMAPI_Conn client, int nSerialNo, QotSub.Response rsp) {
        if (rsp.getRetType() != 0) {
            System.out.printf("QotSub failed: %s\n", rsp.getRetMsg());
        }
        else {
            try {
                String json = JsonFormat.printer().print(rsp);
                System.out.printf("Receive QotSub: %s\n", json);
            } catch (InvalidProtocolBufferException e) {
                e.printStackTrace();
            }
        }
    }

    @Override
    public void onPush_UpdateKL(MMAPI_Conn client, QotUpdateKL.Response rsp) {
        if (rsp.getRetType() != 0) {
            System.out.printf("QotUpdateKL failed: %s\n", rsp.getRetMsg());
        }
        else {
            try {
                String json = JsonFormat.printer().print(rsp);
                System.out.printf("Receive QotUpdateKL: %s\n", json);
            } catch (InvalidProtocolBufferException e) {
                e.printStackTrace();
            }
        }
    }

    public static void main(String[] args) {
        MMAPI.init();
        QotDemo qot = new QotDemo();
        qot.start();

        while (true) {
            try {
                Thread.sleep(1000 * 600);
            } catch (InterruptedException exc) {

            }
        }
    }
}
```

--------------------------------

### C# example: Subscribe and handle real-time K-line updates

Source: https://openapi.moomoo.com/moomoo-api-doc/quote/update-kl.html

Complete C# example showing how to initialize the FTAPI_Qot client, connect, subscribe to a stock's 1-minute K-line, and handle the UpdateKL push callback to print the close price.

```csharp
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)
    {
        Console.Write("Qot onInitConnect: ret={0} desc={1} connID={2}\n", errCode, desc, client.GetConnectID());
        if (errCode != 0)
            return;

        QotCommon.Security sec = QotCommon.Security.CreateBuilder()
                .SetMarket((int)QotCommon.QotMarket.QotMarket_HK_Security)
                .SetCode("00700")
                .Build();
        QotSub.C2S c2s = QotSub.C2S.CreateBuilder()
                .AddSecurityList(sec)
                .AddSubTypeList((int)QotCommon.SubType.SubType_KL_1Min)
                .SetIsSubOrUnSub(true)
                .SetIsRegOrUnRegPush(true)
                .Build();
        QotSub.Request req = QotSub.Request.CreateBuilder().SetC2S(c2s).Build();
        uint seqNo = qot.Sub(req);
        Console.Write("Send QotSub: {0}\n", seqNo);
    }

    
    public void OnDisconnect(FTAPI_Conn client, long errCode) {
        Console.Write("Qot onDisConnect: {0}\n", errCode);
    }

    
    public void OnReply_Sub(FTAPI_Conn client, uint nSerialNo, QotSub.Response rsp) {
        Console.Write("Reply: QotSub: {0}  {1}\n", nSerialNo, rsp.ToString());
    }
    
    public void OnReply_UpdateKL(FTAPI_Conn client, uint nSerialNo, QotUpdateKL.Response rsp)
    {
        Console.Write("Push: UpdateKL: {0}\n", nSerialNo);
        Console.Write("closePrice: {0}\n", rsp.S2C.KlListList[0].ClosePrice);
    }

    public static void Main(String[] args) {
        FTAPI.Init();
        Program qot = new Program();
        qot.Start();


        while (true)
            Thread.Sleep(1000 * 600);
    }
}
```

--------------------------------

### C++ example for Qot_RequestHistoryKLQuota

Source: https://openapi.moomoo.com/moomoo-api-doc/quote/get-history-kl-quota.html

Complete C++ program that initializes the Qot API, connects to a local server, sends a RequestHistoryKLQuota request, and prints the response. The example shows the required includes, class setup, and main function.

```cpp
class Program : public FTSPI_Qot, public FTSPI_Trd, 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) {
		cout << "connect" << endl;

		// 组包
		Qot_RequestHistoryKLQuota::Request req;
		Qot_RequestHistoryKLQuota::C2S *c2s = req.mutable_c2s();

        m_RequestHistoryKLQuotaSerialNo = m_pQotApi->RequestHistoryKLQuota(req);
        cout << "Request RequestHistoryKLQuota SerialNo: " << m_RequestHistoryKLQuotaSerialNo << endl;
	}

	virtual void OnReply_RequestHistoryKLQuota(Futu::u32_t nSerialNo, const Qot_RequestHistoryKLQuota::Response &stRsp){
        if(nSerialNo == m_RequestHistoryKLQuotaSerialNo)
        {
            cout << "OnReply_RequestHistoryKLQuota SerialNo: " << nSerialNo << endl;
            // 解析内部结构打印出来
            // ProtoBufToBodyData和UTF8ToLocal函数的定义参见Sample中的tool.h文件
            string resp_str;
            ProtoBufToBodyData(stRsp, resp_str);
            cout << UTF8ToLocal(resp_str) << endl;
        }
	}

protected:
	FTAPI_Qot *m_pQotApi;

    Futu::u32_t m_RequestHistoryKLQuotaSerialNo;
};

int32_t main(int32_t argc, char** argv)
{
	FTAPI::Init();

	{
		Program program;
		program.Start();
		getchar();
	}

	protobuf::ShutdownProtobufLibrary();
	FTAPI::UnInit();
	return 0;
}
```

--------------------------------

### Modify Order Example (JavaScript)

Source: https://openapi.moomoo.com/moomoo-api-doc/trade/modify-order.html

This example demonstrates the full workflow for modifying an order: unlock trading, get account list, place an order, then modify it. It uses the moomoo-api WebSocket client and requires a running OpenD instance. The example uses a simulated Hong Kong account and prints the response.

```javascript
import mmWebsocket from "moomoo-api";
import { mmCmdID } from "moomoo-api";
import { Common, Qot_Common, Trd_Common } from "moomoo-api/proto";
import beautify from "js-beautify";

function TrdModifyOrder(){
    const { RetType, PacketID } = Common
    const { TrdEnv, TrdSide, OrderType, SecurityFirm, TrdMarket, TrdSecMarket, ModifyOrderOp } = Trd_Common
    let [addr, port, enable_ssl, key] = ["127.0.0.1", 33333, false, '7522027ccf5a06b1'];
    let websocket = new mmWebsocket();

    let tradeSerialNo = 0;
    websocket.onlogin = async ()=>{
        try{
            // 实盘需先解锁；若使用 GUI 版 OpenD，则无需此步，请在界面上手动点击解锁按钮解锁
            let { errCode, retMsg, retType } = await websocket.UnlockTrade({
                c2s: {
                    unlock: true,
                    securityFirm: SecurityFirm.SecurityFirm_FutuSecurities,
                    pwdMD5: "d0970714757783e6cf17b26fb8e2298f", // 设置为自己账号的交易密码MD5
                },
            });
            if(retType == RetType.RetType_Succeed && errCode == 0) { // 解锁交易成功
                let { errCode, retMsg, retType, s2c: { accList } } = await websocket.GetAccList({
                    c2s: {
                        userID: 0,
                    },
                });
                if(retType == RetType.RetType_Succeed && errCode == 0) { // 获取账户成功
                    let acc = accList.filter((item)=>{ 
                        return item.trdEnv == TrdEnv.TrdEnv_Simulate && item.trdMarketAuthList.some((auth)=>{ return auth == TrdMarket.TrdMarket_HK})
                    })[0]; // 样例取第一个香港市场虚拟环境账户
                    
                    let { errCode, retMsg, retType, s2c : { orderID } } = await websocket.PlaceOrder({
                        c2s: {
                            packetID:{
                                connID: websocket.getConnID(),
                                serialNo: tradeSerialNo++,
                            },
                            header: {
                                trdEnv: acc.trdEnv,
                                accID: acc.accID,
                                trdMarket: TrdMarket.TrdMarket_HK,
                            },
                            trdSide: TrdSide.TrdSide_Buy,
                            orderType: OrderType.OrderType_Normal,
                            code: "00700",
                            qty: 100,
                            price: 150,
                            secMarket: TrdSecMarket.TrdSecMarket_HK,
                        },
                    }); 
                    if(retType == RetType.RetType_Succeed && errCode == 0){
                        const req = {
                            c2s: {
                                packetID:{
                                    connID: websocket.getConnID(),
                                    serialNo: tradeSerialNo++,
                                },
                                header: {
                                    trdEnv: acc.trdEnv,
                                    accID: acc.accID,
                                    trdMarket: TrdMarket.TrdMarket_HK,
                                },
                                orderID: orderID,
                                modifyOrderOp: ModifyOrderOp.ModifyOrderOp_Normal,
                                qty: 200,
                                price: 100,
                            },
                        };
                        let { errCode, retMsg, retType, s2c } = await websocket.ModifyOrder(req);
                        console.log("ModifyOrder: 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(err){
            console.log(err)
        }
        
    };

    websocket.start(addr, port, enable_ssl, key);
    
    //关闭行情连接，连接不再使用之后，要关闭，否则占用不必要资源
    //同时OpenD也限制了最多128条连接
    //也可以一个页面或者一个项目维护一条连接，这里范例请求一次创建一条连接
    setTimeout(()=>{ 
        websocket.stop();
        console.log("stop");
    }, 5000); // 5秒后断开
}
```

--------------------------------

### Example output for QotOptionStrategyAnalysis

Source: https://openapi.moomoo.com/moomoo-api-doc/quote/get-option-strategy-analysis.html

Shows the console output from the Java example, including the connection message, the send sequence number, and the JSON response with the strategy analysis results.

```text
Qot onInitConnect: ret=0 desc= connID=7459213669204006063
Send QotOptionStrategyAnalysis: 2
Receive QotOptionStrategyAnalysis: {
  "retType": 0,
  "retMsg": "",
  "errCode": 0,
  "s2c": {
    "code": "TCH260522C/P330",
    "name": "腾讯 跨式策略",
    "optionStrategy": 6,
    "bid1": 25.6,
    "ask1": 26.1,
    "maxProfit": 9999999,
    "maxLoss": -25.85,
    "breakevenPoints": [304.15, 355.85],
    "probOfProfit": 0.4231,
    "delta": 0.012,
    "theta": -0.045
  }
}
```

--------------------------------

### Sample run output: InitConnected and QotGetUserSecurity response

Source: https://openapi.moomoo.com/moomoo-api-doc/quick/demo.html

Example console output after running the Sample project's Program.cs. It shows the InitConnected message and the response to the QotGetUserSecurity request, which includes a JSON list of static security information.

```text
InitConnected
Send QotGetUserSecurity: 3
{"staticInfoList":[{"basic":{"security":{"market":1,"code":"08311"},"id":69179038244983,"lotSize":10000,"secType":3,"name":"\u5706\u7f8e\u5149\u7535","listTime":"2014-02-07","delisting":false,"listTimestamp":1391702400}},{"basic":{"security":{"market":1,"code":"02127"},"id":79925046413391,"lotSize":2000,"secType":3,"name":"\u6c47\u68ee\u5bb6\u5c45","listTime":"2020-12-29","delisting":false,"listTimestamp":1609171200}},{"basic":{"security":{"market":1,"code":"EVG2101"},"id":71002729,"lotSize":2000,"secType":10,"name":"\u4e2d\u56fd\u6052\u5927\u96c6\u56e22101","listTime":"","delisting":false},"futureExData":{"lastTradeTime":"2021-01-28","lastTradeTimestamp":1611820800,"isMainContract":false}},{"basic":{"security":{"market":1,"code":"02333"},"id":53257594472733,"lotSize":500,"secType":3,"name":"\u957f\u57ce\u6c7d\u8f66","listTime":"2003-12-15","delisting":false,"listTimestamp":1071417600}},{"basic":{"security":{"market":1,"code":"06993"},"id":79882096745297,"lotSize":500,"secType":3,"name":"\u84dd\u6708\u4eae\u96c6\u56e2","listTime":"2020-12-16","delisting":false,"listTimestamp":1608048000}},{"basic":{"security":{"market":1,"code":"01810"},"id":76033806042898,"lotSize":200,"secType":3,"name":"\u5c0f\u7c73\u96c6\u56e2-W","listTime":"2018-07-09","delisting":false,"listTimestamp":1531065600}},{"basic":{"security":{"market":1,"code":"09992"},"id":79869211846408,"lotSize":200,"secType":3,"name":"\u6ce1\u6ce1\u739b\u7279","listTime":"2020-12-11","delisting":false,"listTimestamp":1607616000}},{"basic":{"security":{"market":1,"code":"03948"},"id":66709432045420,"lotSize":100,"secType":3,"name":"\u4f0a\u6cf0\u7164\u70ad","listTime":"2012-07-12","delisting":false,"listTimestamp":1342022400}},{"basic":{"security":{"market":1,"code":"01398"},"id":57754425230710,"lotSize":1000,"secType":3,"name":"\u5de5\u5546\u94f6\u884c","listTime":"2006-10-27","delisting":false,"listTimestamp":1161878400}},{"basic":{"security":{"market":1,"code":"06618"},"id":79843442039258,"lotSize":50,"secType":3,"name":"\u4eac\u4e1c\u5065\u5eb7","listTime":"2020-12-08","delisting":false,"listTimestamp":1607356800}},{"basic":{"security":{"market":1,"code":"09698"},"id":79693118186978,"lotSize":100,"secType":3,"name":"\u4e07\u56fd\u6570\u636e-SW","listTime":"2020-11-02","delisting":false,"listTimestamp":1604246400}},{"basic":{"security":{"market":1,"code":"03690"},"id":76364518526570,"lotSize":100,"secType":3,"name":"\u7f8e\u56e2-W","listTime":"2018-09-20","delisting":false,"listTimestamp":1537372800}},{"basic":{"security":{"market":1,"code":"09988"},"id":78224239372036,"lotSize":100,"secType":3,"name":"\u963f\u91cc\u5df4\u5df4-SW","listTime":"2019-11-26","delisting":false,"listTimestamp":1574697600}},{"basic":{"security":{"market":1,"code":"800000"},"id":800000,"lotSize":0,"secType":6,"name":"\u6052\u751f\u6307\u6570","listTime":"1970-01-01","delisting":false,"listTimestamp":0}},{"basic":{"security":{"market":1,"code":"00005"},"id":5,"lotSize":400,"secType":3,"name":"\u6c47\u4e30\u94f6\u884c","listTime":"2006-10-27","delisting":false,"listTimestamp":1161878400}}]}
```

--------------------------------

### Output of moomoo package path

Source: https://openapi.moomoo.com/moomoo-api-doc/qa/other.html

Example output from running the previous code, showing the installation path of the moomoo package.

```text
C:\Users\ceciliali\Anaconda3\lib\site-packages\moomoo\__init__.py
```

--------------------------------

### Java client example for QotOptionStrategyAnalysis

Source: https://openapi.moomoo.com/moomoo-api-doc/quote/get-option-strategy-analysis.html

Shows how to build a request with two combo legs (a put and a call) and send it using the MMAPI. The example connects to 127.0.0.1:11111, sends the request, and prints the response. Note that the main method calls MMAPI.init() without a semicolon, which is a syntax error in the original source.

```java
public class QotDemo implements MMSPI_Qot, MMSPI_Conn {
    MMAPI_Conn_Qot qot = new MMAPI_Conn_Qot();

    public QotDemo() {
        qot.setClientInfo("javaclient", 1);
        qot.setConnSpi(this);
        qot.setQotSpi(this);
    }

    public void start() {
        qot.initConnect("127.0.0.1", (short)11111, false);
    }

    @Override
    public void onInitConnect(MMAPI_Conn client, long errCode, String desc)
    {
        System.out.printf("Qot onInitConnect: ret=%b desc=%s connID=%d\n", errCode, desc, client.getConnectID());
        if (errCode != 0)
            return;

        QotCommon.ComboLeg leg1 = QotCommon.ComboLeg.newBuilder()
                .setSecurity(QotCommon.Security.newBuilder()
                    .setMarket(QotCommon.QotMarket.QotMarket_HK_Security_VALUE)
                    .setCode("TCH260522P330000")
                    .build())
                .setSide(TrdCommon.TrdSide.TrdSide_Buy_VALUE)
                .setQtyRatio(1)
                .build();
        QotCommon.ComboLeg leg2 = QotCommon.ComboLeg.newBuilder()
                .setSecurity(QotCommon.Security.newBuilder()
                    .setMarket(QotCommon.QotMarket.QotMarket_HK_Security_VALUE)
                    .setCode("TCH260522C330000")
                    .build())
                .setSide(TrdCommon.TrdSide.TrdSide_Buy_VALUE)
                .setQtyRatio(1)
                .build();
        QotOptionStrategyAnalysis.C2S c2s = QotOptionStrategyAnalysis.C2S.newBuilder()
                .addMultiLegs(leg1)
                .addMultiLegs(leg2)
            .build();
        QotOptionStrategyAnalysis.Request req = QotOptionStrategyAnalysis.Request.newBuilder().setC2S(c2s).build();
        int seqNo = qot.optionStrategyAnalysis(req);
        System.out.printf("Send QotOptionStrategyAnalysis: %d\n", seqNo);
    }

    @Override
    public void onDisconnect(MMAPI_Conn client, long errCode) {
        System.out.printf("Qot onDisConnect: %d\n", errCode);
    }

    @Override
    public void onReply_OptionStrategyAnalysis(MMAPI_Conn client, int nSerialNo, QotOptionStrategyAnalysis.Response rsp) {
        if (rsp.getRetType() != 0) {
            System.out.printf("QotOptionStrategyAnalysis failed: %s\n", rsp.getRetMsg());
        }
        else {
            try {
                String json = JsonFormat.printer().print(rsp);
                System.out.printf("Receive QotOptionStrategyAnalysis: %s\n", json);
            } catch (InvalidProtocolBufferException e) {
                e.printStackTrace();
            }
        }
    }

    public static void main(String[] args) {
        MMAPI.init()
        QotDemo qot = new QotDemo();
        qot.start();

        while (true) {
            try {
                Thread.sleep(1000 * 600);
            } catch (InterruptedException exc) {

            }
        }
    }
}
```

--------------------------------

### JavaScript example: QotGetOptionStrategy using moomoo-api

Source: https://openapi.moomoo.com/moomoo-api-doc/quote/get-option-strategy.html

Example function that connects to the moomoo OpenD websocket, sends a GetOptionStrategy request for a straddle strategy on Tencent (00700), and logs the response. Includes connection setup, request, and cleanup after 5 seconds.

```javascript
import mmWebsocket from "moomoo-api";
import { mmCmdID } from "moomoo-api";
import { Common, Qot_Common } from "moomoo-api/proto";
import beautify from "js-beautify";

function QotGetOptionStrategy(){
    const { RetType } = Common
    const { QotMarket, OptionStrategyType } = 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: {
                    owner: { market: QotMarket.QotMarket_HK_Security, code: "00700" },
                    optionStrategy: OptionStrategyType.OptionStrategyType_Straddle, // 跨式策略
                },
            };

            websocket.GetOptionStrategy(req)
            .then((res) => {
                let { errCode, retMsg, retType, s2c } = res
                console.log("GetOptionStrategy: 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);

    //关闭行情连接，连接不再使用之后，要关闭，否则占用不必要资源
    //同时OpenD也限制了最多128条连接
    //也可以一个页面或者一个项目维护一条连接，这里范例请求一次创建一条连接
    setTimeout(()=>{ 
        websocket.stop();
        console.log("stop");
    }, 5000); // 5秒后断开
}
```

--------------------------------

### Example output for QotGetSubInfo

Source: https://openapi.moomoo.com/moomoo-api-doc/quote/query-subscription.html

Sample output from the demo, showing the response JSON with retType 0 and subscription quota details.

```json
Send QotGetSubInfo: 2
Receive QotGetSubInfo: {
  "retType": 0,
  "retMsg": "",
  "errCode": 0,
  "s2c": {
    "connSubInfoList": [{
      "usedQuota": 0,
      "isOwnConnData": true
    }],
    "totalUsedQuota": 0,
    "remainQuota": 300
  }
}
```

--------------------------------

### Java client example for QotOptionStrategyAnalysis

Source: https://openapi.moomoo.com/moomoo-api-doc/quote/get-option-strategy-analysis.html

Java example using FTAPI_Conn_Qot to connect and send an option strategy analysis request. It builds two ComboLegs for a straddle strategy (buy put and call) and prints the response. The main method initializes FTAPI and starts the demo.

```java
public class QotDemo implements FTSPI_Qot, FTSPI_Conn {
    FTAPI_Conn_Qot qot = new FTAPI_Conn_Qot();

    public QotDemo() {
        qot.setClientInfo("javaclient", 1);
        qot.setConnSpi(this);
        qot.setQotSpi(this);
    }

    public void start() {
        qot.initConnect("127.0.0.1", (short)11111, false);
    }

    @Override
    public void onInitConnect(FTAPI_Conn client, long errCode, String desc)
    {
        System.out.printf("Qot onInitConnect: ret=%b desc=%s connID=%d\n", errCode, desc, client.getConnectID());
        if (errCode != 0)
            return;

        QotCommon.ComboLeg leg1 = QotCommon.ComboLeg.newBuilder()
                .setSecurity(QotCommon.Security.newBuilder()
                    .setMarket(QotCommon.QotMarket.QotMarket_HK_Security_VALUE)
                    .setCode("TCH260522P330000")
                    .build())
                .setSide(TrdCommon.TrdSide.TrdSide_Buy_VALUE)
                .setQtyRatio(1)
                .build();
        QotCommon.ComboLeg leg2 = QotCommon.ComboLeg.newBuilder()
                .setSecurity(QotCommon.Security.newBuilder()
                    .setMarket(QotCommon.QotMarket.QotMarket_HK_Security_VALUE)
                    .setCode("TCH260522C330000")
                    .build())
                .setSide(TrdCommon.TrdSide.TrdSide_Buy_VALUE)
                .setQtyRatio(1)
                .build();
        QotOptionStrategyAnalysis.C2S c2s = QotOptionStrategyAnalysis.C2S.newBuilder()
                .addMultiLegs(leg1)
                .addMultiLegs(leg2)
            .build();
        QotOptionStrategyAnalysis.Request req = QotOptionStrategyAnalysis.Request.newBuilder().setC2S(c2s).build();
        int seqNo = qot.optionStrategyAnalysis(req);
        System.out.printf("Send QotOptionStrategyAnalysis: %d\n", seqNo);
    }

    @Override
    public void onDisconnect(FTAPI_Conn client, long errCode) {
        System.out.printf("Qot onDisConnect: %d\n", errCode);
    }

    @Override
    public void onReply_OptionStrategyAnalysis(FTAPI_Conn client, int nSerialNo, QotOptionStrategyAnalysis.Response rsp) {
        if (rsp.getRetType() != 0) {
            System.out.printf("QotOptionStrategyAnalysis failed: %s\n", rsp.getRetMsg());
        }
        else {
            try {
                String json = JsonFormat.printer().print(rsp);
                System.out.printf("Receive QotOptionStrategyAnalysis: %s\n", json);
            } catch (InvalidProtocolBufferException e) {
                e.printStackTrace();
            }
        }
    }

    public static void main(String[] args) {
        FTAPI.init()
        QotDemo qot = new QotDemo();
        qot.start();

        while (true) {
            try {
                Thread.sleep(1000 * 600);
            } catch (InterruptedException exc) {

            }
        }
    }
}
```

--------------------------------

### QotGetSubInfo session output

Source: https://openapi.moomoo.com/moomoo-api-doc/quote/query-subscription.html

Example output from a Qot_GetSubInfo session showing connection setup, request, and reply with subscription quota details (usedQuota, remainQuota).

```text
Qot onInitConnect: ret=0 desc= connID=6819190992235784251
Send QotGetSubInfo: 3
Reply: QotGetSubInfo: 3  retType: 0
retMsg: ""
errCode: 0
s2c {
  connSubInfoList {
    usedQuota: 0
    isOwnConnData: true
  }
  totalUsedQuota: 0
  remainQuota: 1000
}
```

--------------------------------

### Java client example for Qot_GetOptionStrategy

Source: https://openapi.moomoo.com/moomoo-api-doc/quote/get-option-strategy.html

Shows how to connect to the Qot API and request an option strategy (straddle) for a stock. The example sets the owner to HK stock 00700 and sends the request, then prints the response.

```java
public class QotDemo implements FTSPI_Qot, FTSPI_Conn {
    FTAPI_Conn_Qot qot = new FTAPI_Conn_Qot();

    public QotDemo() {
        qot.setClientInfo("javaclient", 1);
        qot.setConnSpi(this);
        qot.setQotSpi(this);
    }

    public void start() {
        qot.initConnect("127.0.0.1", (short)11111, false);
    }

    @Override
    public void onInitConnect(FTAPI_Conn client, long errCode, String desc)
    {
        System.out.printf("Qot onInitConnect: ret=%b desc=%s connID=%d\n", errCode, desc, client.getConnectID());
        if (errCode != 0)
            return;

        QotCommon.Security owner = QotCommon.Security.newBuilder()
                .setMarket(QotCommon.QotMarket.QotMarket_HK_Security_VALUE)
                .setCode("00700")
                .build();
        QotGetOptionStrategy.C2S c2s = QotGetOptionStrategy.C2S.newBuilder()
                .setOwner(owner)
                .setOptionStrategy(QotCommon.OptionStrategyType.OptionStrategyType_Straddle_VALUE)
            .build();
        QotGetOptionStrategy.Request req = QotGetOptionStrategy.Request.newBuilder().setC2S(c2s).build();
        int seqNo = qot.getOptionStrategy(req);
        System.out.printf("Send QotGetOptionStrategy: %d\n", seqNo);
    }

    @Override
    public void onDisconnect(FTAPI_Conn client, long errCode) {
        System.out.printf("Qot onDisConnect: %d\n", errCode);
    }

    @Override
    public void onReply_GetOptionStrategy(FTAPI_Conn client, int nSerialNo, QotGetOptionStrategy.Response rsp) {
        if (rsp.getRetType() != 0) {
            System.out.printf("QotGetOptionStrategy failed: %s\n", rsp.getRetMsg());
        }
        else {
            try {
                String json = JsonFormat.printer().print(rsp);
                System.out.printf("Receive QotGetOptionStrategy: %s\n", json);
            } catch (InvalidProtocolBufferException e) {
                e.printStackTrace();
            }
        }
    }

    public static void main(String[] args) {
        FTAPI.init();
        QotDemo qot = new QotDemo();
        qot.start();

        while (true) {
            try {
                Thread.sleep(1000 * 600);
            } catch (InterruptedException exc) {

            }
        }
    }
}

```
Tokens:
Raw