Skip to main content

V5

2025-11-25​

REST API​

Websocket API​

  • Orderbook [UPDATE]
    • The push frequency of Orderbook Level 1000 data is changed from 300ms to 200ms.

2025-11-17​

REST API​

  • We have deprecated the Legacy Crypto Loan Borrow API, since the new crypto loan service is now online.

2025-11-13​

REST API​

  • Get Transaction Log [UPDATE]
    • Add new request param transSubType, it is used to filter Move Position trans log only.

2025-11-11​

REST API​

  • Get Instruments Info [UPDATE]
    • Add new response field postOnlyMaxLimitOrderSize for spot, each trading pair has its own configuration defining the maximum limit order size for Post-only and RPI orders
  • Get Account Instruments Info [UPDATE]
    • Add new response field postOnlyMaxLimitOrderSize for spot, each trading pair has its own configuration defining the maximum limit order size for Post-only and RPI orders

2025-11-04​

REST API​

  • Place Order [UPDATE]
    • Option trading supports slippageToleranceType
  • Get Public Trades [UPDATE]
    • The interval between the order transaction's startTime and endTime has been changed from 7 days to 30 days

Websocket API​

  • Tickers [UPDATE]
    • Spot Push frequency changes from Real-time to 50ms

2025-11-03​

REST API​

2025-10-23​

REST API​

2025-10-22​

REST API​

  • Get Affiliate User List [UPDATE]
    • Add new request fields startDate, endDate
    • Add new response fields takerVol, makerVol, tradeVol, startDate, endDate

2025-10-21​

REST API​

  • Get Withdrawal Address List [NEW]

    • We have launched a new endpoint to query the withdrawal addresses in the address book.

  • Get Instruments Info [UPDATE]

    • Add symbolType request parameter to filter instrument records forspot
    • Add new response field forbidUplWithdrawal

  • Get Account Instruments Info [NEW]

    • Add category = spot to support querying spot instruments

  • Place Order [UPDATE]

    • Add new input parameters bboSideType, bboLevel to suppot to place a BBO order

  • Get Open Orders [UPDATE]

    • createType has new enumeration value: CreateByBboOrder, used to indicate BBO Order

  • Get Order History [UPDATE]

    • createType has new enumeration value: CreateByBboOrder, used to indicate BBO Order

WebSocket API​

  • Order [UPDATE]
    • createType has new enumeration value: CreateByBboOrder, used to indicate BBO Order
  • Execution [UPDATE]
    • createType has new enumeration value: CreateByBboOrder, used to indicate BBO Order

2025-10-16​

REST API​

  • Get Account Instruments Info [NEW]
    • This new endpoint supports querying whether the current account has trading permissions, whether it has RPI permissions, and whether the current symbol is among the public RPI symbols
  • Get Flexible Loans [UPDATE]
    • Add response parameters unpaidAmount, unpaidInterest, to distinguish unpaid principal and unpaid interest from totalDebt
  • Manual Repay [NEW]
    • Add a new endpoint for UTA manual repay

WebSocket API​

  • Ticker [UPDATE]
    • Add new response fields basisRateYear, fundingIntervalHour, fundingCap

2025-10-14​

REST API​

  • Get Sub UID List (Limited) [UPDATE]
    • Update response parameter accountMode, now support distinguish to Classic Account, UTA1.0, UTA1.0 Pro, UTA2.0, UTA2.0 Pro
  • Get Sub UID List (Unlimited) [UPDATE]
    • Update response parameter accountMode, now support distinguish to Classic Account, UTA1.0, UTA1.0 Pro, UTA2.0, UTA2.0 Pro

2025-10-10​

REST API​

2025-10-09​

REST API​

  • Place Order [UPDATE]
    • The value range of slippageTolerance has been adjusted, where: TickSize has changed from [5, 2000] to [1, 10000],Percent has changed from [0.05, 1] to [0.01, 10]
  • Get Instruments Info [UPDATE]
    • Add symbolType request parameter to filter instrument records, only for linear,inverse
  • Get Instruments Info [UPDATE]
    • category=spot adds new response fields maxLimitOrderQty, maxMarketOrderQty, will becomes effective on Oct 16th, refer to the announcement to get more details

2025-09-28​

REST API​

2025-09-25​

REST API​

2025-09-24​

REST API​

2025-09-23​

REST API​

WebSocket API​

  • ADL Alert [NEW]
    • Add new topic to push grouped insurance pool ADL alert and information

2025-09-18​

REST API​

WebSocket API​

  • Execution [UPDATE]
    • Add feeCurrency to return trading fee currency
  • Order [UPDATE]
    • Add a new response field cumFeeDetail to return trading fee details instead of cumExecFee and feeCurrency
  • Order [UPDATE]
    • Add a new response field cumFeeDetail to return trading fee details instead of cumExecFee and feeCurrency

2025-09-16​

REST API​

WebSocket API​

  • Wallet [UPDATE]
    • Add new response fields: spotBorrow

2025-09-15​

REST API​

  • Get Transaction Log [UPDATE]
    • Add new type enums PLATFORM_TOKEN_MNT_LIQRECALLEDMMNT, PLATFORM_TOKEN_MNT_LIQRETURNEDMNT

2025-09-11​

WebSocket API​

  • Orderbook [REMOVE]
    • Remove level 500 orderbooks for futures

2025-09-09​

REST API​

  • Cancel all [UPDATE]
    • orderFilter adds a new enum value StopOrder for option product types

2025-09-08​

REST API​

2025-09-04​

REST API​

  • Get Limit Price Behaviour [NEW]
    • Add a new endpoint to get configuration how the system behaves when your limit order price exceeds the highest bid or lowest ask price

2025-08-28​

REST API​

  • Get Risk Limit [UPDATE]
    • Add support for querying risk limit tables of pre-market trading contract pairs

2025-08-26​

REST API​

2025-08-14​

