ibind 0.0.2

IBind is a REST and WebSocket client library for Interactive Brokers Client Portal Web API.

This library is currently being beta-tested. See something that's broken? Did we get something wrong? Create an issue and let us know!

IBind is a REST and WebSocket client library for Interactive Brokers Client Portal Web API.

Installation

pip install ibind

Use IBeam along with this library for easier authentication with IBKR.

Documentation

See full IBind documentation.

• Installation
• Basic Concepts
• IBind Configuration
• IbkrClient - REST Python client for IBKR REST API.
• IbkrWsClient - WebSocket Python client for IBKR WebSocket API.
• API Reference

Features:

• REST:
  • Automated question/answer handling
  • Parallel requests
  • Rate limiting
  • Conid unpacking
  • and more
• WebSocket:
  • WebSocket thread lifecycle handling
  • Thread-safe Queue data stream
  • Internal subscription tracking
  • Health monitoring
  • and more

Overview

IBind's core functionality consists of two client classes:

• IbkrClient - for IBKR REST API

  Using the IbkrClient requires constructing it with appropriate arguments, then calling the API methods.

• IbkrWsClient - for IBKR WebSocket API

  Using the IbkrWsClient involves handling three areas:

  • Managing its lifecycle. It is asynchronous and it will run on a separate thread, hence we need to construct it, start it and then manage its lifecycle on the originating thread.
  • Subscribing and unsubscribing. It is subscription-based, hence we need to specify which channels we want to subscribe to and remember to unsubscribe later.
  • Consuming data. It uses a queue system, hence we need to access these queues and consume their data.

Their usage differs substantially. Users are encouraged to familiarise themselves with the IbkrClient class first.

Examples

See all examples.

Basic REST Example

import warnings

from ibind import IbkrClient

# In this example we provide no CAcert, hence we need to silence this warning.
warnings.filterwarnings("ignore", message="Unverified HTTPS request is being made to host 'localhost'")

# Construct the client
client = IbkrClient()

# Call some endpoints
print('\n#### check_health ####')
print(client.check_health())

print('\n\n#### tickle ####')
print(client.tickle().data)

print('\n\n#### get_accounts ####')
print(client.portfolio_accounts().data)

Basic WebSocket Example

from ibind import IbkrWsKey, IbkrClient, IbkrWsClient, ibind_logs_initialize

# Initialise the logger
ibind_logs_initialize(log_to_file=False)

# Construct the clients
client = IbkrClient()
ws_client = IbkrWsClient(ibkr_client=client)

# Start the WebSocket worker thread
ws_client.start()

# Acquire a QueueAccessor for the Orders channel
qa = ws_client.new_queue_accessor(IbkrWsKey.ORDERS)

# Subscribe to the Orders channel
ws_client.subscribe(channel='or', data=None, needs_confirmation=False)

# Wait for new items in the Orders queue.
while True:
  try:
    while not qa.empty():
      print(str(qa), qa.get())

  except KeyboardInterrupt:
    print('KeyboardInterrupt')
    break

# Unsubscribe from the Orders channel and shutdown the client
ws_client.unsubscribe(channel='or', data=None, needs_confirmation=False)

ws_client.shutdown()

Licence

See LICENSE

Disclaimer

IBind is not built, maintained, or endorsed by the Interactive Brokers.

Use at own discretion. IBind and its authors give no guarantee of uninterrupted run of and access to the Interactive Brokers Client Portal Web API. You should prepare for breaks in connectivity to IBKR servers and should not depend on continuous uninterrupted connection and functionality. To partially reduce the potential risk use Paper Account credentials.

IBind is provided on an AS IS and AS AVAILABLE basis without any representation or endorsement made and without warranty of any kind whether express or implied, including but not limited to the implied warranties of satisfactory quality, fitness for a particular purpose, non-infringement, compatibility, security and accuracy. To the extent permitted by law, IBind's authors will not be liable for any indirect or consequential loss or damage whatever (including without limitation loss of business, opportunity, data, profits) arising out of or in connection with the use of IBind. IBind's authors make no warranty that the functionality of IBind will be uninterrupted or error free, that defects will be corrected or that IBind or the server that makes it available are free of viruses or anything else which may be harmful or destructive.

Acknowledgement

IBind has been enriched by incorporating work developed in collaboration with Kinetic and Grant Stenger, which now forms part of the initial open-source release. I appreciate their significant contribution to this community-driven initiative. Cheers Kinetic! 🍻

Built by Voy

Hi! Thanks for checking out and using this library. If you are interested in discussing your project, require mentorship, consider hiring me, or just wanna chat - I'm happy to talk.

You can email me to get in touch: [e-mail]

Or if you'd just want to give something back, I've got a Buy Me A Coffee account:

Thanks and have an awesome day 👋