Skip to main content

V5

2026-09-30​

REST API​

  • Get/Set Auto Savings Settings [NEW]
    • Add GET and POST /v5/earn/flexible-saving/auto-savings to query and update Flexible Saving auto savings settings.

2026-09-29​

REST API​

  • Get Instruments Info [UPDATE]
    • Add new response field tags, an array of symbol tags such as ST. Applies to linear and inverse.
  • Batch Request Export Reports [NEW]
    • Add POST /v5/fht/compliance/tax/private/batch_create to export multiple types of tax reports in a batch. Supports time ranges of up to 12 months and CSV/ORC formats.
    • Set type=ALL to export all report types supported by the current site; the number value is ignored.
  • Get Batch Export Report Status [NEW]
    • Add GET /v5/fht/compliance/tax/private/batch_query to query each task's status and download URL by batchId.

2026-09-24​

REST API​

2026-09-23​

REST API​

  • Strategy [UPDATE]
    • pov now supports Spot (category=UTA_SPOT), covering all three execution modes and One-Time execution
    • pov adds new request parameter positionValue: total order quantity by value, denominated in the quote currency. Mutually exclusive with size
    • pov adds new request parameter leverageType: 0: normal, 1: borrow to trade (UTA_SPOT only)
    • iceberg maximum number of sub-orders raised from 100 to 200

2026-09-22​

REST API​

  • Get Option Base Coins [NEW]
    • Add GET /v5/market/option-base-coins to query option base coins, including display names, launch times, and tradable symbol availability. Supports filtering by multiple underlying asset types.
  • Get Delay Liquidation Status [NEW]
    • Add GET /v5/ins-loan/delay-liq-status to query the current LTV, liquidation status, and delay liquidation timing information for an institutional loan account.
  • Integration Guidance [UPDATE]
    • Remove Netherlands domain.

2026-09-10​

REST API​

  • Get Instruments Info [UPDATE]
    • baseCoin now supports passing All to return all option symbols. Only valid when category=option
  • Create Order [UPDATE]
    • rpiTakerAccess=true now supports orderType=Limit with timeInForce=IOC or FOK

2026-09-07​

REST API​

  • Integration Guidance
    • Update the API access method for internal accounts in Brazil and Argentina. Going forward, please use api.bybit.com; there is no longer a need to include the request header x-site-id.

Websocket API​

  • Connect
    • Update the API access method for internal accounts in Brazil and Argentina. Going forward, please use stream.bybit.com; there is no longer a need to include the request header x-site-id.

2026-09-02​

REST API​

  • Event Trading [NEW]
    • Launch Event Contract OpenAPI. Includes Market, Trade endpoints and WebSocket streams.

2026-09-01​

2026-08-31​

REST API​

Websocket API​

  • Connect
    • Add websocket integration method for HongKong users

2026-08-28​

REST API​

Websocket API​

  • Connect
    • Add websocket integration method for Argentina users

2026-08-27​

REST API​

  • Get Position Info [UPDATE]

    • Add new response field netDeltaRatio: Net delta ratio.

  • Get Instruments Info [UPDATE]

    • Add new field fullName, marketRegion, underlyingTicker to differentiate the symbols represent same stock but in different venues

  • Get Account Instruments Info [UPDATE]

    • Add new field fullName, marketRegion, underlyingTicker to differentiate the symbols represent same stock but in different venues

  • Funding Account Transaction History [UPDATE]

    • Add a new response field currcCursor, which is used to duplicate check

Websocket API​

  • Position [UPDATE]
    • Add new field netDeltaRatio: Net delta ratio.

2026-08-25​

REST API​

  • Batch Place Order [UPDATE]

    • category=option reduces the batch size to 5

  • Batch Amend Order [UPDATE]

    • category=option reduces the batch size to 5

  • Batch Cancel Order [UPDATE]

    • category=option reduces the batch size to 5

  • Get Universal Transfer List [UPDATE]

    • Add new request parameters fromMemberId, toMemberId, used to filter the transfer list by from/to account.
    • Add new response fields withdrawReqId, depositReqId, the intenrally used req ID

Websocket API​

2026-08-20​

REST API​

  • Get Broker Earning [UPDATE]
    • bizType request parameter and response field now support new value FIAT_CONVERT (Fiat Convert)
    • totalEarningCat adds new field fiatConvert: rebate records for Fiat Convert trading
  • Enum [UPDATE]
    • execType: remove CorporateAction; add ForwardSplitSettle (forward stock split fractional share settlement), ReverseSplitSettle (reverse stock split fractional share settlement), Dividend (dividend distribution)
  • Enum [UPDATE]
    • type(uta-translog): add FORWARD_SPLIT_SETTLE (forward stock split fractional share settlement), REVERSE_SPLIT_SETTLE (reverse stock split fractional share settlement)

2026-08-18​

REST API​

  • Asset Overview [UPDATE]
    • UnifiedTradingAccount now returns a categories breakdown (crypto and stocks) instead of a flat coinDetail list

2026-08-13​

REST API​

  • Reinvest [UPDATE]
    • Add new optional request parameter leverage: leverage multiplier (integer only, passed as string); defaults to "1" (no leverage)

2026-08-11​

REST API​

  • Get Transaction Log [UPDATE]

    • Add new response field displayType: display type for the transaction log entry, consistent with the UI display
    • Add new "type", DIVIDEND_SETTLEMENT，indicates stock perps dividend

  • Get Full Depth Orderbook [UPDATE]

    • Support Futures

  • Get Airdrop Products [UPDATE]

    • Add new response fields personalApy and multiplier under yields: personal APR and personal coefficient for each yield coin
    • Add new response field personalApy at the product level: sum of personal APR across all yield coins

Websocket API​

2026-08-09​

REST API​

Websocket API​

  • Connect
    • Add websocket integration method for Brazil users

2026-08-07​

REST API​

Crypto Loan (Fixed-Term)

  • Get Available Inventory [NEW]
    • New endpoint to query available lending pool inventory for fixed-term loan
  • Create Borrow Order [UPDATE]
    • Add new request parameter strategyType: PARTIAL (allow partial fill, default); FULL (full fill only)
  • Get Borrow Order Info [UPDATE]
    • Add new response field strategyType: PARTIAL (allow partial fill, default); FULL (full fill only)

Crypto Loan (Flexible)

2026-08-06​

REST API​

  • Move Position [UPDATE]
    • TradFi perpetual contracts (including forex, stock, and commodities) are now supported
  • Switch Position Mode [UPDATE]
    • USDT futures, USDC perpetual, Inverse perpetual, and Inverse futures now support both one-way and hedge-mode
  • Get Order History [UPDATE]
    • smpGroup field type changed from integer to string
  • Get Open Orders [UPDATE]
    • smpGroup field type changed from integer to string
  • Get Trade Behaviour Config [UPDATE]
    • Add new response field smpType: user SMP (Self-Match Prevention) type configuration. 0: default; 1: cancel taker; 2: cancel maker; 3: cancel both

Websocket API​

  • Order [UPDATE]
    • smpGroup field type changed from integer to string

2026-08-04​

REST API​

  • Self Match Prevention [UPDATE]
    • Kazakhstan (KAZ) derivatives: SMP is now mandatory for all derivative orders
    • Turkey (TUR), Kazakhstan (KAZ), Georgia (GEO) spot: smpType of None, invalid value, or missing value is automatically set to CancelMaker
  • Upgrade to Unified Account Pro [UPDATE]
    • Upgrading from UTA PUBLIC to UTA PRO is prohibited daily between 07:55 and 08:05 UTC+0

2026-07-30​

REST API​

  • Get Account Instruments Info [UPDATE]
    • Updated the RPI permission model from account-level to symbol-level. Users can now submit RPI orders on any symbol that supports RPI, without requiring account-specific RPI permissions. Check the definition of isPublicRpiand and myRpiPermission
  • Get Coin Delta Amount [UPDATE]
    • Add new response field riskUnitDelta (risk unit delta value)
  • Create RFQ [UPDATE]
    • Added hedge request parameter: optional Delta Hedge leg for linear perpetual / linear delivery futures. Supports category, symbol, side, qty, and optional price
    • When anonymous is true, the deskCode returned by Get RFQs is an empty string
  • Create Quote [UPDATE]
    • Quoting the hedge leg is optional. Include it in quoteBuyList or quoteSellList. If the RFQ carries a hedge price, omitting the price when quoting will fall back to the RFQ price
  • Execute Quote [UPDATE]
    • Added isHedge request parameter: set to true to simultaneously execute the hedge leg in the RFQ. Direction is determined by quoteSide. Default: false
  • Get RFQs (real-time) [UPDATE]
    • Added response fields: anonymous (boolean), hedge (array of objects with category, symbol, side, qty, price)
  • Get RFQs [UPDATE]
    • Added response fields: anonymous (boolean), hedge (array of objects with category, symbol, side, qty, price)
  • Get Quotes (real-time) [UPDATE]
    • Added response field anonymous (boolean); added isHedge (boolean) to each item in quoteBuyList and quoteSellList
  • Get Quotes [UPDATE]
    • Added response field anonymous (boolean); added isHedge (boolean) to each item in quoteBuyList and quoteSellList
  • Get RFQ Details [NEW]
    • New endpoint to retrieve historical RFQ information with full details including active quotes (quoteList) and trade execution results (tradeLegs)

2026-07-28​

REST API​

Spot-X Launchpool — New endpoints

Spot-X Puzzle — New endpoints

Spot-X Token Splash — New endpoints

2026-07-27​

REST API​

  • Get Referral Code [NEW]
    • New endpoint to query the referral codes owned by the current user and their corresponding referral registration links. Sub-accounts return the master account's referral codes

2026-07-24​

REST API​

2026-07-23​

REST API​

  • Enum [UPDATE]
    • Add new execType value: CorporateAction (stock split or reverse stock split)

2026-07-21​

Websocket API​

  • Fast Order Response [UPDATE]
    • Option now is available
    • XML version upgrades to v2, added four response fields

2026-07-16​

REST API​

Websocket API​

  • Full Orderbook [NEW]
    • You can subscribe full depths orderbook channel (Spot)

2026-07-14​

REST API​

  • Get Flexible Available Inventory [NEW]
    • New endpoint to query the flexible available inventory (remaining borrowable amount from the lending pool) for a specified coin in spot margin trading
  • Get Fixed-Rate Available Inventory [NEW]
    • New endpoint to query the available inventory for fixed-rate borrowing by currency, term, and annual rate

2026-07-10​

REST API​

  • Get Deposit Records (on-chain) [UPDATE]
    • Added a new depositType enum: 50. If a deposit is classified as "depositType" = 50, the funds will not be credited to your account. Instead, you’ll need to log in to the Bybit website and withdraw the funds from there.
  • Get Sub Deposit Records (on-chain) [UPDATE]
    • Added a new depositType enum: 50. If a deposit is classified as "depositType" = 50, the funds will not be credited to your account. Instead, you’ll need to log in to the Bybit website and withdraw the funds from there.
  • Get Sub Account Deposit Records [UPDATE]
    • Added a new depositType enum: 50. If a deposit is classified as "depositType" = 50, the funds will not be credited to your account. Instead, you’ll need to log in to the Bybit website and withdraw the funds from there.

2026-07-06​

REST API​

2026-07-01​

REST API​

  • Get Internal Deposit Records [UPDATE]
    • Add new response field complianceStatus (internal transfer compliance collection status, only applicable to Bybit Turkey site users)

2026-07-02​

REST API​

Websocket API​

  • SBE Fast Order [UPDATE]
    • The Fast Order XML template version is updated to 1.
    • A new response field, liquidity, is added to indicate whether the corresponding order execution is Maker or Taker.

2026-06-29​

REST API​

  • Get Order List [UPDATE]
    • Add new response fields: fromAccount, toAccount, externalEventType

2026-06-23​

REST API​

  • Get Coin Delta Amount [NEW]
    • New endpoint to query coin delta amount details for institutional loan hedge product
  • Get Product Info [UPDATE]
    • Add new response field productType (0: Default, 1: CTA, 2: Hedge)

2026-06-16​

REST API​

  • Get Futures Leverage [NEW]
    • Add a new endpoint to get futures leverage in one request
  • Get Coupon List [NEW]
    • New endpoint to query interest-rate coupons and Dual Assets reward cards
  • Stake / Redeem [UPDATE]
    • Add new optional request parameter interestCard (interest bonus card, only applicable to FlexibleSaving Stake orders)

Alpha LP — New Endpoints

2026-06-15​

REST API​

RWA (Real World Assets) — New Endpoints

2026-06-11​

REST API​

  • Get Tickers [UPDATE]
    • Added single side open interest fields, singleOpenInterest, singleOpenInterestValue
  • Get Open Interest [UPDATE]
    • Added single side open interest fields, singleOpenInterest

Websocket API​

  • Tickers [UPDATE]
    • Added single side open interest fields, singleOpenInterest, singleOpenInterestValue

2026-06-10​

REST API​

  • Withdraw [UPDATE]
    • Added a new optional request parameter questionnaire, which can be used as a replacement for beneficiary. We recommend integrating this field as soon as possible.
  • Questionnaire [NEW]
    • It is a questionnaire page that serves as a reference for deposit and withdrawal transactions to meet Travel Rule compliance requirements.
  • Submit Deposit Originator Info [NEW]
    • A new endpoint has been introduced to submit the originator's compliance information when a deposit is flagged for Travel Rule review.
  • Get Deposit Records (on-chain) [UPDATE]
    • add response field travelRuleStatus
  • Get Sub Deposit Records (on-chain) [UPDATE]
    • add response field travelRuleStatus
  • Get Sub Account Deposit Records [UPDATE]
    • add response field travelRuleStatus
  • Get Fee Group Structure [UPDATE]
    • Add a new fee group groupId="9", G9(TradFi). There are no symbols in this group until June 16, 2026

2026-06-09​

REST API​

  • Set MMP [UPDATE]
    • Add new optional request parameter vegaLimit (vega limit, default: 500000)
  • Get MMP State [UPDATE]
    • Add new response field vegaLimit
  • Reset MMP [UPDATE]
    • vegaLimit will also be reset to 0 upon reset

2026-06-03​

  • Place Order [UPDATE]
    • add a new request parameter rpiTakerAccess, this feature is currently in a gradual rollout phase and will be fully available on 12 June.

Websocket API​

  • SBE Order Entry [UPDATE]
    • Update the xml template from version=1 to version=2, please see template
    • Add a new request parameter rpiTakerAccess, this feature is currently in a gradual rollout phase and will be fully available on 12 June.

2026-06-02​

Websocket API​

2026-05-28​

REST API​

  • Get Crypto Loan Position [UPDATE]
    • Add new response field colRes (platform level collateral restriction status)
  • Get Wallet Balance [UPDATE]
    • Add new response field colRes (platform level collateral restriction status)

Websocket API​

  • Wallet [UPDATE]
    • Add new response field colRes (platform level collateral restriction status)

2026-05-26​

REST API​

  • Strategy [UPDATE]
    • Supports a new strategy type pov

Websocket API​

  • Order [UPDATE]
    • Add new response fields rpiTakerAccess (whether the order has matched with an RPI order) and rpiMatchedQty (cumulative RPI matched quantity)

2026-05-22​

REST API​

PWM (Private Wealth Management) — New Endpoints

2026-05-21​

REST API​

  • Get Order History [UPDATE]

    • Add new response fields rpiTakerAccess (whether the order has matched with an RPI order) and rpiMatchedQty (cumulative RPI matched quantity)

  • Get Transaction Log [UPDATE]

    • The api rate limit downgraded from 50 req/s to 25 req/s

2026-05-14​

REST API​

Websocket API​

  • SBE Order Entry
    • XML template has been updated. 1. Update retMsg type from "varString8" to "varString16"; 2. Remove createAt from "BatchCreateRespV5"

2026-05-07​

REST API​

  • Get Staked Position [UPDATE]
    • Add new response fields availableAmount (redeemable amount) and freezeDetails (freeze detail list with amount and description)