WebSocket API​

  • Orderbook [UPDATE]
    • Add level 1000 orderbooks for spot and futures

2025-08-13​

REST API​

  • Rate Limit [UPDATE]
    • Add endpoints to set api rate limit and query api rate limit

2025-08-07​

REST API​

2025-08-06​

REST API​

  • Withdraw [UPDATE]

    • Request parameter accountType becomes mandatory, and supports withdrawing from multiple wallets.

  • Get Delay Withdraw Amount

    • Support returning UTA wallet balance

2025-08-05​

Websocket API​

  • Trade [UPDATE]

    • Add seq
    • Futures and Spot public trade message will be split into multiple messages when it exceeds 1024 trades

  • Trade [UPDATE]

    • Add seq in spread trading
    • Futures and Spot public trade message will be split into multiple messages when it exceeds 1024 trades

2025-07-31​

REST API​

  • Set Limit Price Behaviour [NEW]
    • This endpoint is used to select the system behaviour when the limit order price exceeds the price boundary

2025-07-25​

REST API​

  • New Crypto Loan [UPDATE]
    • Add new response fields: flexibleAnnualizedInterestRate,annualizedInterestRate7D,annualizedInterestRate14D,annualizedInterestRate30D,annualizedInterestRate60D,annualizedInterestRate90D,annualizedInterestRate180D

2025-07-22​

REST API​

Websocket API​

2025-07-17​

REST API​

2025-07-16​

REST API​

  • Get Transaction Log (UTA) [UPDATE]
    • Add new types DEFI_INVESTMENT_SUBSCRIPTION, DEFI_INVESTMENT_REFUND, DEFI_INVESTMENT_REDEMPTION

2025-07-15​

Websocket API​

  • RPI Orderbook [NEW]
    • Add new topic to push the orderbook feed with RPI quote

2025-07-08​

REST API​

Websocket API​

2025-07-04​

REST API​

  • Add new api hostname https://api.bybitgeorgia.ge for Georgia users

Websocket API​

  • Add new stream hostname wss://stream.bybitgeorgia.ge for Georgia users

2025-07-03​

REST API​

  • Get Wallet Balance [UPDATE]
    • Add new response fields: totalMaintenanceMarginByMp,accountMMRateByMp,accountIMRateByMp,totalInitialMarginByMp
  • Get Position Info [UPDATE]
    • Add new response fields: positionIMByMp,positionMMByMp

Websocket API​

  • Wallet [UPDATE]
    • Add new fields: accountIMRateByMp,accountMMRateByMp,totalInitialMarginByMp,totalMaintenanceMarginByMp
  • Position [UPDATE]
    • Add new fields: positionIMByMp,positionMMByMp

2025-06-30​

REST API​

Websocket API​

  • Execution [UPDATE]
    • Add extraFees for Indian GST tax
  • BTC and ETH leveraged tokens are delisted, and the API service will be terminated on 4 July, 2025

2025-06-26​

REST API​

Websocket API​

  • Spread Execution [UPDATE]
    • Add execFeeV2 for Spot leg trading fee
    • Add feeCurrency for all legs trading fee currency

2025-06-24​

REST API​

  • Get Closed Options Positions [NEW]
    • Add new endpoint which is used to get closed options positions
  • Get Closed PnL [UPDATE]
    • Add new response fields openFee, closeFee
    • Add new enum "option" for category field to support getting option closed pnl records
  • Get Delivery Record [UPDATE]
    • Add new response field entryPrice
  • Get Transaction Log (UTA) [UPDATE]
    • Add new types ONCHAINEARN_SUBSCRIPTION, ONCHAINEARN_REDEMPTION, ONCHAINEARN_REFUND, STRUCTURE_PRODUCT_SUBSCRIPTION, STRUCTURE_PRODUCT_REFUND, CLASSIC_WEALTH_MANAGEMENT_SUBSCRIPTION, PREMIMUM_WEALTH_MANAGEMENT_SUBSCRIPTION, PREMIMUM_WEALTH_MANAGEMENT_REFUND, LIQUIDITY_MINING_SUBSCRIPTION, LIQUIDITY_MINING_REFUND, FLEXIBLE_STAKING_REFUND, FIXED_STAKING_REFUND, PWM_SUBSCRIPTION, PWM_REFUND

2025-06-19​

REST API​

WebSocket API​

  • Order Price Limit [NEW]
    • Add new websocket topic "priceLimit" which is used to get order price limit

2025-06-12​

REST API​

2025-06-10​

REST API​

  • Pre Check Order [NEW]
    • Add new endpoint which is used to calculate the changes in IMR and MMR of UTA account before and after placing an order.

2025-05-28​

REST API​

  • Get Order History [UPDATE]
    • Add new response field extraFees which is only used for Indonesian site or EU site
  • Get Trade History [UPDATE]
    • Add new response field extraFees which is only used for Indonesian site or EU site
  • Get Transaction Log (UTA) [UPDATE]
    • Add new response field extraFees which is only used for Indonesian site or EU site

2025-05-27​

REST API​

2025-05-23​

REST API​

  • Get Insurance [UPDATE]
    • The balance data update frequency has been changed from every 24 hours to every 1 minute
  • Insurance Pool [NEW]
    • A new WebSocket topic has been introduced to allow users to listen for updates to the insurance pool balance

2025-05-06​

REST API​

  • Spread Trading Rate limit [UPDATE]
    • Modify the rate limit for create/amend/cancel from 100/min to 20/sec
    • Modify the rate limit for cancel-all from 100/min to 5/sec

2025-04-24​

REST API​

  • Get Transaction Log (UTA) [UPDATE]
    • Add new response field transSubType, used for trans log generated by move position now
    • Modify the default time range from 7 days to 24 hours when startTime & endTime are not passed together
  • Get Spread Order History [UPDATE]
    • Add response field cxlRejReason
    • Remove redundent field orderPrice

