ETF 篩選

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

ETF 專用條件篩選。按市場過濾、排序、分頁，並返回指定因子。 篩選條件用 ETF FieldID（費率/槓桿/風格箱/持股分佈/跟蹤誤差等），使用本接口篩選 ETF。 取值在 items[].values[]，ival 為按指標倍率縮放的整數（含倍率）。

請求參數

參數	類型	位置	必填	說明
market	string	請求體	是	ETF 市場：US、HK、JP、AU、SG、CA、MY、CN。
screen_groups	object[]	請求體	否	篩選條件，多組按 AND 組合。每項結構為 {field_id, intervals?, choices?, sub_groups?}。
sorts	object[]	請求體	否	排序規則，每項 {sort_field_id, sort_flag}；sort_flag 為 0 升序、1 降序；預設按 AUM 降序。
need_fields	object[]	請求體	否	返回因子，每項 {field_id}；預設返回代碼（2）、價格（5）、AUM（10）。
offset	int	請求體	否	起始下標，預設 0，最小 0。
limit	int	請求體	否	返回條數，預設 20，最大 500。

請求示例

curl -X POST 'https://webapi.moomoo.com/api/v1.0/quote/etf-screen' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <AccessToken>' \
  -d '{"market":"US","sorts":[{"sort_field_id":10,"sort_flag":1}],"need_fields":[{"field_id":2},{"field_id":5},{"field_id":10}],"offset":0,"limit":20}' | jq

響應參數

參數	類型	說明
data.items	object[]	符合條件的 ETF 列表
data.total	integer	符合條件的 ETF 總數
data.items[].code	string	ETF 代碼
data.items[].name	string	ETF 名稱
data.items[].values	object[]	請求的因子取值，ival 為按指標倍率縮放的整數
data.items[].values[].field_id	integer	因子 FieldID
data.items[].values[].ival	integer	數值（含倍率）
data.items[].values[].text	string	文本值
data.items[].values[].content_type	integer	內容類型：1=百分比 2=數值 3=普通數字 4=文本 5=持倉列表
pagination.completed	boolean	是否已到末頁

錯誤碼

ret_code	error.code	說明
0	—	成功
-3	invalid_parameter	參數缺失或不在允許範圍內
-7	invalid_symbol	標的不存在
-8	unsupported	市場或品類不支持
-9	permission_denied	沒有對應權限
-10	no_data	沒有可返回的數據
-11	rate_limited	調用過於頻繁

響應示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "total": 1,
    "items": [
      {
        "code": "US.SPY",
        "name": "SPDR S&P 500 ETF",
        "values": [
          {"field_id": 2, "text": "US.SPY"},
          {"field_id": 5, "ival": 500000000},
          {"field_id": 10, "ival": 500000000000}
        ]
      }
    ]
  },
  "pagination": {
    "completed": true
  }
}