Skip to main content

Get Single Account

Frequency limit: 10 times/1s (uid)

Description

Get account details with the given 'marginCoin' and 'productType'

HTTP Request

  • GET /api/v2/mix/account/account
Request Example
curl "https://api.cointr.com/api/v2/mix/account/account?symbol=btcusdt&productType=USDT-FUTURES&marginCoin=usdt" \
-H "ACCESS-KEY:*******" \
-H "ACCESS-SIGN:*" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:en-US" \
-H "Content-Type: application/json"

Request Parameters

ParameterTypeRequiredDescription
symbolStringYesTrading pair
productTypeStringYesProduct type
USDT-FUTURES USDT professional futures
COIN-FUTURES Mixed futures
USDC-FUTURES USDC professional futures
SUSDT-FUTURES USDT professional futures demo
SCOIN-FUTURES Mixed futures demo
SUSDC-FUTURES USDC professional futures demo
marginCoinStringYesMargin coin
Response Example
{
"code": "00000",
"data": {
"marginCoin": "USDT",
"locked": "0",
"available": "13168.86110692",
"crossedMaxAvailable": "13168.86110692",
"isolatedMaxAvailable": "13168.86110692",
"maxTransferOut": "13168.86110692",
"accountEquity": "13178.86110692",
"usdtEquity": "13178.861106922",
"btcEquity": "0.344746495477",
"crossedRiskRate": "0",
"crossedMarginLeverage": "20",
"isolatedLongLever": "20",
"isolatedShortLever": "20",
"marginMode": "crossed",
"posMode": "hedge_mode",
"unrealizedPL": "",
"coupon": "0"
},
"msg": "success",
"requestTime": 1627292199523
}

Response Parameters

ParameterTypeDescription
>marginCoinStringMargin coin
>lockedStringLocked quantity (margin coin). Lockup will be triggered when there is a position to be closed.
>availableStringAvailable quantity in the account
>crossedMaxAvailableStringMaximum available balance to open positions under the cross margin mode (margin coin)
>isolatedMaxAvailableStringMaximum available balance to open positions under the isolated margin mode (margin coin)
>maxTransferOutStringMaximum transferable amount
>accountEquityStringAccount equity (margin coin), including unrealized PnL (based on mark price)
>usdtEquityStringAccount equity in USDT
>btcEquityStringAccount equity in BTC
>crossedRiskRateStringRisk ratio in cross margin mode
>crossedMarginLeverageStringLeverage in cross margin mode
>isolatedLongLeverStringLeverage of long positions in isolated margin mode
>isolatedShortLeverStringLeverage of short positions in isolated margin mode
>marginModeStringMargin mode.
isolated – isolated margin mode;
crossed – cross margin mode
>posModeStringPosition mode
one_way_mode: one-way mode
hedge_mode: hedge mode
>unrealizedPLStringUnrealized PnL
>couponStringTrading bonus
>crossedUnrealizedPLStringunrealizedPL for croessed
>isolatedUnrealizedPLStringunrealizedPL for isolated