Skip to Content
📈 Futures APITrading APIQuery User Info

Query User Info

Request URL

GET /ftapi/v1/account/info

Request Parameters

NameTypeRequiredDescription

Response Parameters

NameTypeDescription
codeSTRINGResponse Code
msgSTRINGResponse Message
successBOOLEANSuccess Flag
data.assetsARRAY
data.assets[].availableSTRING
data.assets[].balanceSTRING
data.assets[].canTransferSTRING
data.assets[].coinSTRING
data.assets[].crossLockedSTRING
data.assets[].crossMarginSTRING
data.assets[].crossProfitUnrealSTRING
data.assets[].crossedMaintainMarginSTRING
data.assets[].crossedMaintainMarginRateSTRING
data.assets[].equitiesSTRING
data.assets[].isolatedLockedSTRING
data.assets[].isolatedMarginSTRING
data.assets[].lockedSTRING
data.assets[].profitUnrealSTRING
data.assets[].totalTrialFundBalanceSTRING
data.assets[].trialFundBalanceSTRING
data.availableSTRING
data.balanceSTRING
data.canTransferSTRING
data.crossLockedSTRING
data.crossMarginSTRING
data.crossProfitUnrealSTRING
data.crossedMaintainMarginSTRING
data.crossedMaintainMarginRateSTRING
data.isolatedLockedSTRING
data.isolatedMarginSTRING
data.positionsARRAY
data.positions[].avgEntryPriceSTRING
data.positions[].bkrFeeSTRING
data.positions[].closedFeeSTRING
data.positions[].ctimeINTEGER
data.positions[].deductFeeAmountSTRING
data.positions[].deductFundingAmountSTRING
data.positions[].deductLossAmountSTRING
data.positions[].entryValueSTRING
data.positions[].feeAmountSTRING
data.positions[].feeAssetIdSTRING
data.positions[].frozenFeeSTRING
data.positions[].fundAmountSTRING
data.positions[].lastPriceSTRING
data.positions[].lastUpdateTimeINTEGER
data.positions[].leverageINTEGER
data.positions[].liquidPriceSTRING
data.positions[].maintainMarginSTRING
data.positions[].marginSTRING
data.positions[].marginModeSTRING
data.positions[].marginRateSTRING
data.positions[].markPriceSTRING
data.positions[].otherClosedFeeSTRING
data.positions[].otherMaintainMarginSTRING
data.positions[].pnlSTRING
data.positions[].posTpSlSizeINTEGER
data.positions[].positionIdSTRING
data.positions[].positionModeSTRING
data.positions[].profitUnrealSTRING
data.positions[].profitUnrealRateSTRING
data.positions[].quantitySTRING
data.positions[].realizedPnlSTRING
data.positions[].sideSTRING
data.positions[].symbolIdSTRING
data.positions[].tpSlSTRING
data.positions[].tpSlOrdersSTRING
data.positions[].tpSlSizeINTEGER
data.positions[].uidSTRING
data.profitUnrealSTRING
data.totalEquitiesSTRING
data.totalLockedSTRING
data.totalTrialFundBalanceSTRING
data.trialFundBalanceSTRING

Request Example

https://openapi.bittap.com/ftapi/v1/account/info

Response Example

{
  "code": "0",
  "data": {
    "assets": [
      {
        "available": "11631.90264130674743639045",     // Available balance (balance - locked - cross margin unrealized PnL)
        "balance": "12282.88002680674743639045",       // Wallet balance (account total assets)
        "canTransfer": "12149.07471130674743639045",   // Transferable amount (can transfer from futures to spot)
        "coin": "USDT",                                // Coin name
        "crossLocked": "0",                            // Cross margin locked amount
        "crossMargin": "0",                            // Cross margin
        "crossProfitUnreal": "-517.17207",             // Cross margin unrealized PnL
        "crossedMaintainMargin": "21.5893424",         // Maintenance margin (minimum margin to prevent liquidation)
        "crossedMaintainMarginRate": "0.0018351061760195", // Maintenance margin rate
        "equities": "11765.70795680674743639045",      // Account equity (balance + profitUnreal)
        "isolatedLocked": "0",                         // Isolated margin locked amount
        "isolatedMargin": "0",                         // Isolated margin
        "locked": "133.8053155",                       // Total locked amount
        "profitUnreal": "-517.17207",                  // Unrealized PnL (total)
        "totalTrialFundBalance": "0",                  // Total trial fund balance
        "trialFundBalance": "0"                        // Available trial fund balance
      }
    ],
 
    "available": "11631.90264130674743639045", // Total available balance
    "balance": "12282.88002680674743639045",   // Total wallet balance
    "canTransfer": "12149.07471130674743639045", // Total transferable amount
    "crossLocked": "0",                        // Total cross margin locked
    "crossMargin": "0",                        // Total cross margin
    "crossProfitUnreal": "-517.17207",         // Total cross margin unrealized PnL
    "crossedMaintainMargin": "21.5893424",     // Total maintenance margin
    "crossedMaintainMarginRate": "0.0018351061760195", // Total maintenance margin rate
    "isolatedLocked": "0",                     // Total isolated margin locked
    "isolatedMargin": "0",                     // Total isolated margin
 
    "positions": [
      {
        "avgEntryPrice": "3.0721",             // Average entry price
        "bkrFee": null,                        // Bankruptcy fee
        "closedFee": null,                     // Close fee
        "ctime": 1758179319000,                // Position creation time (timestamp)
        "deductFeeAmount": "0",                // Deducted fee amount
        "deductFundingAmount": "0",            // Deducted funding fee amount
        "deductLossAmount": "0",               // Deducted loss amount
        "entryValue": "2676.10631",            // Position value (notional value)
        "feeAmount": "0.267610631",            // Fee generated
        "feeAssetId": "USDT",                  // Fee currency
        "frozenFee": "0",                      // Frozen fee
        "fundAmount": "0",                     // Funding fee
        "lastPrice": null,                     // Latest price (may be empty if position unchanged)
        "lastUpdateTime": 1758179319143,       // Last update time
        "leverage": 20,                        // Leverage
        "liquidPrice": "0",                    // Liquidation price (0 means will not trigger)
        "maintainMargin": "0",                 // Maintenance margin
        "margin": "133.8053155",               // Current margin
        "marginMode": "CROSSED",               // Margin mode (CROSSED cross margin / ISOLATED isolated margin)
        "marginRate": null,                    // Margin rate
        "markPrice": null,                     // Mark price
        "otherClosedFee": null,                // Other estimated close fee
        "otherMaintainMargin": null,           // Other maintenance margin
        "pnl": "0",                            // Close position PnL
        "posTpSlSize": 0,                      // Position take profit/stop loss order count
        "positionId": "8039784359178546030",   // Position ID
        "positionMode": "HEDGE",               // Position mode (HEDGE hedge / ONEWAY one-way)
        "profitUnreal": null,                  // Unrealized PnL
        "profitUnrealRate": null,              // Unrealized PnL rate
        "quantity": "871.1",                   // Position quantity
        "realizedPnl": "-0.267610631",         // Realized PnL
        "side": "BUY",                         // Direction (BUY long / SELL short)
        "symbolId": "XRP-USDT-M",              // Contract ID (trading pair)
        "tpSl": null,                          // Take profit/stop loss settings
        "tpSlOrders": [],                      // Take profit/stop loss order list
        "tpSlSize": 0,                         // Take profit/stop loss count
        "uid": "76957286"                      // User ID
      }
    ],
 
    "profitUnreal": "-517.17207", // Total unrealized PnL
    "totalEquities": "11765.70795680674743639045", // Total account equity
    "totalLocked": "133.8053155", // Total locked amount
    "totalTrialFundBalance": "0", // Total trial fund balance
    "trialFundBalance": "0" // Available trial fund balance
  },
  "msg": "Request successful",
  "success": true
}

Error Codes

Error CodeDescription
500Server Error

Code Example

Last updated on:
Query User BalanceQuery User Fee Rate