Exchange & API Keys setup



Security


Your funds are stored safely on your exchange account, BitSpreader just executes orders on your behalf on the exchange using the API key that you have provided.

BitSpreader never does any transfers of your funds.

For further increase of security we strongly encourage you to not provide any API keys that have privilege to execute transfers - please refer to your exchange API key settings to make sure to reduce the API key privileges just to the most necessary (balance, history, trading).

Your data is encrypted

Your API keys are encrypted and available only in the internal layer of the BitSpreader services safely hidden behind the firewalls and not accessible from the website.

For managing your API keys we follow write-only pattern - once you have provided your API key, the BitSpreader has stored it internally for the trading purposes and doesn't expose it even to you for editing. If you need to update the API key - you need to delete the old key and provide the updated one.


Adding new API Key


In order to access the API Key management panel, click on the “API Keys” option in the sliding sidebar on the left side of the screen. Users can define any number of API keys with following limitations:
  • There can be only one API key for given exchange
  • After adding an API Key, the user cannot see it and cannot update it - the only action that can be performed is deleting the API key. In case the user made a mistake when entering the api key, user needs to delete invalid api key and add the correct one again
Registration#1

Click “Add API Key” button, select an exchange to which you don’t have any API key yet, provide API key and secret key. Some exchanges may require you to provide additional parameter i.e. passphrase - please provide it in the last box.
Registration#1


API Key Permissions


When creating a new API Key on the exchange please make sure that the API Key has following permissions:
  • Access to balances/wallet information
  • Trading on futures
  • Accessing transaction list


API Key status


After entering the API Keys management panel you see the list of exchanges to which you have active API keys along with the status of the API key. The key can have INVALID status in case:
  • Key data was invalid
  • Key has expired and is no longer accepted by the exchange
  • The exchange returned and API key error during the initialization
Registration#1


Removing API Key


After clicking an API Key on the list, you can see the first three characters of the api key (to enable the user to identify the key in case there is more than one on a given exchange) and an option to delete this key from BitSpreader.


Exchange specific requirements


Binance

API KEY setup

Binance has two separate APIs for futures - one for coin-margined (COIN-M) futures and another one for usds-margined (USD-M) futures. You will need to define two separate API key definitions in BitSpreader if you want to trade on both types - select proper exchange name on the exchange list when defining API Key:
  • Binance USD-M futures - for USD margined
  • Binance COIN-M Futures - for coin margined
On the Binance side you only need to define the key once and you can use the same key value and secret for both API key definitions in BitSpreader

API KEY permissions

Before creating the API key, disable the Default Security Controls. option. This will allow to enable trading on futures without providing multiple IP addresses of servers used by BitSpreader.

Disable Default Security Controls


After creating the API key, make sure to click "Edit permissions" button and update the API key permissions - you need to check the option "Enable Futures" and don't remember to click Save.

Setup Binance Futures API Key


Load funds into Binance futures trading wallet

Binance has separate wallets for each type of trading account. For futures trading it has two separate wallets for COIN-M futures and for USD-M futures.

Coin margined (COIN-M) futures use base currency of the instrument as the currency in which margin is controlled. Before you trade with these futures, make sure you transfer some BTC to your COIN-M wallet.
In the top bar select Wallet

Setup Binance Futures API Key - top bar


You are in the Wallet overview, click Transfer

Setup Binance Futures API Key - wallet


Select the source wallet, target wallet, set currency to BTC, choose amount and click Transfer

Setup Binance Futures API Key - transfer to coinm


USD(S) margined (USDS-M) futures use base stable coin - either USDT or BUSD as the currency in which margin is controlled. Before you trade with these futures, make sure you transfer some USDT or BUSD to your USD-M wallet. If you want to trade on BTC-USDT contracts - load USDT, for BTC-BUSD contracts - load BUSD

For USD-M when transfering the funds select the source wallet, target wallet, set currency to USDT/BUSD, choose amount and click Transfer

Setup Binance Futures API Key - transfer to usdm


Position mode

Binance supports two position modes: One-way and Hedge. Currently BitSpreader supports only One-way meaning a symbol only supports holding a position in one direction. In case Hedge mode is set in Binance preferences BitSpreader will not be able to open and close positions. Please ensure that Position Mode is set to One-way

Setup Position Mode


How much funds do I need in the futures wallet

As the default leverage for Binance is 20, that means that if we want to open position with size X, we need to provide equity on our account called margin equal to X/20. To start spread trade with size of 1000 dollars, we need to provide the equity worth 100 dollars on our trading account as a margin for a spread trade, 50 dollars for each of the legs of the spread trade.

