moomoo API Doc v10.1

# 權限和限制

# 登入限制

# 開户限制

首先，您需要先在moomoo APP上，完成交易業務帳戶的開通，才能成功登錄 OpenAPI。

# 合規確認

首次登錄成功後，您需要完成問卷評估與協議確認，才能繼續使用 OpenAPI。moomoo 用户請 點擊這裏。

# 行情數據

行情數據的限制主要體現在以下幾方面：

  • 行情權限 —— 獲取相關行情數據的權限
  • API / 介面限頻 —— 調用行情API / 介面的頻率限制
  • 訂閲額度 —— 同時訂閲的實時行情的數量
  • 歷史 K 線額度 —— 每 30 天最多可獲取多少個標的的歷史 K 線

# 行情權限

通過 OpenAPI 獲取行情數據，需要相應的行情權限，OpenAPI 的行情權限跟 APP 的行情權限不完全一樣，不同的權限等級對應不同的時延、擺盤檔數以及API / 介面使用權限。

部分品種行情，需要購買行情卡後方可獲取，具體獲取方式見下表。

市場 標的類別 獲取方式
香港市場 證券類產品（含股票、ETFs、窩輪、牛熊、界內證） * 中國內地IP客户：免費獲取 LV2 行情。暫不支援獲取 SF 權限。
* 港澳台及海外IP客户：免費獲取 LV1 行情。如需獲得 LV2 權限，請購買 港股 LV2 高級行情 。暫不支援獲取 SF 權限。
指數
板塊
期權 * 中國內地IP客户：推廣期免費獲取 LV2 行情。
* 港澳台及海外IP客户：免費獲取 LV1 行情，如需獲得 LV2 權限，請購買 港股 LV2 + 期權期貨 LV2 行情 。
期貨
美國市場 證券類產品（含紐交所、美交所、納斯達克上市的股票、ETFs） * 與用戶端行情權限不共用，如需獲得 LV1 權限（基本報價，含夜盤），請購買 Nasdaq Basic 。
* 與用戶端行情權限不共用，如需獲得 LV2 權限（基本報價+深度擺盤，含夜盤深度擺盤），請購買 Nasdaq Basic+TotalView 。
板塊
OTC 股票 暫不支援獲取
期權（含普通股票期權、指數期權） * 達到門檻
的客户：免費獲得 LV1 權限。
* 未達到門檻
的客户：請購買 OPRA 期權 LV1 實時行情 獲得 LV1 權限。
期貨 * 已開通期貨帳戶
的客户：
如需獲取 CME Group 行情
，請購買 CME Group 期貨 LV2
如需獲取 CME 行情，請購買 CME 期貨 LV2
如需獲取 CBOT 行情，請購買 CBOT 期貨 LV2
如需獲取 NYMEX 行情，請購買 NYMEX 期貨 LV2
如需獲取 COMEX 行情，請購買 COMEX 期貨 LV2

* 未開通期貨帳戶的客户：不支援獲取
指數 暫不支援獲取
A 股市場 證券類產品（含股票、ETFs） * 中國內地 IP 個人客户：免費獲取 LV1 行情。
* 港澳台及海外IP客户/機構客户：暫不支援。
指數
板塊

提示

上述表格，中國內地IP客户和港澳台及海外IP客户，以 OpenD 登錄的 IP 地址作為區分依據。

# API / 介面限頻

為保護伺服器，防止惡意攻擊，所有需要向 moomoo 伺服器發送請求的API / 介面，都會有頻率限制。
每個API / 介面的限頻規則會有不同，具體請參見每個API / 介面頁面下面的 API / 介面限制。

舉例：
快照 API / 介面的限頻規則是：每 30 秒內最多請求 60 次快照。您可以每隔 0.5 秒請求一次勻速請求，也可以快速請求 60 次後，休息 30 秒，再請求下一輪。如果超出限頻規則，API / 介面會返回錯誤。

# 訂閲額度 & 歷史 K 線額度

訂閲額度和歷史 K 線額度限制如下：

用户類型 訂閲額度 歷史 K 線額度
開户用户 100 100
總資產達 1 萬 HKD 300 300
以下三條滿足任意一條即可：
1. 總資產達 50 萬 HKD；
2. 月交易筆數 > 200；
3. 月交易額 > 200 萬 HKD 		1000 1000
以下三條滿足任意一條即可：
1. 總資產達 500 萬 HKD；
2. 月交易筆數 > 2000；
3. 月交易額 > 2000 萬 HKD 		2000 2000

1、總資產
總資產，是指您在 moomoo 證券的所有資產，包括：港、美、A 股證券帳戶，期貨帳戶，基金資產以及債券資產，按照即時匯率換算成以港元為單位。

2、月交易筆數
月交易筆數，會綜合您在 moomoo 證券的綜合帳戶，在當前自然月與上一自然月的交易情況，取您上個自然月的成交筆數與當前自然月的成交筆數的較大值進行計算，即：
max (上個自然月的成交筆數，當前自然月的成交筆數)。

3、月交易額
月交易額，會綜合您在 moomoo 證券的綜合帳戶，在當前自然月與上一自然月的交易情況，取您上個自然月的成交總金額與當前自然月的成交總金額的較大值進行計算，即：
max（上個自然月的成交總金額，當前自然月的成交總金額）
按照即期匯率換算成以港幣為單位。其中，期貨交易額的計算，需要乘以相應的調整係數（預設取 0.1），期貨交易額計算公式如下：
期貨交易額=∑（單筆成交數 * 成交價 * 合約乘數 * 匯率 * 調整係數）

4、訂閲額度
訂閲額度，適用於 訂閲 API / 介面。每隻股票訂閲一個類型即佔用 1 個訂閲額度，取消訂閲會釋放已佔用的額度。 舉例：
假設您的訂閲額度是 100。 當您同時訂閲了 HK.00700 的實時擺盤、US.AAPL 的實時逐筆、SH.600519 的實時報價時，此時訂閲額度會佔用 3 個，剩餘的訂閲額度為 97。 這時，如果您取消了 HK.00700 的實時擺盤訂閲，您的訂閲額度佔用將變成 2 個，剩餘訂閲額度會變成 98。

5、歷史 K 線額度
歷史 K 線額度，適用於 獲取歷史 K 線 API / 介面。最近 30 天內，每請求 1 只股票的歷史 K 線，將會佔用 1 個歷史 K 線額度。最近 30 天內重複請求同一隻股票的歷史 K 線，不會重複累計。 同時，訂閲同一股票的不同週期的K線只佔用1個額度，不會重複累計。 舉例：
假設您的歷史 K 線額度是 100，今天是 2020 年 7 月 5 日。 您在 2020 年 6 月 5 日~2020 年 7 月 5 日之間，共計請求了 60 只股票的歷史 K 線，則剩餘的歷史 K 線額度為 40。

提示

  • 訂閲額度和歷史 K 線額度為系統自動分配，不需要手動申請。
  • 新入金的帳戶，額度等級會在 2 小時內自動生效。
  • 在途資產
    不會用於額度計算。

# 交易功能

  • 進行指定市場的交易時，需要先確認是否已開通該市場的交易業務帳戶。
    舉例：您只能在美股交易業務帳戶下進行美股交易，無法在港股交易業務帳戶下進行美股交易。

← 費用 →