{"id":363870,"date":"2024-05-21T02:05:19","date_gmt":"2024-05-21T02:05:19","guid":{"rendered":"http:\/\/savepearlharbor.com\/?p=363870"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T21:00:00","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=363870","title":{"rendered":"Trade bot python setup (using Binance API), Vol 1<\/span>"},"content":{"rendered":"
<\/div>\n
\n
\n
\n
\n

IMPORTANT NOTE:<\/strong> this article is created for educative purposes only<\/strong>. Trading could be very risky<\/strong> and can lead to significant loses<\/strong>.<\/p>\n

Introduction<\/h2>\n

In this article we will introduce the fully functioning python<\/code> pipeline for the trading bot<\/strong> implementation using Binance API <\/strong>(on the USD\u24c8-M futures market). We will first discuss the framework and prerequisites, then the important API calls and finally the python<\/code> code. The framework that we will discuss concentrates on the one asset trading bot, but on the same time it gives opportunities for generalization to multiple assets.<\/p>\n

Binance API<\/h2>\n

Binance, being the largest cryptocurrency exchange, provides extensive API documentation for trading using python<\/code>. To initialize API client you should:<\/p>\n

    \n
  1. \n

    Visit the Binance official web page and create an account<\/p>\n<\/li>\n

  2. \n

    Open a futures account<\/p>\n<\/li>\n

  3. \n

    Create an API keys (in the developers tab)<\/p>\n<\/li>\n<\/ol>\n

    After getting the API keys (public & private) they should be pasted in the python<\/code> code on the marked places (see below).<\/p>\n

    API calls descriptions<\/h2>\n

    Full API documentation is available at official website<\/a>. In this section we will present the most important for basic usage API calls and their descriptions:<\/p>\n

    \n
    \n\n\n\n\n\n\n\n\n
    \n

    API call<\/strong><\/p>\n<\/td>\n

    		\n

    Python implementation<\/strong><\/p>\n<\/td>\n

    		\n

    Description<\/strong><\/p>\n<\/td>\n<\/tr>\n

    \n

    GET \/fapi\/v1\/time<\/code><\/p>\n<\/td>\n

    		\n

    client.get_server_time()<\/code><\/p>\n<\/td>\n

    		\n

    Get the current server time.<\/p>\n<\/td>\n<\/tr>\n

    \n

    GET \/fapi\/v1\/ticker\/bookTicker<\/code><\/p>\n<\/td>\n

    		\n

    client.futures_symbol_ticker()<\/code><\/p>\n<\/td>\n

    		\n

    Get latest price of the symbol (returns dict)<\/p>\n<\/td>\n<\/tr>\n

    \n

    GET \/fapi\/v1\/klines<\/code><\/p>\n<\/td>\n

    		\n

    client.futures_historical_klines()<\/code><\/p>\n<\/td>\n

    		\n

    Get historical prices of the symbol (OHLC and other data)<\/p>\n<\/td>\n<\/tr>\n

    \n

    GET \/fapi\/v2\/account<\/code><\/p>\n<\/td>\n

    		\n

    client.futures_account()<\/code><\/p>\n<\/td>\n

    		\n

    Get info about your futures account (including assets balances<\/p>\n<\/td>\n<\/tr>\n

    \n

    POST \/fapi\/v1\/order<\/code><\/p>\n<\/td>\n

    		\n

    client.futures_create_order()<\/code><\/p>\n<\/td>\n

    		\n

    Create order (buy\/sell, limit\/market) for specified symbol and quantity<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n

    Python implementation<\/h2>\n

    Now we can implement the whole trading bot using python. First of all you should install python package to connect with Binance. The standard package for this purpose is python-binance<\/code>, which can be installed using standard pip install python-binance<\/code> command.<\/p>\n

    Next the client<\/strong> should be initialized:<\/p>\n

    from binance.client import Client  api_key = \"<your_api_key>\" api_secret = \"<your_private_api_key>\" client = Client(api_key,  api_secret)<\/code><\/pre>\n
    After the client is being initialized we can to request market data. The simplest and most commonly used data is the candlestick data. After the candlestick data is retrieved from the server it is converted to pandas data frame and types are changed to the appropriate data types.<\/p>\n
    symbol = \"BTCUSDT\" interval = \"15m\" start_time = dt.datetime.now() - dt.timedelta(hours=24) end_time = dt.datetime.now()  # get the kline data from Binance server klines = client.futures_historical_klines(symbol,                                            interval,                                            start_time,                                            end_time)  # convert the json data to pd.DataFrame  klines_data = pd.DataFrame(klines) klines_data.columns = ['open_time',                        'open',                         'high',                         'low',                         'close',                         'volume',                        'close_time',                        'qav',                        'num_trades',                        'taker_base_vol',                        'taker_quote_vol',                        'ignore']  # convert data to appropriate data types klines_data['close_time'] = [dt.datetime.fromtimestamp(x\/1000.0) for x in klines_data[\"close_time\"] klines_data['open_time'] = [dt.datetime.fromtimestamp(x\/1000.0) for x in klines_data[\"open_time\"] klines_data['close'] = klines_data['close'].astype('float') klines_data['open'] = klines_data['open'].astype('float') klines_data['high'] = klines_data['high'].astype('float') klines_data['low'] = klines_data['low'].astype('float')<\/code><\/pre>\n
    After we have the candlestick data for last 24 hours we are ready to make the decisions and open any orders. To open an order the following script could be used:<\/p>\n
    # to open the market short trade client.futures_create_order(symbol=symbol,                              side='SELL',                              type='MARKET',                              quantity=quantity)  # to open the market long trade client.futures_create_order(symbol=symbol,                              side='BUY',                              type='MARKET',                              quantity=quantity)<\/code><\/pre>\n
    To close the trade on futures market<\/strong> you need to open the trade in the opposite direction with the same quantity.<\/p>\n
    Next, you could be interested in the current balance of your account, this information could be obtained via this code:<\/p>\n
    i = ... # number of asset you want to get balance for cur_balance = float(client.futures_account()['assets'][i]['walletBalance'])<\/code><\/pre>\n
    Now we can present the full code of the very basic trading system, which will open the short trade if the latest price of an asset exceeds 2000$ and open the long trade if the price of an asset falls below 1900$.<\/p>\n
    Note, that is real-time<\/strong> we do not usually need the Klines<\/code> request because it is sometimes sufficient just to know the latest price (in the simplest case just the latest price, but in more natural way: the latest bid\/ask<\/em> prices with volumes, i.e. the order book). This could be done using the following code:<\/p>\n
    # returns latest price as str latest_price = client.futures_symbol_ticker(symbol='ETHUSDT')['price'] # convert str to float latest_price = float(latest_price)<\/code><\/pre>\n
    Now we combine everything together:<\/p>\n
    import time from datetime import datetime from binance.client import Client  # exchange operations: # note that short_open and long_close are exactly the same # this is due to the fact mentioned above, that closing the trade # is just opening the trade in other direction with the same qty; # here we kept both for the convience of understanding def short_open(symbol, quantity):     client.futures_create_order(symbol=symbol,                                  side='SELL',                                  type='MARKET',                                  quantity=quantity)      def short_close(symbol, quantity):     client.futures_create_order(symbol=symbol,                                  side='BUY',                                  type='MARKET',                                  quantity=quantity)      def long_open(symbol, quantity):     client.futures_create_order(symbol=symbol,                                  side='BUY',                                  type='MARKET',                                  quantity=quantity)  def long_close(symbol, quantity):     client.futures_create_order(symbol=symbol,                                  side='SELL',                                  type='MARKET',                                  quantity=quantity)  # initialize Client with your API keys api_key = \"<your_api_key>\" api_secret = \"<your_private_api_key>\" client = Client(api_key,  api_secret)  # traded symbol symbol = \"ETHUSDT\"  # flags to track the exchanges to avoid duplicated entries in_short = False in_long = False  # main loop while True:     # get latest price for the symbol     latest_price = client.futures_symbol_ticker(symbol=symbol)['price']     latest_price = float(latest_price)      # print latest price with current time     latest_time = datetime.now().strftime('%Y-%m-%d %H:%M:%S')     print(latest_time, latest_price)          # check the condition (these conditions could be substitued by any other)     if latest_price > 2000.0:         # if we are in long position, close it         if in_long:             long_close(symbol=symbol, quantity=1)             in_long = False         # if we are not in short position, open it         if not in_short:             short_open(symbol=symbol, quantity=1)             in_short = True     elif latest_price < 1900.0:         # if we are in long position, close it         if not in_long:             long_open(symbol=symbol, quantity=1)             in_long = True         # if we are in short position, close it         if in_short:             short_close(symbol=symbol, quantity=1)             in_short = False      # 1 second sleep     time.sleep(1)<\/code><\/pre>\n
    Thank you for reading!<\/p>\n<\/p>\n<\/div>\n<\/div>\n<\/div>\n
    <\/div>\n

     \u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438  https:\/\/habr.com\/ru\/articles\/782892\/<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
    <\/div>\n
    \n
    \n
    \n
    \n
    IMPORTANT NOTE:<\/strong> this article is created for educative purposes only<\/strong>. Trading could be very risky<\/strong> and can lead to significant loses<\/strong>.<\/p>\n
    Introduction<\/h2>\n
    In this article we will introduce the fully functioning python<\/code> pipeline for the trading bot<\/strong> implementation using Binance API <\/strong>(on the USD\u24c8-M futures market). We will first discuss the framework and prerequisites, then the important API calls and finally the python<\/code> code. The framework that we will discuss concentrates on the one asset trading bot, but on the same time it gives opportunities for generalization to multiple assets.<\/p>\n
    Binance API<\/h2>\n
    Binance, being the largest cryptocurrency exchange, provides extensive API documentation for trading using python<\/code>. To initialize API client you should:<\/p>\n
      \n
    1. \n
      Visit the Binance official web page and create an account<\/p>\n<\/li>\n
    2. \n
      Open a futures account<\/p>\n<\/li>\n
    3. \n
      Create an API keys (in the developers tab)<\/p>\n<\/li>\n<\/ol>\n
      After getting the API keys (public & private) they should be pasted in the python<\/code> code on the marked places (see below).<\/p>\n
      API calls descriptions<\/h2>\n
      Full API documentation is available at official website<\/a>. In this section we will present the most important for basic usage API calls and their descriptions:<\/p>\n
      \n
      \n\n\n\n\n\n\n\n\n
      \n
      API call<\/strong><\/p>\n<\/td>\n
      		\n
      Python implementation<\/strong><\/p>\n<\/td>\n
      		\n
      Description<\/strong><\/p>\n<\/td>\n<\/tr>\n
      \n
      GET \/fapi\/v1\/time<\/code><\/p>\n<\/td>\n
      		\n
      client.get_server_time()<\/code><\/p>\n<\/td>\n
      		\n
      Get the current server time.<\/p>\n<\/td>\n<\/tr>\n
      \n
      GET \/fapi\/v1\/ticker\/bookTicker<\/code><\/p>\n<\/td>\n
      		\n
      client.futures_symbol_ticker()<\/code><\/p>\n<\/td>\n
      		\n
      Get latest price of the symbol (returns dict)<\/p>\n<\/td>\n<\/tr>\n
      \n
      GET \/fapi\/v1\/klines<\/code><\/p>\n<\/td>\n
      		\n
      client.futures_historical_klines()<\/code><\/p>\n<\/td>\n
      		\n
      Get historical prices of the symbol (OHLC and other data)<\/p>\n<\/td>\n<\/tr>\n
      \n
      GET \/fapi\/v2\/account<\/code><\/p>\n<\/td>\n
      		\n
      client.futures_account()<\/code><\/p>\n<\/td>\n
      		\n
      Get info about your futures account (including assets balances<\/p>\n<\/td>\n<\/tr>\n
      \n
      POST \/fapi\/v1\/order<\/code><\/p>\n<\/td>\n
      		\n
      client.futures_create_order()<\/code><\/p>\n<\/td>\n
      		\n
      Create order (buy\/sell, limit\/market) for specified symbol and quantity<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n
      Python implementation<\/h2>\n
      Now we can implement the whole trading bot using python. First of all you should install python package to connect with Binance. The standard package for this purpose is python-binance<\/code>, which can be installed using standard pip install python-binance<\/code> command.<\/p>\n
      Next the client<\/strong> should be initialized:<\/p>\n
      from binance.client import Client  api_key = \"<your_api_key>\" api_secret = \"<your_private_api_key>\" client = Client(api_key,  api_secret)<\/code><\/pre>\n
      After the client is being initialized we can to request market data. The simplest and most commonly used data is the candlestick data. After the candlestick data is retrieved from the server it is converted to pandas data frame and types are changed to the appropriate data types.<\/p>\n
      symbol = \"BTCUSDT\" interval = \"15m\" start_time = dt.datetime.now() - dt.timedelta(hours=24) end_time = dt.datetime.now()  # get the kline data from Binance server klines = client.futures_historical_klines(symbol,                                            interval,                                            start_time,                                            end_time)  # convert the json data to pd.DataFrame  klines_data = pd.DataFrame(klines) klines_data.columns = ['open_time',                        'open',                         'high',                         'low',                         'close',                         'volume',                        'close_time',                        'qav',                        'num_trades',                        'taker_base_vol',                        'taker_quote_vol',                        'ignore']  # convert data to appropriate data types klines_data['close_time'] = [dt.datetime.fromtimestamp(x\/1000.0) for x in klines_data[\"close_time\"] klines_data['open_time'] = [dt.datetime.fromtimestamp(x\/1000.0) for x in klines_data[\"open_time\"] klines_data['close'] = klines_data['close'].astype('float') klines_data['open'] = klines_data['open'].astype('float') klines_data['high'] = klines_data['high'].astype('float') klines_data['low'] = klines_data['low'].astype('float')<\/code><\/pre>\n
      After we have the candlestick data for last 24 hours we are ready to make the decisions and open any orders. To open an order the following script could be used:<\/p>\n
      # to open the market short trade client.futures_create_order(symbol=symbol,                              side='SELL',                              type='MARKET',                              quantity=quantity)  # to open the market long trade client.futures_create_order(symbol=symbol,                              side='BUY',                              type='MARKET',                              quantity=quantity)<\/code><\/pre>\n
      To close the trade on futures market<\/strong> you need to open the trade in the opposite direction with the same quantity.<\/p>\n
      Next, you could be interested in the current balance of your account, this information could be obtained via this code:<\/p>\n
      i = ... # number of asset you want to get balance for cur_balance = float(client.futures_account()['assets'][i]['walletBalance'])<\/code><\/pre>\n
      Now we can present the full code of the very basic trading system, which will open the short trade if the latest price of an asset exceeds 2000$ and open the long trade if the price of an asset falls below 1900$.<\/p>\n
      Note, that is real-time<\/strong> we do not usually need the Klines<\/code> request because it is sometimes sufficient just to know the latest price (in the simplest case just the latest price, but in more natural way: the latest bid\/ask<\/em> prices with volumes, i.e. the order book). This could be done using the following code:<\/p>\n
      # returns latest price as str latest_price = client.futures_symbol_ticker(symbol='ETHUSDT')['price'] # convert str to float latest_price = float(latest_price)<\/code><\/pre>\n
      Now we combine everything together:<\/p>\n
      import time from datetime import datetime from binance.client import Client  # exchange operations: # note that short_open and long_close are exactly the same # this is due to the fact mentioned above, that closing the trade # is just opening the trade in other direction with the same qty; # here we kept both for the convience of understanding def short_open(symbol, quantity):     client.futures_create_order(symbol=symbol,                                  side='SELL',                                  type='MARKET',                                  quantity=quantity)      def short_close(symbol, quantity):     client.futures_create_order(symbol=symbol,                                  side='BUY',                                  type='MARKET',                                  quantity=quantity)      def long_open(symbol, quantity):     client.futures_create_order(symbol=symbol,                                  side='BUY',                                  type='MARKET',                                  quantity=quantity)  def long_close(symbol, quantity):     client.futures_create_order(symbol=symbol,                                  side='SELL',                                  type='MARKET',                                  quantity=quantity)  # initialize Client with your API keys api_key = \"<your_api_key>\" api_secret = \"<your_private_api_key>\" client = Client(api_key,  api_secret)  # traded symbol symbol = \"ETHUSDT\"  # flags to track the exchanges to avoid duplicated entries in_short = False in_long = False  # main loop while True:     # get latest price for the symbol     latest_price = client.futures_symbol_ticker(symbol=symbol)['price']     latest_price = float(latest_price)      # print latest price with current time     latest_time = datetime.now().strftime('%Y-%m-%d %H:%M:%S')     print(latest_time, latest_price)          # check the condition (these conditions could be substitued by any other)     if latest_price > 2000.0:         # if we are in long position, close it         if in_long:             long_close(symbol=symbol, quantity=1)             in_long = False         # if we are not in short position, open it         if not in_short:             short_open(symbol=symbol, quantity=1)             in_short = True     elif latest_price < 1900.0:         # if we are in long position, close it         if not in_long:             long_open(symbol=symbol, quantity=1)             in_long = True         # if we are in short position, close it         if in_short:             short_close(symbol=symbol, quantity=1)             in_short = False      # 1 second sleep     time.sleep(1)<\/code><\/pre>\n
      Thank you for reading!<\/p>\n<\/p>\n<\/div>\n<\/div>\n<\/div>\n
      <\/div>\n

       \u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438  https:\/\/habr.com\/ru\/articles\/782892\/<\/a>
      <\/br><\/br><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-363870","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/363870","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=363870"}],"version-history":[{"count":0,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/363870\/revisions"}],"wp:attachment":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=363870"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=363870"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=363870"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}