Skip to main content

Python sync/async framework for Interactive Brokers API

Project description

Join the user group PyPi


The ib_insync package is build on top of the Python API from Interactive Brokers. The objective is to make it as easy as possible to use the API to its fullest extent.

The main features are:

  • An IB component that automatically keeps in sync;
  • An easy to use linear style of programming (no more callbacks);
  • A fully asynchonous framework based on asyncio for advanced users;
  • Interactive operation with live data in Jupyter notebooks.


pip3 install -U ib_insync


  • Python version 3.6 or higher;
  • The Interactive Brokers Python API version 9.73.06 or higher. If using Python 3.7, then comment out line 60 of ibapi/ that reads self.async = False.
  • A running TWS or IB gateway application (version 969 or higher). Make sure the API port is enabled and ‘Download open orders on connection’ is checked.

To install packages needed for the examples and notebooks:

pip3 install -U jupyter numpy pandas


This is a complete script to download historical data:

from ib_insync import *
# util.startLoop()  # uncomment this line when in a notebook

ib = IB()
ib.connect('', 7497, clientId=1)

contract = Forex('EURUSD')
bars = ib.reqHistoricalData(contract, endDateTime='', durationStr='30 D',
        barSizeSetting='1 hour', whatToShow='MIDPOINT', useRTH=True)

# convert to pandas dataframe:
df = util.df(bars)
print(df[['date', 'open', 'high', 'low', 'close']])


                   date      open      high       low     close
0   2017-08-13 23:15:00  1.182850  1.183100  1.182100  1.182400
1   2017-08-14 00:00:00  1.182400  1.182450  1.181875  1.182175
2   2017-08-14 01:00:00  1.182175  1.182675  1.181900  1.182525
719 2017-09-22 22:00:00  1.194425  1.195425  1.194225  1.195050

Be sure to take a look at the notebooks and the recipes too.


The complete API documentation.



The insync user group is the place to discuss IB-insync and anything related to it.


The software is provided on the conditions of the simplified BSD license.

This project is not affiliated with Interactive Brokers Group, Inc.’s.

Good luck and enjoy,

author:Ewald de Wit <>

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
ib_insync-0.9.35-py3-none-any.whl (51.3 kB) Copy SHA256 hash SHA256 Wheel py3
ib_insync-0.9.35.tar.gz (48.4 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page