ib-api 10.33.4 → 972.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5d9a4c216502efb44ea4f2623804809e053f1ba64b86f46aa36bde860a9ade25
-  data.tar.gz: 1afd8025c476db5dd8db0aaf266888bd3ee56594a7cf530d8adc739d3095305a
+  metadata.gz: 542bca5318150ae448c4b7578abd64beec70e5b35760eea8abfd22c28f5da1fd
+  data.tar.gz: cb68b0afa4812eb224936f5269be2f6d6c825ea5f9bd21b25c1c9dfe21b70777
 SHA512:
-  metadata.gz: 76cd2898733774d607d2e57ecb6dbf68b9e4edbc3c79f3daaa9648188c93f77157048a03709cd49c633c32cd545d318ce97c482da6cabc942a6425e833d91c2a
-  data.tar.gz: 23046dad3ed7332c14d8a3135d5047dd2cbe5fb8b0d157fadfd3dda87131e4188366b5d361508776815ea95e8be6e8d6706e4b38121ef21d3bf2a3af5e8c2da5
+  metadata.gz: 96bac41a8432c7175dcba4fa38548db4af966d370fc8e12570c4cfd28f89284afb3188ad50d1131859861cc40d414515772cece8bed147093de04aaaf3e6b2c5
+  data.tar.gz: 57c186381a3da9eb7e2169d588ca99440c24993a41905ca9828c4490471a229d1e078739b34f58e666fffb7d4031bba0dfcae4a48e987667ce6d0d65246a66be

data/.gitignore

@@ -1,7 +1,5 @@
 *.gem
 *.rbc
-*.swp
-*.swo
 /.config
 /coverage/
 /InstalledFiles

data/Gemfile

@@ -5,13 +5,12 @@ git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
 # Specify your gem's dependencies in api.gemspec
 gemspec
 
-# gem 'value_semantics'																	# models, future plans
-
+gem 'value_semantics'																	# models
+gem 'ox',  git: 'https://github.com/ohler55/ox.git'   # xml handling  used for news and flex
 
 
 gem 'rspec'
 gem 'rspec-its'
-gem 'rspec-given'
 gem 'rspec-collection_matchers'
 gem 'guard'
 gem 'guard-rspec'

data/Gemfile.lock

@@ -1,47 +1,39 @@
+GIT
+  remote: https://github.com/ohler55/ox.git
+  revision: 67ce6ecb45a0d1354e1f8ed9a155826ba986e21e
+  specs:
+    ox (2.13.4)
+
 PATH
   remote: .
   specs:
-    ib-api (10.33.1)
+    ib-api (972.0)
       activemodel
       activesupport (>= 6.0)
-      ox
-      terminal-table
-      workflow (~> 3.1)
-      zeitwerk
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activemodel (7.1.3.4)
-      activesupport (= 7.1.3.4)
-    activesupport (7.1.3.4)
-      base64
-      bigdecimal
+    activemodel (6.0.3.4)
+      activesupport (= 6.0.3.4)
+    activesupport (6.0.3.4)
       concurrent-ruby (~> 1.0, >= 1.0.2)
-      connection_pool (>= 2.2.5)
-      drb
-      i18n (>= 1.6, < 2)
-      minitest (>= 5.1)
-      mutex_m
-      tzinfo (~> 2.0)
-    base64 (0.2.0)
-    bigdecimal (3.1.8)
+      i18n (>= 0.7, < 2)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+      zeitwerk (~> 2.2, >= 2.2.2)
     coderay (1.1.3)
-    concurrent-ruby (1.3.3)
-    connection_pool (2.4.1)
-    diff-lcs (1.5.1)
-    drb (2.2.1)
-    ffi (1.17.3-x86_64-linux-gnu)
-    formatador (1.1.0)
-    given_core (3.8.2)
-      sorcerer (>= 0.3.7)
-    guard (2.18.1)
+    concurrent-ruby (1.1.7)
+    diff-lcs (1.4.4)
+    ffi (1.13.1)
+    formatador (0.2.5)
+    guard (2.16.2)
       formatador (>= 0.2.4)
       listen (>= 2.7, < 4.0)
       lumberjack (>= 1.0.12, < 2.0)
       nenv (~> 0.1)
       notiffany (~> 0.0)
-      pry (>= 0.13.0)
+      pry (>= 0.9.12)
       shellany (~> 0.0)
       thor (>= 0.18.1)
     guard-compat (1.2.1)
@@ -49,72 +41,65 @@ GEM
       guard (~> 2.1)
       guard-compat (~> 1.1)
       rspec (>= 2.99.0, < 4.0)
-    i18n (1.14.5)
+    i18n (1.8.5)
       concurrent-ruby (~> 1.0)
-    listen (3.9.0)
+    listen (3.2.1)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
-    lumberjack (1.2.10)
-    method_source (1.1.0)
-    minitest (5.24.1)
-    mutex_m (0.2.0)
+    lumberjack (1.2.8)
+    method_source (1.0.0)
+    minitest (5.14.2)
     nenv (0.3.0)
     notiffany (0.1.3)
       nenv (~> 0.1)
       shellany (~> 0.0)
-    ox (2.14.18)
-    pry (0.14.2)
+    pry (0.13.1)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    rake (13.2.1)
-    rb-fsevent (0.11.2)
-    rb-inotify (0.11.1)
+    rake (13.0.1)
+    rb-fsevent (0.10.4)
+    rb-inotify (0.10.1)
       ffi (~> 1.0)
-    rspec (3.13.0)
-      rspec-core (~> 3.13.0)
-      rspec-expectations (~> 3.13.0)
-      rspec-mocks (~> 3.13.0)
-    rspec-collection_matchers (1.2.1)
+    rspec (3.9.0)
+      rspec-core (~> 3.9.0)
+      rspec-expectations (~> 3.9.0)
+      rspec-mocks (~> 3.9.0)
+    rspec-collection_matchers (1.2.0)
       rspec-expectations (>= 2.99.0.beta1)
-    rspec-core (3.13.0)
-      rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.1)
+    rspec-core (3.9.3)
+      rspec-support (~> 3.9.3)
+    rspec-expectations (3.9.2)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-given (3.8.2)
-      given_core (= 3.8.2)
-      rspec (>= 2.14.0)
+      rspec-support (~> 3.9.0)
     rspec-its (1.3.0)
       rspec-core (>= 3.0.0)
       rspec-expectations (>= 3.0.0)
-    rspec-mocks (3.13.1)
+    rspec-mocks (3.9.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-support (3.13.1)
+      rspec-support (~> 3.9.0)
+    rspec-support (3.9.3)
     shellany (0.0.1)
-    sorcerer (2.0.1)
-    terminal-table (3.0.2)
-      unicode-display_width (>= 1.1.1, < 3)
-    thor (1.3.1)
-    tzinfo (2.0.6)
-      concurrent-ruby (~> 1.0)
-    unicode-display_width (2.5.0)
-    workflow (3.1.1)
-    zeitwerk (2.6.16)
+    thor (1.0.1)
+    thread_safe (0.3.6)
+    tzinfo (1.2.7)
+      thread_safe (~> 0.1)
+    value_semantics (3.6.0)
+    zeitwerk (2.4.0)
 
 PLATFORMS
-  x86_64-linux
+  ruby
 
 DEPENDENCIES
-  bundler
+  bundler (~> 1.17)
   guard
   guard-rspec
   ib-api!
+  ox!
   rake (~> 13.0)
   rspec
   rspec-collection_matchers
-  rspec-given
   rspec-its
+  value_semantics
 
 BUNDLED WITH
-   2.4.6
+   1.17.3

data/README.md

@@ -1,39 +1,22 @@
 # ib-api
 Ruby interface to Interactive Brokers' TWS API 
 
-Reimplementation of ib-ruby
+Reimplementation of the basic functions of ib-ruby
 
----
-__VERSION 10__
-
-You have to switch from "require 'ib-extentions', 'ib-symbols'," etc.  to "activate_plugin :name"
----
-
-**Whats new**
-
-*    Zeitwerk integration.  
-*    Plugin's to ease automations
----
-
-__Documentation: [https://ib-ruby.github.io/ib-doc/](https://ib-ruby.github.io/ib-doc/)__
 
 ----
-`ib-api`   offers a modular access to the TWS-API-Interface of Interactive Brokers.
+`ib-ruby`   offers a modular access to the TWS-API-Interface of Interactive Brokers.
 
-----
+`ib-api`    provides a simple interface to low-level TWS API-calls.  
 
-Install in the usual way
+----
 
-```
-$ gem install ib-api
-```
+In its plain vanilla usage, it just exchanges messages with the TWS. The user is responsible for any further data processing.
 
-In its plain vanilla usage, it just exchanges messages with the TWS. Any response is stored in the `received-array`.
 
-It needs just a few lines of code to place an order
+Even then, it needs just a few lines of code to place an order
 
 ```ruby
-require 'ib-api'
 # connect with default parameters 
 ib =  IB::Connection.new 
 
@@ -56,44 +39,9 @@ puts ib.recieved[:OrderStatus].to_human
 # => ["<OrderState: Submitted #17/1528367295 from 2000 filled 0.0/100.0 at 0.0/0.0 why_held >"]
 
 ```
-
-## Plugins
-
-**IB-API** ships with simple plugins to facilitate automations 
-
-```ruby
-require 'ib-api'
-# connect with default parameters 
-ib =  IB::Connection.new do | c |
-  c.activate_plugin "verify"
-end
-
-g =  IB::Stock.new symbol: 'GE'
-puts g.verify.first.attributes
-{:symbol=>"GE", :sec_type=>"STK", :last_trading_day=>"", :strike=>0.0, :right=>"", :exchange=>"SMART", :currency=>"USD", :local_symbol=>"GE", :trading_class=>"GE", :con_id=>498843743, :multiplier=>0, :primary_exchange=>"NYSE", }
-```
-
-Currently implemented plugins
-
-* connection-tools: ensure that a connection is established and active
-* verify:  get contract details from the tws
-* symbols: use predefined symbols 
-* managed-accounts: fetch and organize account- and portfoliovalues
-* advanced-account: perform account-based previewing, opening, modifying and closing of Positions
-* process-orders: account-based bookkeeping of orders
-* auto-adjust: properly adjust the orderprice to the next valid min-tick of the contract
-* market-price: fetch the current market-price of a contract
-* eod:  retrieve EOD-Data for the given contract
-* greeks: read current option greeks
-* roll: easy rolling of futures and options
-* option-chain: build option-chains for given strikes and expiries 
-* spread-prototypes:  create limit, stop, market, etc. orders through prototypes
-* probability-of-expiring: calculate the probability of expiring for the option-contract
-
-
 ## Minimal TWS-Version
 
-`ib-api` is tested via the _stable IB-Gateway_ (Version 10.33) and should work with any current tws-installation. 
+`ib-api` is tested via the _stable ib-Gateway_ (Version 9.72) 
 
 ## Tests
 
@@ -110,7 +58,7 @@ You have to edit `spec/spec.yml` and replace the `:account`-Setting with your ow
 
 ## Contributing
 
-Bug reports and pull requests are welcome. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/ib-api. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
 
 ## Code of Conduct
 

data/VERSION

@@ -1 +1 @@
-10.33.4
+972.0

data/api.gemspec

@@ -8,12 +8,10 @@ Gem::Specification.new do |spec|
   spec.version       = IB::VERSION
   spec.authors       = ["Hartmut Bischoff"]
   spec.email         = ["topofocus@gmail.com"]
-  spec.license       = "MIT"
 
   spec.summary       = %q{Ruby Implementation of the Interactive Brokers TWS API}
   spec.description   = %q{Ruby Implementation of the Interactive Brokers TWS API}
   spec.homepage      = "https://github.com/ib-ruby"
-  spec.required_ruby_version = ">= 3.0"
 
   # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
   # to allow pushing to a single host or delete this section to allow pushing to any host.
@@ -37,14 +35,9 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "bundler", "~> 2.0"
+  spec.add_development_dependency "bundler", "~> 1.17"
   spec.add_development_dependency "rake", "~> 13.0"
   spec.add_development_dependency "rspec", "~> 3.0"
-  spec.add_dependency 'activesupport', '~> 7.0'
-  spec.add_dependency 'activemodel', '~> 7.0'
-  spec.add_dependency 'ox', '~> 2.14'
-  spec.add_dependency 'terminal-table', '~> 3.0'
-  spec.add_dependency 'zeitwerk', '~> 2.6'
-  spec.add_dependency 'workflow', '~> 3.1'
-
+	spec.add_dependency 'activesupport', '>= 6.0'
+	spec.add_dependency 'activemodel'
 end

data/bin/console

@@ -1,5 +1,5 @@
 #!/usr/bin/env ruby
-### loads the active-orient environment
+### loads the active-orient environment 
 ### and starts an interactive shell
 ###
 ### Parameter: t)ws | g)ateway (or number of port ) Default: Gateway ,
@@ -10,6 +10,8 @@
 require 'bundler/setup'
 require 'yaml'
 
+require 'logger'
+
 require 'ib-api'
 
 class Array
@@ -17,9 +19,9 @@ class Array
   # i.e
   #
   #  2.5.0 :006 > C.received[:OpenOrder].local_id
-  #   => [16, 17, 21, 20, 19, 8, 7]
+  #   => [16, 17, 21, 20, 19, 8, 7] 
   #   2.5.0 :007 > C.received[:OpenOrder].contract.to_human
-  #    => ["<Bag: IECombo SMART USD legs:  >", "<Stock: GE USD>", "<Stock: GE USD>", "<Stock: GE USD>", "<Stock: GE USD>", "<Stock: WFC USD>", "<Stock: WFC USD>"]
+  #    => ["<Bag: IECombo SMART USD legs:  >", "<Stock: GE USD>", "<Stock: GE USD>", "<Stock: GE USD>", "<Stock: GE USD>", "<Stock: WFC USD>", "<Stock: WFC USD>"] 
   #
   # its included only in the console, for inspection purposes
 
@@ -31,66 +33,63 @@ class Array
   end
 end # Array
 
-class Object
-  def inspect
-    respond_to?(:to_human) ? to_human : super
-  end
-end
 
-# read items from console.yml
-  read_yml = -> (key) do
+# read items from console.yml 
+read_yml = -> (key) do
 		YAML::load_file( File.expand_path('../console.yml',__FILE__))[key]
 	end
 
-  puts
-  puts ">> IB-API Interactive Console <<"
+
+  puts 
+  puts ">> IB-Core Interactive Console <<" 
   puts '-'* 45
-  puts
+  puts 
   puts "Namespace is IB ! "
   puts
   puts '-'* 45
+	include LogDev
   include IB
   require 'irb'
   client_id = ARGV[1] || read_yml[:client_id]
-  specified_host = ARGV[0] || 'Gateway'
-	host =  case specified_host
+  specified_port = ARGV[0] || 'Gateway'
+	port =  case specified_port
+					when Integer
+						specified_port  # just use the number
 					when /^[gG]/ 
 						read_yml[:gateway]
 					when /^[Tt]/
 						read_yml[:tws]
-          else
-            raise "Specify target from console.yml: `g|t` instead of #{specified_host}"
 					end
-  ARGV.clear
 
-  C =  Connection.new  client_id: client_id, host: host
-  C.logger.level = Logger::WARN
-
-  C.subscribe(:Alert){ |m| puts "A: "+ m.message }
-  C.subscribe(:AccountUpdateTime){  }
+  ARGV.clear
+  logger = default_logger #  Logger.new  STDOUT
+	
+  ## The Block takes instructions which are executed  after initializing all instance-variables
+  ## and prior to the connection-process
+  ## Here we just subscribe to some events  
+  C =  Connection.new  client_id: client_id, port: port  do |c|  # future use__ , optional_capacities: "+PACEAPI"  do |c|
 
-  C.received = true
-  C.activate_plugin :connection_tools, :symbols, :market_price,
-                    "order-prototypes", "spread-prototypes",
-                    "advanced_account", 'process_orders'
-  C.logger.level = Logger::INFO
-  puts C.workflow_state
-  C.get_account_data
-  C.request_open_orders
-  C.logger.level = Logger::ERROR
-  puts  "Connection established on  #{host}"
+    c.subscribe( :ContractData, :BondContractData) { |msg| logger.info { msg.contract.to_human } }
+    c.subscribe( :Alert, :ContractDataEnd, :ManagedAccounts, :OrderStatus ) {| m| logger.info { m.to_human } }
+    c.subscribe( :PortfolioValue, :AccountValue, :OrderStatus, :OpenOrderEnd, :ExecutionData ) {| m| logger.info { m.to_human }}
+#    c.subscribe :ManagedAccounts do  |msg|
+#        puts "------------------------------- Managed Accounts ----------------------------------"
+#				puts "Detected Accounts: #{msg.accounts.account.join(' -- ')} " 
+#				puts
+#    end
 
+    c.subscribe( :OpenOrder){ |msg|  "Open Order detected and stored: C.received[:OpenOrders] " }
+		c.logger.level = Logger::INFO 
+	end 
   unless  C.received[:OpenOrder].blank?
-        puts "---------------------------------------- OpenOrders -------------------------------------------"
-        puts C.clients.map{ |c| c.orders.map &:to_human }.flatten.join("\n")
+        puts "------------------------------- OpenOrders ----------------------------------"
+    puts C.received[:OpenOrder].to_human.join "\n"
   end
-  puts ""
-  puts  Terminal::Table.new title: 'Active Plugins',
-                             rows: C.plugins.delete_if{ |x| x =~ /\// }.sort.each_slice(4),
-                            style: { border: :unicode  }
+  puts  "Connection established on Port  #{port}, client_id #{client_id} used"
   puts
   puts  "----> C    points to the connection-instance"
   puts
+  puts  "some basic Messages are subscribed and accordingly displayed"
   puts '-'* 45
 
   IRB.start(__FILE__)

data/bin/console.yml

@@ -1,3 +1,3 @@
-:gateway:  "localhost:4002"
-:tws: "tws:7496"
+:gateway:  4002
+:tws: 7496
 :client_id: 2000

data/changelog.md

@@ -5,28 +5,3 @@ Changelog
 |=++++   |=++++++++++++ |
 | 30.8.2020 | migrating lib-files from ib-ruby-project |
 
-| 28.11.2020| separating lib/model and lib/models to enable extension with
-              ActiveRecord/Rails and OrientDB/ActiveOrient. |
-|           | Introducing a Database-Switch in /lib/requires to omit 
-              loading of model- and messages files. This has to be done 
-							manually after assigning the database-model framework. |
-
-| 1.12.2020 | moving model/ib/spread.rb from `ib-extensions` to `ib-api`.|
-| 1.12.2020 | creating a dummy Contract#verify to guaranty safe operation of spreads |
-
-|           | Preparation of a Gem-Release  |
-| 23.2.2021 | Fixed retrieving of ContractDetail requests of Options with strikes < 1 
-|           | Gem Release                   |
-
-|  1.4.2024 | Proper monkey patching of classes through class_extensions (Prepare for Zeitwerk, V10)
-|  2.4.2024 | Renaming of IBSupport and IBSocket to IB::Support and IB::Socket (Prepare for Zeitwerk, V10)
-|  4.4.2024 | Apply Zeitwerk, V10
-              Put `model` to the root directory (the files are then easily fetched through zeitwerk)
-              Reorganizing Messages. One message class per file. Keeping general incoming and outgoing-files
-|  1.1.2025 | introducing plugins 
-|           | using a state machine to organize access to advanced featurs
-
-|  7.5.2025 | Disabled verify buffer size to enable receiving historical datastreams
-|           | Removed contract#verify! in favour of #contract.verify 
-
-

data/example/README.md

@@ -0,0 +1,76 @@
+## IB-RUBY EXAMPLES:
+
+This folder contains sample scripts that demonstrate common ib-ruby use cases.
+The scripts show you how to access account info, print real time quotes, retrieve
+historic or fundamental data, request options calculations, place, list, and cancel orders.
+You may also want to look into `spec/integration` directory for more scenarios,
+use cases and examples of handling IB messages.
+
+Normally you run these examples like this:
+
+    $ ruby example/list_orders
+
+The examples are executable.
+If you're on Unix-like platform, they can be called directly ( » ./{script} «)
+
+The Examples assume a running Gateway-Application on Localhost. Please use a Demo-Account or run
+the API in »read-only-mode«
+
+## EXAMPLE DESCRIPTION:
+
+*account_info* - Request your account info, current positions, portfolio values and so on
+
+    $ ruby example/account_info   # or cd example; ./account_info
+
+For Financial Advisors, you need to add the managed account you want info for:
+
+    $ ruby example/account_info U123456
+
+*cancel_orders*  - Cancel either all open orders, or specific order(s),  by their (local) ids. Examples:
+
+    $ ruby example/cancel_orders
+    $ ruby example/cancel_orders 492 495
+
+*contract_details* - Obtain detailed descriptions for specific Stock, Option, Forex, Futures and Bond contracts.
+
+*contract_sample details* - Define Contract samples provided by java and python API-implementations
+
+*depth_of_market* - Receive a stream of MarketDepth change events for Stock, Forex and Future symbols.
+
+*fa_accounts* - Get info about accounts under management (for Financial Advisors).
+
+*flex_query* - Run a pre-defined Flex query, receive and print Flex report. Example:
+
+    $ ruby example/flex_query 12345 # Flex query id pre-defined in Account Management
+
+*fundamental_data* - Request and print fundamental data report for a specific stock.
+
+*historic_data* - Receive 5 days of 1-hour trade data for Stock, Forex and Future symbols.
+
+*historic_data_cli* - CLI script for historic data downloading. It has many options, for detailed help run:
+
+    $ ruby example/historic_data_cli
+
+*list_orders* - List all open API orders.
+
+*market_data* - Receive a stream of trade events for multiple Forex symbols.
+
+*option_data* - Receive a stream of underlying, price and greeks calculations for multiple Option symbols.
+
+*place_braket_order* - Place a braket order for Stock.
+
+*place_combo_order* - Place an Option combo order (Google butterfly).
+
+*place_order* - Place a simple limit order to buy Stock.
+
+*portfolio_csv* - Exports your IB portfolio in a CSV format. Usage:
+
+    $ ruby example/portfolio_csv [account] > my_portfolio.csv
+
+*real_time_data* - Subscribe to real time data for specific symbol.
+
+*template* - A blank example to start a new script (setting up all the dependencies).
+
+*tick_data* - Subscribe to extended tick types for a single stock symbol.
+
+*time_and_sales* - Print out Time&Sales format for Futures symbols.

data/example/account_info

@@ -0,0 +1,54 @@
+#!/usr/bin/env ruby
+#
+# This script connects to IB API, subscribes to account info and prints out
+# messages received from IB (update every 3 minute or so)
+
+require 'bundler/setup'
+require 'ib-api'
+
+# Only for Advisor accounts: you can provide account_code such as U666777  (otherwise the last account is used)
+account_code = ARGV[0] || ''
+
+include IB
+# Connect to IB TWS
+accounts =  []
+ib = Connection.new client_id: 1113, port: 4002 do | gw |  # :port => 7497 # TWS
+
+	# Subscribe to TWS alerts/errors and account-related messages
+	# that TWS sends in response to account data request
+	gw.subscribe(:Alert) do |msg|
+			## if an account is not given. but required, (Error 321 indicates this) 
+			## fetch data from the last account detected. (The first is most probably the Advisor-Account)
+											if  msg.code == 321
+												gw.send_message :RequestAccountData, :subscribe => true, :account_code => accounts.last
+											else
+												puts msg.to_human
+											end
+								end
+	
+	## Print Account+Portfolio-Values
+	gw.subscribe(:AccountValue,
+		     :PortfolioValue, :AccountUpdateTime) { |msg| puts msg.to_human }
+
+	## Just in case: put account-names into accounts-array
+	gw.subscribe(:ManagedAccounts){  |msg| accounts = msg.accounts_list.split ',' }
+
+	# Set log level
+	gw.logger.level = Logger::FATAL # DEBUG #FATAL
+end
+
+ib.send_message :RequestAccountData, :subscribe => true, :account_code => account_code
+
+puts "\nSubscribing to IB account data"
+
+## print message after recieving account-data
+Thread.new do 
+	sleep 3
+	puts "\n******** Press <Enter> to quit *********\n\n"
+end
+
+STDIN.gets
+puts "Cancelling account data subscription.."
+
+ib.send_message :RequestAccountData, :subscribe => false
+sleep 2

data/example/account_positions

@@ -0,0 +1,30 @@
+#!/usr/bin/env ruby
+#
+# This script connects to IB API and subscribes to  Position Values which are updated regulary
+
+require 'bundler/setup'
+require 'ib-api'
+
+
+# connect to IB TWS.
+
+
+ib = IB::Connection.new( :client_id => 1110) do | gw | #, :port => 7496 # TWS) 
+## Subcribe to forseable events before the connection is completed
+## Subscribe to TWS alerts/errors
+  gw.subscribe(:Alert, :PositionData){ |msg| puts msg.to_human }
+	gw.logger.level = Logger::FATAL # DEBUG  -- INFO -- WARN -- ERROR  -- FATAL
+end
+
+ Thread.new do 
+	sleep 1
+	puts "\n******** Press <Enter> to quit *********\n\n"
+ end
+# request the  AccountSummary
+  ib.send_message :RequestPositions
+
+STDIN.gets
+ puts "\n *** canceling Reqest ..." 
+		ib.send_message :CancelPositions
+sleep 1
+puts "done."