Kraken API Keys

Connect your Kraken account to TraderBotz using the Kraken REST API. Your bots will be able to view market data, query balances, and execute spot trades on 300+ trading pairs.

Important: Your Private Key is a base64-encoded secret. Never share it with anyone. TraderBotz encrypts all credentials at rest with Fernet symmetric encryption.

Step 1: Open Kraken API Settings

Go to kraken.com/u/security/api and sign in with your Kraken account. This is the API management page where you create and manage your API key pairs.

Step 2: Create a New API Key

  1. 1 Click Create API Key (or Add key)
  2. 2 Give the key a description (e.g., "TraderBotz")

Step 3: Configure Permissions

Enable the following permissions for the API key:

  • Query Funds — Required for balance and portfolio queries
  • Query Open Orders & Trades — Required for order status and trade history
  • Query Closed Orders & Trades — Required for fill confirmation
  • Create & Modify Orders — Required for placing buy/sell orders
  • Cancel/Close Orders — Required for order management
  • Withdraw Funds — Not needed (leave unchecked)
  • Deposit Funds — Not needed (leave unchecked)

Tip: You can optionally restrict the API key to specific IP addresses for extra security. If you're using a self-hosted TraderBotz node, add your node's public IP.

Step 4: Save Your Keys

After creating the key, Kraken will show you two values:

API Key

A public key string that identifies your API key pair. Example format: Ab1C2d/Ef3G4h...

Private Key

A base64-encoded secret key used for signing API requests. This is your API Secret.

Save the Private Key immediately. Kraken only shows it once during creation. If you lose it, you'll need to create a new API key.

Step 5: Add to TraderBotz

  1. 1 In TraderBotz, go to Accounts in the sidebar
  2. 2 Click Add Account and select Kraken from the dropdown
  3. 3 Enter a name (e.g., "My Kraken")
  4. 4 Paste the API Key into the API Key field
  5. 5 Paste the Private Key into the Private Key field
  6. 6 Click Test Connection to verify everything works
  7. 7 Save the account — it's now available when creating bots

US Customers

Kraken is available to US customers in most states. Note that New York and Maine residents are not supported. A small number of tokens (e.g., XRP) may be restricted for US users due to regulatory requirements. The available trading pairs will be filtered automatically based on what Kraken offers for your account.

Troubleshooting

"EAPI:Invalid key" error on Test Connection

Double-check that you pasted the correct API Key (the public key, not the private key) and that the Private Key is the full base64-encoded string. Also verify the key hasn't been revoked in your Kraken settings.

"EGeneral:Permission denied" on trade

Verify that the Create & Modify Orders permission is enabled for your API key. Query-only keys can read balances and market data but cannot place orders.

"EAPI:Invalid nonce" errors

This can happen if your system clock is out of sync or if the same API key is used by multiple applications simultaneously. Each API key should only be used by one application at a time. You can also increase the nonce window in your Kraken API settings.