查询用户信息
请求地址
GET /ftapi/v1/account/info
请求参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|
响应参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| code | string | 响应代码 |
| msg | string | 响应消息 |
| success | boolean | 是否成功 |
| data | object | 账户详情 |
| data.assets | array | 资产列表 |
| data.available | string | 总可用余额 |
| data.balance | string | 总钱包余额 |
| data.canTransfer | string | 总可划转金额 |
| data.crossLocked | string | 全仓冻结总额 |
| data.crossMargin | string | 全仓保证金总额 |
| data.crossProfitUnreal | string | 全仓未实现盈亏总额 |
| data.crossedMaintainMargin | string | 总维持保证金 |
| data.crossedMaintainMarginRate | string | 总维持保证金率 |
| data.isolatedLocked | string | 逐仓冻结总额 |
| data.isolatedMargin | string | 逐仓保证金总额 |
| data.positions | array | 持仓列表 |
| data.profitUnreal | string | 总未实现盈亏 |
| data.totalEquities | string | 总账户权益 |
| data.totalLocked | string | 总冻结金额 |
| data.totalTrialFundBalance | string | 总体验金余额 |
| data.trialFundBalance | string | 可用体验金余额 |
请求示例
https://openapi.bittap.com/ftapi/v1/account/info响应示例
{
"code": "0",
"data": {
"assets": [
{
"available": "11631.90264130674743639045", // 可用余额（balance - 冻结 - 全仓未实现盈亏）
"balance": "12282.88002680674743639045", // 钱包余额（账户总资产）
"canTransfer": "12149.07471130674743639045", // 可划转金额（可从合约划转到现货）
"coin": "USDT", // 币种名称
"crossLocked": "0", // 全仓冻结金额
"crossMargin": "0", // 全仓保证金
"crossProfitUnreal": "-517.17207", // 全仓未实现盈亏
"crossedMaintainMargin": "21.5893424", // 维持保证金（防爆仓要求的最小保证金）
"crossedMaintainMarginRate": "0.0018351061760195", // 维持保证金率
"equities": "11765.70795680674743639045", // 账户权益（balance + profitUnreal）
"isolatedLocked": "0", // 逐仓冻结金额
"isolatedMargin": "0", // 逐仓保证金
"locked": "133.8053155", // 总冻结金额
"profitUnreal": "-517.17207", // 未实现盈亏（总计）
"totalTrialFundBalance": "0", // 总体验金余额
"trialFundBalance": "0" // 可用体验金余额
}
],
"available": "11631.90264130674743639045", // 总可用余额
"balance": "12282.88002680674743639045", // 总钱包余额
"canTransfer": "12149.07471130674743639045", // 总可划转金额
"crossLocked": "0", // 全仓冻结总额
"crossMargin": "0", // 全仓保证金总额
"crossProfitUnreal": "-517.17207", // 全仓未实现盈亏总额
"crossedMaintainMargin": "21.5893424", // 总维持保证金
"crossedMaintainMarginRate": "0.0018351061760195", // 总维持保证金率
"isolatedLocked": "0", // 逐仓冻结总额
"isolatedMargin": "0", // 逐仓保证金总额
"positions": [
{
"avgEntryPrice": "3.0721", // 平均开仓价
"bkrFee": null, // 破产手续费
"closedFee": null, // 平仓手续费
"ctime": 1758179319000, // 仓位创建时间（时间戳）
"deductFeeAmount": "0", // 抵扣手续费金额
"deductFundingAmount": "0", // 抵扣资金费用金额
"deductLossAmount": "0", // 抵扣亏损金额
"entryValue": "2676.10631", // 仓位价值（名义价值）
"feeAmount": "0.267610631", // 已产生手续费
"feeAssetId": "USDT", // 手续费币种
"frozenFee": "0", // 冻结手续费
"fundAmount": "0", // 资金费用
"lastPrice": null, // 最新价（若仓位未变动可能为空）
"lastUpdateTime": 1758179319143, // 最后更新时间
"leverage": 20, // 杠杆倍数
"liquidPrice": "0", // 强平价格（0 表示不会触发）
"maintainMargin": "0", // 维持保证金
"margin": "133.8053155", // 当前保证金
"marginMode": "CROSSED", // 保证金模式（CROSSED 全仓 / ISOLATED 逐仓）
"marginRate": null, // 保证金率
"markPrice": null, // 标记价格
"otherClosedFee": null, // 其它预计平仓手续费
"otherMaintainMargin": null, // 其它维持保证金
"pnl": "0", // 平仓盈亏
"posTpSlSize": 0, // 仓位止盈止损单数量
"positionId": "8039784359178546030", // 仓位 ID
"positionMode": "HEDGE", // 持仓模式（HEDGE 对冲 / ONEWAY 单向）
"profitUnreal": null, // 未实现盈亏
"profitUnrealRate": null, // 未实现盈亏率
"quantity": "871.1", // 仓位数量
"realizedPnl": "-0.267610631", // 已实现盈亏
"side": "BUY", // 方向（BUY 做多 / SELL 做空）
"symbolId": "XRP-USDT-M", // 合约 ID（交易对）
"tpSl": null, // 止盈止损设置
"tpSlOrders": [], // 止盈止损订单列表
"tpSlSize": 0, // 止盈止损数量
"uid": "76957286" // 用户 ID
}
],
"profitUnreal": "-517.17207", // 总未实现盈亏
"totalEquities": "11765.70795680674743639045", // 总账户权益
"totalLocked": "133.8053155", // 总冻结金额
"totalTrialFundBalance": "0", // 总体验金余额
"trialFundBalance": "0" // 可用体验金余额
},
"msg": "Request successful",
"success": true
}错误码解释
| 代码 | 描述 |
|---|---|
| 500 | 系统内部错误 |
代码示例
最后更新于: