cotcube-helpers 0.1.10 → 0.2.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e00fe82276d1be8a2f034759240a0bf820574f6c99de4ec6126bf436bf6a149b
-  data.tar.gz: e512de0546fd46dcdb356a55265bb8bc874999447c98df67c77b1289a8e2cee4
+  metadata.gz: 2e416bde4f3c3a8dbba8290c74fa4a54d8f0b5f84f61eb9af8e7bd669bab5a43
+  data.tar.gz: abb4a2842d5b11f2fcb38bbede59bd693b18117547c94d9eb11a2342d1f76665
 SHA512:
-  metadata.gz: 5c0474d0638810ecf7af38f662c80c9a91ac531e5d38e71ff03e7872b559a4add577437c91c435ace0a8b1afc2adb1c1b686272426b6404d138d9d7b3fdfa8af
-  data.tar.gz: 94b42e991e539ac38e672c0fea5aba4a052e9c5a2b3899bc48d3e855ce23541f04f3b8a8640bb9bb76bd144476e4110d226e4a28298c66ad45480b3d80031a51
+  metadata.gz: 60f1bc2438ef256bc3d772dec73e22a12711e4088a8ffa07463976c0931e149d471f9d7ea93c6930aff3b96fe06d15537cf96319946ed0fb4cbbbdf70573295a
+  data.tar.gz: b372776b0d180c6007b0c652d1eeb056d1845ac12775a8853e6e9e9ba9de128cf411527c4912174c722d5c6c4705d4524240665e917928ab50bb9ca0a3fe53cf

data/CHANGELOG.md

@@ -1,3 +1,36 @@
+## 0.2.2.4 (December 07, 2021)
+  - introduced cache_client as client to readcache
+
+## 0.2.2.3 (November 28, 2021)
+  - data_client: fixing troublesome output in .command
+
+## 0.2.2.2 (November 28, 2021)
+  - dataclient fixing = for false ==
+  - solving merge conflicts
+  - Bump version to 0.2.2.
+
+## 0.2.2.1 (November 28, 2021)
+  - Bump version to 0.2.2.1
+
+## 0.2.2 (November 13, 2021)
+  - some further improvements to DataClient
+  - some fixes related to ib_contracts
+  - some fixes related to DataClient
+
+## 0.2.1.1 (November 10, 2021)
+  - Bump version to 0.2.1.
+
+## 0.2.1 (November 10, 2021)
+  - added new class 'dataclient' for communication with dataproxy
+  - added .translate_ib_contract
+
+## 0.2.0 (November 07, 2021)
+  - added module Candlestick_Recognition
+  - added instance_inspect method to 'scan' objects for contents of instance variables
+  - symbols: made selection of symbols more versatile by key
+  - added headers (:ib_symbol, :internal, :exchange, :currency) to symbol headers as well as symbol examples
+  - added scripts/symbols to list (and filter) symbols from command line (put to PATH!)
+
 ## 0.1.10 (October 28, 2021)
   - added script cron_ruby_wrapper.sh (linkable as /usr/local/bin/cruw.sh)
   - added numeric ext .with_delimiter to support printing like 123_456_789.00121

data/Gemfile

@@ -4,3 +4,6 @@ source 'https://rubygems.org'
 
 # Specify your gem's dependencies in bitangent.gemspec
 gemspec
+gem 'parallel'
+gem 'bunny'
+gem 'httparty'

data/VERSION

@@ -1 +1 @@
-0.1.10
+0.2.2.4

data/lib/cotcube-helpers/cache_client.rb

@@ -0,0 +1,28 @@
+require 'httparty'
+require 'json'
+
+module Cotcube
+  module Helpers
+    def cached(query, timezone: Cotcube::Helpers::CHICAGO, debug: false, deflate: false)
+      # TODO: set param to enable deflate on transmission via HTTPARRTY Header
+      request_headers = {} 
+      request_headers['Accept-Encoding' => 'deflate'] if deflate
+      res = JSON.parse(HTTParty.get("http://100.100.0.14:8081/#{query}").parsed_response, symbolize_names: true) rescue { error: 1, msg: "Could not parse response for query '#{query}'." }
+      unless res[:error] and res[:error].zero? 
+        puts "ERROR: #{res}"
+        return false
+      end
+      #res[:valid_until] = timezone.parse(res[:valid_until])
+      #res[:modified]    = timezone.parse(res[:modified_at])
+      if debug
+        puts "Warnings: #{res[:warnings]}"
+        puts "Modified: #{res[:modified]}"
+        puts "Valid_un: #{res[:valid_until]}"
+        puts "payload:  #{res[:payload].to_s.size}"
+      end
+      res[:payload]
+    end
+
+    module_function :cached
+  end
+end

