BUbullish
trading-accounts

Get Trading Account Details by ID

Gets details for specific trading account by tradingAccountId and API key used in the request. It requires bearer token in authorization header.

Ratelimited: True

get/v1/accounts/trading-accounts/{tradingAccountId}

Request

  • Base URL
    https://api.exchange.bullish.com/trading-api
  • Auth
    HTTP bearer

Path parameters

tradingAccountIdstring required

unique trading account ID

Example:111000000000001

Id of the trading account

Response

OK

isBorrowingstring required

whether the trading account is borrowing

isLendingstring required

whether the trading account is lending

makerFeestring

Deprecated and no longer accurate. See tradeFeeRate instead

takerFeestring

Deprecated and no longer accurate. See tradeFeeRate instead

maxInitialLeveragestring required

max initial leverage

tradingAccountIdstring required

unique trading account ID

tradingAccountNamestring required

name of the trading account

tradingAccountDescriptionstring required

description of the trading account

isPrimaryAccountstring required

whether this is the primary account

rateLimitTokenstring required

unique rate limit token of the trading account

isDefaultedstring required

whether the trading account is defaulted

riskLimitUSDstring required

The maximum allowed borrowing for this trading account (in USD currency)

totalLiabilitiesUSDstring required

The The total liabilities for this trading account (in USD currency)

totalBorrowedUSDstring required

total borrowed across all assets in this trading account displayed in the reference asset in USD

totalCollateralUSDstring required

total collateral across all assets in this trading account displayed in the reference asset in USD

initialMarginUSDstring required

The minimum margin one must maintain in order to be able to purposefully increase risk

warningMarginUSDstring required

The minimum margin when the customer will receive warning via email/notifications over UI

liquidationMarginUSDstring required

The minimum value of margin one must maintain in order to avoid liquidation

fullLiquidationMarginUSDstring required

The value of margin when full liquidation occurs

defaultedMarginUSDstring required

The value of margin when this trading account will be moved into a Defaulted state

endCustomerIdstring required

The end customer id used for self trade prevention (default is institution id, max 32 characters)

isConcentrationRiskEnabledstring required

whether concentration risk checks are enforced for an account when sending new orders. By default, concentration risk checks will apply to all accounts

liquidityAddonUSDstring required

expected market impact of unwinding the portfolio in the case of a liquidation event

marketRiskUSDstring required

the worst possible loss on the portfolio based on scenario analysis

Example response

{
  "isBorrowing": "false",
  "isLending": "false",
  "makerFee": "0.00000000",
  "takerFee": "0.00020000",
  "maxInitialLeverage": "1",
  "tradingAccountId": "111000000000001",
  "tradingAccountName": "algo trading account",
  "tradingAccountDescription": "algo trading account with experimental strategy",
  "isPrimaryAccount": "false",
  "rateLimitToken": "97d98951b12fb11f330dd9cb1b807d888c702679ee602edcf1ebc6bac17ad63d",
  "isDefaulted": "false",
  "tradeFeeRate": [
    {
      "feeGroupId": 1,
      "makerFee": "0.00005000",
      "takerFee": "0.00005000",
      "makerOtcFee": "0.00005000",
      "takerOtcFee": "0.00005000",
      "brokerFee": "0.00005000",
      "auctionFee": "0.00005000"
    }
  ],
  "riskLimitUSD": "10000.0000",
  "totalLiabilitiesUSD": "14000.0000",
  "totalBorrowedUSD": "12000.0000",
  "totalCollateralUSD": "13000.0000",
  "initialMarginUSD": "0000.0000",
  "warningMarginUSD": "0000.0000",
  "liquidationMarginUSD": "0000.0000",
  "fullLiquidationMarginUSD": "0000.0000",
  "defaultedMarginUSD": "0000.0000",
  "endCustomerId": "PrimeBroker",
  "isConcentrationRiskEnabled": "true",
  "liquidityAddonUSD": "1000.0000",
  "marketRiskUSD": "2000.0000",
  "marginProfile": {
    "initialMarketRiskMultiplierPct": "200.00",
    "warningMarketRiskMultiplierPct": "150.00",
    "liquidationMarketRiskMultiplierPct": "100.00",
    "fullLiquidationMarketRiskMultiplierPct": "75.00",
    "defaultedMarketRiskMultiplierPct": "50.00"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.