Skip to content

查询最大买卖数量 ​

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_idstring是业务账户 ID。

请求参数 ​

参数类型位置必填说明
codestring查询是标的代码。格式:market.symbol,例如 US.AAPL
pricestring查询否非市价单的价格。期货账户精确到 9 位小数,外汇账户精确到 5 位小数,证券账户精确到 4 位小数,超出部分四舍五入。
order_typestring查询是订单类型。可选值参见 命名词典
sessiontrading_session查询否交易时段(仅美股适用)。
order_idstring查询否订单 ID。默认为空查询新订单最大可用数量;传入时返回该订单最大可改数量。下单成功后请稍后再查(建议间隔 0.5 秒以上)。
position_idstring查询否可选。控制可平数量的粒度:传入时按指定持仓返回最大可平数量(max_position_sell / max_buy_back 按持仓维度计算),必须为有效持仓 ID;不传时按标的聚合返回。
sub_acc_idstring查询条件必填子账户 ID。下单时作为 sub_acc_id 传入。日本账户必填。

响应参数 ​

字段类型说明
max_cash_buystring现金可买
max_cash_and_margin_buystring融资可买
max_position_sellstring持仓可卖
max_sell_shortstring可做空
max_buy_backstring可买回(平空仓)
long_required_imstring买入一份合约所需初始保证金变动
short_required_imstring卖出一份合约所需初始保证金变动

响应示例 ​

json
{
  "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"
  }
}

失败响应:

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