Unified Trading Accounts

Add a Unified Trading Account

Changed on

Your first account is the cross-margin main one; every account after that is an isolated sub-account under it, with its own collateral. Send no name and it is labelled Main or Sub1, Sub2… — a label only, which you can change later without changing what the account is.

post/api/futures/account

Request

  • Base URL
    https://api.binibit.com
  • URL
    https://api.binibit.com/api/futures/account
  • 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.

Request body

currencyCodestring nullable

Settlement currency the account is denominated in, e.g. USDT.

leverageinteger

Default leverage for positions opened on this account. Can be changed later.

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