This page introduces the trade types that can be obtained via Bybit API and exchange file.
Contents
1.Period for which history can be obtained in a file
It is announced that you can obtain history for the past 2 years.
- You can export up to two years of data while the maximum data can be exported each time is six months for Spot & Earn and three months for Derivatives.
- You can export up to 5 times per day.
- Each download URL will only be kept for 7 days.
- Up to 10,000 records can be exported each time; please modify the date range or contact the Bybit customer support if the status shows "Limit Exceeded"
- The export will be processed within 5 -10 minutes. You can download the file once the export is complete.
For example, you want to export Spot Trade History of Year 2022. You will need to export two times by manually filter the export range from Jan to June, and July to December.
How to get trade history from Bybit
2.Period for which history can be obtained via API
Due to the specifications of the exchange's API, it is unclear from what point in time the transaction history can be obtained. We understand that the period retrievable in cryptact is as follows:
-
Spot history
- Classic/Standard accounts: past 180 days
- Unified trading accounts (UTA): past 2 years *It is unclear how long the history can be obtained if you upgrade from a standard account to a unified trading account.
- Convert: past about 4 months
*For past history that cannot be obtained via API, please download the transaction history file and upload it. For transaction types that cannot be automatically handled by both API and file, please list them yourself in a custom file and upload.
3.History support status by trade type
*1 The funding fee for derivative transactions is reflected at position closure, reflecting the initial setup where realized gains and losses (closed P&L) included these fees. While future updates may consider alternative methods to retrieve funding fees, current integration with historical data complicates immediate changes. If discrepancies arise across fiscal years, users are advised to manually adjust the funding fee records.
*2 Regarding the purchase history with a credit card, the file only includes the number of coins purchased and does not capture the price of the transaction. Therefore, we adopt a specification that recognizes the purchase at the price rate of the cryptocurrency on Cryptact at the time of the transaction.
*3 We understand Bybit's margin trading as a derivative product based on spot trading. Therefore, since the borrowing history is not distributed via the API, please upload the history of borrowings/repayments using a custom file.
*4 The "Dual Asset Settlement" in the funding account file is not documented in a manner that allows third parties to identify it, so even if the file is uploaded, it will not be reflected in cryptact.
Additionally, regarding the history of the funding account "Launchpad," it is understood that the history includes participation in Launchpad and refunds for unsuccessful lottery entries. For calculations, information on which and how many coins were received through participation in Launchpad is necessary. However, since third parties cannot obtain the required information via files, we are currently unable to accommodate this. Please upload the necessary information separately via a custom file.
*5 We have confirmed that conversion history will be written in funding account file. If you converted in funding account, please upload funding account file. If not, please create a custom file to upload.
Also, we have confirmed the conversion history in the funding account file regarding the rebranding and token conversion from BIT to MNT. (For more details about the rebranding and token conversion from BIT to MNT, please refer to this external site.) As for this history, cryptact handles it as a 1:1 swap (SELL/BUY at market value) via both API and file.
*6 We support the affiliate reward history as listed in the file downloaded from the Bybit affiliate account. (How to download the history from Bybit Affiliates)
The transaction type "Commission (Affiliate)" listed in the funding account history file is not reflected to avoid double counting. Please upload the affiliate rewards using the account balance file.
*7 In API integration, the convert history for "Funding", "Unified Trading", and "Inverse Derivatives" is reflected. However, for files, only the convert history for "Funding" is supported. Additionally, because the funding history file includes transactions other than convert history, the system cannot link the funding history file with the API connection's convert history. Therefore, if you upload the convert history via file and then perform an API connection, double counting of the "Funding" history will occur. If you switch to using the API, please delete the duplicate history. If you do not use the Bybit convert history API endpoint, please continue to upload via file.
*8 We have categorized it as 'To confirm' for the "P2P Sale" because the file does not specify the price or which fiat currency was used for the acquisition. Please verify this on your own and enter the correct information.
Transaction types that are currently not automatically supported by both the API and the file
・Please upload a custom file.
・As soon as we receive sufficient samples (transaction history files) from customers, we will automatically respond. If you have a file, please send it to us via the "Support" button.
・API will be supported in due course, depending on the delivery status on the exchange side.
【Related Articles】
How to get trade history from Bybit
How to get an API key for Bybit
How to get trade history from Bybit Affiliates