查詢最大買賣數量

GET /api/v1.0/accounts/{acc_id}/acctradinginfo

查詢指定交易賬戶下的最大可買可賣數量，也可查詢指定訂單的最大可改數量。

什麼時候用

• 下單前：傳入與即將下單一致的 code、order_type，非市價單建議同時傳 price；用返回的 max_cash_buy / max_cash_and_margin_buy / max_position_sell 等約束下單數量。
• 改單前：傳入原訂單的 order_id，查詢該單最大可改數量。下單成功後請稍後再查（見下方 order_id 參數說明）。
• 日本賬戶：必須傳 sub_acc_id，與下單時一致。
• 按持倉平倉：傳入 position_id 時，max_position_sell / max_buy_back 按該持倉計算；不傳則按標的聚合。
• 本接口只做數量預估，不代替下單；實際能否成交仍以下單與後續訂單狀態為準。

路徑參數

參數	類型	必填	說明
acc_id	string	是	業務賬戶 ID。

請求參數

參數	類型	位置	必填	說明
code	string	查詢	是	標的代碼。格式：market.symbol，例如 US.AAPL
price	string	查詢	否	非市價單的價格。期貨賬戶精確到 9 位小數，外匯賬戶精確到 5 位小數，證券賬戶精確到 4 位小數，超出部分四捨五入。
order_type	string	查詢	是	訂單類型。可選值參見 命名詞典
session	trading_session	查詢	否	交易時段（僅美股適用）。
order_id	string	查詢	否	訂單 ID。默認為空查詢新訂單最大可用數量；傳入時返回該訂單最大可改數量。下單成功後請稍後再查（建議間隔 0.5 秒以上）。
position_id	string	查詢	否	可選。控制可平數量的粒度：傳入時按指定持倉返回最大可平數量（max_position_sell / max_buy_back 按持倉維度計算），必須為有效持倉 ID；不傳時按標的聚合返回。
sub_acc_id	string	查詢	條件必填	子賬戶 ID。下單時作為 sub_acc_id 傳入。日本賬戶必填。

響應參數

字段	類型	說明
max_cash_buy	string	現金可買
max_cash_and_margin_buy	string	融資可買
max_position_sell	string	持倉可賣
max_sell_short	string	可做空
max_buy_back	string	可買回（平空倉）
long_required_im	string	買入一份合約所需初始保證金變動
short_required_im	string	賣出一份合約所需初始保證金變動

響應示例

{
  "s": "ok",
  "d": {
    "max_cash_buy": "3700",
    "max_cash_and_margin_buy": "3900",
    "max_position_sell": "2100",
    "max_sell_short": "4300",
    "max_buy_back": "0",
    "long_required_im": "0",
    "short_required_im": "0"
  }
}

失敗響應：

{
  "s": "error",
  "errcode": 485210001,
  "errmsg": "invalid order_type"
}