2026-05-06​

REST API​

  • Create Supply Order [UPDATE]
    • Add new optional request parameter availableSource to specify the source account for supply (0: Funding Account, 1: Earn Flexible Account, 2: ALL, default: 0)
  • Cancel Supply Order [UPDATE]
    • Add new optional request parameter refundedAccount to specify the account to receive the refund (0: Funding Account, 1: EasyEarn, default: 0)

2026-04-30​

REST API​

2026-04-27​

REST API​

2026-04-23​

REST API​

2026-04-22​

REST API​

2026-04-21​

REST API​

Websocket API​

2026-04-20​

REST API​

  • Sign Agreement [UPDATE]
    • Add new request parameter categoryV2. New enum values will be added to categoryV2 going forward; the existing category field remains supported

2026-04-17​

REST API​

  • Withdraw [UPDATE]
    • add a new required request param transactionPurpose for Bybit Turkey site users

2026-04-16​

REST API​

2026-04-14​

REST API​

2026-04-10​

REST API​

2026-04-09​

REST API​

  • Manual Repay [UPDATE]
  • Manual Repay Without Asset Conversion [UPDATE]
    • Add new request parameter repaymentType to specify whether to repay fixed-rate, floating-rate, or both liabilities
  • Get Liability Info [NEW]
    • Add a new endpoint to query liability details for a coin, including total, fixed-rate, floating-rate, spot, and derivatives borrow amounts
  • Fixed-Rate Borrow [NEW]
    • Add a new endpoint to place a fixed-rate borrow order with customizable annual rate, term, repayment type, and fill strategy
  • Get Fixed-Rate Borrow Order Info [NEW]
    • Add a new endpoint to query fixed-rate borrow order history with filtering by order ID, coin, status, and term
  • Get Fixed-Rate Borrow Contract Info [NEW]
    • Add a new endpoint to query fixed-rate borrow contract details including principal, interest, repayment time, and contract status
  • Get Fixed-Rate Borrow Order Quote [NEW]
    • Add a new endpoint to query available fixed-rate borrow quotes with sorting by annual rate, term, or quantity
  • Renew Fixed-Rate Borrow [NEW]
    • Add a new endpoint to renew a fixed-rate borrow contract, supporting full or partial renewal by quantity
  • Get API Key Information [UPDATE]
    • Add new response field FiatBitPay under permissions. The old field FiatBybitPay remains available during the transition period
  • Modify Master API Key [UPDATE]
    • Add new request parameter FiatBitPay under permissions. The old field FiatBybitPay remains available during the transition period

2026-04-08​

REST API​

  • Support a new earn product [UPDATE]

2026-04-07​

REST API​

2026-03-31​

REST API​

2026-03-26​

REST API​

  • Get Instruments Info [UPDATE]
    • Add a new response field xstockMultiplierfor category=spot, used for xstocks trading pairs.
  • Get Account Instruments Info [UPDATE]
    • Add a new response field xstockMultiplierfor category=spot, used for xstocks trading pairs.
  • Asset Overview [UPDATE]
    • Add new request parameters valuationCurrency and accountType
    • Add new response field extMap (with priceUpper, priceLower, equityUnit) under coinDetail when accountType=Alpha
  • Get Spread Max Qty [NEW]
    • Add a new endpoint to query the available balance for placing a spread order based on symbol ID, side, and order price
  • Get Option Asset Info [NEW]
    • Add a new endpoint to query option asset P&L information per coin, including delta, realised/unrealised P&L, and margin data
  • Get Portfolio Margin Info [NEW]
    • Add a new endpoint to query portfolio margin account wallet balance and asset P&L range information
  • Get Pay Info [NEW]
    • Add a new endpoint to query repayment collateral information for the account
  • Get Trade Info For Analysis [NEW]
    • Add a new endpoint to query aggregated trade statistics for a symbol, including execution values, quantities, fees, and daily breakdown
  • Get Total Members Assets [NEW]
    • Add a new endpoint to query total assets across all member accounts with optional coin-denominated valuation
  • Get Trade Behaviour Config [UPDATE]
    • Add new response fields smsef and fmsef to indicate whether Spot and Futures MNT fee deduction is enabled

2026-03-24​

REST API​

2026-03-23​

REST API​

  • Get Trade Quote [NEW]
    • Add a new endpoint to get a price quote before executing an on-chain purchase or redeem trade
  • Execute Purchase [NEW]
    • Add a new endpoint to execute a buy order to purchase on-chain tokens with payment tokens (e.g. USDT)
  • Execute Redeem [NEW]
    • Add a new endpoint to execute a sell order to redeem on-chain tokens back to payment tokens
  • Get Payment Token List [NEW]
    • Add a new endpoint to query available payment tokens and their CEX token codes for on-chain trading
  • Get Order List [NEW]
    • Add a new endpoint to query on-chain trade order history with status, fees, and execution details
  • Get Biz Token List [NEW]
    • Add a new endpoint to query on-chain tradable tokens with DEX token codes, risk flags, and order limits
  • Get Token Price List [NEW]
    • Add a new endpoint to batch query on-chain token prices, 24h change, volume, and market cap
  • Get Token Details [NEW]
    • Add a new endpoint to query token project details including description, social links, and risk flags
  • Get Asset List [NEW]
    • Add a new endpoint to query user's on-chain token portfolio with holdings, PnL, and market value
  • Get Asset Detail [NEW]
    • Add a new endpoint to query detailed holding information for a specific on-chain token

2026-03-20​

REST API​

  • Sign Agreement [UPDATE]
    • Add a new category=3 for crude oil perpetual agreement

2026-03-19​

WebSocket​

  • Orderbook [UPDATE]
    • Spot Level 200 data push frequency changed from 200ms to 100ms

REST API​

  • Get Staked Position [UPDATE]
    • Add new response field autoReinvest to indicate whether auto-reinvest is enabled.
  • Modify Position [NEW]
    • Add a new endpoint to modify the auto-reinvestment setting for OnChain Fixed positions
  • Get Yield History [UPDATE]
    • category now supports OnChain
  • Get APR History [NEW]
    • Add a new endpoint to query historical APR data for FlexibleSaving and OnChain products, supporting up to 6 months of history

2026-03-17​

WebSocket​

2026-03-13​

REST API​

  • Get Currency Data [NEW]
    • Add a new endpoint to query borrowing currency data, including flexible/fixed borrow availability, min borrow quantity, precision, and interest rate range

2026-03-12​

REST API​

2026-03-09​

REST API​

2026-03-06​

REST API​

  • Asset Overview [NEW]
    • Add a new endpoint to query master account or subaccount's total assets and detailed asset holdings across different accounts and product categories
  • Funding Account Transaction History [NEW]
    • Add a new endpoint to query transaction log in Funding Account, supporting filtering by transaction type and time range

2026-03-05​

REST API​

2026-03-03​

REST API​

2026-02-12​

REST API​

2026-02-10​

REST API​

  • Set Rate Limit [NEW]
    • Add new endpoint to support exchange broker to set the rate limit for its sub account
  • Get Rate Limit Cap [NEW]
    • Add new endpoint to query the EB cap once specially configured.
  • Get All Rate Limits [NEW]
    • Add new endpoint to query all configured rate limit data
  • Modify Master API Key [UPDATE]
    • Remove request fields "ips", modifying, adding, or deleting IP addresses via API is prohibited.
    • For Read_Write apikey, adding or deleting FiatP2P, FiatBybitPay, and FiatConvertBroker is prohibited.
  • Spot DMM Listing Integration [NEW]
    • Add Spot DMM listing integration description

2026-02-04​

REST API​

  • Get Affiliate User List [UPDATE]
    • Add new response fields "tradfiTradeVol", "tradfiTradeVol30Day", "tradfiTradeVol365Day", "commissionsVol", "commissions30Day", "commissions365Day"
  • Get Affiliate User Info [UPDATE]
    • Add new response fields "tradfiTradeVol30Day", "tradfiTradeVol365Day", "commissions30Day", "commissions365Day"

