Skip to Content
📈 Futures APITrading APIQuery User Balance

Query User Balance

Request URL

GET /ftapi/v1/account/balance

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

Request Example

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

Response Example

{
    "code": "0",
    "data": {
        "assets": [
            {
                "available": "11631.90264130674743639045",     // Available balance (balance - cross margin unrealized PnL)
                "balance": "12920.00134673674743639045",       // Wallet balance (total assets)
                "canTransfer": "12149.07471130674743639045",   // Transferable amount
                "coin": "USDT",                                // Coin identifier
                "crossLocked": "0",                            // Cross margin locked amount
                "crossMargin": "0",                            // Cross margin
                "crossProfitUnreal": "-517.17207",             // Cross margin unrealized PnL
                "crossedMaintainMargin": "21.5893424",         // Maintenance margin
                "crossedMaintainMarginRate": "0.0018351061760195", // Maintenance margin rate
                "equities": "12369.05869673674743639045",      // Account equity (total assets - unrealized PnL)
                "isolatedLocked": "0",                         // Isolated margin locked amount
                "isolatedMargin": "637.12131993",              // Isolated margin used
                "locked": "770.92663543",                      // Total locked amount (isolated + cross)
                "profitUnreal": "-550.94265",                  // Unrealized PnL (cross + isolated)
                "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 Current PositionsQuery User Info