2025-04-22​

REST API​

  • Get Instruments Info [UPDATE]
    • category=option adds a new response field displayName
    • category=linear adds a new response field displayName

2025-04-17​

REST API​

2025-04-16​

REST API​

2025-04-14​

REST API​

2025-04-11​

REST API​

  • Earn API [UPDATE]
    • Add category OnChain.

2025-04-02​

REST API​

  • Withdraw [UPDATE]
    • Add request parameter beneficiaryAddressCountry, beneficiaryAddressState, beneficiaryAddressCity they are used for users from Bybit Indonesia to fill travel rule info

2025-04-01​

REST API​

Websocket API​

  • Websocket Trade Service[Perpetual & Futures]
    • "timeInForce" request parameter supports RPI when creating orders
  • Order [Perpetual & Futures]
    • Response field "timeInForce" supports RPI
  • Trade [Perpetual & Futures]
    • Inverse Perpetual & Inverse Futures are effective, and the rest will be done in a week.

2025-03-20​

WebSocket API​

  • Orderbook [UPDATE]
    • Spot and Futures orderbook.1 pushes snapshot message only

2025-03-05​

REST API​

  • Withdraw [UPDATE]
    • Add request parameter beneficiaryLegalType, beneficiaryWalletType, beneficiaryUnhostedWalletType, beneficiaryPoiNumber, beneficiaryPoiType, beneficiaryPoiIssuingCountry, beneficiaryPoiExpiredDate they are used for users from Bybit Turkey and Bybit Kazakhstan to fill travel rule info

2025-02-27​

REST API​

  • Place Order [UPDATE]
    • Add slippageToleranceType request parameter, used to select slippage type for Spot and Futures market orders
    • Add slippageTolerance request parameter, used to set slippage value based on the type of slippage
  • Get Order History [UPDATE]
    • Add a new response param slippageToleranceType
    • Add a new response param slippageTolerance

Websocket API​

  • Order [UPDATE]
    • Add a new response param slippageToleranceType
    • Add a new response param slippageTolerance

2025-02-26​

Websocket API​

2025-02-20​

REST API​

Websocket API​

  • All Liquidation [NEW]
    • A new topic to get full liquidation occurred in Bybit exchange.
  • Liquidation [DEPRECATE]
    • The old one only pushes 1 liquidation per second, it can be discarded.

2025-02-19​

REST API​

  • Get Affiliate User List [UPDATE]
    • Add new response fields takerVol30Day, makerVol30Day, tradeVol30Day, depositAmount30Day, takerVol365Day, makerVol365Day, tradeVol365Day, depositAmount365Day

2025-02-18​

REST API​

Websocket API​

  • Websocket Trade Service[Spot]
    • "timeInForce" request parameter supports RPI when creating orders
  • Order [Spot]
    • Response field "timeInForce" supports RPI
  • Trade [Spot]
    • Four symbols (MASKUSDT, IOUSDT, ZROUSDT, TWTUSDT) now have RPI response field, full release will be 20th Feb.

2025-02-17​

REST API​

2025-02-13​

REST API​

  • Get Transaction Log (UTA) [UPDATE]
    • New transaction type value PEF_TRANSFER_IN, PEF_TRANSFER_OUT, PEF_PROFIT_SHARE
  • Get Collateral Info [UPDATE]
    • The field collateralRatio field will be no longer useful due to the transition from a single conversion rate to a tiered collateral value ratio starting from 19 Feb, 2025, refer to announcement
  • Get VIP Margin Data [UPDATE]
    • The field collateralRatio field will be no longer useful due to the transition from a single conversion rate to a tiered collateral value ratio starting from 19 Feb, 2025

2025-02-07​

REST API​

  • Cancel All Orders [UPDATE]
    • Option orders can be cancelled by specifying settleCoin, and choose cancel all USDT or USDC Option orders

2025-01-14​

REST API​

  • Get Instruments Info [UPDATE]
    • For category=spot, replace limitParameter and marketParamter with priceLimitRatioX, priceLimitRatioY, please refer to this change

2025-01-09​

REST API​

Websocket API​

  • Wallet [UPDATE]
    • For accountType=UNIFIED, the response field availableToWithdraw is deprecated, it always returns ""

2025-01-02​

REST API​

  • Get Instruments Info [UPDATE]
    • For category=linear and inverse, added response field riskParameters, priceLimitRatioX, priceLimitRatioY, please refer to this change

2024-12-12​

REST API​

  • Get Risk Limit [UPDATE]
    • When query category="linear", API returned 30 symbols data set each request before, but now it returns 15.
  • Withdraw [UPDATE]
    • API rate limit is raised from 1 req to 5 reqs per second

2024-12-09​

REST API​

2024-12-04​

REST API​

2024-11-19​

REST API​

2024-11-14​

REST API​

  • Get Long Short Ratio [UPDATE]
    • Add request parameter startTime, endTime, used to query historical data by filter time range

2024-11-05​

  • Kazakhstan users registered from "www.bybit.kz", please use "api.bybit.kz" and "stream.bybit.kz" hostnames.

2024-10-30​

REST API​

2024-10-15​

Websocket API​

2024-10-11​

REST API​

2024-09-29​

Websocket API​

  • Order [UPDATE]
    • Add new response field closedPnl
  • Execution [UPDATE]
    • Add a response field execPnl

2024-09-12​

REST API​

2024-08-29​

REST API​

2024-08-13​

REST API​

  • Get Loan Orders [UPDATE]
    • Add a new response param reserveToken, reserveQuantity

2024-08-07​

REST API​

  • Request a Quote [UPDATE]
    • Add two new request parameter for API broker client, paramType, paramValue
  • Get Convert history [UPDATE]
    • Add two new response paramType, paramValue in the "extInfo" object

2024-08-06​

REST API​

  • Demo Trading Service [Demo trading]
    • Add request param adjustType to determine adding or reducing the demo funds