Setting the default leverage on Binance

Binance manages the leverage per each individual instrument.

  • Minimum leverage: 1x
  • Maximum leverage: 50x
  • Default leverage: 20x


In order to change the default leverage for currently selected instrument click on the "20x" (or current leverage value) in the top right corner of the Binance trading platform:
Setup Binance Leverage
And then change the leverage to the preferred value:
Setup Binance Leverage


Important

  • BitSpreader currently doesn't support the margin control - if you don't have enough funds on your account available, exchange will return errors

Bitmex


API KEY permissions

To create API Key on Bitmex exchange please visit "API Keys".
When creating the API key please make sure Key Permissions are set to "Order".

Setup Bitmex API Key


When API Key is created you will be presented with "ID" and "Secret" values:

Setup Bitmex API Key


Please use "ID" as "API KEY" and "Secret" as "SECRET KEY" when adding Api Key to BitSpreader.

How much funds do I need in the futures wallet

As the default leverage for Bitmex is 100, that means that if we want to open position with size X, we need to provide equity on our account called margin equal to X/100. To start spread trade with size of 1000 dollars, we need to provide the equity worth 20 dollars on our trading account as a margin for a spread trade, 10 dollars for each of the legs of the spread trade.

Isolated and Cross Margin

Please note that by default Bitmex uses Cross Margin meaning that margin is shared between open positions with the same settlement cryptocurrency. Alternatively one can use Isolated Margin which means that liability is limited to the initial margin set at order creation. For more details please visit bitmex support page "Isolated and Cross Margin".

Setting the default leverage on Bitmex

Bitmex manages the leverage per each individual instrument.

  • Minimum leverage: 1x
  • Maximum leverage: 100x with Cross Margin
  • Default leverage: 100x with Cross Margin


To change the default leverage for an instrument select it on Bitmex web interface and using slider under "Your position" choose either cross margin or isolated leverage between 1-100x. trading platform:
Setup Bitmex Leverage


Important

  • BitSpreader currently doesn't support the margin control - if you don't have enough funds on your account available, exchange will return errors

Deribit


API KEY permissions

After creating the API key, make sure to set proper permissions on the API Key:

  • Account: read
  • Wallet: read
  • Trade: read_write


Setup Deribit API Key


Load funds into Deribit futures trading wallet

You need to make sure that you have funds in the currency that is suitable as a margin for selected type of futures. Majority of the futures on Deribit are coin margined - that means that you need to provide the equity in your wallet in the base currency (ie BTC) of the contracts as the margin. In case you wanted to trade on BTC-USDC perpetual, you need to provide a margin in USDC.

How much funds do I need in the futures wallet

As the default leverage for Deribit is 50, that means that if we want to open position with size X, we need to provide equity on our account called margin equal to X/50. To start spread trade with size of 1000 dollars, we need to provide the equity worth 40 dollars on our trading account as a margin for a spread trade, 20 dollars for each of the legs of the spread trade.

Setting the default leverage on Deribit

Deribit has fixed leverage 50x, there is no way user can change the leverage.



Important

  • BitSpreader currently doesn't support the margin control - if you don't have enough funds on your account available, exchange will return errors

Huobi


API KEY permissions

When creating the API key please make sure proper API Key permissions are set. You need following permissions on your API key

  • Read-only
  • Trade


Setup HUOBI API Key


Load funds into Huobi futures trading wallet

BitSpreader currently supports only coin-margined futures with delivery dates. Perpetuals are not supported. You need to fund your account with BTC.

How much funds do I need in the futures wallet

As the default leverage for Huobi is 5, that means that if we want to open position with size X, we need to provide equity on our account called margin equal to X/5. To start spread trade with size of 1000 dollars, we need to provide the equity worth 200 dollars on our trading account as a margin for a spread trade, 100 - dollars for each of the legs of the spread trade.

Setting the default leverage on Huobi

Huobi manages the leverage per each individual instrument.

  • Minimum leverage: 1x
  • Maximum leverage: 50x
  • Default leverage: 5x


In order to change the default leverage for currently selected instrument click on the "5x" (or current leverage value) in the top right corner of the Huobi trading platform:
Setup Binance Leverage
And then change the leverage to the preferred value:
Setup Binance Leverage


Important

  • BitSpreader currently doesn't support the margin control - if you don't have enough funds on your account available, exchange will return errors

