Get Margin Ratio

GET /api/v1.0/margin_ratio

Query margin and short-selling data for symbols. Supports batch query of up to 10 symbols.

When to use

• Before placing, call this API when you need to know whether a symbol allows margin buy / short sell, short pool availability, and rates.
• Take security_firm from Get Authorized Trading Accounts; format codes the same way as place order (market.symbol).
• This returns symbol-level margin/short attributes, not the account’s current buying power. For funds and tradable size, see Get Account Funds and Get Max Qty.

Request Parameters

Parameter	Type	Position	Required	Description
security_firm	security_firm	Query	Yes	Security firm identifier.
codes	string	Query	Yes	Symbol code list, multiple codes separated by commas. Format: market.symbol, e.g. HK.00700,US.AAPL. Maximum 10 symbols.

Request Example

curl -X GET 'https://webapi.moomoo.com/api/v1.0/margin_ratio?security_firm=FUTUSECURITIES&codes=HK.00700,US.AAPL' \
  -H 'Authorization: Bearer <AccessToken>' | jq

Response Parameters

Field	Type	Description
margin_ratios	list[margin_ratio]	Margin ratio data list.

Response Example

{
  "s": "ok",
  "d": {
    "margin_ratios": [
      {
        "code": "HK.00700",
        "is_long_permit": true,
        "is_short_permit": true,
        "short_pool_remain": "100000",
        "short_fee_rate": "0.003%",
        "alert_long_ratio": "130.00%",
        "alert_short_ratio": "130.00%",
        "im_long_ratio": "50.00%",
        "im_short_ratio": "50.00%",
        "mcm_long_ratio": "30.00%",
        "mcm_short_ratio": "30.00%",
        "mm_long_ratio": "25.00%",
        "mm_short_ratio": "25.00%"
      }
    ]
  }
}