data/lib/cotcube-helpers/constants.rb

@@ -3,13 +3,13 @@
 module Cotcube
   module Helpers
     SYMBOL_EXAMPLES = [
-      { id: '13874U', symbol: 'ES', ticksize: 0.25, power: 12.5, months: 'HMUZ', bcf: 1.0, reports: 'LF', format: '8.2f', name: 'S&P 500 MICRO' },
-      { id: '209747', symbol: 'NQ', ticksize: 0.25, power: 5.0,  monhts: 'HMUZ', bcf: 1.0, reports: 'LF', format: '8.2f', name: 'NASDAQ 100 MICRO' }
+      { id: '13874U', symbol: 'ES', ib_symbol: 'ES', internal: 'ES', exchange: 'GLOBEX', currency: 'USD', ticksize: 0.25, power: 12.5, months: 'HMUZ', bcf: 1.0, reports: 'LF', format: '8.2f', name: 'S&P 500 MICRO' },
+      { id: '209747', symbol: 'NQ', ib_symbol: 'NQ', internal: 'NQ', exchange: 'GLOBEx', currency: 'USD', ticksize: 0.25, power: 5.0,  monhts: 'HMUZ', bcf: 1.0, reports: 'LF', format: '8.2f', name: 'NASDAQ 100 MICRO' }
     ].freeze
 
     MICRO_EXAMPLES = [
-      { id: '13874U', symbol: 'ET', ticksize: 0.25, power: 1.25, months: 'HMUZ', bcf: 1.0, reports: 'LF', format: '8.2f', name: 'MICRO S&P 500 MICRO' },
-      { id: '209747', symbol: 'NM', ticksize: 0.25, power: 0.5,  monhts: 'HMUZ', bcf: 1.0, reports: 'LF', format: '8.2f', name: 'MICRO NASDAQ 100 MICRO' }
+      { id: '13874U', symbol: 'ET', ib_symbol: 'MES', internal: 'MES', exchange: 'GLOBEX', currency: 'USD', ticksize: 0.25, power: 1.25, months: 'HMUZ', bcf: 1.0, reports: 'LF', format: '8.2f', name: 'MICRO S&P 500 MICRO' },
+      { id: '209747', symbol: 'NM', ib_symbol: 'MNQ', internal: 'MNQ', exchange: 'GLOBEX', currency: 'USD', ticksize: 0.25, power: 0.5,  monhts: 'HMUZ', bcf: 1.0, reports: 'LF', format: '8.2f', name: 'MICRO NASDAQ 100 MICRO' }
     ].freeze
 
     COLORS         = %i[light_red light_yellow light_green red yellow green cyan magenta blue].freeze
@@ -33,6 +33,12 @@ module Cotcube
 
     DATE_FMT = '%Y-%m-%d'
 
+    # Simple mapper to get from MONTH to LETTER
+    LETTERS = { "JAN"=> "F", "FEB"=> "G", "MAR"=> "H",
+                "APR"=> "J", "MAY"=> "K", "JUN"=> "M",
+                "JUL"=> "N", "AUG"=> "Q", "SEP"=> "U",
+                "OCT"=> "V", "NOV"=> "X", "DEC"=> "Z" }
+
   end
 end
 

data/lib/cotcube-helpers/data_client.rb

@@ -0,0 +1,230 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bunny'
+require 'json'
+
+module Cotcube
+  module Helpers
+    class DataClient
+      SECRETS_DEFAULT = {
+        'dataproxy_mq_proto' => 'http',
+        'dataproxy_mq_user' => 'guest',
+        'dataproxy_mq_password' => 'guest',
+        'dataproxy_mq_host' => 'localhost',
+        'dataproxy_mq_port' => '15672',
+        'dataproxy_mq_vhost' => '%2F'
+      }.freeze
+
+      SECRETS = SECRETS_DEFAULT.merge(
+        lambda {
+          begin
+            YAML.safe_load(File.read(Cotcube::Helpers.init[:secrets_file]))
+          rescue StandardError
+            {}
+          end
+        }.call
+      )
+
+      def initialize
+        @connection = Bunny.new(user: SECRETS['dataproxy_mq_user'],
+                                password: SECRETS['dataproxy_mq_password'],
+                                vhost: SECRETS['dataproxy_mq_vhost'])
+        @connection.start
+
+        @commands  = connection.create_channel
+        @exchange  = commands.direct('dataproxy_commands')
+        @requests  = {}
+        @persistent = { depth: {}, realtimebars: {}, ticks: {} }
+        @debug     = false
+        setup_reply_queue
+      end
+
+      # command acts a synchronizer: it sends the command and waits for the response
+      #     otherwise times out --- the counterpart here is the subscription within 
+      #     setup_reply_queue
+      #
+      def command(command, timeout: 5)
+        command = { command: command.to_s } unless command.is_a? Hash
+        command[:timestamp] ||= (Time.now.to_f * 1000).to_i
+        request_id = Digest::SHA256.hexdigest(command.to_json)[..6]
+        requests[request_id] = {
+          request: command,
+          id: request_id,
+          lock: Mutex.new,
+          condition: ConditionVariable.new
+        }
+
+        exchange.publish(command.to_json,
+                         routing_key: 'dataproxy_commands',
+                         correlation_id: request_id,
+                         reply_to: reply_queue.name)
+
+        # wait for the signal to continue the execution
+        #
+        requests[request_id][:lock].synchronize do
+          requests[request_id][:condition].wait(requests[request_id][:lock], timeout)
+        end
+
+        # if we reached timeout, we will return nil, just for explicity
+        response = requests[request_id][:response].dup
+        requests.delete(request_id)
+        response
+      end
+
+      alias_method :send_command, :command
+
+      def stop
+        %i[depth ticks realtimebars].each do |type|
+          persistent[type].each do |local_key, obj|
+            puts "Cancelling #{local_key}"
+            obj[:subscription].cancel
+          end
+        end
+        commands.close
+        connection.close
+      end
+
+      def get_contracts(symbol:)
+        send_command({ command: :get_contracts, symbol: symbol })
+      end
+
+      def get_historical(contract:, interval:, duration: nil, before: nil, rth_only: false, based_on: :trades)
+        # rth.true? means data outside of rth is skipped
+        rth_only = rth_only ? 1 : 0
+
+        # interval most probably is given as ActiveSupport::Duration
+        if interval.is_a? ActiveSupport::Duration
+          interval = case interval
+                     when       1; :sec1 
+                     when       5; :sec5
+                     when      15; :sec15
+                     when      30; :sec30
+                     when      60; :min1
+                     when     120; :min2
+                     when     300; :min5
+                     when     900; :min15
+                     when    1800; :min30
+                     when    3600; :hour1
+                     when   86400; :day1
+                     else; interval
+                     end
+        end
+
+        default_durations = { sec1: '30_M',  sec5: '2_H', sec15: '6_H', sec30: '12_H',
+                              min1:  '1_D',  min2: '2_D',  min5: '5_D', min15:  '1_W',
+                              min30: '1_W', hour1: '1_W',  day1: '1_Y'                 }
+
+        unless default_durations.keys.include? interval
+          raise "Invalid interval '#{interval}', should be in '#{default_durations.keys}'."
+        end
+
+        # TODO: Check for valid duration specification
+        puts 'WARNING in get_historical: param :before ignored' unless before.nil?
+        duration ||= default_durations[interval]
+        send_command({
+                       command: :historical,
+                       contract: contract,
+                       interval: interval,
+                       duration: duration,
+                       based_on: based_on.to_s.upcase,
+                       rth_only: rth_only,
+                       before: nil
+                     }, timeout: 20)
+      end
+
+      def start_persistent(contract:, type: :realtimebars, local_id: 0, &block)
+        unless %i[depth ticks realtimebars].include? type.to_sym
+          puts "ERROR: Inappropriate type in stop_realtimebars with #{type}"
+          return false
+        end
+
+        local_key = "#{contract}_#{local_id}"
+
+        channel = connection.create_channel
+        exchange  = channel.fanout("dataproxy_#{type}_#{contract}")
+        queue     = channel.queue('', exclusive: true, auto_delete: true)
+        queue.bind(exchange)
+
+        ib_contract = Cotcube::Helpers.get_ib_contract(contract)
+
+        command = { command: type, contract: contract, con_id: ib_contract[:con_id],
+                    delivery: queue.name, exchange: exchange.name }
+
+        block      ||= ->(bar) { puts bar.to_s }
+
+        subscription = queue.subscribe do |_delivery_info, _properties, payload|
+          block.call(JSON.parse(payload, symbolize_names: true))
+        end
+        persistent[type][local_key] = command.dup
+        persistent[type][local_key][:queue] = queue
+        persistent[type][local_key][:subscription] = subscription
+        persistent[type][local_key][:channel] = channel
+        send_command(command)
+      end
+
+      def stop_persistent(contract:, local_id: 0, type: :realtimebars)
+        unless %i[depth ticks realtimebars].include? type.to_sym
+          puts "ERROR: Inappropriate type in stop_realtimebars with #{type}"
+          return false
+        end
+        local_key = "#{contract}_#{local_id}"
+        p persistent[type][local_key][:subscription].cancel
+        p persistent[type][local_key][:channel].close
+        persistent[type].delete(local_key)
+      end
+
+      attr_accessor :response
+      attr_reader   :lock, :condition
+
+      private
+
+      attr_reader :call_id, :connection, :requests, :persistent,
+                  :commands, :server_queue_name, :reply_queue, :exchange
+
+      def setup_reply_queue
+        @reply_queue = commands.queue('', exclusive: true, auto_delete: true)
+        @reply_queue.bind(commands.exchange('dataproxy_replies'), routing_key: @reply_queue.name)
+
+        reply_queue.subscribe do |delivery_info, properties, payload|
+          __id__ = properties[:correlation_id]
+
+          if __id__.nil?
+            puts "Received without __id__: #{delivery_info.map       { |k, v| "#{k}\t#{v}" }.join("\n")
+                                      }\n\n#{properties.map          { |k, v| "#{k}\t#{v}" }.join("\n")
+                                      }\n\n#{JSON.parse(payload).map { |k, v| "#{k}\t#{v}" }.join("\n")}" if @debug
+
+          elsif requests[__id__].nil?
+            puts "Received non-matching response, maybe previously timed out: \n\n#{delivery_info}\n\n#{properties}\n\n#{payload}\n."[..620].scan(/.{1,120}/).join(' '*30 + "\n") if @debug
+          else
+            # save the payload and send the signal to continue the execution of #command
+            # need to rescue the rare case, where lock and condition are destroyed right in parallel by timeout
+            begin 
+              puts "Received result for #{__id__}" if @debug
+              requests[__id__][:response] = payload
+              requests[__id__][:lock].synchronize { requests[__id__][:condition].signal }
+            rescue nil
+            end
+          end
+        end
+      end
+    end
+  end
+end
+
+__END__
+begin 
+  client = DataClient.new
+  reply = client.send_command( { command: 'ping' } ) #{ command: :hist, contract: 'A6Z21', con_id: 259130514, interval: :min15 } )
+  puts reply.nil? ? 'nil' : JSON.parse(reply)
+  reply = client.get_historical( contract: 'A6Z21',  con_id: 259130514, interval: :min15 , rth_only: false)
+  JSON.parse(reply, symbolize_names: true)[:result].map{|z| 
+    z[:datetime] = Cotcube::Helpers::CHICAGO.parse(z[:time]).strftime('%Y-%m-%d %H:%M:%S')
+    z.delete(:created_at)
+    z.delete(:time)
+    p z.slice(*%i[datetime open high low close volume]).values
+
+  } 
+ensure
+  client.stop
+  e,nd