Kraken


API KEY permissions

When creating the API key please make sure proper API Key permissions are set. You need following permissions on your API key

  • "Full access" permissions are required under "General API"
  • no access is required under "Withdrawal API"


Setup Kraken API Key


Load funds into Kraken futures single collateral trading wallet

BitSpreader currently supports only coin-margined futures traded using single-collateral wallet. You need to transfer your funds from Holding Wallet to Single Collateral wallet to trade.
To do so, open Single Collateral Wallets directly using link "futures.kraken.com/trade/wallets/single-collateral"or open "futures.kraken.com", open "Wallets" and select "Single Collateral Futures".
Transfer funds to Single Collateral wallet

On this screen you can use Transfer" option to transfer funds between Holding Wallets and Single Collateral Wallets.
Transfer funds to Single Collateral wallet


How much funds do I need in the futures wallet

Maximum leverage for Kraken Futures is 50. That means that if we want to open position with size X, we need to provide equity on our account called margin equal to X/50. To start spread trade with size of 1000 dollars, we need to provide the equity worth 40 dollars on our trading account as a margin for a spread trade, 20 - dollars for each of the legs of the spread trade.

Setting the default leverage on Kraken Futures

Kraken Futures does not allow for isolating a margin amount in your order or resulting position. All funds in your Single Collateral Wallet are at risk when you have orders and positions that are active. To reduce risk you can reduce funds kept in Single Collateral Wallet to only those meant to be used in trading or as collateral. Rest of funds can be kept safely on Funding Wallet.

KuCoin


API KEY permissions

When creating the API key please make sure proper API Key restrictions are set. You need following permissions on your API key

  • "General" permissions which is enabled by default
  • "Futures Trading" required in order to trade futures


Setup KuCoin API Key


Load funds into KuCoin futures account

BitSpreader supports both: coin-margined and usd-margined futures traded using single-collateral wallet. You need make transfer of your funds with two steps:
To do so, open Funding Account (or main account) and deposit assets.
Transfer funds to Funding Account

On Funding Account screen you can use "Deposit" option to transfer funds between Holding Wallets and Funding Account.
When transfer is done then you need to transfer funds from Funding Account to Futures Account. Go to Futures Account and use "Transfer" option to transfer funds from Funding Account to Futures Account.
Transfer funds to Futures Account

Transfer funds to Futures Account


How much funds do I need in the futures wallet

Maximum leverage on futures is 75. That means that if we want to open position with size X, we need to provide equity on our account called margin equal to X/75. To start spread trade with size of 1000 dollars, we need to provide the equity worth 28 dollars on our trading account as a margin for a spread trade, 14 - dollars for each of the legs of the spread trade.

Setting the default leverage on KuCoin

All funds in your Futures Account wallet are at risk when you have orders and positions that are active. To reduce risk you can reduce funds kept in Futures Account to only those meant to be used in trading or as collateral. Rest of funds can be kept safely on Funding Wallet.

To change the default leverage for an instrument select it on KuCoin web interface and using slider between 1-100x.


OKX


API KEY permissions

When creating the API key please make sure proper API Key permissions are set. You need following permissions on your API key

  • Read
  • Trade


Setup OKX API Key


Load funds into OKX futures trading wallet

OKX has two wallets: Funding and Trading. Funds deposited into OKX accounts are put into Funding wallet which is not used for trading. To be able to trade transfer funds into Trading wallet.
Setup OKX API Key


How much funds do I need in the futures wallet

Maximum leverage for OKX is 125. That means that if we want to open position with size X, we need to provide equity on our account called margin equal to X/125. To start spread trade with size of 1000 dollars, we need to provide the equity worth 16 dollars on our trading account as a margin for a spread trade, 8 - dollars for each of the legs of the spread trade.

Setting the default leverage on OKX

OKX manages the leverage per each individual instrument.

  • Minimum leverage: 1x
  • Maximum leverage: 125x
  • Default leverage: 3x


In order to change the default leverage for currently selected instrument click on current leverage trading platform:
Setup OKX Leverage 1
And then change the leverage to the preferred value:
Setup OKX Leverage 2


Important

  • BitSpreader currently doesn't support the margin control - if you don't have enough funds on your account available, exchange will return errors

Leverage Setup

BitSpreader doesn't support changing the leverage from BitSpreader user interface. In order to change the leverage you need to change the default leverage directly on the exchange. Please follow these links to find out how to update the default leverage on particular exchanges: