Installation

Installation

I use homebrew as my package manager on OSX.

IB documentation:

• IB API reference
• http://www.interactivebrokers.com/download/inst/JavaAPIQuickReference.pdf
• http://www.interactivebrokers.com/download/JavaAPIGettingStarted.pdf
• http://www.interactivebrokers.com/download/JavaAPIExamples.zip

Install groovy

Use a 1.8.x maintenance release. Do NOT use the latest groovy version: 2.0.

• http://groovy.codehaus.org/Installing+Groovy
• http://groovy.codehaus.org/Download

Here's my groovy version:

$ groovy -version
Groovy Version: 1.8.6 JVM: 1.6.0_35 Vendor: Apple Inc. OS: Mac OS X

Install gradle

• http://gradle.org/downloads
• http://gradle.org/documentation

Here's my gradle version:

$ gradle --version
------------------------------------------------------------
Gradle 1.0-milestone-9
------------------------------------------------------------

Gradle build time: Tuesday, March 13, 2012 4:10:09 PM UTC
Groovy: 1.8.6
Ant: Apache Ant(TM) version 1.8.2 compiled on December 20 2010
Ivy: 2.2.0
JVM: 1.6.0_35 (Apple Inc. 20.10-b01-428)
OS: Mac OS X 10.7.4 x86_64

Source code

You'll need to install git.

• http://git-scm.com/downloads
• https://github.com/kmcd/hummingbird

Download code from github:

$ git clone git@github.com:kmcd/hummingbird.git 

Run gradle task (sanity check)

$ gradle test 

Start IB gateway

Please follow the instructions to install the IB TWS:

• Gateway: http://www.interactivebrokers.com/en/control/systemstandalone-ibGateway.php?os=unix&ib_entity=llc
• Test client: http://www.interactivebrokers.com/en/p.php?f=programInterface

Login credentials:

• Username: kmcdon370
• Password: d0naupav
• Select IB API api type not FIX CTCI .

N.B. I'm using Mac OSX/Unix, if you're using Windows please use the relevant installation guides from the the IB documentation.

Start IB gateway test client

Please follow the instructions to start the IB TWS test client:

• http://www.interactivebrokers.com/en/control/standalone_api.php?beta=1&os=mac&ib_entity=llc

If you can't connect, ensure you're using the correct port number.

Test request for Historical Data using the QQQ symbol.

Connect to the IB gateway from groovy shell.

See if you can use the gateway code I've written to connect to the IB gateway:

• https://github.com/kmcd/hummingbird/blob/master/src/main/groovy/gateway.groovy

$ groovysh

load /src/main/groovy/gateway.groovy

...