Skip to content

Get Combo Trading Info ​

POST /api/v1.0/accounts/{acc_id}/combo_trading_info

Query available buying power and margin preview information for combo options orders. Not supported for JP brokers.

When to use

  • Before placing a combo options order (order_class=MLEG), preview buying power and margin here, then Place Order.
  • When modifying an existing combo order, pass order_id for a replace-scenario preview.
  • Single-leg stock / options orders usually do not need this API; for single-leg size limits use Get Max Qty.

Path Parameters ​

ParameterTypeRequiredDescription
acc_idstringYesTrading business account ID.

Request Parameters ​

ParameterTypeRequiredDescription
multi_leg_infomulti_leg_infoYesMulti-leg combo information.
pricestringYesOrder price.
qtystringYesOrder quantity.
sidetrd_sideYesOrder direction.
order_idstringNoOrder ID. Pass when modifying an order.

Request Example ​

bash
curl -X POST 'https://webapi.moomoo.com/api/v1.0/accounts/{acc_id}/combo_trading_info' \
  -H 'Authorization: Bearer <AccessToken>' \
  -H 'Content-Type: application/json' \
  -d '{
    "multi_leg_info": {
      "leg_infos": [
        {
          "leg_code": "US.AAPL230120C00150000",
          "leg_side": "BUY",
          "leg_ratio_qty": "1"
        },
        {
          "leg_code": "US.AAPL230120C00160000",
          "leg_side": "SELL",
          "leg_ratio_qty": "1"
        }
      ]
    },
    "price": "2.50",
    "qty": "1",
    "side": "BUY"
  }' | jq

Response Parameters ​

FieldTypeDescription
option_buying_powerstringAvailable options buying power.
buying_power_decreasestringBuying power decrease from this operation.
margin_previewslist[margin_preview]Margin preview list.

Response Example ​

json
{
  "s": "ok",
  "d": {
    "option_buying_power": "50000.00",
    "buying_power_decrease": "250.00",
    "margin_previews": [
      {
        "name": "Initial Margin",
        "inc_value": "250.00"
      }
    ]
  }
}