Skip to content

窩輪篩選 ​

POST /api/v1.0/quote/warrant-screen

窩輪篩選 — 在窩輪市場(認購證 CALL / 認沽證 PUT / 牛證 BULL / 熊證 BEAR / 界內證 INLINE)中按發行商、正股、價格、行使價、到期日、街貨比、引伸波幅、槓桿、對沖值、輪證狀態等維度組合篩選,支持多級排序與分頁。

請求參數 ​

參數類型位置必填説明
market_typeint請求體否市場,默認 1。1 港股,4 新加坡,15 馬來西亞。 默認 1; 取值 1, 4, 15
is_delaybool請求體否是否使用延時數據,默認否。 默認 false
only_countbool請求體否是否只返回數量、不返回明細,默認否。 默認 false
stock_ownerstring請求體否正股代碼,例如 HK.00700。
screen_groupsobject[]請求體否篩選條件列表。每元素結構 {field_id, interval{lower{value,is_included}, upper{value,is_included}}, choices[{content_type, value}]}。離散選擇用 choices(多元素表 OR);區間篩選用 interval。field_id 取值詳見下方枚舉表。
sortsobject[]請求體否排序字段列表,按數組順序分主次。 最多項數 10000
next_keystring請求體否翻頁遊標,首頁留空。 最長長度 1000; 格式 ^$|^(-?[0-9]+)?$
limitint請求體否單頁條數。 ≤ 1000; 默認 200

枚舉 wrnt_field(篩選 / 排序字段 field_id) ​

field_id含義形態/精度
4ISSUER_ID 發行商 IDchoice
5STOCK_OWNER 正股 IDchoice
6WARRANT_TYPE 窩輪類型choice(1=CALL, 2=PUT, 3=BULL, 4=BEAR, 5=INLINE)
7CONVERSION_RATIO 換股比率interval, x1e3
8CURRENT_PRICE 當前價interval, x1e3
9STREET_RATIO 街貨佔比interval, x1e3
10VOLUME 成交量interval
11MATURITY_DATE 到期日interval(秒級時間戳)
12STRIKE_PRICE 行使價interval, x1e3
13PREMIUM 溢價interval, x1e5
14RECOVERY_PRICE 收回價interval, x1e3
15IMPLIED_VOLATILITY 引伸波幅interval, x1e2
16LEVERAGE_RATIO 槓桿interval, x1e3
17PRICE_RECOVERY_RATIO 正股距收回價 %interval, x1e5
18DELTA 對沖值interval, x1e3
19STATUS 狀態choice(0=NORMAL, 2=STOP_TRADE, 3=PRE_IPO)
20IPO_TIME 上市時間interval(秒級時間戳)
21BUY_VOL 買量interval
22SELL_VOL 賣量interval
23EFFECTIVE_LEVERAGE 有效槓桿interval, x1e3
24LAST_CLOSE_PRICE 昨收價interval, x1e3
25TURNOVER 成交額interval
26SELL_PRICE 賣價interval, x1e3
27BUY_PRICE 買價interval, x1e3
28HIGH_PRICE 最高價interval, x1e3
29LOW_PRICE 最低價interval, x1e3
30RATIO_ITM_OTM 價內/價外 %interval, x1e5
31BREAK_EVEN_POINT 打和點interval, x1e5
32AMPLITUDE 振幅 %interval, x1e5
33SCORE_FAXING 法興評分interval, x1e5
34LAST_TRADE_DATE 最後交易日interval(秒級時間戳)
35STREET_VOLUME 街貨量interval
36LOT_SIZE 每手股數interval
37ISSUE_SIZE 發行量interval
38IPO_PRICE 發行價interval, x1e3
39LOWER_STRIKE_PRICE 下限價interval, x1e3(僅界內證)
40UPPER_STRIKE_PRICE 上限價interval, x1e3(僅界內證)
41IW_PRICE_STATUS 界內/界外choice(0=界內, 1=界外上, 2=界外下)
42SENSITIVITY 敏感度interval, x1e3
43CONVERSION_PRICE 換股價interval
44CHANGE_RATE 漲跌幅 %interval, x1e3
45CHANGE_VALUE 漲跌額interval
51SCORE 評分interval, x1e5
52FILTER_NO_TRADE 過濾無成交choice(0=不過濾, 1=過濾)
53CURRENCY_CODE 幣種interval
54STOCK_OWNER_PRICE 正股價格interval, x1e3

請求示例 ​

bash
curl -X POST "https://webapi.moomoo.com/api/v1.0/quote/warrant-screen" \
  -H "Content-Type: application/json" \
  -d '{"market_type":1,"limit":3,"screen_groups":[{"field_id":6,"choices":[{"content_type":1,"value":1}]},{"field_id":5,"choices":[{"content_type":1,"value":54047868453564}]},{"field_id":19,"choices":[{"content_type":1,"value":0}]}],"sorts":[{"sort_field_id":16,"sort_flag":true}]}' | jq

響應字段 ​

通用字段:

參數類型説明
dataobject
data.warrantsobject[]
data.warrants[].codestring窩輪 code,例: HK.18869
data.warrants[].namestring窩輪英文名
data.warrants[].sc_namestring窩輪簡體中文名,例: 騰訊法巴六二購A.C
data.warrants[].tc_namestring窩輪繁體中文名
data.warrants[].stock_ownerstring正股 code,例: HK.00700
data.warrants[].typestring窩輪類型,取值: CALL(認購)/ PUT(認沽)/ BULL(牛證)/ BEAR(熊證)/ INLINE(界內證)/ N/A(未識別值)
data.warrants[].issuerstring發行商名稱,例: 法巴 / 摩利 / 高盛
data.warrants[].maturity_timestring到期日字符串(按市場時區),格式 yyyy-MM-dd,例: 2026-12-02
data.warrants[].maturity_timestampint到期日,毫秒時間戳,例: 1770048000000
data.warrants[].list_timestring上市日字符串(按市場時區),格式 yyyy-MM-dd,例: 2025-08-01
data.warrants[].list_timestampint上市時間,毫秒時間戳,例: 1753977600000
data.warrants[].last_trade_timestring最後交易日字符串(按市場時區),格式 yyyy-MM-dd,例: 2026-11-26
data.warrants[].last_trade_timestampint最後交易日,毫秒時間戳,例: 1769529600000
data.warrants[].recovery_pricenumber收回價(僅牛熊證),例: 0
data.warrants[].conversion_rationumber換股比率,例: 100
data.warrants[].lot_sizeint每手股數,例: 10000
data.warrants[].strike_pricenumber行使價,例: 738.88
data.warrants[].last_close_pricenumber昨收價,例: 0.01
data.warrants[].cur_pricenumber窩輪當前價,例: 0.01
data.warrants[].statusstring輪證狀態,取值: NORMAL(正常)/ STOP_TRADE(終止交易)/ PENDING_LISTING(待上市)/ N/A(未識別值)
data.warrants[].bid_pricenumber買一價,例: 0.01
data.warrants[].ask_pricenumber賣一價,例: 0.01
data.warrants[].bid_volint買一量(股),例: 10000
data.warrants[].ask_volint賣一量(股),例: 10000
data.warrants[].volumeint成交量(股),例: 0
data.warrants[].turnovernumber成交額,例: 0
data.warrants[].scorenumber窩輪評分,例: 0.00002
data.warrants[].premiumnumber溢價(百分數),例: 0.4651
data.warrants[].break_even_pointnumber打和點,例: 739.88
data.warrants[].leveragenumber槓桿比率,例: 505
data.warrants[].ipopnumber價內/價外(百分數,正=價內/負=價外),例: -0.46312
data.warrants[].price_recovery_rationumber正股距收回價百分比,例: 0
data.warrants[].street_ratenumber街貨佔比(百分數),例: 41.14
data.warrants[].street_volint街貨量(股),例: 20570000
data.warrants[].amplitudenumber振幅(百分數),例: 0
data.warrants[].issue_sizeint發行量(股),例: 50000000
data.warrants[].high_pricenumber最高價,例: 0
data.warrants[].low_pricenumber最低價,例: 0
data.warrants[].implied_volatilitynumber引伸波幅(百分數),例: 0
data.warrants[].deltanumber對沖值,例: 0
data.warrants[].effective_leveragenumber有效槓桿,例: 0
data.warrants[].upper_strike_pricenumber上限價(僅界內證),例: 0
data.warrants[].lower_strike_pricenumber下限價(僅界內證),例: 0
data.warrants[].inline_price_statusstring界內/界外(僅界內證),取值: WITH_IN(界內)/ OUTSIDE(界外)/ N/A(非界內證或未識別值)
data.warrants[].price_change_valnumber價格變動絕對值(current_price - last_close_price),例: 0
data.warrants[].change_ratenumber漲跌幅(百分數,相對昨收價),例: 0
data.warrants[].conversion_pricenumber換股價(current_price × conversion_ratio),例: 1
paginationobject
pagination.totalint
pagination.has_morebool
pagination.next_keystring

價格 / 成交:

字段類型說明
cur_pricefloat窩輪當前價。
last_close_pricefloat昨收價。
high_pricefloat最高價。
low_pricefloat最低價。
bid_pricefloat買一價。
ask_pricefloat賣一價。
bid_volint買一量(股)。
ask_volint賣一量(股)。
volumeint成交量(股)。
turnoverfloat成交額。
price_change_valfloat漲跌額(cur_price - last_close_price)。
change_ratefloat漲跌幅,單位 %。
amplitudefloat振幅,單位 %。

衍生品指標:

字段類型說明
strike_pricefloat行使價。
conversion_ratiofloat換股比率。
conversion_pricefloat換股價。
break_even_pointfloat打和點。
premiumfloat溢價,單位 %。
ipopfloat價內/價外,單位 %(正=價內 / 負=價外)。
leveragefloat槓桿比率。
effective_leveragefloat有效槓桿。
deltafloat對沖值。
implied_volatilityfloat引伸波幅,單位 %。
scorefloat窩輪評分。
street_ratefloat街貨佔比,單位 %。
street_volint街貨量(股)。

牛熊證 / 界內證專屬:

字段類型說明
recovery_pricefloat收回價(僅牛/熊證)。
price_recovery_ratiofloat正股距收回價百分比(僅牛/熊證)。
upper_strike_pricefloat上限價(僅界內證 INLINE)。
lower_strike_pricefloat下限價(僅界內證 INLINE)。
inline_price_statusstring界內/界外:WITH_IN / OUTSIDE / N/A。

分頁:

字段類型說明
pagination.totalint滿足條件的窩輪總數。
pagination.has_morebool是否還有下一頁。
pagination.next_keystring下一頁遊標;無更多頁為 "-1"。

限制範圍 ​

  • 支持市場:HK 港股 / SG 新加坡 / MY 馬來西亞(market_type 取值 1 / 4 / 15)。其他市場不支持。
  • 支持品類:CALL(認購證)、PUT(認沽證)、BULL(牛證)、BEAR(熊證)、INLINE(界內證)。
  • 單頁 limit 最大 1000,next_key 為不透明遊標。
  • 合法但無數據(如某市場暫無該類窩輪、過嚴篩選未命中)返回 ret_code=0 + data.warrants=[] + all_count=0。

錯誤碼 ​

ret_codeerror.code觸發條件處理建議
-3invalid_parametermarket_type 不在 [1,4,15] / limit 越界(>1000)/ next_key 非法 / 其他參數類型不合法。校正請求體後重試。
-7invalid_symbol無法識別 stock_owner 傳入的證券代碼。通過基礎接口確認正股代碼合法性後重試。
-2 / -4 / -6internal_error服務錯誤重試;持續報錯請聯繫技術支援排查。

響應示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "warrants": [
      {
        "code": "HK.25894",
        "name": "騰訊摩通六七購B.C",
        "stock_owner": "HK.00700",
        "issuer": "JP",
        "type": "CALL",
        "status": "NORMAL",
        "strike_price": 778.27,
        "cur_price": 0.01,
        "leverage": 453.2,
        "premium": 71.948,
        "street_rate": 5.9,
        "maturity_time": "2026-07-29"
      }
    ]
  },
  "pagination": {
    "has_more": true,
    "next_key": "3",
    "total": 335
  }
}