CoinLedger only needs Read-Only or View access to import your trade history. This permission does not give access to your private keys nor the ability to move your funds. Learn more about API access in this article here.

Jump ahead with this table of contents:

Step 1:

Log into your Bybit account.

Step 2:

Click on your profile on the menu in the upper right corner and then on API.

Step 3:

Under API Management click the Create New Key button. Be sure to also select the correct Key Type, which is System-Generated API Keys.

​

Step 4:

Keep the API Transaction option selected. Give your key some name, select Read-Only under API Key Permissions and then select No IP restriction.

NOTE: you should copy these permissions exactly as shown in the screenshots below. This ensures that read-only permissions are given to CoinLedger.

Next, under Trade select Standard Account, and under Spot select NFT products and transaction history. Finally, select Assets, and then hit Submit.

Step 5:

After clicking the Submit button, you need to enter your 2FA code and click Confirm to create the keys. If everything is correct, the window shown below should pop up.

The API Secret is accessible only while this window is available. Please store your API Secret somewhere safe to have access to it.

Copy all of the following keys and continue on to CoinLedger.

Step 6:

Navigate to Step 1. Import. Select Add Account then choose the Bybit tab on CoinLedger. Click on Auto-Import then enter your API Key and API Secret into the correct fields. Click Sync Transactions.

When importing your transaction history via API, you will have the option to specify a start date for your import. This feature is designed to prevent duplicate data from being imported. You can access this feature by hitting the Import Settings drop down menu, as shown below, and then specifying a date for your import to start from. All transactions after this date will be imported. You should not do this if you are importing all of your transactions into CoinLedger for the first time.

CoinLedger currently does not support derivatives trading. If you've participated in derivatives trades on Bybit, these types of transactions may fail to import.

Additionally, if you have subaccounts, create an API key for each of those accounts and import them into CoinLedger one by one. The API keys created will automatically expire after 3 months. You will need to create new API keys after this period to sync new transactions.