This page explains how to get trade history from Bybit.
【For those who have completed the file download.】
When uploading the downloaded files to cryptact, please upload them in order from the oldest transaction date. For more details, please refer to the help page below.
2．How to get files from Standard Account
2-2．Derivatives Closed P&L (USDT Perpetual, Inverse Perpetual and Inverse Futures)
2-3．Funding Account History (ex. ByFi)
3．How to get files from Unified Trading Account (UTA)
3‐2．Derivatives Closed P&L (USDT Perpetual)
3‐3．Derivatives Closed P&L (USDT Option)
3‐4．Derivatives Closed P&L (Inverse Perpetual and Inverse Futures)
3‐5．Derivatives Closed P&L (USDC Perpetual)
3‐6．Derivatives Closed P&L (USDC Options)
4．History before upgrading to Unified Trading Account (UTA)
4-1．Pre-upgrade Spot Trade History
4-2．Pre-upgrade Derivatives Closed P&L
4-3．Pre-upgrade USDC-Options Trade Cashflow
6．Calculation Methods for Derivative Transactions
1. Important Notes
1-1. Trade types that can be obtained by API and exchange file.
- Please be sure to check this article for more details about our support for Bybit.
- "To confirm" transactions・・"To confirm transactions" lack sufficient details in the file to identify the transaction specifics. Refer this article for guidance on handling such transactions.
- When downloading the funding history, files downloaded with any option other than "Funding" checked in the account change details are not supported. Click here for instructions on how to download the funding history.
- When downloading the copy trade history, files downloaded with any option other than "Copy Trade" checked in the account change details are not supported. Click here for instructions on how to download the copy trade history.
1-2. Export
- 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.
2. How to get the files from Standard Account
2-1．Spot Trade History
1. After logging in, click "Orders" from the menu bar and click "Spot Order"
2． Under Spot Account, select "Trade History", then click "Export".
*Please note that the "Order History" file is not supported by cryptact, so please make sure you have selected "Trade History".
3. Select the date range and click "Export Now". When the file is ready, you can download it by clicking "Download" in "My Exports" section.
* Please download all trade history. If they are divided into multiple files, please upload all files in the order of the oldest period to the newest.
File Upload Box
2-2．Derivatives Closed P&L (USDT Perpetual, Inverse Perpetual and Inverse Futures)
1．After logging into Bybit, click on "Orders" → "Derivatives Order".
2．Under "Derivatives", click on "Closed P&L" → "Export".
* The exported file will contain "Inverse Perpetual", "USDT Perpetual", and "Inverse Futures".
3．Select the date range, then click "Export Now". Once the file is ready for download, in the "My Exports" section, the "Download" button becomes active.
* Please download all trade history. If they are divided into multiple files, please upload all files in the order of the oldest period to the newest.
File Upload Box
When downloading using the above method, we understand that a single file will contain transaction histories for "Inverse Futures," "Inverse Perpetual," and "USDT Perpetual."
Please upload the file to the appropriate upload box based on the transaction history you have.
*If you have all three types of transaction histories ("Inverse Perpetual," "Inverse Futures," and "USDT Perpetual"), please upload the same file to both of the upload boxes below. Due to cryptact's specifications, the "Inverse Perpetual and Inverse Future Closed P&L" upload box will only read the transaction histories for "Inverse Perpetual" and "Inverse Futures," so there will be no duplication of records. (The same applies to "USDT Perpetual.")
2-3．Funding Account History (ex. ByFi)
1． After logging in, click "Assets" from the menu bar and click "Funding Account".
2．In "Funding" tab click on "History".
3．Click on "Export"
4．Select only "Funding" and select the date range then click on "Export" .
5．Click on "Download".
(It takes some time until the data is ready.)
Please note:
The download file is a zipped file.
Please unzip it before uploading it to cryptact.
Reference for Windows users
Please install 7-Zip, and follow the below steps to unzip the file.
「7-Zip」https://sevenzip.osdn.jp/download.html
1) Right-click the file you want to unzip, and select "7-Zip" from the menu.
2) When the 7-ZIP menu appears, click "Extract files…" option.
3) Check which folder the unzipped file will be placed. If you want to the unzipped file to be placed in a different folder, click the "" button beside the "Extract to" field.
4) Click "OK".
File Upload Box
2-4．Copy Trading History
1． After logging in, click "Assets" from the menu bar and click "Funding Account".
2．In "Funding" tab click on "History".
3．Click on "Export"
4．Select "Copy Trading" and select the date range then click on "Export" .
5．Click on "Download".
(It takes some time until the data is ready.)
Please note:
The download file is a zipped file.
Please unzip it before uploading it to cryptact.
Reference for Windows users
Please install 7-Zip, and follow the below steps to unzip the file.
「7-Zip」https://sevenzip.osdn.jp/download.html
1) Right-click the file you want to unzip, and select "7-Zip" from the menu.
2) When the 7-ZIP menu appears, click "Extract files…" option.
3) Check which folder the unzipped file will be placed. If you want to the unzipped file to be placed in a different folder, click the "" button beside the "Extract to" field.
4) Click "OK".
File Upload Box
3. How to get files from Unified Trading Account (UTA)
3‐1．Spot Trade History
1. Click the "Unified Trading Order" under the "Order" tab in the top right of the screen.
2． Click on "Spot Orders" under Unified Trading Account, select "Trade History*", then click "Export".
*Be sure to select "Trade History". The "Order History" file is not supported.
3. Select the date range and click "Export Now". When the file is ready, you can download it by clicking "Download" in "My Exports" section.
* Please download all trade history. If they are divided into multiple files, please upload all files in the order of the oldest period to the newest.
File Upload Box
3‐2．Derivatives Closed P&L (USDT Perpetual)
1. Click the "Unified Trading Order" under the "Order" tab in the top right of the screen.
2．Click on "USDT Perpetual" under Unified Trading Account, select "Closed P&L*", then click "Export".
*Be sure to select "Closed P&L".
3. Select the date range and click "Export Now". When the file is ready, you can download it by clicking "Download" in "My Exports" section.
File Upload Box
As of February 6, 2025, we have confirmed that when downloading the "USDT Perpetual" file, it also includes transaction histories for "Inverse Futures" and "Inverse Perpetual."
However, the "USDT Perpetual Realized P&L" upload box is designed to read only "USDT Perpetual" transaction histories. Therefore, if you have transaction histories for "Inverse Futures" or "Inverse Perpetual," please upload either the "USDT Perpetual" file or the file downloaded using the "Derivatives Closed P&L (Inverse Perpetual and Inverse Futures)" download method to the "Inverse Perpetual and Inverse Futures Closed P&L" upload box.
3‐3．Derivatives Closed P&L (USDT Options)
1．After logging in, click on the 'Unified Trading Order' under the 'Order' tab at the top right of the screen.
2．Click on "USDT Options" in Unified Trading Acount tab,choose "Trade Cashflow" and click on "Export".
3. Select the date range and click "Export Now". When the file is ready, you can download it by clicking "Download" in "My Exports" section.
File Upload Box
3‐4．Derivatives Closed P&L (Inverse Perpetual and Inverse Futures)
・In the case of an Inverse Perpetual
1．After logging in, click on the 'Unified Trading Order' under the 'Order' tab at the top right of the screen.
2．Click on 'Inverse Perpetual' → 'Closed P&L (*)' → 'Export'.
*Be sure to select "Closed P&L".
3. Specify the date and click "Download Now." Once the download is ready, the "Download" button will become active, so click it.
*Please ensure to download the file for the entire period. If the files are split into multiple parts, please upload them in order starting with the oldest date.
File Upload Box
・In the case of an Inverse Futures
1．After logging in, click on the 'Unified Trading Order' under the 'Order' tab at the top right of the screen.
2．Click on 'Inverse Futures' → 'Closed P&L (*)' → 'Export'.
*Be sure to select "Closed P&L".
3. Specify the date and click "Download Now." Once the download is ready, the "Download" button will become active, so click it.
*Please ensure to download the file for the entire period. If the files are split into multiple parts, please upload them in order starting with the oldest date.
File Upload Box
3‐5．Derivatives Closed P&L (USDC Perpetual)
1．After logging in, click on the 'Unified Trading Order' under the 'Order' tab at the top right of the screen.
2．Click on "USDC Perpetual" in Unified Trading Account tab, choose "P&L History" and click on "Export".
3. Select the date range and click "Export Now". When the file is ready, you can download it by clicking "Download" in "My Exports" section.
File Upload Box
3‐6．Derivatives Closed P&L (USDC Options)
1．After logging in, click on the 'Unified Trading Order' under the 'Order' tab at the top right of the screen.
2．Click on "USDC Options" in Unified Trading Acount tab,choose "Trade Cashflow" and click on "Export".
3. Select the date range and click "Export Now". When the file is ready, you can download it by clicking "Download" in "My Exports" section.
File Upload Box
3-7．Funding Account History (ex. ByFi)
1． After logging in, click "Assets" from the menu bar and click "Funding Account".
2．In "Funding" tab click on "History".
3．Click on "Export"
4．Select "Funding" and select the date range then click on "Export" .
5．Click on "Download".
(It takes some time until the data is ready.)
Please note:
The download file is a zipped file.
Please unzip it before uploading it to cryptact.
Reference for Windows users
Please install 7-Zip, and follow the below steps to unzip the file.
「7-Zip」https://sevenzip.osdn.jp/download.html
1) Right-click the file you want to unzip, and select "7-Zip" from the menu.
2) When the 7-ZIP menu appears, click "Extract files…" option.
3) Check which folder the unzipped file will be placed. If you want to the unzipped file to be placed in a different folder, click the "" button beside the "Extract to" field.
4) Click "OK".
File Upload Box
3-8．Copy Trading History
1． After logging in, click "Assets" from the menu bar and click "Funding Account".
2．In "Funding" tab click on "History".
3．Click on "Export"
4．Select only "Copy Trading" and select the date range then click on "Export" .
5．Click on "Download".
(It takes some time until the data is ready.)
Please note:
The download file is a zipped file.
Please unzip it before uploading it to cryptact.
Reference for Windows users
Please install 7-Zip, and follow the below steps to unzip the file.
「7-Zip」https://sevenzip.osdn.jp/download.html
1) Right-click the file you want to unzip, and select "7-Zip" from the menu.
2) When the 7-ZIP menu appears, click "Extract files…" option.
3) Check which folder the unzipped file will be placed. If you want to the unzipped file to be placed in a different folder, click the "" button beside the "Extract to" field.
4) Click "OK".
File Upload Box
4. History before upgrading to Unified Trading Account (UTA)
4-1．Pre-upgrade Spot Trade History
1. From menu bar, click Orders and choose Unified Trading Order.
2. Select Spot (Pre-UTA) in Unified Trading Acount tab, choose Trade History and click Export.
3. Select the date range and click "Export Now". When the file is ready, you can download it by clicking "Download" in "My Exports" section.
File Upload Box
4-2．Pre-upgrade Derivatives Closed P&L *not supported
*Due to the content being identical to the file introduced in 2-2, this file is not supported to avoid double counting. If you were previously unable to download the file introduced in 2-2, please download it using method 4-2, then manually enter the data into a custom file and upload it.
4-3．Pre-upgrade USDC-Options Trade Cashflow
1. From menu bar, click Orders and choose Unified Trading Order.
2. Select USDC Options(Pre-UTA) in Unified Trading Acount tab , choose Trade Cashflow and click Export.
3.Select the date range and click "Export Now". When the file is ready, you can download it by clicking "Download" in "My Exports" section.
File Upload Box
5. Bybit Affiliates
Please refer to the link below for how to download the file.
How to get trade history from Bybit Affiliates
6. Calculation Methods for Derivative Transactions
- P&L Calculation for Derivatives: profit and loss calculations are based on the contract’s collateral. If the collateral has increased at the time of settlement it is considered a profit, and if decreased it is considered a loss. Although profit and loss calculation itself is possible, cryptact is not able to display the detail of the transaction that generated the P&L (e.g. profit generated by ETH leveraged transactions). Please check the trade history from the exchange separately.
- The funding fees for derivatives trades get reflected when the positions are closed.
7. Regarding the Old File Format of Inverse Contract History
With the update on July 11, 2024, support for the old file formats of "Bybit/Inverse Perpetual Contract" and "Bybit/Inverse Futures Contract" has been discontinued. We understand that the old file format can no longer be downloaded from the exchange interface. Customers who have the old file format should manually enter the history into a custom file and upload it.
▼ The following two boxes have been discontinued as of July 11, 2024.
▼ Headers of the old file format *Currently not supported.
Contracts, Closing Direction, Qty, Entry Price, Exit Price, Closed P&L, Exit Type, Trade Time (UTC+0)
8. How to Upload Bybit Files to cryptact
After downloading the trade history, please upload it via the upload screen.
Related Help Pages:
- How to get an API key for Bybit
- Support Status for Bybit (updated as needed)
- How to get trade history from Bybit Affiliates