This page explains how to get trade history from Bybit.
Contents
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 (Inverse Perpetual and Inverse Futures)
3‐4．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
7．Regarding the Old File Format of Inverse Contract History
8．How to upload Bybit files to cryptact
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.
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
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. After logging in, click "Orders" from the menu bar and click "Unified Trading Order".
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． After logging in, click "Orders" from the menu bar and click "Unified Trading Order".
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
3‐3．Derivatives Closed P&L (Inverse Perpetual and Inverse Futures)
1． After logging in, click "Orders" from the menu bar and click "Inverse Derivatives Order".
2．Click on "Closed P&L" under Inverse Derivatives 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.
*Although there is an on-screen notice that "*Exported data includes historical records of USDT perpetual , Inverse perpetual and Inverse Futures." the file we downloaded as of 11/1/2023 did not include historical records for USDT indefinite contracts.
File Upload Box
3‐4．Derivatives Closed P&L (USDC Options)
1． After logging in, click "Orders" from the menu bar and click "Unified Trading Order".
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-5．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-6．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 range and click Export Now.
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.
1. From menu bar, click Orders and choose Unified Trading Order.
2. Select USDTPerpetuals(Pre-UTA) in Unified Trading Acount tab, choose Closed P&L and click Export.
3. Select the range and click Export Now.
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 range and click Export Now.
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