2024-07-30​

Websocket API​

  • Fast Execution [UPDATE]
    • Add response field isMaker
    • Supports Spot execution

2024-07-25​

REST API​

2024-07-09​

Websocket API​

  • Fast Execution [UPDATE]
    • Add categorised topic, execution.fast.linear, execution.fast.inverse

2024-07-04​

REST API​

2024-07-03​

2024-07-01​

  • Integration Guidance [UPDATE]
    • To obey the compliance rule, the new domain is added for Turkey region users.

2024-06-27​

REST API​

  • Get Instruments Info [UPDATE]
    • Pre-market contract: add new response fields isPreListing, preListingInfo, curAuctionPhase, phases, startTime, endTime, auctionFeeInfo, auctionFeeRate, takerFeeRate, makerFeeRate
    • Request parameter status supports Closed, Delivering, PreLaunch for category="inverse" and "linear"
    • When category=linear&status=PreLaunch, you can get pre-market perpetual
  • Get Tickers [UPDATE]
    • Pre-market contract: add new response fields preOpenPrice, preQty, curPreListingPhase
  • New error codes related to pre-market perpetual trading
    • 110095: You cannot create, modify or cancel Pre-Market Perpetual orders during the Call Auction.
    • 110096: Pre-Market Perpetual Trading does not support Portfolio Margin mode.
    • 110097: Non-UTA users cannot access Pre-Market Perpetual Trading. To place, modify or cancel Pre-Market Perpetual orders, please upgrade your Standard Account to UTA.
    • 110098: Only Good-Till-Canceled (GTC) orders are supported during Call Auction.
    • 110099: You cannot create TP/SL orders during the Call Auction for Pre-Market Perpetuals.
    • 110100: You cannot place, modify, or cancel Pre-Market Perpetual orders when you are in Demo Trading.
    • 3777029: You currently have orders for pre-market trading that can’t be bind UIDs
    • 3200419: Unable to switch to Portfolio margin due to active pre-market Perpetual orders and positions

Websocket API​

  • Tickers [UPDATE]
    • Pre-market contract: add new response fields preOpenPrice, preQty, curPreListingPhase

2024-06-20​

REST API​

  • Place Order [UPDATE]
    • marketUnit field now supports orderFilter=tpslOrder, StopOrder when placing Spot market order (UTA)
  • Batch Place Order [UPDATE]
    • marketUnit field now supports orderFilter=tpslOrder, StopOrder when placing Spot market order (UTA)

2024-06-18​

REST API​

Websocket API​

  • Dcp [UPDATE]
    • Deprecate the topic name dcp
    • Add new topic names dcp.future, dcp.spot, dcp.option

2024-06-14​

Websocket API​

  • Fast Execution [UPDATE]
    • orderLinkId will be also output for a maker trade, but the value will be "" all the time.

2024-06-13​

REST API​

2024-06-06​

REST API​

Websocket API​

2024-06-04​

REST API​

  • Get Orderbook [UPDATE]
    • A new response field cts added when category=spot, and it is matched with the "cts" from ws ob.200

2024-05-30​

REST API​

  • Get Orderbook [UPDATE]
    • A new response field cts added when category=linear & inverse, and it is matched with the "cts" from ws ob.500

2024-05-09​

REST API​

  • Get Risk Limit [UPDATE]
    • When query category="linear", API returns 30 symbols data set each request, please add request parameter cursor paginate
    • Add new response parameter nextPageCursor
  • Withdraw [UPDATE]
    • Add request parameter beneficiary, vaspEntityId, beneficiaryName, they are only used for kyc=KOR (Korean users) to fill travel rule info
  • Get Exchange Entity List [NEW]
    • Add a new API for kyc=KOR users to query target exchange info when fill travel rule info
  • Create Internal Transfer [UPDATE]
    • Add new response field status. When you get "PENDING", please call query API to check the final status after a while
  • Create Universal Transfer [UPDATE]
    • Add new response field status. When you get "PENDING", please call query API to check the final status after a while

2024-05-06​

Websocket API​

2024-04-25​

REST API​

2024-04-23​

REST API​

Websocket API​

2024-04-15​

REST API​

2024-04-11​

REST API​

2024-04-03​

REST API​

2024-04-01​

REST API​

Websocket API​

2024-03-28​

Websocket API​

2024-03-22​

  • Integration Guidance [UPDATE]
    • To obey the compliance rule, two new domains are added for Netherlands users and Hong Kong users repectively.
  • Create Internal Transfer [UPDATE]
    • API rate limit is increase from 20req/min to 60req/min

2024-03-21​

  • Get Orderbook [UPDATE]
    • linear & inverse supports up to limit=500
    • linear & inverse, field u is matched with the u in ws 500 level

2024-03-13​

REST API​

2024-03-12​

REST API​

  • Set Risk Limit [Deprecate]
    • Since auto risk limit has been launched, it is meaningless to use this API

2024-03-11​

REST API​

  • Get Order History [UPDATE]
    • UTA(spot, linear, option) can only query last 24 hours full cancelled orders records

2024-03-06​

REST API​

2024-03-05​

REST API​

  • Get Position Info [UPDATE]
    • Add new response field sessionAvgPrice for USDC contracts
    • Add new response field curRealisedPnl for Perps, Futures and Option
    • cumRealisedPnl is deprecated for Option
    • Add new response fields delta, vega, theta, gamma for Option

Websocket API​

  • Position [UPDATE]
    • Add new response field sessionAvgPrice for USDC contracts
    • Add new response field curRealisedPnl for Perps, Futures and Option
    • cumRealisedPnl is deprecated for Option
    • Add new response fields delta, vega, theta, gamma for Option

2024-03-04​

REST API​

Websocket API​

  • Trade
    • Add new stream fields for Option only. mP, iP, mIv, iv

2024-03-01​

REST API​

