Bybit API Announcements
3.12K subscribers
1 photo
2 files
329 links
Download Telegram
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
Dear traders,

Regarding the earlier announcement (https://t.me/Bybit_API_Announcements/299), we have already deployed the change to TESTNET. You may test it and let us know if you encounter any issues.

The production deployment will begin on March 20, and all traffic will be switched over by March 27, 2025
Dear trader,

To improve efficiency and performance, Bybit will be making changes to the Get Transfer Records endpoints due to the increasing volume of transfer records.

Before the change:
* If startTime and endTime are not provided, the API returns data from the past 30 days by default.
* There is no restriction on the startTime & endTime range when querying transfer records.

After the change:
* If startTime and endTime are not provided, the API returns data from the past 7 days by default.
* If only startTime is provided, the API returns records from startTime to startTime + 7 days.
* If only endTime is provided, the API returns records from endTime - 7 days to endTime.
* If both are provided, the maximum allowed range is 7 days (endTime - startTime ≤ 7 days).

Affected APIs:
V5 - Get Internal Transfer Records
V5 - Get Universal Transfer Records
V3 - /asset/v3/private/transfer/inter-transfer/list/query
V3 - /asset/v3/private/transfer/universal-transfer/list/query

Deployment timeline:
1. Accounts with UID ending in "0": 6AM UTC, April 15
2. All other accounts: 6AM UTC, April 16
Dear Traders,


Discontinuation of SLP as collateral and borrowable asset.

Bybit will be discontinuing SLP as a collateralizable or loanable asset from Apr 10, 2025.

Please check the details below:
https://announcements.bybit.com/article/discontinuation-of-slp-as-collateral-and-borrowable-asset-blt7be16cc0532403c8/
Dear Traders,

Due to the increasing volume of data from large accounts, the /v5/account/transaction-log query frequently experiences timeouts, placing significant strain on our system. To mitigate this, we've decided to change the default query range from 7 days to 24 hours.

Before this change: startTime and endTime are not passed, return 7 days by default
After this change: startTime and endTime are not passed, return 1 days by default

This change is currently expected to be available on the testnet on 2025/04/17 and on the mainnet on 2025/04/25.


Please refer to API doc:
https://bybit-exchange.github.io/docs/v5/account/transaction-log
Dear Traders,

We are pleased to announce the launch of the Market Order with Slippage Tolerance feature, now available for both Spot and Futures trading.

📢 Announcement:
Please refer to our official announcement here:
Introducing the Market Order with Slippage Tolerance Feature


🔧 OpenAPI Update:
Two new request params — slippageToleranceType and slippageTolerance — have been added to the order placement endpoint.
For full details, please refer to the OpenAPI documentation:

Create Order – OpenAPI v5
Create Batch Order – OpenAPI v5
Websocket Create Order – OpenAPI v5
Announcement: USDC Derivatives Display Name Update

Starting April 28, 2025, Bybit will update the display names for all USDC Perp, Futures & Options on Web & App for better clarity and industry alignment.

🔄 What’s Changing?
BTC-PERP → BTCUSDC
BTC-27JUN25 → BTCUSDC-27JUN25
BTC-27JUN25-75000-C → BTCUSDC-27JUN25-75000-C

No impact on trading: All orders and positions remain active. No action is needed.
API unchanged: The symbol parameter stays the same for USDC Derivatives.
New displayName field added to Instrument Info endpoint (for UI/internal mapping).

📲 Please update to the latest Bybit App and restart it to ensure all name changes are properly reflected across the platform (older versions may show outdated names in some areas like push notifications or emails).
Bybit API Rate Limit Policy (Institutional Version).pdf
118.3 KB
Dear Traders,

Announcement: Upcoming Institutional API Rate Limit Policy
Bybit will introduce a unified rate limit cap of 60,000 transactions per second (TPS) per product line (Futures, Options, Spot). This cap applies independently by business line, allowing institutions to allocate limits flexibly across all UIDs under their structure.

Features:
• Supports tier upgrades and downgrades, with proportional scaling to ensure compliance when limits are exceeded
Backend-assisted configuration during rollout
Custodial structures supported: institutional cap applies across all accounts (parent and sub accounts)


The new policy is expected to launch next quarter. If you have any questions or concerns, please contact your Bybit RM within two weeks.
Dear Traders,
We would like to inform you of an upcoming change to the SPOT order price logic.

Current Behavior (Before the Change):
If a user places a limit order with a price that crosses the opposite side of the order book:
• Buy order price > system calculated maximum limit price for buy orders
The system rejects the order with: "retCode": 170193, "retMsg": "Buy order price cannot be higher than XXXX USDT."
• Sell order price < system calculated minimum limit price for sell orders
The system rejects the order with: "retCode": 170194, "retMsg": "Sell order price cannot be lower than XXXX USDT."

New Behavior (After the Change):
If such orders are submitted:
• Buy order price > system calculated maximum limit price for buy orders, The system will automatically adjust the order price to that maximum limit price
• Sell order price < system calculated minimum limit price for sell orders. The system will automatically adjust the order price to that minimum limit price.
No error will be returned. The order will proceed with the adjusted price.

Deployment Schedule:
• 2025.06.02 — Rollout to Mainnet-Grayscale
• 2025.06.16 — Rollout to Mainnet-Full
Dear users,

To better measure market risks and enhance your trading experience, we're updating the third batch assets of collateral value ratio rules for Unified Trading Account (UTA) Borrowing, effective May 28, 2025, 6AM UTC. This transition, from a single collateral value ratio to a tiered collateral value ratio, will impact the Maintenance Margin Rate (MMR) in your UTA account. Stay informed and monitor your positions accordingly to manage any potential risks.

Please check the details below:
https://announcements.bybit.com/article/update-to-uta-borrowing-collateral-value-ratio-rules-third-batch-implementation-bltec147ec6cb8c554b/