Connect Deribit

Connect Deribit to Viktury in one click, or with a read-only API key, so your trades sync automatically.

  • DeribitAutomatic read-only syncCSV import

Connecting Deribit lets Viktury sync your trades automatically. Viktury only ever gets read access, so it can see your trade history but can never trade or move funds.

There are two ways to connect. Signing in through Deribit is the quickest and needs no key. An API key works too, if you would rather manage the access yourself.

Connect in one click

  1. On the Add account screen, choose Deribit. The Connect via Deribit tab is open first.

    Viktury Add Exchange Account form with Deribit picked and the Connect via Deribit tab open
    Pick Deribit. The Connect via Deribit tab is open first.
  2. Click Connect via Deribit. Deribit opens and asks you to sign in.

  3. Deribit shows what Viktury is asking for: read access to your account, wallet and trades. Nothing that can trade or withdraw. Approve it. Deribit may ask you to confirm with your 2FA code or passkey.

    Deribit Authorize application screen for Viktury asking for read access to trade, account and wallet, with Deny and Approve
    Deribit lists exactly what Viktury can see: trade, account and wallet, read only.
  4. You come back to Viktury. Tick the Deribit accounts you want to track and click Add. Each one becomes its own account in your journal, and Viktury runs its first sync to pull your history.

    Viktury account picker after connecting Deribit, with one Deribit account ticked and an Add 1 account button
    Tick the accounts you want to track, then click Add.

You can disconnect any time from the account's card on the Accounts page.

Or 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, open the API key tab, 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

  • Your account says it needs you to reconnect. Deribit stopped accepting Viktury's access, for example because it was revoked on Deribit. Click Reconnect on the account's card and approve again. Your trades and notes stay where they are.

    A Deribit account card in Viktury marked disconnected, with the Reconnect button highlighted
    A disconnected account shows Reconnect on its card.
  • The connection did not finish. If you see a message after coming back from Deribit, start again from the Add account screen. If it keeps failing, use an API key instead.

  • 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.