data/lib/cotcube-helpers/expiration.rb

@@ -0,0 +1,31 @@
+module Cotcube
+  module Helpers
+
+    class ExpirationMonth
+      attr_accessor *%i[ asset month year holidays stencil ]
+      def initialize( contract: )
+        a,b,c,d,e = contract.chars
+        @asset  = [ a, b ].join
+        if %w[ GG DL BJ GE VI ] 
+          puts "Denying to calculate expiration for #{@asset}".light_red
+          return
+        end
+        @month  = MONTHS[c] + offset
+        @month -= 1 if %w[ CL HO NG RB SB].include? @asset
+        @month += 1 if %w[ ].include? @asset
+        @month += 12 if month < 1
+        @month -= 12 if month > 12
+        @year   = [ d, e ].join.to_i
+        @year  += year > 61 ? 1900 : 2000
+        @holidays = CSV.read("/var/cotcube/bardata/holidays.csv").map{|x| DateTime.parse(x[0]).to_date}.select{|x| x.year == @year }
+        @stencil  = [ Date.new(@year, @month, 1) ] 
+        end_date = Date.new(@year, @month + 1, 1 )
+        while (next_date = @stencil.last + 1) < end_date
+          @stencil << next_date
+        end
+        @stencil.reject!{|x| [0,6].include?(x.wday) or @holidays.include? x}
+      end
+    end
+
+  end
+end

data/lib/cotcube-helpers/get_id_set.rb

@@ -20,10 +20,10 @@ module Cotcube
       end
 
       unless symbol.nil?
-        sym = symbols(symbol: symbol)
+        sym = symbols(symbol: symbol).presence || micros(symbol: symbol)
         if sym.nil? || sym[:id].nil?
           raise ArgumentError,
-                "Could not find match in #{config[:symbols_file]} for given symbol #{symbol}"
+                "Could not find match in #{config[:symbols_file]} or #{config[:micros_file]} for given symbol #{symbol}"
         end
         raise ArgumentError, "Mismatching symbol #{symbol} and given id #{id}" if (not id.nil?) && (sym[:id] != id)
 
@@ -39,6 +39,7 @@ module Cotcube
       end
       raise ArgumentError, 'Need :id, :symbol or valid :contract '
     end
+
   end
 end
 

data/lib/cotcube-helpers/ib_contracts.rb

@@ -0,0 +1,69 @@
+module Cotcube
+  module Helpers
+    def get_ib_contract(contract)
+      symbol = contract[..1]
+      # TODO consider file location to be found in configfile
+      filepath =  '/etc/cotcube/ibsymbols/'
+      result = YAML.load(File.read( "#{filepath}/#{symbol}.yml"))[contract].transform_keys(&:to_sym) rescue nil
+      result.nil? ? update_ib_contracts(symbol: contract[..1]) : (return result)
+      YAML.load(File.read( "#{filepath}/#{symbol}.yml"))[contract].transform_keys(&:to_sym) rescue nil
+    end
+
+    def update_ib_contracts(symbol: nil)
+      begin
+        client = DataClient.new
+        (Cotcube::Helpers.symbols + Cotcube::Helpers.micros).each do |sym|
+
+          # TODO: consider file location to be located in config
+          file = "/etc/cotcube/ibsymbols/#{sym[:symbol]}.yml"
+
+          # TODO: VI publishes weekly options which dont match, the 3 others need multiplier enabled to work
+          next if %w[ DY TM SI VI ].include? sym[:symbol]
+          next if symbol and sym[:symbol] != symbol
+          begin
+            if File.exist? file
+              next if Time.now - File.mtime(file) < 5.days
+              data = nil
+              data = YAML.load(File.read(file))
+            else
+              data = {}
+            end
+            p file
+            %w[ symbol sec_type exchange multiplier ticksize power internal ].each {|z| data.delete z}
+            raw   = client.get_contracts(symbol: sym[:symbol])
+            reply = JSON.parse(raw)['result']
+            reply.each do |set|
+              contract = translate_ib_contract set['local_symbol']
+              data[contract] ||= set
+            end
+            keys = data.keys.sort_by{|z| z[2]}.sort_by{|z| z[-2..] }.select{|z| z[..1] == sym[:symbol] }
+            data = data.slice(*keys)
+            File.open(file, 'w'){|f| f.write(data.to_yaml) }
+          rescue Exception => e
+            puts e.full_message
+            p sym
+            binding.irb
+          end
+        end
+      ensure 
+        client.stop
+        true
+      end
+    end
+
+    def translate_ib_contract(contract)
+      short = contract.split(" ").size == 1
+      sym_a = contract.split(short ? '' : ' ')
+      year  = sym_a.pop.to_i + (short ? 20 : 0)
+      if short and sym_a[-1].to_i > 0
+        year = year - 20 + sym_a.pop.to_i * 10
+      end
+      month = short ? sym_a.pop : LETTERS[sym_a.pop]
+      sym   = Cotcube::Helpers.symbols(internal: sym_a.join)[:symbol] rescue nil
+      sym ||= Cotcube::Helpers.micros(internal: sym_a.join)[:symbol] rescue nil
+      sym.nil? ? false : "#{sym}#{month}#{year}"
+    end
+
+  end
+end
+

data/lib/cotcube-helpers/orderclient.rb

@@ -0,0 +1,203 @@
+# frozen_string_literal: true
+
+# rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+
+module Cotcube
+  module Helpers
+    # A proxyclient is a wrapper that allows communication with cotcube-orderproxy and cotcube-dataproxy. It fulfills
+    # registration and provides the opportunity to implement the logic to respond do events.
+    # (orderproxy and dataproxy are separate gems creating a layer between tws/ib-ruby and cotcube-based
+    #  applications)
+    #
+    #  NOTE: Whats here is a provisionally version
+    #
+    class DataClient # rubocop:disable Metrics/ClassLength
+      attr_reader :power, :ticksize, :multiplier, :average, :account
+
+      # The constructor takes a lot of arguments:
+      def initialize(
+        debug: false,
+        contract: ,
+        serverport: 24001,
+        serveraddr: '127.0.0.1',
+        client:,
+        bars: true,
+        ticks: false,
+        bar_size: 5,
+        spawn_timeout: 15
+      )
+        require 'json'   unless Hash.new.respond_to? :to_json
+        require 'socket' unless defined? TCPSocket
+
+        puts 'PROXYCLIENT: Debug enabled' if @debug
+
+        @contract = contract.upcase
+        %w[debug serverport serveraddr client bars ticks bar_size].each {|var| eval("@#{var} = #{var}")}
+
+        @position     = 0
+        @account      = 0
+        @average      = 0
+
+        exit_on_startup(':client must be in range 24001..24999') if @client.nil? || (@client / 1000 != 24) || (@client == 24_000)
+
+        res = send_command({ command: 'register', contract: @contract, date: @date,
+                             ticks: @ticks, bars: @bars, bar_size: @bar_size })
+
+        # spawn_server has to be called separately after initialization. 
+        print "Waiting #{spawn_timeout} seconds on server_thread to spawn..."
+        Thread.new do 
+          begin 
+            Timeout.timeout(spawn_timeout) { sleep(0.1) while @server_thread.nil? }
+          rescue Timeout::Error
+            puts 'Could not get server_thread, has :spawn_server been called?' 
+            shutdown
+          end
+        end
+
+        unless res['error'].zero?
+          exit_on_startup("Unable to register on orderproxy, exiting")
+        end
+      end
+
+      def exit_on_startup(msg = '')
+        puts "Cannot startup client, exiting during startup: '#{msg}'"
+        shutdown
+        defined?(::IRB) ? (raise) : (exit 1)
+      end
+
+      def send_command(req)
+        req[:client_id] = @client
+        res = nil
+        puts "Connecting to #{@serveraddr}:#{@serverport} to send '#{req}'." if @debug
+
+        TCPSocket.open(@serveraddr, @serverport) do |proxy|
+          proxy.puts(req.to_json)
+          raw = proxy.gets
+          begin
+            res = JSON.parse(raw)
+          rescue StandardError
+            puts 'Error while parsing response'
+            return false
+          end
+          if @debug
+            # rubocop:disable Style/FormatStringToken, Style/FormatString
+            res.each do |k, v|
+              case v
+              when Array
+                (v.size < 2) ? puts(format '%-15s', "#{k}:") : print(format '%-15s', "#{k}:")
+                v.each_with_index { |x, i| i.zero? ? (puts x) : (puts "               #{x}") }
+              else
+                puts "#{format '%-15s', "#{k}:"}#{v}"
+              end
+            end
+            # rubocop:enable Style/FormatStringToken, Style/FormatString
+          end
+          puts "ERROR on command: #{res['msg']}" unless res['error'].nil? or res['error'].zero?
+        end
+        puts res.to_s if @debug
+        res
+      end
+
+      # #shutdown ends the @server_thread and --if :close is set-- closes the current position attached to the client
+      def shutdown(close: true)
+        return if @shutdown
+        @shutdown = true
+
+        if @position.abs.positive? && close
+          send_command({ command: 'order', action: 'create', type: 'market',
+                         side: (@position.positive? ? 'sell' : 'buy'), size: @position.abs })
+        end
+        sleep 3
+        result = send_command({ command: 'unregister' })
+        puts "FINAL ACCOUNT: #{@account}"
+        result['executions']&.each do |x|
+          x.delete('msg_type')
+          puts x.to_s
+        end
+        @server_thread.exit if @server_thread.respond_to? :exit
+      end
+
+      def spawn_server(
+        execution_proc: nil,
+        orderstate_proc: nil, 
+        tick_proc: nil,
+        depth_proc: nil, 
+        order_proc: nil, 
+        bars_proc: nil
+      )                                           # rubocop:disable Metrics/MethodLength
+
+        %w[execution_proc orderstate_proc tick_proc depth_proc order_proc bars_proc].each {|var| eval("@#{var} = #{var}") }
+
+        if @bars 
+          @bars_proc ||= lambda {|msg| puts msg.inspect }
+        end
+
+        if @ticks
+          @ticks_proc ||= lambda {|msg| puts msg.inspect }
+        end
+
+        if @shutdown
+          puts "Cannot spawn server on proxyclient that has been already shut down."
+          return
+        end
+        if @server_thread
+          puts "Cannot spawn server more than once."
+          return
+        end
+
+        @server_thread = Thread.new do                                      # rubocop:disable Metrics/BlockLength
+          puts 'Spawning RECEIVER'
+          server = TCPServer.open(@serveraddr, @client)
+          loop do                                                           # rubocop:disable Metrics/BlockLength
+            Thread.start(server.accept) do |client|                         # rubocop:disable Metrics/BlockLength
+              while (response = client.gets)
+                response = JSON.parse(response)
+
+                case response['msg_type']
+
+                when 'alert'
+                  case response['code']
+                  when 2104
+                    puts 'ALERT: data farm connection resumed   __ignored__'.light_black
+                  when 2108
+                    puts 'ALERT: data farm connection suspended __ignored__'.light_black
+                  when 2109
+                    # Order Event Warning:Attribute 'Outside Regular Trading Hours' is ignored
+                    # based on the order type and destination. PlaceOrder is now being processed.
+                    puts 'ALERT: outside_rth __ignored__'.light_black
+                  when 2100
+                    puts 'ALERT: Account_info unsubscribed __ignored__'.light_black
+                  when 202
+                    puts 'ALERT: order cancelled'
+                  else
+                    puts '-------------ALERT------------------------------'
+                    puts response.to_s
+                    puts '------------------------------------------------'
+                  end
+
+                when 'tick'
+                  @tick_proc&.call(response)
+
+                when 'depth'
+                  @depth_proc&.call(response)
+
+                when 'realtimebar'
+                  @bars_proc&.call(response)
+
+                else
+                  puts "ERROR:       #{response}"
+
+                end
+              end
+            end
+          rescue StandardError => e
+            backtrace = e.backtrace.join("\r\n")
+            puts "======= ERROR: '#{e.class}', MESSAGE: '#{e.message}'\n#{backtrace}"
+          end
+        end
+        puts '@server_thread spawned'
+      end
+    end
+  end
+end
+# rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity