Bybit API Announcements
3.12K subscribers
1 photo
2 files
329 links
Download Telegram
Dear traders,

Due to the upcoming calculation pressure for transferBalance, availableToWithdraw fields, there will be changes to the below API endpoints.

Before the change:
1. Get Wallet Balance, when accountType=`UNIFIED`, availableToWithdraw returns the transferable balance
2. Websocket - Wallet, when accountType=`Unified`, availableToWithdraw returns the transferable balance
3. V5 - Get All Coins Balance and /asset/v3/private/transfer/account-coins/balance/query, when accountType=`UNIFIED`, request parameter coin is not required, and no limit when passing multiple coins

After the change:
1 & 2. when accountType=`UNIFIED`, response field availableToWithdraw is deprecated, and always returns empty string
3. when accountType=`UNIFIED`, request parameter coin is required, and supports up to 10 coins

Above changes will be implemented from 2AM UTC, 9 Jan 2025.

A new endpoint has been introduced: Get Unified Wallet Transferable Amount.

Please make sure you adapt to the changes in advance.
Dear traders,

We are pleased to inform you about the upcoming rebranding and migration of Fantom (FTM) to Sonic (S) on Bybit. All FTM tokens will be automatically converted to S tokens at a 1:1 ratio (1 FTM = 1 S). Please review the key updates and important dates below to ensure a smooth transition and uninterrupted trading experience.

https://announcements.bybit.com/article/bybit-rebrands-fantom-to-sonic-blt7b74611f3ce04095/
Dear traders,

To mitigate market risks, enhance liquidity, and improve the overall trading experience, Bybit will be implementing the following changes starting on Jan 21, 2025:

1. The minimum order value (minOrderAmt) for Spot Trading via API will increase from 1 USDT to 5 USDT. Trading through Spot trading bots and brokers will not be impacted.

2. All users must meet both the minimum order quantity (minOrderQty) and value (minOrderAmt) requirements when placing a Limit Order.

API traders can access the latest minimum order sizes for different trading pairs via GET /v5/market/instruments-info (category = spot, field = minOrderAmt/minOrderQty).

Announcement link: https://announcements.bybit.com/en/article/bybit-spot-adjustment-to-minimum-order-value-for-api-trading-bltc321af13dcc5254f/ for reference
Important Notice: UTA Upgrade Across Bybit Platforms and Phasing Out of Standard Accounts.

Since its launch in Jul 2022, the Unified Trading Account (UTA) has proven its reliability and efficiency even during extreme market volatility. Offering a consolidated platform for Spot, Perpetuals, Futures, and Options trading, UTA has become the go-to account for over 80% of Bybit users.

Bybit is committed to providing a seamless trading experience; therefore, we have decided to upgrade all Standard Accounts to UTAs.

Please make sure to migrate to the new version of UTA before January 31, 2025. Starting from February, we will force the upgrade of Standard accounts and old versions of UTA, and take measures such as Derivatives trading reduce only, Spot trading suspend and orders cancel. For the mandatory measures that have been implemented for non-INS users, please refer to: https://announcements.bybit.com/en/article/important-notice-uta-upgrade-across-bybit-platforms-and-phasing-out-of-standard-accounts--blt38103c4e0642c7c7/
Changelog 2025-01-09
REST API
Get Sub Account Deposit Records (Exchange Broker)
Get Deposit Records (on chain)
Get Sub Deposit Records (on chain)
- Add new response field fromAddress, source address of the deposit

Get Coin Information
- Add a new response field contractAddress, show complete token contract address

Get All Coins Balance
- For accountType=UNIFIED, "coin" request parameter becomes mandatory, and it supports up to 10 coins in one request

Get Exchange Broker Earning
- Add a new response field execId
Dear trader,

Due to the underlying calculation update, there is a change for convert endpoint Get Convert Coin List.

Before the change, when you query like GET /v5/asset/exchange/query-coin-list?side=0, response field `balance` represents fromCoin balance can be used to convert

After the change, when you query like GET /v5/asset/exchange/query-coin-list?side=0, response field `balance` is no longer accurate, which means it is not the balance that can be used to convert

To get the accurate balance of fromCoin to convert, you need to query in this way, e.g., GET /v5/asset/exchange/query-coin-list?side=1&coin=BTC, you will find BTC data in the response, and the `balance` field for BTC is an accurate balance

Above change will be implemented from 2AM UTC, 16 Jan 2025
Collateral Value Ratio Adjustments for 13 Assets

To provide users with a better trading experience, Bybit will be adjusting the collateral value ratio for 13 assets for Unified Trading Account (UTA) users, effective Jan 16, 2025, 10AM UTC.

Please monitor your account closely for any changes in the available margin after the adjustments to mitigate account risks and avoid any potential negative impact on your assets.

Please check the details below: https://announcements.bybit.com/article/collateral-value-ratio-adjustments-for-13-assets-jan-16-2025--bltffd75fea92cdaca3/
Dear traders,

According to the earlier announcement, new risk parameters have been added in the Get Instruments Info category=spot.

Before the change, "riskParameters": {"limitParameter": "0.01","marketParameter": "0.02"}
Now, "riskParameters": {"priceLimitRatioX": "0.01","priceLimitRatioY": "0.02"}

To get more details, please refer to https://announcements.bybit.com/en/article/title-adjustments-to-bybit-s-spot-trading-limit-order-mechanism-blt786c0c5abf865983/
Dear traders,

Bybit will change the push way of Websocket - Orderbook level 1 messages for Spot, Perpetuals and Futures.

Currently, you receive the snapshot data first, then with delta data only.

After the change, you always receive the snapshot data.

Deployment timeline:
Testnet: 13 Mar, 2025
Mainnet: start from 20 Mar, and all traffic will be switched until 27 Mar, 2025

Sample:
{"topic":"orderbook.1.XUSDT","ts":1737517610071,"type":"snapshot","data":{"s":"XUSDT","b":[["0.00011424","8951586"]],"a":[["0.00011429","465637"]],"u":1,"seq":87575644668},"cts":1737517609886}

{"topic":"orderbook.1.XUSDT","ts":1737517611071,"type":"snapshot","data":{"s":"XUSDT","b":[["0.00011425","400000"]],"a":[["0.0001143","2252755"]],"u":2,"seq":87575647278},"cts":1737517610615}

{"topic":"orderbook.1.XUSDT","ts":1737517840331,"type":"snapshot","data":{"s":"XUSDT","b":[["0.00011425","100000"]],"a":[],"u":3,"seq":87576052462},"cts":1737517840324}
Dear users,

please check the important announcements below:

Updates to Collateral Value Ratio Rules for UTA Borrowing
To better measure market risks and enhance your trading experience, we are updating the Collateral Value Ratio Rules for Unified Trading Account (UTA) Borrowing, effective Feb 19, 2025, at 8AM UTC. This transition from a single conversion rate to a tiered collateral value ratio will impact the Maintenance Margin Rate (MMR) in your UTA account. Please stay informed and monitor your positions accordingly to manage any potential risks.
https://announcements.bybit.com/article/updates-to-collateral-value-ratio-rules-for-uta-borrowing-blteba1497739a08988/

Discontinuation of TUSD as Collateral and Borrowable Asset
Bybit will be discontinuing the support of TUSD as a collateralizable or loanable asset from Feb 13, 2025.
https://announcements.bybit.com/article/discontinuation-of-tusd-as-collateral-and-borrowable-asset-blte5a71fefe65aa0e7/
Dear traders,

Regarding announcement: https://t.me/Bybit_API_Announcements/300, please also note the value of collateralRatio field from below two APIs is no longer useful due to the transition from a single conversion rate to a tiered collateral value ratio when the change is effective.

We will introduce a new endpoint to obtain tiered collateral value ratio.

Affected APIs:
Get Collateral Info
Get VIP Margin Data
Dear Users,

Due to a backend configuration error, certain API endpoints allow access using read-only API keys, which should not have been permitted. The affected endpoints include:
Set Deposit Account
Create Internal Transfer
Create Universal Transfer
Set Collateral Coin
Batch Set Collateral Coin
Modify Sub acct API Key

After this adjustment, requests to the above-listed endpoints using read-only API keys will be denied with the error code:
10005 – Permission denied, please check your API key permissions.

If your integration currently relies on read-only keys for these operations, please update your API key permissions accordingly before the scheduled change to ensure continued functionality.

This change will take effect on February 18, 2025, at 7:00 AM (UTC+0).
Change log 2025-02-20
REST API
Earn API [NEW]
- Get Product Info
- Stake / Redeem
- Get Stake/Redeem Order History
- Get Staked Position

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.
Dear traders,

The webSocket batch trade feature is now available in production. Please note that we may roll it back if any critical defects are reported.

API Documentation: https://bybit-exchange.github.io/docs/v5/websocket/trade/guideline#batch-createamendcancel-order
bybit-api Node.js SDK

Trading via WebSocket APIs is here! The next generation of the Node.js/JavaScript/TypeScript SDK for Bybit is finally released:
https://www.npmjs.com/package/bybit-api

Detailed release notes, including some minor but necessary breaking changes to the WebsocketClient, can be found here:
https://github.com/tiagosiebler/bybit-api/pull/398

What’s new in this major release?
- Trade using Bybit’s WebSocket API, with an async/await REST-like interface!
—> Example: https://github.com/tiagosiebler/bybit-api/blob/master/examples/ws-api-promises.ts#L93-L120
- Significant upgrades to the WebsocketClient architecture.
- Misc dependency updates (Node LTS, Axios, TypeScript).
- Auth/sign with Web Crypto API by default, for increased compatibility with frontend environments.
- Removal of decommissioned V1-V3 REST APIs.

Thank you to those that helped with testing in the extended public beta. After 9 beta releases we ironed out the few remaining issues before the major release, thanks to your help!
Dear traders,

We are excited to announce the listing of 5 new Inverse Perpetual Contract on our Derivative trading platform!


DOGEUSD

FILUSD

LINKUSD

AVAXUSD

BCHUSD

https://announcements.bybit.com/en/article/bybit-to-list-5-new-inverse-perpetual-contract-on-derivative-trading-platform-blt86f7582fb065a873/?category=new_crypto