Unified Trading Accounts

List the caller's Unified Trading Accounts

Changed on

Returns every UTA the caller owns with its live balance, margin and leverage: the cross-margin main account plus each isolated sub-account. Read accountType — not name, which the owner can rename to anything — to tell them apart, and pass id as futuresAccountId on the order, position and transaction-history endpoints.

Served on both api/uta/accounts and the original api/futures/account, which keeps working unchanged.

get/api/uta/accounts

Request

  • Base URL
    https://api.binibit.com
  • URL
    https://api.binibit.com/api/uta/accounts
  • Auth
    none declared

Headers

Your API key, verbatim. Create one at https://azbit.com/dashboard/settings/api-settings.

Signature of THIS request — lower-case hex of HMAC-SHA256 over publicKey + fullUrl + body, keyed with your private key. It changes with every request, so it cannot be set once and reused. Full algorithm and code samples are at the top of this page.

Response

OK

idstring uuid

Account identifier — the value to pass as futuresAccountId on the other endpoints.

userIdstring nullable

Owner of the account — the caller.

namestring nullable

Display label, editable by the owner. Defaults are Main for the main account and Sub1, Sub2, … for sub-accounts — but treat it as free text: it identifies nothing. Use PublicApi.Models.Futures.FuturesAccountDto.AccountType to tell the main account from a sub-account.

accountType'Funding' | 'UnifiedTradingMain' | 'UnifiedTradingSubAccount' | 'System' | 'Demo'

What a Unified Trading Account IS. Serialized by NAME, so an integrator never has to keep a table of magic numbers — and the numeric values still match the platform's own, so an unmapped future value degrades to the number instead of being lost.

balancenumber double

Settled funds on the account, in PublicApi.Models.Futures.FuturesAccountDto.CurrencyCode. Open-position PnL is NOT in here until the position closes — PublicApi.Models.Futures.FuturesAccountDto.Equity is the figure that includes it.

blockedCopyTradingBalancenumber double

Part of PublicApi.Models.Futures.FuturesAccountDto.Balance reserved for copy-trading and unavailable as margin.

usedMarginnumber double

Part of PublicApi.Models.Futures.FuturesAccountDto.Balance currently committed as margin to open positions.

leverageinteger

Default leverage for new positions on this account.

equitynumber double

Balance plus unrealized PnL — what the account is worth if every position closed at the current mark.

unrealizedPnlnumber double

Profit or loss on open positions at the current mark, not yet booked to the balance.

freeMarginnumber double

Balance not yet committed as margin. Computed, not stored.

marginLevelnumber double

Equity as a percentage of used margin — how much cushion the open positions have. 0 when nothing is open, which means "no positions", not "no cushion". Computed, not stored.

isLiquidatedboolean

True while the account is liquidated and cannot open new positions.

liquidationTimestampstring date-time nullable

When the account was last liquidated (UTC), or null if it never was.

currencyCodestring nullable

Currency the account is denominated in and settles in, e.g. USDT.

Changes