账户信息V2 (USER_DATA)
接口描述
现有账户信息。 用户在单资产模式和多资产模式下会看到不同结果，响应部分的注释解释了两种模式下的不同。
HTTP请求
GET /fapi/v3/account
请求权重
5
请求参数
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| recvWindow | LONG | NO | |
| timestamp | LONG | YES |
响应示例
单资产模式
{
"totalInitialMargin": "0.00000000", // 当前所需起始保证金总额(存在逐仓请忽略), 仅计算usdt资产positions), only for USDT asset
"totalMaintMargin": "0.00000000", // 维持保证金总额, 仅计算usdt资产
"totalWalletBalance": "103.12345678", // 账户总余额, 仅计算usdt资产
"totalUnrealizedProfit": "0.00000000", // 持仓未实现盈亏总额, 仅计算usdt资产
"totalMarginBalance": "103.12345678", // 保证金总余额, 仅计算usdt资产
"totalPositionInitialMargin": "0.00000000", // 持仓所需起始保证金(基于最新标记价格), 仅计算usdt资产
"totalOpenOrderInitialMargin": "0.00000000", // 当前挂单所需起始保证金(基于最新标记价格), 仅计算usdt资产
"totalCrossWalletBalance": "103.12345678", // 全仓账户余额, 仅计算usdt资产
"totalCrossUnPnl": "0.00000000", // 全仓持仓未实现盈亏总额, 仅计算usdt资产
"availableBalance": "103.12345678", // 可用余额, 仅计算usdt资产
"maxWithdrawAmount": "103.12345678" // 最大可转出余额, 仅计算usdt资产
"assets": [
{
"asset": "USDT", // 资产
"walletBalance": "23.72469206", // 余额
"unrealizedProfit": "0.00000000", // 未实现盈亏
"marginBalance": "23.72469206", // 保证金余额
"maintMargin": "0.00000000", // 维持保证金
"initialMargin": "0.00000000", // 当前所需起始保证金
"positionInitialMargin": "0.00000000", // 持仓所需起始保证金(基于最新标记价 格)
"openOrderInitialMargin": "0.00000000", // 当前挂单所需起始保证金(基于最新标记价格)
"crossWalletBalance": "23.72469206", // 全仓账户余额
"crossUnPnl": "0.00000000" // 全仓持仓未实现盈亏
"availableBalance": "23.72469206", // 可用余额
"maxWithdrawAmount": "23.72469206", // 最大可转出余额
"updateTime": 1625474304765 // 更新时间
},
{
"asset": "USDC",
"walletBalance": "103.12345678",
"unrealizedProfit": "0.00000000",
"marginBalance": "103.12345678",
"maintMargin": "0.00000000",
"initialMargin": "0.00000000",
"positionInitialMargin": "0.00000000",
"openOrderInitialMargin": "0.00000000",
"crossWalletBalance": "103.12345678",
"crossUnPnl": "0.00000000"
"availableBalance": "126.72469206",
"maxWithdrawAmount": "103.12345678",
"updateTime": 1625474304765
}
],
"positions": [ // 仅有仓位或挂单的交易对会被返回
// 根据用户持仓模式展示持仓方向，即单向模式下只返回BOTH持仓情况，双向模式下只返回 LONG 和 SHORT 持仓情况
{
"symbol": "BTCUSDT", // 交易对
"positionSide": "BOTH", // 持仓方向
"positionAmt": "1.000", // 持仓数量
"unrealizedProfit": "0.00000000", // 持仓未实现盈亏
"isolatedMargin": "0.00000000",
"notional": "0",
"isolatedWallet": "0",
"initialMargin": "0", // 持仓所需起始保证金(基于最新标记价格)
"maintMargin": "0", // 当前杠杆下用户可用的最大名义价值
"updateTime": 0 // 更新时间
}
]
}
多资产模式
{
"totalInitialMargin": "0.00000000", // 以USD计价的所需起始保证金总额
"totalMaintMargin": "0.00000000", // 以USD计价的维持保证金总额
"totalWalletBalance": "126.72469206", // 以USD计价的账户总余额
"totalUnrealizedProfit": "0.00000000", // 以USD计价的持仓未实现盈亏总额
"totalMarginBalance": "126.72469206", // 以USD计价的保证金总余额
"totalPositionInitialMargin": "0.00000000", // 以USD计价的持仓所需起始保证金(基于最新标记价格)
"totalOpenOrderInitialMargin": "0.00000000", // 以USD计价的当前挂单所需起始保证金(基于最新标记价格)
"totalCrossWalletBalance": "126.72469206", // 以USD计价的全仓账户余额
"totalCrossUnPnl": "0.00000000", // 以USD计价的全仓持仓未实现盈亏总额
"availableBalance": "126.72469206", // 以USD计价的可用余额
"maxWithdrawAmount": "126.72469206" // 以USD计价的最大可转出余额
"assets": [
{
"asset": "USDT", // 资产
"walletBalance": "23.72469206", // 余额
"unrealizedProfit": "0.00000000", // 未实现盈亏
"marginBalance": "23.72469206", // 保证金余额
"maintMargin": "0.00000000", // 维持保证金
"initialMargin": "0.00000000", // 当前所需起始保证金
"positionInitialMargin": "0.00000000", // 持仓所需起始保证金(基于最新标记价格)
"openOrderInitialMargin": "0.00000000", // 当前挂单所需起始保证金(基于最新标记价格)
"crossWalletBalance": "23.72469206", // 全仓账户余额
"crossUnPnl": "0.00000000" // 全仓持仓未实现盈亏
"availableBalance": "23.72469206", // 可用余额
"maxWithdrawAmount": "23.72469206", // 最大可转出余额
"updateTime": 1625474304765 // 更新时间
},
{
"asset": "USDC",
"walletBalance": "103.12345678",
"unrealizedProfit": "0.00000000",
"marginBalance": "103.12345678",
"maintMargin": "0.00000000",
"initialMargin": "0.00000000",
"positionInitialMargin": "0.00000000",
"openOrderInitialMargin": "0.00000000",
"crossWalletBalance": "103.12345678",
"crossUnPnl": "0.00000000"
"availableBalance": "126.72469206",
"maxWithdrawAmount": "103.12345678",
"updateTime": 1625474304765
}
],
"positions": [ // 仅有仓位或挂单的交易对会被返回
// 根据用户持仓模式展示持仓方向，即单向模式下只返回BOTH持仓情况，双向模式下只返回 LONG 和 SHORT 持仓情况
{
"symbol": "BTCUSDT", // 交易对
"positionSide": "BOTH", // 持仓方向
"positionAmt": "1.000", // 持仓数量
"unrealizedProfit": "0.00000000", // 持仓未实现盈亏
"isolatedMargin": "0.00000000",
"notional": "0",
"isolatedWallet": "0",
"initialMargin": "0", // 持仓所需起始保证金(基于最新标记价格)
"maintMargin": "0", // 当前杠杆下用户可用的最大名义价值
"updateTime": 0 // 更新时间
}
]
}