Skip to main content

API Changelog

2026 Changes​

[2026-04]​

Changed​

[2026-03]​

Added​

Changed​

  • Updated REST API - Get OTC Trades NEW filter brokeredBy
  • Updated REST API - Get OTC Trades NEW status APPROVAL_PENDING in OtcTradeExternalStatus
  • Updated REST API - Get OTC Trades NEW fields tradingAccountId, tradingAccountNickname and brokeredBy in response

[2026-02]​

Removed​

2025 Changes​

[2025-12]​

Changed​

  • updated REST API - Get Unconfirmed OTC Trade NEW fields createdAtDatetime, createdAtTimestamp, expireDatetime and expireTimestamp

[2025-11]​

Added​

Removed​

  • Removed deprecated fields maxPriceLimit, minPriceLimit, maxCostLimit, minCostLimit, makerFee, takerFee from Get Markets

[2025-09]​

Added​

[2025-08]​

Added​

[2025-07]​

Added​

Changed​

  • Support for Getting Otc Trade - Get Trades new fields otcMatchId and otcTradeId
  • Updated REST API - Get Markets NEW fields strikePrice
  • Updated REST API - Get Market Tick NEW fields bidIVPercentage, askIVPercentage and greeks

[2025-06]​

Added​

[2025-05]​

Changed​

  • Support for fee rebates - Get Trades new fields tradeRebateAmount and tradeRebateAssetSymbol

Deprecated​

  • Hybrid Order Book WebSocket (unauthenticated) - to be removed June 2025
  • Market Data WebSocket (authenticated) - to be removed June 2025
  • Anonymous Trades WebSocket (unauthenticated) - to be removed June 2025

[2025-04]​

Changed​

[2025-03]​

Added​

Changed​

Deprecated​

  • Updated REST API - Get Trading Account Deprecated fields makerFee and takerFee
  • Updated REST API - Get Markets Deprecated fields makerFee and takerFee

Removed​

2024 Changes​

[2024-12]​

Changed​

  • Updated REST API - Get Trading Account new field totalLiabilitiesUSD
  • Updated WebSocket API - /private-data topic - tradingAccounts new field totalLiabilitiesUSD

[2024-11]​

Added​

Changed​

  • Updated REST API - Get Trading Account new fields liquidityAddonUSD, marketRiskUSD and marginProfile
  • Updated WebSocket API - /private-data topic - tradingAccounts new fields liquidityAddonUSD, marketRiskUSD and marginProfile
  • Updated REST API - Get Assets new nested fields underlyingAsset
  • Updated REST API - Get Markets new field expiryDatetime

Deprecated​

  • Deprecated REST API - [Perpetual Settlement History]
  • Deprecating REST API - GET /trading-api/v1/history/perpetual-settlement

[2024-10]​

Added​

[2024-09]​

Added​

Deprecated​

  • Updated REST API - Get Markets deprecated fields maxInitialLeverage, warningLeverage, liquidationLeverage, fullLiquidationLeverage and defaultedLeverage

[2024-08]​

Added​

[2024-07]​

Added​

  • New APIs
    • WebSocket /trading-api/v1/index-data for index price updates
    • REST - GET /trading-api/v1/index-prices
    • REST - GET /trading-api/v1/index-prices/{assetSymbol}

Changed​

  • Updated REST API - Get Trading Account new field isConcentrationRiskEnabled
  • Updated REST API - Get Markets new fields openInterestUSD, concentrationRiskThresholdUSD and concentrationRiskPercentage
  • Updated REST API - Get Markets new fields roundingCorrectionFactor, makerMinLiquidityAddition, liquidityInvestEnabled and liquidityWithdrawEnabled

[2024-06]​

Changed​

  • Updated REST API - Get Assets new fields name and collateralBands

Deprecated​

  • Updated REST API - Get Assets deprecating field collateralRating

[2024-05]​

Added​

  • WebSocket API /private-data new topic - ammInstructions

[2024-04]​

Deprecated​

  • Moved deprecated items to Deprecated Features & APIs
    • Bullish Key
    • Old Signing Format
    • Hybrid Order Book WebSocket (unauthenticated)
    • Market Data WebSocket (authenticated)
    • V1 Orders APIs
    • V1 AMM Instructions APIs
    • REST - GET /accounts/spot
    • REST - GET /accounts/spot/{symbol}

Removed​

  • Removed decommissioned items
    • REST - POST /trading-api/v1/users/login

[2024-03]​

Added​

Changed​

  • WebSocket API /private-data response models contain new field - tradingAccountId

[2024-02]​

Added​

