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

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

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

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: