Skip to main content

Pilot Features

Open API Supports Demo Trading​

  • Available date: Testnet - alive, Mainnet - 3 Apr 2024
  • Cover: demo trading account
  • Details: You can refer to this page to start demo trading API

Websocket Place Order Feature​

  • Available date: Testnet - alive, Mainnet - TBD
  • Cover: UTA Spot/Linear/Option
  • Details: You can use websocket to place/amend/cancel the order

Batch APIs are ready for Spot​

  • Available date: Testnet - alive, Mainnet - 5 Mar 2024
  • Cover: UTA Spot
  • Details: You can use batch API to start Spot trading

Spot supports bidirectional Tp/Sl​

  • Available date: Testnet - alive, Mainnet - 15 Jan 2024
  • Cover: UTA Spot
  • Details: You can set takeProfit, stopLoss when creating Spot order

Spot Hedging Feature Is Available​

  • Available date: Testnet - alive, Mainnet - 16 Nov 2023
  • Cover: Unified account - Portfolio Margin mode
  • Details: You can enable Spot Hedging function for Portfolio Margin via Set Spot Hedging

Spot Supports Amend Order​

  • Available date: Testnet - alive, Mainnet - 1 Nov 2023
  • Cover: Classic & Unified account Spot
  • Details: You can amend your spot orders via Amend Order

Unified Account Spot Stop Orders logic is changed​

  • Available date: Testnet - alive, Mainnet - 26 Oct 2023 (grey scale period, all are effective est. 2th Nov 2023)
  • Cover: Unified account Spot Stop Orders
  • Details: Once the TP/SL order or Conditional order is triggered, the order ID will be kept the same

UTA Pro Batch Feature​

  • Available date: Testnet - alive, Mainnet - 31 Aug 2023
  • Cover: UTA Pro, USDT Perpetual, USDC Perpetual & USDC Futures (linear)
  • Details: UTA Pro user can batch create/amend/cancel linear orders
Sample code
POST https://api-testnet.bybit.com/v5/order/create-batch

> Request Body
{
    "category": "linear",
    "request": [
        {

            "symbol": "BTCUSDT",
            "orderType": "Limit",
            "side": "Buy",
            "qty": "0.1",
            "price": "25500",
            "timeInForce": "GTC",
            "orderLinkId": "test-03",
            "reduceOnly": false,
            "tpslMode": "Full",
            "takeProfit": "26300",
            "stopLoss": "24800",
            "triggerDirection": null,
            "triggerPrice": null,
            "triggerBy": null,
            "positioIdx": 0,
            "smpType": null,
            "tpLimitPrice": null,
            "slLimitPrice": null,
            "slOrderType": null,
            "tpOrderType": null

        },
        {

            "symbol": "ETHUSDT",
            "orderType": "Limit",
            "side": "Buy",
            "qty": "0.1",
            "price": "1550",
            "timeInForce": "GTC",
            "orderLinkId": "test-04",
            "reduceOnly": false,
            "tpslMode": "Full",
            "takeProfit": "1680",
            "stopLoss": "1490",
            "triggerDirection": null,
            "triggerPrice": null,
            "triggerBy": null,
            "positioIdx": 0,
            "smpType": null,
            "tpLimitPrice": null,
            "slLimitPrice": null,
            "slOrderType": null,
            "tpOrderType": null
        }
    ]
}
> Response
{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "list": [
            {
                "category": "linear",
                "symbol": "BTCUSDT",
                "orderId": "6afd7e83-7176-4f73-93e0-44a8f2babd14",
                "orderLinkId": "test-03",
                "createAt": "1693212677410"
            },
            {
                "category": "linear",
                "symbol": "ETHUSDT",
                "orderId": "9eeef30c-c682-42b2-a4a7-7e403db8506c",
                "orderLinkId": "test-04",
                "createAt": "1693212677410"
            }
        ]
    },
    "retExtInfo": {
        "list": [
            {
                "code": 0,
                "msg": "OK"
            },
            {
                "code": 0,
                "msg": "OK"
            }
        ]
    },
    "time": 1693212677411
}

Add Customised Disconnection Configuration​

  • Available date: Testnet - alive, Mainnet - 16 Aug 2023
  • Cover: All kinds of accounts - V5 Websocket Private Connection
  • Details: Set /v5/private?max_active_time=, supported range is from 30s to 600s. For more info, please check here

Adjust error code​

Old error codeNew error codeMsg
34001283200320Operations Restriction: The current LTV ratio of your Institutional Loan has hit the liquidation threshold. Assets in your account are being liquidated.
1760363200320Operations Restriction: The current LTV ratio of your Institutional Loan has hit the liquidation threshold. Assets in your account are being liquidated.

UTA borrow quota is shared across main-sub uids​

  • Available date: Testnet - alive, Mainnet - 11 Aug 2023
  • Cover: UTA account
  • Details: Before each uid has an independent borrow quota, but now, main-sub uids share the same borrow quota

UTA user can set collateral coin​

  • Available date: Testnet - alive, Mainnet - 10 Aug 2023
  • Cover: UTA account
  • Details: User can set collateral coin via API

User can upgrade account to UTA Pro manually​

  • Available date: Testnet - alive, Mainnet - 08 Aug 2023
  • Cover: Normal account, UTA account
  • Details: User can upgrade account to UTA Pro via API

OpenAPI supports Spot Conditional Order​

  • Available date: Testnet - alive, Mainnet - 07 Aug 2023
  • Cover: Normal account, UTA account
  • Details: User can place Spot conditional order

UTA Supports Institutional Lending​

  • Available date: Testnet - alive, Mainnet - 24 July 2023
  • Cover: UTA
  • Details: UTA can have OTC loan

Support Funding For USDC Perp​

  • Available date: Testnet - alive, Mainnet - 13 July 2023
  • Cover: UTA USDC Perpetual
  • Details: There was no execType=Funding in Get Trade History and websocket execution stream update. Now you will it.

New Copy Trading​

  • Available date: Testnet - alive, Mainnet - 24 June 2023
  • Cover: Copy trading
  • Details: Bybit will release uids that allow upgrades in batches starting from 23 June, and if you select to upgrade it, you can only use Contract V3 or V5 to copy trade

Unified Account Supports Isolated Margin And Hedge Mode​

  • Available date: Testnet - alive, Mainnet - 1 June 2023
  • Cover: Unified trading account only
  • Details: Isolated margin mode for UTA is account level. Hedge mode supports USDT perpetual only

New TP/SL​

  • Available date: Testnet - alive, Mainnet - 23 May 2023
  • Cover: V5 API and Contract V3 API
  • Details: UTA account: USDT Perpetual, USDC Perpetual and Futures, Inverse contract, Inverse contract
    Normal account: USDT Perpetual, Inverse contract

Query Pre-upgrade Records​

  • Available date: Testnet - alive, Mainnet - 27 Apr 2023
  • Cover: UTA account
  • Details: After upgraded to UTA, you can get those order information before upgraded.

C2C Lending (Abandoned)​

  • Available date: Testnet - alive, Mainnet - 22 Apr 2023
  • Cover: All users (grey scale in the progress right now)
  • Details: You can lend your available assets to platform to earn yield

Self Match Prevention​

  • Available date: Testnet - alive, Mainnet - 20 Apr 2023
  • Cover: read here
  • Details: Support spot, futures and options

Upgrade to UTA without closing positions​

  • Available date: Testnet - alive, Mainnet - 04 Apr 2023
  • Cover: Normal account is upgraded to Unified account
  • Details: Do not need to close positions when upgrade. For more details. please refer to upgrade API information

UTA can trade USDC Futures via V5​

  • Available date: Testnet - alive, Mainnet - 20 Mar 2023
  • Cover: Unified trading account users only
  • Details: Add USDC Futures trading pair

Institutional Lending V5 API​

  • Available date: Testnet - alive, Mainnet - 13 Mar 2023
  • Cover: Institutional clients who applied OTC
  • Details: Clients can get LTV, lends and repayment information

Normal account can trade Spot via V5​

  • Available date: Testnet - alive, Mainnet - 10 Mar 2023
  • Cover: Normal account
  • Details: Use V5 API to trade Spot for normal account

Unify symbol status enums​

  • Available date: Testnet - alive, Mainnet - 10 Mar 2023
  • Cover: /v5/market/instruments-info status field
  • Details: Use Trading, Closed, Settling, PreLaunch, Deliverying

Release V5 Margin trade (normal account) API​

  • Available date: Testnet - alive, Mainnet - 3 Mar 2023
  • Cover: Normal account can operate margin trade via V5
  • Details: able to loan, repay margins with V5

UTA can trade Inverse Contract​

  • Available date: Testnet - alive, Mainnet - 21 Feb 2023
  • Cover: UTA has ability to trade inverse contract via V5 API
  • Details: Please note that inverse contract trade is conducted though the CONTRACT wallet

Merge SPOT account into UNIFIED account(IMPORTANT)​

  • Available date: est. March 3rd, 2023
  • Cover: UTA users only
  • Details: You need to adjust withdrawal logic by transfer funds to FUND account first, then call withdraw API

Use RSA keys to authenticate​

  • Available date: Testnet - alive, Mainnet - 21 Feb 2023
  • Cover: All V3 & V5 the endpoints need authentication
  • Details: Please refer to this guideline to have a quick start

Add a new enum type for execType​

  • Available date: Testnet - alive, Mainnet - 20 Feb 2023
  • Cover: Contract V3 - Websocket private channel - execution topic
  • Details: Funding execution stream will be pushed depending on the funding interval of the symbol.

Normal account is supported by V5 API​

  • Available date: Testnet - alive, Mainnet - 9 Feb 2023
  • Cover: non-unified account can trade USDT perpetual and Inverse contract
  • Details: After this release, you may get some 401 errors or 404 errors if you have following actions:

401: You are using v1/v2 way to pass authentication params:

GET https://api.bybit.com/v5/position/list?api_key=xxx&category=linear&recv_window=5000&symbol=ETHUSDT&timestamp=1675929695887&sign=xxx

You should pass them in the request header:

Host: api-testnet.bybit.com
-H 'X-BAPI-SIGN: XXXXXXXXXX' \
-H 'X-BAPI-API-KEY: XXXXXXXXXX' \
-H 'X-BAPI-TIMESTAMP: 1658384431891' \
-H 'X-BAPI-RECV-WINDOW: 5000'

404: For below APIs, if you use unsuitable category, i.e., you use Normal account to access category=option/spot

Adjust error code​

Old error codeNew error codeMsg
3400045110073Set margin mode failed
34009910016Server error

Add level 500 depth​

  • Available date: Testnet - 13 JAN 2023, Mainnet - 16 JAN 2023
  • Cover: V5 orderbook and V3 orderbook
  • Details: Linear contract and inverse contract supports 500 depth, and the push frequency is 100ms.