Changed​

  • Response model changes for GET /trading-api/assets and GET /trading-api/assets/{symbol}
    • new fields totalOfferedLoanQuantity and loanBorrowedQuantity
  • Updated REST API - Get Trading-Accounts new fields totalBorrowedUSD totalCollateralUSD, initialMarginUSD, warningMarginUSD liquidationMarginUSD, fullLiquidationMarginUSD, defaultedMarginUSD, endCustomerId
  • Updated WS API - /private-data WebSocket, tradingAccounts response model updated with new fields

[2024-01]​

Changed​

  • Added new field quoteAmount for response models
    • REST - GET /orders
    • REST - GET /trades
    • WebSocket - orders and trades topic

2023 Changes​

[2023-12]​

Changed​

  • History APIs require date/time range to be specified.
  • Added test instruments.

Added​

  • Direct Connect connectivity option added.

Deprecated​

[2023-11]​

Added​

Changed​

Deprecated​

  • /trading-api/v1/orders - will be removed towards the end of Q3 2024.
  • /trading-api/v1/amm-instructions - will be removed towards the end of Q3 2024.
  • /trading-api/v1/command - will be removed towards the end of Q3 2024.
  • margin, borrowedQuantity, handle deprecated, will be removed towards the end of Q3 2024.
  • liquidityId deprecated, will be removed towards the end of Q3 2024.

[2023-10]​

Added​

  • New heartbeat topic for Private Data WebSocket (authenticated)
  • New ECDSA API Keys and ECDSA based signing
  • Login API - POST /trading-api/v2/users/login supports ECDSA signatures
  • BX-SIGNATURE header supports signatures generated via ECDSA

[2023-09]​

Added​

  • New HMAC API Keys and HMAC based signing
  • Login API - GET /v1/users/hmac/login
  • BX-SIGNATURE header supports signatures generated via HMAC and EDDSA
  • New FIX API - The FIX API is available to institutional clients

[2023-08]​

Added​

  • New REST API - GET /history/borrow-interest
  • New REST API - Cancel All Open Limit Orders after Delay - POST /command?commandType=V1DelayedCancelAllOrders
  • New REST API - logout session - GET /v1/users/logout

[2023-07]​

Added​

  • New GET /accounts/asset and GET /accounts/asset/{symbol}
  • New assetAccounts and tradingAccounts topics in WS /private-data

Changed​

  • borrowedQuantity and isLiquidation fields added to GET /orders and WS /private-data orders topic
  • Calculation for free and used fields changed in GET /accounts/spot, GET /accounts/spot/{symbol} and WS /private-data spotAccounts topic
  • isLending, isBorrowing, isDefaulted, maxInitialLeverage, makerFee and takerFee fields added to GET /accounts/trading-accounts
  • collateralRating and maxBorrow fields added to /assets

[2023-05]​

Added​

  • Add V1CancelAllOrdersByMarket to cancel all open orders by trading account id and market

[2023-04]​

Added​

Changed​

[2023-03]​

Added​

  • Introduce "trading account id" to authenticated REST API and WebSocket
  • Add custody SIGNET support
  • Add unsolicited amend status reason code
  • Add nonce window to /orders to allow out-of-order order requests to be processed

Removed​

  • Remove SEN support

Deprecated​

  • /v1/users/login to be deprecated towards the end of Q2 2023

[2023-01]​

Added​

  • Add AMM instructions API

2022 Changes​

[2022-11]​

Deprecated​

  • Deprecate subscription topics in /private-data - events, positions and marginAccounts
  • Deprecate /accounts/margin, /accounts/margin/{symbol}, /positions and /positions/{symbol}

[2022-10]​

Added​

  • Add Custody API

[2022-08]​

Added​

  • Add anonymous trades WebSocket API

[2022-07]​

Added​

  • Add hybrid order book WebSocket API

Deprecated​

  • Deprecate WebSocket API /v1/private and /v1/market-data

[2022-06]​

Changed​

  • Add handle field to GET /trades and GET /trades/{tradeId}
  • Add handle field to V1TATrade for private data WebSocket
  • Order book default depth of 10 - GET /markets/{symbol}/orderbook/hybrid

[2022-05]​

Added​

  • Add events topic to private data WebSocket

[2022-04]​

Added​

  • Add market data WebSocket API
  • Add private data WebSocket API

[2022-03]​

Added​

  • Add optional depth parameter to GET /markets/{symbol}/orderbook/hybrid?depth=10
  • Add IOC time-in-force order type
  • Add FOK time-in-force order type
  • Add order statusReasonCode map to API documentation
  • Add historical anonymous trades API - GET /history/markets/{symbol}/trades

[2022-02]​

Changed​

  • Add filter by status=CANCELLED to GET /orders?status=CANCELLED

[2022-01]​

Changed​

  • Add pagination support to GET /markets/{symbol}/candle