2024-02-29​

REST API​

  • Get Borrow History [UPDATE]
    • startTime & endTime are restricted to 30 days time range
    • Support getting up to 2 years data
  • Get Delivery Record [UPDATE]
    • Add query parameter startTime & endTime, and 30 days times range per request
    • Support getting up to 2 years data
  • Get USDC Session Settlement [UPDATE]
    • Add query parameter startTime & endTime, and 30 days times range per request
    • Support getting up to 2 years data
  • Get Orderbook [UPDATE]
    • Add a new response field seq for linear, inverse & spot

2024-02-28​

REST API​

2024-02-21​

REST API​

  • Get Instruments Info [Futures]
    • Add response fields maxMktOrderQty
    • postOnlyMaxOrderQty is useless, use maxOrderQty for Limit and PostOnly order

2024-02-06​

REST API​

2024-02-05​

REST API​

  • Get Order History [UPDATE]
    • UTA (linear,spot,option) does not support querying open status orders any more
    • Add a new error code: "181017", error message: "OrderStatus must be final status"

2024-01-18​

REST API​

2024-01-16​

REST API​

2024-01-15​

REST API​

  • Place Order [UPDATE]
    • Spot(UTA) can use takeProfit, stopLoss, tpLimitPrice, slLimitPrice, tpOrderType, slOrderType to set Market TPSL or Limit TPSL when creating Spot limit order.
  • Amend Order [UPDATE]
    • Spot(UTA) can amend takeProfit, stopLoss, tpLimitPrice, slLimitPrice if the original order has related attributes
  • Cancel All Orders [UPDATE]
    • Add new enums "OcoOrder", "BidirectionalTpslOrder" for orderFilter. You can only cancel all untriggered "BidirectionalTpslOrder"
  • Get Open Orders [UPDATE]
    • Add new enum "BidirectionalTpslOrder" for orderFilter
    • Add new enum "BidirectionalTpslOrder" for stopOrderType
  • Get Order History [UPDATE]
    • Add new enum "BidirectionalTpslOrder" for orderFilter
    • Add new enum "BidirectionalTpslOrder" for stopOrderType

Websocket API​

  • Order [UPDATE]
    • Add new enum "BidirectionalTpslOrder" for stopOrderType

2024-01-11​

REST API​

  • Get Transaction Log [UPDATE]
    • new type enums FLEXIBLE_STAKING_SUBSCRIPTION, FLEXIBLE_STAKING_REDEMPTION, FIXED_STAKING_SUBSCRIPTION

2024-01-09​

REST API​

2024-01-08​

REST API​

  • Get Trade History [UPDATE]
    • Add a new response field feeCurrency for UTA Spot trading fee currency

2024-01-02​

REST API​

New error codeDescription
131231Transfers into this account are not supported
131232Transfers out this account are not supported

2023-12-28​

REST API​

  • Get Loan Orders [UPDATE]
    • Add a new response param deferredLiquidationLine, deferredLiquidationTime
  • Get LTV [UPDATE]
    • Add a new response param rst.
  • Get Product Info [UPDATE]
    • Add a new response param deferredLiquidationLine, deferredLiquidationTime

2023-12-22​

REST API​

  • Place Order [UPDATE]
    • Add a new request param marketUnit, the value are baseCoin, quoteCoin. It can be used to select qty unit for Spot market order (Unified account)
  • Get Open Orders [UPDATE]
    • Add a new response param marketUnit
  • Get Order History [UPDATE]
    • Add a new response param marketUnit

Websocket API​

  • Order [UPDATE]
    • Add a new response param marketUnit

2023-12-20​

REST API​

2023-12-14​

Websocket API​

2023-12-12​

REST API​

Websocket API​

  • Order [UPDATE]
    • Add a response field createType
  • Execution [UPDATE]
    • Add a response field createType

2023-12-07​

REST API​

  • Repay Liability [NEW]
    • Add a new endpoint to repay the liability of Unified Account

2023-12-04​

REST API​

2023-11-16​

REST API​

Websocket API​

  • Wallet [UPDATE]
    • Add a new response field spotHedgingQty

2023-11-14​

REST API​

  • Withdraw [UPDATE]
    • The rate limit is changed from 10 req/min to 1 req/s

2023-11-09​

REST API​

  • Get Open Orders [UPDATE]
    • Classic account Spot can use orderFilter="OcoOrder"
  • Get Order History [UPDATE]
    • Add the time range limitation for startTime and endTime request params
    • Classic account Spot can use orderFilter="OcoOrder"
  • Get Trade History [UPDATE]
    • Add the time range limitation for startTime and endTime request params
  • Get Closed PnL [UPDATE]
    • Add the time range limitation for startTime and endTime request params
    • Classic account data is sort by updatedTime
  • Get Transaction Log [UPDATE]
    • Add the time range limitation for startTime and endTime request params
  • Get Pre-upgrade Order History [UPDATE]
    • Add the time range limitation for startTime and endTime request params
  • Get Pre-upgrade Trade History [UPDATE]
    • Add the time range limitation for startTime and endTime request params
  • Get Pre-upgrade Closed PnL [UPDATE]
    • Add the time range limitation for startTime and endTime request params
    • Classic account data is sort by updatedTime
  • Get Pre-upgrade Transaction Log [UPDATE]
    • Add the time range limitation for startTime and endTime request params
  • Get Sub Account All API Keys [NEW]
    • Add new endpoint for master account to query all api keys of a sub UID

2023-11-08​

REST API​

2023-11-02​

REST API​

  • Amend Order [UPDATE]
    • Add tpslMode in the request parameter
  • Batch Amend Order [UPDATE]
    • Add tpslMode in the request parameter
  • Get Borrow Quota (Spot) [UPDATE]
    • Add new response fields spotMaxTradeQty, spotMaxTradeAmount
  • Withdraw [UPDATE]
    • Add new enum value for forceChain parameter. You can withdraw between Bybit main accounts via inputting UID
  • Delete Sub UID [NEW]
    • Add new endpoint to delete sub account

