Connect Kraken

Kraken connects to Viktury in one of two ways. A read-only API key keeps the account up to date by itself. If you would rather not create a key, you can upload your ledger export from Kraken instead.

The key lets Viktury read your balances, trades and ledger. It cannot trade and it cannot withdraw, because you only tick the permissions that read.

Create the key

1. Sign in at kraken.com and open Settings, then API.

2. Under "Spot trading API", choose "Create API key". The "Futures trading API" section on the same page makes a separate key, covered below. You only need it if you trade futures.

   

3. Tick these three permissions and nothing else:

   • "Query" under "Funds permissions", so we can read your balances.
   • "Query closed orders & trades" under "Orders and trades", so we can check each trade against Kraken's own trade list.
   • "Query ledger entries" under "Data", so we can read your trades, deposits, withdrawals and rewards.

4. Leave every other box off: Deposit, Withdraw, Add withdrawal addresses, Earn, Query open orders & trades, Create & modify orders, Cancel & close orders, Query affiliate participants and Export data. None of them is needed to read your history, and some of them would let the key move money.

5. Leave all the toggles off. "Query start date" and "Query end date" matter most: either one hides part of your history from the key, and your balances would come out wrong. "IP address restriction" and "Key expiration" stay off too.

   

6. Create the key. Kraken shows the Private Key only once, so copy the API Key and the Private Key before you close the page.

7. In Viktury, open Add account, choose Kraken and paste both keys.

When you add the key, Viktury checks with Kraken that it has all three permissions. If one is missing, the form tells you which box to tick, and nothing is saved until the key passes. A key that can place orders or withdraw is refused.

Add your Futures key (optional)

If you trade Kraken Futures, add a Futures key as well. It is a separate key from your Spot key, and an account can hold a Spot key, a Futures key, or both. If you only trade futures, you can leave the Spot key out.

1. On the same Settings, API page at kraken.com, open "Futures trading API" and choose "Create API key".

2. Set "General API" to "Read only" and "Withdrawal API" to "No access", and leave "IP address restriction" off.

   

3. Generate the key and copy both parts before you close the page.

4. In Viktury, paste them into the "Kraken Futures (optional)" section of Add account, as the Kraken Futures Public Key and Private Key. To add a Futures key to an account you already have, edit the account and paste them there.

Both parts of the Futures key are needed, so leave both empty or fill in both. The Futures key has to come from the same Kraken login as your Spot key, or Viktury refuses it. To stop syncing futures later, edit the account and choose "Remove Futures key". Your futures history stays, but it stops updating.

Or upload your ledger export

1. Sign in at pro.kraken.com and open the Statements page at pro.kraken.com/app/statements.

2. Click "Export statement" and choose "Ledger". Leave "Spot" selected.

3. Set "Start and end date" to start from your first month on Kraken. The form opens on the last month only, and a shorter range leaves your older history and balances out.

4. Leave "Transaction types", "Assets" and "Fields" on "All", and set "Format" to "CSV".

   

5. Click "Export". When the file is ready it appears under "On-demand statements". Download it and unzip it.

6. In Viktury, open Add account, choose Kraken, open the "Upload CSV" tab and upload the .csv file from the download as Kraken gave it to you. Kraken names it after the dates you chose, for example kraken-spot-ledgers-2024-03-01-2026-10-23.csv.

Only the ledger export is needed. It holds your trades, deposits, withdrawals and rewards. The trades export from the same form is not read.

A file is a snapshot, so to bring the account up to date later, export the ledger again and upload it to the same account. Rows already imported are skipped, so overlapping files do no harm. You can also add an API key to an account you started with a file, and the other way round: both carry Kraken's own id for each row, so nothing is counted twice.

What we import

• Spot trades, with the fee you actually paid.
• Crypto and bank deposits and withdrawals.
• Staking and Earn rewards, as income.
• Moves between your spot wallet and your derivatives wallet.

With a Futures key you also get:

• Perpetual and fixed-date futures round trips, with fees, funding and realized profit and loss.
• Your futures collateral balances.
• Moves between your Spot and Futures wallets, shown as one internal move instead of a deposit and a withdrawal. This needs both keys on the same account. With only a Futures key, those moves show as deposits and withdrawals.

Kraken's Unified Wallet works too. If your account has been switched to it, add both keys: Kraken reports the whole wallet on the Spot side and on the Futures side, and Viktury counts it once.

With a key, the first sync reads your whole history, and after that the account syncs once a day.

What is not supported yet

Inverse (coin-margined) futures are booked as cash movements only, with no round trips, and Kraken is delisting them on 30 October 2026. A Futures key from a different Kraken login than your Spot key is refused.

Margin trades, NFT activity and custody transfers are not imported. If your history has any of them, the account card or the upload says how many rows were left out. A trade we cannot match to Kraken's own trade list is left out too, and counted. A file has no trade list to check against, so from a file Viktury reads a trade only when one side is a currency or a dollar stablecoin, such as BTC for USD or ETH for USDC. A trade between two coins, such as ETH for BTC, is left out of a file import and counted, and adding a read-only key to the account brings it in. Viktury leaves these out rather than guess at them.

Troubleshooting

• The key is refused. If the form names a box, tick it for the key on Kraken and try again. Otherwise check that you copied both the API Key and the Private Key in full.
• Older history is missing. Open the key on Kraken and check that "Query start date" and "Query end date" are off. If either is on, create a new key with both off. With a file, export the ledger again starting from your first month on Kraken.
• The file is refused as the trades export. Kraken's form offers Ledger and Trades. Export Ledger and upload that file instead.