查询所有合约账户信息
限速规则：1次/s
HTTP请求 查询所有合约账户信息
GET /api/swap/v3/account/accounts
返回数据:
[
{
"symbol":"cmt_btcusdt", //合约名称
"equity":"0.00000000", //账户权益
"fixed_balance":"0.00000000",//废弃字段
"total_avail_balance":"0.00000000", //可用余额
"margin":"0", //已用保证金
"realized_pnl":"0", //已实现盈亏
"unrealized_pnl":"0", //未实现盈亏
"longMarginRatio":"0",//逐仓多仓保证金率
"shortMarginRatio": "0",//逐仓空仓保证金率
"marginRatio": "0",//全仓保证金率
"margin_frozen":"0", //开仓冻结保证金
"timestamp":"1658098718494", //创建时间
"margin_mode":"fixed", //仓位模式 fixed逐仓模式 crossed全仓模式
"forwardContractFlag":true //是否是正向合约
}
]
返回值说明
单个合约账户信息
限速规则：5次/s
HTTP请求 单个合约账户信息
GET /api/swap/v3/account/account
请求参数
返回数据:
{
"symbol":"cmt_btcusdt", //合约名称
"equity":"0.00000000", //账户权益
"fixed_balance":"0.00000000", //废弃字段
"total_avail_balance":"0.00000000", //可用余额
"margin":"0", //已用保证金
"realized_pnl":"0", //已实现盈亏
"unrealized_pnl":"0", //未实现盈亏
"longMarginRatio":"0",//逐仓多仓保证金率
"shortMarginRatio": "0",//逐仓空仓保证金率
"marginRatio": "0",//全仓保证金率
"margin_frozen":"0", //开仓冻结保证金
"timestamp":"1658098718494", //创建时间
"margin_mode":"fixed", //仓位模式 fixed逐仓模式 crossed全仓模式
"forwardContractFlag":true //是否是正向合约
}
返回值说明
获取单个合约的用户配置
限速规则：5次/s
HTTP请求 获取单个合约的用户配置
GET /api/swap/v3/account/settings
请求参数
返回数据:
{
"symbol":"cmt_btcusdt", //合约名称
"long_leverage":"100", //多仓杠杆
"margin_mode":"fixed", //持仓模式 fixed逐仓模式 crossed全仓模式
"short_leverage":"2", //空仓杠杆
"forwardContractFlag":true //是否是正向合约
}
返回值说明
调整杠杆
限速规则：5次/s
HTTP请求 调整杠杆
POST /api/swap/v3/account/leverage
请求参数
返回数据:
{
"symbol":"cmt_btcusdt", //合约名称
"long_leverage":"100", //多仓杠杆
"margin_mode":"fixed", //持仓模式 fixed逐仓模式 crossed全仓模式
"short_leverage":"2", //空仓杠杆
"forwardContractFlag":true //是否是正向合约
}
返回值说明
调整保证金
限速规则：20次/2s
HTTP请求 调整保证金
POST /api/swap/v3/account/adjustMargin
请求参数
返回数据:
{
"result":true, //结果
"orderNo":"527252921197264814" //订单号
}
返回值说明
自动追加保证金
限速规则：5次/s
HTTP请求 自动追加保证金
POST /api/swap/v3/account/modifyAutoAppendMargin
请求参数
返回数据:
{
"result":true, //设置结果
"append_type":1 //当前设置状态：0表示不自动追加，1表示自动追加
}
返回值说明
获取全部合约仓位信息
限速规则：5次/s
HTTP请求 获取全部合约仓位信息
GET /api/swap/v3/position/allPosition
返回数据:
[
{
"margin_mode":"fixed", //持仓模式 fixed逐仓模式 crossed全仓模式
"holding":[
{
"symbol":"cmt_btcusdt", //合约名称
"liquidation_price":"0.00", //预估爆仓价
"position":"0", //持仓数量
"avail_position":"0", //可平数量
"avg_cost":"0.00", //开仓平均价
"leverage":"2", //杠杆
"realized_pnl":"0.00000000", //已实现盈亏
"keepMarginRate":"0.005", //维持保证金率
"side":"1", //持仓方向 标注废弃
"holdSide": "1",// 持仓方向
"timestamp":"1557571623963", //系统时间戳
"margin":"0.0000000000000000", //已用保证金
"unrealized_pnl":"0.00000000" //未实现盈亏
}
]
}
]
返回值说明
获取单个合约仓位信息
限速规则：10次/s
HTTP请求 获取单个合约仓位信息
GET /api/swap/v3/position/singlePosition
请求参数
返回数据:
{
"margin_mode":"fixed", //持仓模式 fixed逐仓模式 crossed全仓模式
"holding":[
{
"symbol":"cmt_btcusdt", //合约名称
"liquidation_price":"0.00", //预估爆仓价
"position":"0", //持仓数量
"avail_position":"0", //可平数量
"avg_cost":"0.00", //开仓平均价
"leverage":"2", //杠杆
"realized_pnl":"0.00000000", //已实现盈亏
"keepMarginRate":"0.005", //维持保证金率
"side":"1", //持仓方向 标注废弃
"holdSide": "1",// 持仓方向
"timestamp":"1557571623963", //系统时间戳
"margin":"0.0000000000000000", //已用保证金
"unrealized_pnl":"0.00000000" //未实现盈亏
}
]
}
返回值说明
修改用户账户模式
限速规则：20次/s
HTTP请求 修改用户账户模式
POST /api/swap/v3/position/changeHoldModel
请求参数
返回数据:
{
"symbol":"cmt_btcusdt", //合约名称
"resultHoldMode":1, //返回账户模式 1 逐仓 2 全仓
"switchSuccess":true, //是否修改成功 true 成功 false 失败
"longLeverage":20, //多仓杠杆
"shortLeverage":20, //空仓杠杆
"userId":111 //uid
}
返回值说明
