修改保证金模式
修改指定合约交易对的保证金模式。
接口信息
- 方法:
POST - 路径:
/api/v1/futures/open-api/account/margin-mode
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| symbol | string | 是 | 合约交易对,如 AAPL |
| marginMode | int | 是 | 保证金模式:1=全仓,2=逐仓 |
请求示例
{
"symbol": "AAPL",
"marginMode": 2
}
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码,0 表示成功 |
| data.symbol | string | 合约交易对 |
| data.marginMode | int | 生效的保证金模式 |
响应示例
{
"code": 0,
"data": {
"symbol": "AAPL",
"marginMode": 2
}
}
与下单的关系
此接口是切换保证金模式的专用 API,下单接口不支持通过传参切换模式。
切换成功后,后续 创建订单 将自动使用新的保证金模式。建议先通过 账户合约配置 查询当前 marginMode,确认是否需要调用本接口。
错误码
业务错误以 HTTP 200 返回,通过 body code 字段区分。
| code | 说明 |
|---|---|
| 3000 | 交易对不存在 |
| 8009 | 切换保证金模式失败 |
| 8010 | 有持仓,不支持调整保证金模式 |