2023-11-01​

REST API​

  • Amend Order [UPDATE]
    • Spot supports amending order, category=spot

2023-10-26​

REST API​

  • Get Trade History [UPDATE]
    • UTA Spot: stopOrderType, "" for normal order, tpslOrder for TP/SL order, Stop for conditional order, OcoOrder for OCO order
  • Get Open Orders [UPDATE]
    • UTA Spot: add new response field ocoTriggerBy, and the value can be OcoTriggerByUnknown, OcoTriggerByTp, OcoTriggerBySl
  • Get Order History [UPDATE]
    • UTA Spot: add new response field ocoTriggerBy, and the value can be OcoTriggerByUnknown, OcoTriggerByTp, OcoTriggerBySl

Websocket API​

  • Order [UPDATE]
    • UTA Spot: add new response field ocoTriggerBy, and the value can be OcoTriggerByUnknown, OcoTriggerByTp, OcoTriggerBySl

2023-10-25​

REST API​

Websocket API​

  • Position [UPDATE]
    • Add response field isReduceOnly, mmrSysUpdatedTime, leverageSysUpdatedTime

2023-10-17​

REST API​

2023-10-09​

Websocket API​

  • Orderbook [Spot]
    • Add a new level 200 data with frequency 200ms

2023-09-28​

REST API​

2023-09-25​

REST API​

  • Get Open Orders [UPDATE]
    • stopOrderType has new enumeration value: OcoOrder, used to indicate the Spot OCO Order (Unified Trading Account)
  • Get Order History [UPDATE]
    • stopOrderType has new enumeration value: OcoOrder, used to indicate the Spot OCO Order (Unified Trading Account)
  • Get Trade History [UPDATE]
    • execType has new enumeration value: MovePosition, used to indicate the position movement execution (Unified Trading Account)
  • Get Transaction Log [UPDATE]
    • type has new enumeration values: TRANSFER_IN_INS_LOAN, TRANSFER_OUT_INS_LOAN (Unified Trading Account)
  • Get Transaction Log [UPDATE]
    • type has new enumeration values: SPOT_REPAYMENT_SELL, SPOT_REPAYMENT_BUY (Unified Trading Account)

Websocket API​

  • Order [UPDATE]
    • stopOrderType has new enumeration value: OcoOrder, used to indicate the Spot OCO Order (Unified Trading Account)

2023-09-21​

REST API​

  • Get Trade History [UPDATE]
    • Add response field seq
  • Get Position Info [UPDATE]
    • Add response field seq
  • Get Collateral Info [UPDATE]
    • Added "freeBorrowAmount" field: This field represents the amount of borrowing within your total borrowing amount that is exempt from interest charges
    • deprecated "freeBorrowingAmount" field: The value of this field has been migrated to "freeBorrowingLimit", and it keeps empty string.
    • Added "freeBorrowingLimit" field: This field indicates the maximum limit for interest-free borrowing. If the unrealized loss portion exceeds this limit, all borrowings will be subject to interest.

WebSocket API​

  • Position [UPDATE]
    • Add response field seq
    • Can subscribe specific category position
  • Execution [UPDATE]
    • Add response field seq
    • Can subscribe specific category position
  • Order [UPDATE]
    • Can subscribe specific category position

2023-09-18​

REST API​

  • Create Sub UID API Key [UPDATE]
    • Request parameter ips is actually string type. array can be used, but string is more explicit
    • Request parameter Derivatives has been deprecated due to auto identification by system
  • Modify Master API Key [UPDATE]
    • Request parameter ips is actually string type. array can be used, but string is more explicit
    • Request parameter Derivatives has been deprecated due to auto identification by system
  • Modify Sub API Key [UPDATE]
    • Add a new request param apikey, which can be used for Master account to manage sub account api key
    • Request parameter ips is actually string type. array can be used, but string is more explicit
    • Request parameter Derivatives has been deprecated due to auto identification by system
  • Delete Sub API Key [UPDATE]
    • Add a new request param apikey, which can be used for Master account to delete sub account api key

2023-09-14​

REST API​

  • Get Product Info [UPDATE]
    • Add a new response field spotMarginTrading
    • You can use api key and secret to call this endpoint to get your private data if you are eligible.
  • Get Margin Coin Info [UPDATE]
    • You can use api key and secret to call this endpoint to get your private data if you are eligible.
  • Get Loan Orders [UPDATE]
    • Add a new response field spotMarginTrading
    • The meaning of parentUid is changed. After the change, it represents the uid that bound with OTC loan product
  • Get LTV [NEW]
    • The meaning of parentUid is changed. After the change, it represents the uid that bound with OTC loan product

2023-09-07​

REST API​

  • Get Open Orders [UPDATE]
    • By /v5/order/realtime?category=inverse, you can get all inverse contracts opening orders
  • Get Position Info [UPDATE]
    • By /v5/position/list?category=inverse, you can get all inverse contracts holding positions
    • symbol supports multiple values for category=inverse

2023-09-04​

REST API​

  • Batch Place Order [UPDATE]
    • UTA Pro: support USDT perp, USDC perp & USDC Futures batch place orders
  • Batch Amend Order [UPDATE]
    • UTA Pro: support USDT perp, USDC perp & USDC Futures batch amend orders
  • Batch Cancel Order [UPDATE]
    • UTA Pro: support USDT perp, USDC perp & USDC Futures batch cancel orders

2023-08-31​

REST API​

  • Cancel All Orders [UPDATE]
    • add new request params stopOrderType
    • enumerations Order and StopOrder for orderFilter support linear and inverse product types
  • Get Deposit Records (on chain) [UPDATE]
    • Add a new response field depositType. You can process deposit assets when the deposit has daily deposit limit or abnormal deposit issue.
  • Get Sub Deposit Records (on chain) [UPDATE]
    • Add a new response field depositType. You can process deposit assets when the deposit has daily deposit limit or abnormal deposit issue.

2023-08-30​

REST API​

2023-08-25​

REST API​

2023-08-24​

REST API​

Old error codeNew error codeMsg
110075182021Cannot enable spot margin while in isolated margin mode. Please switch to cross margin mode or portfolio margin mode to trade spot with margin.

2023-08-22​

REST API​

  • Get Transaction Log [UPDATE]
    • Add a new response field id, which is a unique id for each transaction log
  • Get Status And Leverage [NEW]
    • Add a new endpoint to query margin trade status and leverage of Unified account

2023-08-17​

REST API​

2023-08-11​

REST API​

  • Get Wallet Balance [UPDATE]
    • availableToBorrow always returns "" because main-sub uids share borrow quota
  • Get Collateral Info [UPDATE]
    • Add new response field borrowUsageRate
    • availableToBorrow is a shared value across main-sub uids

Websocket API​

  • Wallet [UPDATE]
    • availableToBorrow always returns "" because main-sub uids share borrow quota

2023-08-10​

REST API​

  • Set Collateral Coin [NEW]
    • Add a new endpoint to set collateral coin in the Unified account
  • Get Account Info [UPDATE]
    • Add a new response field isMasterTrader to indicate if the account is master trader (copytrading)

2023-08-08​

REST API​

2023-08-07​

REST API​

  • Place Order [UPDATE]
    • Spot supports conditional order, orderFilter adds a new enum value StopOrder
  • Cancel Order [UPDATE]
    • Spot supports conditional order, orderFilter adds a new enum value StopOrder
  • Cancel All Orders [UPDATE]
    • Spot supports conditional order, orderFilter adds a new enum value StopOrder
  • Get Open Orders [UPDATE]
    • Spot supports conditional order, orderFilter adds a new enum value StopOrder, stopOrderType reuses Stop for Futures and Spot conditional order
  • Get Order History [UPDATE]
    • Spot supports conditional order, orderFilter adds a new enum value StopOrder, stopOrderType reuses Stop for Futures and Spot conditional order

Websocket API​

  • Order [UPDATE]
    • stopOrderType reuses Stop for Futures and Spot conditional order
    • Add new field feeCurrency, which is used to identify Spot trading fee asset
    • updatedTime has value for classic account Spot trading

2023-07-31​

REST API​

WebSocket API​

  • Position
    • Adjust liqPrice value logic. It only has value when minPrice < liqPrice < maxPrice, otherwise it is always ""
  • Wallet
    • Add new response field collateralSwitch

2023-07-24​

REST API​

  • Get Product Info
    • Add new Response fields: USDTPerpetualOpenLine``USDCContractOpenLine, USDCOptionsOpenLine, USDTPerpetualCloseLine, USDCContractCloseLine, USDCOptionsCloseLine, USDCContractSymbols, USDCOptionsSymbols, marginLeverage, USDTPerpetualLeverage, symbol, leverage, USDCContractLeverage
  • Get Loan Orders
    • Add new Response fields: USDTPerpetualOpenLine, USDCContractOpenLine, USDCOptionsOpenLine, USDTPerpetualCloseLine, USDCContractCloseLine, USDCOptionsCloseLine, USDCContractSymbols, USDCOptionsSymbols, marginLeverage, USDTPerpetualLeverage, symbol, leverage, USDCContractLeverage
  • Get Single Coin Balance
    • Add new request param: toAccountType, toMemberId, withLtvTransferSafeAmount
    • Add new response field: ltvTransferSafeAmount
  • Add error codes for UTA with OTC loan when trade Spot, Futures and Option
New error codeDescription
30133USDT Perp: When the trading pair is not in the whitelist
30134USDC Contract: When the trading pair is not in the whitelist
30135USDT Perp: When you try to change a leverage higher than the maximum leverage in OTC loan
30136USDC Contract: When you try to change a leverage higher than the maximum leverage in OTC loan
3200316Option: restrict to trade
3200317Option: restrict to buy
170709Spot: When the trading pair is not in the whitelist
170215Spot: restrict to buy
170216Spot: margin leverage exceeded
170220Spot: restrict to trade

2023-07-13​

REST API​

2023-07-04​

REST API​

2023-06-26​

WebSocket API​

  • Orderbook [Spot]
    • Improve the push frequency from 100ms to 20ms of level 50

2023-06-24​

REST API​

  • Get Instruments Info [UPDATE]
    • When category=linear, add a new response params copyTrading to indicate this trading pair supporting copy trade or not for UTA and normal account

2023-06-15​

REST API​

2023-06-14​

REST API​

2023-06-08​

REST API​

  • Get Fee Rate [UPDATE]
    • Support to get USDC perp & USDC futures trading fee rate

2023-06-07​

REST API​

  • Withdraw [UPDATE]
    • Add new request param feeType, which is used to select the withdrawal fee operation type when withdraw

2023-06-02​

REST API​

  • Get Affiliate User Info [New]
    • A brand new endpoint, which is used for affiliate to check the basic information of their users

2023-06-01​

REST API​

  • Set Margin Mode [UPDATE]
    • UTA account supports isolated margin, a new enum ISOLATED_MARGIN for request param "setMarginMode"
  • Switch Position Mode [UPDATE]
    • UTA account supports Hedge mode for USDT Perp when it is isolated margin or cross margin mode
  • Get Position Info [UPDATE]
    • Add new response field positionBalance
  • Get Account Info [UPDATE]
    • "marginTrade" field has a new enum value - ISOLATED_MARGIN
  • Set Auto Add Margin [UPDATE]
    • add category enum linear for UTA
  • Add Or Reduce Margin [UPDATE]
    • A brand new endpoint is used to add or reduce specific margin you want

