--- url: /usage-guides/integrations/exchange-keys.md description: >- Connect centralized exchanges to rotki using read-only API keys, with step-by-step setup instructions and exchange-specific notes for each platform. --- # Exchange API Keys This page covers connecting centralized exchanges to rotki via read-only API keys. Go to the `API Keys` menu in the sidebar, then **Exchanges**. ## Exchanges API Keys ![List of connected exchanges](/images/usage-guides/integrations/exchange-keys/add_exchange_2.webp) You can integrate many different exchanges with rotki via API Keys. Currently supported exchanges are: * Kraken (Spot and Future) * Poloniex * Binance * Bitmex * Coinbase * Coinbase Prime * Gemini * Bitstamp * Binance US * Bitfinex * Bitcoin.de * Iconomi * KuCoin * Independent Reserve * Bitpanda * OKX * Woo * Bybit * HTX * Gate (Global, Europe, and US) * Bit2Me * CoinEx * Crypto.com (experimental) ![Add API keys for a new exchange](/images/_shared/add_exchange_1.webp) ### Steps to Add Exchange API Key: 1. Create API key on your exchange (see [API key permissions](#api-key-permissions)) 2. Navigate to `API Keys > Exchanges` in the left sidebar 3. Click button `Add an exchange` to open addition menu 4. Enter your: * API Key * API Secret (for the majority of exchanges) * Password (for some exchanges) 5. Click `Save` ### After Adding: * Successful addition: Exchange will appear in your list * If failed: * Verify key and secret are correct * Some exchanges may have issues due to timestamp difference between the computer and the server (e.g. binance, read [this](https://github.com/tiagosiebler/awesome-crypto-examples/wiki/Timestamp-for-this-request-is-outside-of-the-recvWindow)) ### Sync Settings: * Option to enable/disable exchange synchronization * Consider disabling to avoid IP bans from frequent syncs > **Note**: At the moment, [margin trades](https://github.com/rotki/rotki/issues/1980) and [future trades](https://github.com/rotki/rotki/issues/1606) are not yet supported in rotki. ### API key permissions rotki only needs read-only permissions for your accounts. As a general rule, exchanges (e.g., Binance) group all the read-only permissions as "read" or "view". ![Simple API key permissions](/images/usage-guides/integrations/exchange-keys/add_api_keys_binance.webp) In the case of an exchange providing a more granular permissions scheme (e.g., Coinbase, Kraken) or having additional options (e.g., query limits, passphrase), refer to the exchange documentation or get in touch via their customer support channel. ![Granular API key permissions](/images/usage-guides/integrations/exchange-keys/add_api_keys_coinbase.webp) You may also try creating an API key with the minimum read-related permissions, then adding it in rotki and finally checking that the connection was successful and data was loaded as expected. Otherwise, try again adding more read-related permissions. #### Kraken When inputting the API key for Kraken, you need to specify the type of your Kraken account, which depends on your Kraken account verification level. Refer to [this](https://support.kraken.com/hc/en-us/articles/360001395743-Verification-levels-explained) for more information. ![Kraken account type](/images/usage-guides/integrations/exchange-keys/add_kraken.webp) To track your Kraken Futures balances, you can optionally provide your Futures API key and Futures API secret in the same Kraken exchange form. Both fields must be provided together. When set, rotki will query your Kraken Futures cash, margin, and flex balances and merge them into your overall Kraken balance total. #### Binance / Binance US To improve the speed of querying trade information using the Binance API, you can specify which market pairs to query instead of querying all possible pairs. This reduces the number of requests made to Binance servers, avoiding potential rate limits and failures. To select specific markets, edit your Binance exchange instance configuration. ![Edit Binance in the exchanges section](/images/usage-guides/integrations/exchange-keys/edit_binance.webp) ##### Market Pairs (required) Choose the markets in the `Filter market pair(s)` search. ::: warning **Due to Binance API limitations**, querying trade information does not work without specifying market pairs. Binance's endpoint requires every possible market pair to be queried individually, and their rate limits make it impossible to query all markets for your entire history. This API issue has existed for years and has not been fixed by Binance. You must select which specific markets you want to query for the integration to work properly. ::: ![Binance markets selection](/images/usage-guides/integrations/exchange-keys/binance_markets_selection.webp) Once finished, click on save. #### Coinbase Prime Coinbase Prime requires an API Key, API Secret, and a Passphrase. Make sure you provide all three when adding the exchange. #### OKX OKX requires an API Key, API Secret, and a Passphrase. When adding OKX, you also need to select your **region**: * **Global** — the default OKX platform. * **EEA** — for European Economic Area users. * **US** — for United States users. Make sure to select the region that matches the OKX platform you registered on, as the API endpoints differ between regions. #### Gate Gate requires an API Key and API Secret. When adding Gate, select the **region** that matches the platform where you created your API key: * **Global** — the default Gate platform. * **Europe** — Gate Europe. * **United States (US)** — Gate US. The selected region determines which Gate API endpoint rotki uses. #### Crypto.com Crypto.com is currently listed as an **experimental** exchange. It requires an API Key and API Secret. Since it is experimental, some functionality may be incomplete or subject to change.