查询最大买卖数量
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 | 卖出一份合约所需初始保证金变动 |
响应示例
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"
}