WebSocket API​

  • Position [UPDATE]
    • Add new response param positionBalance

2023-05-30​

REST API​

  • Get Instruments Info [UPDATE]
    • When category=spot, add a new response params marginTrading to indicate this trading pair supporting margin trade or not for UTA and normal account

2023-05-23​

REST API​

  • Place Order [UPDATE]
    • Add new request params for new TP/SL tpslMode, tpLimitPrice, slLimitPrice, tpOrderType, slOrderType
  • Amend Order [UPDATE]
    • Add new request params for new TP/SL tpLimitPrice, slLimitPrice
  • Get Open Orders [UPDATE]
    • Add new response params for new TP/SL tpslMode, tpLimitPrice, slLimitPrice
  • Get Order History [UPDATE]
    • Add new response params for new TP/SL tpslMode, tpLimitPrice, slLimitPrice
  • Get Position Info [UPDATE]
    • tpslMode in the position is deprecated
  • Set Trading Stop [UPDATE]
    • Add new request params for new TP/SL tpslMode, tpLimitPrice, slLimitPrice, tpOrderType, slOrderType

WebSocket API​

  • Position [UPDATE]
    • tpslMode in the position is deprecated
  • Order [UPDATE]
    • Add new response params for new TP/SL tpslMode, tpLimitPrice, slLimitPrice

2023-05-10​

REST API​

Old error codeNew error codeMsg
10001110075RiskId is not modified

2023-05-05​

REST API​

2023-05-04​

REST API​

  • Get Trade History [UPDATE]
    • symbol is no longer mandatory for normal account when get derivatives
  • Get Closed PnL [UPDATE]
    • symbol is no longer mandatory for normal account when get derivatives

2023-04-20​

REST API​

  • Place Order [UPDATE]
    • add new request param smpType used to select SMP execution type
  • Get Open Orders [UPDATE]
    • add new response fields smpType, smpOrderId, smpGroup
    • add new enum cancelBySmp of cancelType
  • Get Order History [UPDATE]
    • add new response fields smpType, smpOrderId, smpGroup
    • add new enum cancelBySmp of cancelType
  • Get Account Info [UPDATE]
    • add new response fields dcpStatus, timeWindow, smpGroup

WebSocket API​

  • Order [UPDATE]
    • add new response fields smpType, smpOrderId, smpGroup
    • add new enum cancelBySmp of cancelType

2023-04-06​

REST API​

2023-04-04​

REST API​

  • Get Instruments Info [UPDATE]
    • add request param startTime endTime, effective for UTA mode
    • add response param placeType, used for option

2023-04-04​

REST API​

WebSocket API​

  • Position [UPDATE]
    • add response param adlRankIndicator
    • category field is added to UTA stream
  • Order [UPDATE]
    • add response param placeType, used for option
  • Execution [UPDATE]
    • add response param closedSize

2023-03-24​

REST API​

2023-03-23​

REST API​

WebSocket API​

  • Wallet [UPDATE]
    • Add a new response field accountLTV

2023-03-22​

REST API​

2023-03-15​

REST API​

  • Get Single Coin Balance [UPDATE]
    • Add a new request param withTransferSafeAmount and a new response field transferSafeAmount

2023-03-10​

REST API​

  • Get Instruments Info [UPDATE]
    • Unify the enums of status for Spot, Derivatives and Options. Use Trading, Closed, Settling, PreLaunch, Deliverying
    • Remove duplicate category field in the Options response
  • Get Fee Rate [UPDATE]
    • Support to get Options trading fee rate

2023-03-09​

REST API​

  • Set Leverage [UPDATE]
    • UTA user can set up to 10X for margin trade
  • Get Wallet Balance [UPDATE]
    • Before adjustment: normal account gets error code and message when call accountType=UNIFIED.
      After adjustment: normal account gets http code 400 when call accountType=UNIFIED

2023-02-28​

REST API​

WebSocket API​

  • Wallet [UPDATE]
    • Add a new field bonus

2023-02-20​

REST API​

2023-02-15​

REST API​

  • User [NEW]
    • Add a set of user & api key related endpoints for V5

2023-02-14​

REST API​

  • Get Fee Rate (Derivatives) [NEW]
    • Get the trading fee rate for derivatives
  • Withdraw [UPDATE]
    • Select the wallet to be withdrawn from
    • The default withdrawn wallet is Spot wallet
Req paramRequiredTypeComments
accountTypefalsestringSelect the wallet to be withdrawn from
  • SPOT：spot wallet (default)
  • FUND：Funding wallet

2023-02-09​

REST API​

2023-01-19​

REST API​

  • Set Margin Mode [UPDATE]
    • Portfolio margin mode supports USDT Perpetual
  • Get Position Info [UPDATE]
    • For portfolio margin mode, positionIM, positionMM, leverage, riskLimitValue returns "", riskId returns 0
  • Get Wallet Balance [UPDATE]
    • For portfolio margin mode, totalOrderIM, totalPositionIM, totoalPositionMM returns ""

WebSocket API​

  • Position [UPDATE]
    • For portfolio margin mode, positionIM, positionMM, leverage, riskLimitValue returns "", riskId returns 0
  • Wallet [UPDATE]
    • For portfolio margin mode, totalOrderIM, totalPositionIM, totoalPositionMM returns ""

2023-01-16​

REST API​

  • Get Tickers [spot]
    • usdIndexPrice has been added to response. It means USD index price, which can be empty.

WebSocket API​

  • Tickers [spot]
    • usdIndexPrice has been added to stream. It means USD index price, which can be empty.
  • Orderbook [linear contract & inverse contract]
    • Add 500 level depth, push frequency is 100ms

2023-01-09​

WebSocket API​

  • Tickers [linear contract & inverse contract]
    • nextFundingTime has been changed from dataTime 2023-01-05T08:00:00Z to timestamp (ms) 1672905600000
    • predicatedFundingRate has been removed from stream