Connect Deribit

Create a read-only Deribit API key and connect it to Viktury so your trades sync automatically.

  • DeribitAutomatic read-only syncCSV import

Connecting Deribit lets Viktury sync your trades automatically. You only ever give it a read-only key, so it can see your trade history but can never trade or move funds.

Create a read-only API key on Deribit

  1. Sign in to Deribit, open your account settings from the person icon at the top right and pick API in the left menu. Click Add new key.

    Deribit account settings on the API page, with the ADD NEW KEY button
    Open your account settings and pick API in the left menu.

  2. Choose Deribit-generated key.

    Deribit Select API key type dialog with Deribit-generated key and Self-generated key
    Choose Deribit-generated key.

  3. Every scope starts at none. Set Account and Trade to read and leave the rest at none. Never set a scope to read_write. If you give the key a name, Deribit allows at most 16 characters, using only letters, numbers and underscores.

    Deribit Create a new API key form with Account and Trade set to read and every other scope set to none
    Set Account and Trade to read. Leave the rest at none.

  4. Create the key and confirm it. Copy the Client ID and the Client Secret from the key's row. Deribit hides the list until you click Show keys, and you can come back to it later.

    Deribit API Access list with the new key, its Client ID and Client Secret hidden
    Copy the Client ID and Client Secret from the key's row.

Add it to Viktury

On the Add account screen, choose Deribit, give the account a name, and paste the Client ID and Client Secret into the matching fields. Save, and Viktury runs its first sync to pull your history.

Viktury Add Exchange Account form with an exchange picked and the API key tab open
Pick your exchange. The steps for it appear right under the tabs.

Import from a CSV instead

  1. On Deribit, open your account settings and pick Transaction Log in the left menu.

  2. Pick the currency and the date range, then click Download Logs. The button turns on once the range has entries. Repeat for each currency you trade.

    Deribit Transaction Log with the currency picker, date range, Download Logs and Export
    Pick a currency and a date range, then click Download Logs. It turns on once the range has entries.

  3. On the Add account screen, choose Deribit, open the Upload CSV tab and select the file as it is.

    Viktury Add Exchange Account form on the Upload CSV tab, with the base currency and the file picker
    On the Upload CSV tab, pick your file and click Upload Trades.

Troubleshooting

  • Key rejected. Recheck that the Client ID and Client Secret are pasted with no stray spaces, and that the key is active on Deribit.
  • No trades showing yet. The first sync can take a moment. If your account is new or the date range is quiet, there may simply be nothing to pull yet.
  • Permissions error. If syncing fails on access, the key's read scopes are probably too narrow. Edit the key on Deribit so it can read your account and trade history. If you accidentally granted trade or withdrawal rights, remove them: Viktury never needs them.

What Viktury imports from Deribit →