預估可交易數量

此端點根據用戶可用資金或持倉，並依指定比例，計算某一產品可買入或賣出的最大數量。適用於策略分配、風險控管或作為用戶下單時的 UI 輔助提示。

---

HTTP 請求

POST /trade/v1/orders/quantity

---

請求參數

參數名稱	類型	是否必填	說明
market	ENUM	是	市場代碼（參見支援的 market 列舉值）
symbol	STRING	是	股票代碼／標的
order_side	ENUM	是	買賣方向：buy 或 sell（參見 order_side 列舉定義）
price	DECIMAL	否	交易價格（order_side 為 buy 時必填）
ratio	DECIMAL	是	資金或持倉分配比例（小於 1，例如 0.5）

---

cURL 請求範例

curl --location --request POST '{$base_url}/trade/v1/orders/quantity' \
--header 'X-API-Key: YOUR_API_KEY' \
--header 'X-API-Signature: YOUR_GENERATED_SIGNATURE' \
--header 'X-API-Timestamp: 1746774142003' \
--header 'Content-Type: application/json' \
--data-raw '{
    "market": "hkex",
    "symbol": "00700",
    "order_side": "buy",
    "price": 438.30,
    "ratio": 0.5
}'

---

成功回應格式

欄位名稱	類型	說明
qty	DECIMAL	可交易的最大數量

---

成功回應範例

{
	"code": 0,
	"data": {
		"qty": 20000
	}
}

---

錯誤回應範例

{
	"code": 500,
	"message": "Internal Service Error",
	"details": ""
}

更多錯誤碼及說明請參見 錯誤碼參考。