2026-01-28​

REST API​

2026-01-16​

REST API​

  • Obtain Max Loan Amount [NEW]
    • Add a new endpoint to check the maximum borrowable amount & remaining individual platform limit for crypto loans.

2026-01-13​

REST API​

  • Get Trade History [UPDATE]
    • Add new request param "settleCoin" for linear,inverse,option
  • Get Position Info [UPDATE]
    • Add new response field "breakEvenPrice" for linfear,inverse

WebSocket API​

  • Position [UPDATE]
    • Add new response fields breakEvenPrice for linear,inverse

2026-01-08​

REST API​

  • Repay [NEW]
    • Add a new endpoint that allows INS loan clients to repay their loans independently.

2026-01-07​

REST API​

  • Get Open Orders [UPDATE]
    • add parentOrderLinkId response field for take profit & stop loss orders to link its parent order.
  • Get Order History [UPDATE]
    • add parentOrderLinkId response field for take profit & stop loss orders to link its parent order.

WebSocket API​

  • Order [UPDATE]
    • add parentOrderLinkId response field for take profit & stop loss orders to link its parent order.

2026-01-06​

REST API​

2026-01-05​

REST API​

  • Withdraw [UPDATE]
    • For beneficiary information, add beneficiaryTransactionPurpose, beneficiaryRepresentativeFirstName, beneficiaryRepresentativeLastName mandatory required parameters when withdraw to company account via Krean CODE channel

2025-12-25​

REST API​

  • Get LTV [UPDATE]
    • Add new field liqStatus

2025-12-24​

REST API​

2025-12-23​

2025-12-18​

REST API​

  • Accept non-LP Quote[NEW]
    • Add new endpoint for accept non-LP Quote
  • Get RFQs (real-time)[UPDATE]
    • Add new response filed acceptOtherQuoteStatus
  • Get RFQs [UPDATE]
    • Add new response filed acceptOtherQuoteStatus
  • Get ADL Alert [UPDATE]
    • For shared insurance pool, the "balance" field will follow a T+1 refresh mechanism and will be updated daily at 00:00 UTC.
    • The "maxBalance" field will be deprecated and will return an empty string.
  • Manual Repay [UPDATE]
    • MNT will temporarily not be used for repayment, and repaying MNT liabilities through convert-repay is not supported. However, you may still use Manual Repay Without Asset Conversion to repay MNT using your existing balance.

WebSocket API​

  • ADL Alert [UPDATE]
    • For shared insurance pool, the "b" field will follow a T+1 refresh mechanism and will be updated daily at 00:00 UTC.
    • The "mb" field will be deprecated and will return an empty string.
  • RFQ [UPDATE]
    • Add new response filed acceptOtherQuoteStatus

2025-12-16​

  • SBE Level 50 Integration [UPDATE]
    • SBE Level 50 for Futures will be released on the mainnet at 7:00 AM (UTC+0) on December 16th

2025-12-02​

SBE API​

  • SBE Basic Info [NEW]
    • Add SBE basic information description
  • SBE BBO Integration [NEW]
    • Add SBE BBO market data endpoint
    • SBE BBO for Spot was released on the mainnet on September 18th
    • SBE BBO for Futures was released on the mainnet on November 4th
  • SBE Level 50 Integration [NEW]
    • Add SBE Level 50 market data endpoint
    • SBE Level 50 for Spot was released on the mainnet at 7:00 AM (UTC+0) on December 2nd

2025-11-27​

REST API​

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​

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[UPDATE]
    • "timeInForce" request parameter supports RPI when creating orders
  • Order [UPDATE]
    • Response field "timeInForce" supports RPI
  • Trade [UPDATE]
    • 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[UPDATE]
    • "timeInForce" request parameter supports RPI when creating orders
  • Order [UPDATE]
    • Response field "timeInForce" supports RPI
  • Trade [UPDATE]
    • 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 [UPDATE]
    • 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 [UPDATE]
    • 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 [UPDATE]
    • 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​

  • Get Instruments Info [UPDATE]
    • Add new response fields riskParameters, limitParameter, marketParameter

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