Ibkr Httpapi is a free, open-source Python service that wraps Interactive Brokers in a REST and MCP interface, made for developers and technically minded traders who want to read market data and manage orders from their own scripts or AI tools. It sits in our Portfolio & Price Trackers category, but it works more like a data bridge than a dashboard. Under the hood it uses FastAPI and ibasync to talk to a Linux-native IB Gateway.
The project covers stocks, options, futures, forex, crypto and CFDs, and the latest release is v0.5.7. The codebase has been updated recently, so it is not abandoned. Windows is mentioned in the documentation, but that support has not been verified, so many users will find Docker or a Linux environment the more predictable route. The API is available only with an IBKR Pro account; IBKR Lite accounts have it disabled.
What Is a REST and MCP Bridge for Interactive Brokers?
A bridge sits between your code and a broker's connection layer. Connecting directly to Interactive Brokers typically means handling persistent sessions, contract identifiers and asynchronous messages, which is a lot of plumbing before you write any trading logic. A REST bridge turns those steps into ordinary HTTP requests that any language can make.
MCP, the Model Context Protocol, adds a second way in. It lets AI assistants and agent frameworks discover and call the same functions as tools. A research agent could ask for a snapshot, pull bars and then report back, without you writing a custom client.
The practical benefit is separation. Your strategy code can stay simple and focus on decisions, while the service handles the broker-specific work. If you later change how you run your strategy, the interface your code sees stays the same.
Who Is Ibkr Httpapi For?
The project suits people who already write code and want an Interactive Brokers account to behave like an API. A typical user might be a developer building a personal dashboard that refreshes quotes every few seconds, or a quantitative hobbyist who wants historical bars to test a simple moving average rule in Python.
It also fits teams experimenting with AI agents. Because the service exposes MCP tools, an agent can read market data within limits you define, which is useful for research prototypes. Keep these experiments on a paper or test setup until you understand how the agent behaves.
It is a poor match for people who want a point-and-click interface. There is no chart window or tax report generator in the project. If your goal is to review your holdings visually, a tracker built for that purpose will serve you better, and you can still use this service as a data source for custom views.
How Market Classes Shape Your Requests
Every market type has its own URL prefix, which the project calls the class segment. Requests follow the same shape: a class, a symbol and an action such as contract details, snapshot, bars or ticks. Once you learn the pattern for one asset class, you can apply it to the others with only small changes.
Consider a watchlist script that checks ten instruments every minute. If the stocks, futures and forex pairs all use the same route structure, you can write one loop and pass in different classes and symbols. That reduces bugs and makes the code easier to review.
Options are a special case because snapshot responses include Greeks. A script monitoring a single option contract can read price and sensitivity values in one call, which saves you from calculating them separately. Crypto and CFD prefixes follow the same logic, so the layout does not change when you add a new market to your watchlist.
Key Terms: Bars, Ticks, Greeks and Enrichment
Understanding the vocabulary makes the data easier to use. An OHLC bar records the open, high, low and close for a time interval. The high and low show how far price travelled, and the open and close show where it started and ended. Comparing these values across bars is the basis of most chart-based analysis.
A tick is a single recorded event, such as a trade or a quote update. The bid is the highest price a buyer currently offers, and the ask is the lowest price a seller accepts. The gap between them is the spread, which matters when you estimate the cost of entering or exiting a position.
Greeks are sensitivity measures for options, including delta, gamma, theta and vega. Delta approximates how much an option price moves when the underlying moves by one unit. Technical enrichment adds indicator values to bars, so your code receives derived measures alongside raw prices. Always check the exact definitions in the project documentation before building logic on them.
Key features
Contract Details Lookup
Snapshot Quotes with Greeks
Historical OHLC Bars
Raw Historical Ticks
Bars with Technical Enrichment
Supported coins
The project covers stocks, options, futures, forex, crypto and CFDs as market types. Its documentation mentions Bitcoin (BTC) as an example of a crypto asset you can request, so crypto symbols follow the same URL pattern as other classes.
How to install Ibkr Httpapi on Windows
- 1
Confirm Your Account Type
Before anything else, make sure you have an Interactive Brokers Pro account. The API requires Pro, and IBKR Lite accounts have it disabled. Opening a Pro account and reviewing your brokerage terms should happen before you install any software.
- 2
Download the Release
Download only from the official website or the project's GitHub Releases page at github.com/psyb0t/ibkr-httpapi. Choose the latest version, which is v0.5.7 at the time of writing, and read the release notes for any setup changes.
- 3
Verify the File
If the release lists a SHA-256 checksum or a signature, compare it with your download before running anything. On Windows, open a command prompt in the download folder and run certutil -hashfile followed by the file name and SHA256, then match the output to the published value. Do not run a file whose hash does not match.
- 4
Choose Docker or a Local Setup
The repository includes a Dockerfile.api that builds a multi-stage production image. It runs as a non-root user and installs dependencies from a hash-locked requirements file. Because Windows support is unverified, Docker is the most predictable route for most users, and it keeps the service isolated from your everyday system.
- 5
Start IB Gateway
Run the Interactive Brokers Gateway on a Linux host or inside a Linux environment, then log in with your IBKR Pro credentials. The service connects to the gateway, so the gateway must be running before you start the API. Keep the gateway and the API on the same trusted machine or network.
-
Run a Test Request
Start the service and send a GET request for contract details using a test symbol. If you receive a valid response, try a snapshot request next. Confirm each step before adding strategy logic, so you know which layer is responding.
System requirements
- An Interactive Brokers Pro account with API access; IBKR Lite accounts have the API disabled
- A running Interactive Brokers Gateway, which is Linux-native
- Docker or a Linux host for the most predictable setup
- Windows is documented but not verified, so test thoroughly before relying on it
How to use Ibkr Httpapi
Using Ibkr Httpapi is a matter of starting the gateway, starting the service and sending HTTP requests. The steps below follow the typical order for a first session, and they work the same whether you call the API from a script, a browser tool or an MCP-enabled assistant.
- Log in to the IB Gateway with your IBKR Pro credentials and confirm that it is connected.
- Start the Ibkr Httpapi service, either through the Docker image or your local setup.
- Send a GET request to the contract details route for a test symbol to confirm that the instrument resolves.
- Request a snapshot for the same symbol to check that bid, ask and last values arrive.
- Request historical bars with a short time range to confirm that the history endpoint returns data.
- For options, check that the snapshot includes Greeks before using them in a calculation.
- Use the POST bars endpoint only after you understand which enrichment values it returns.
- Add your own logic gradually, logging each response so you can trace problems later.
Pros & cons
- Free and open source, so you can read the code and adapt it to your needs
- Exposes both REST and MCP interfaces, which suits scripts and AI agent tools
- One consistent URL pattern covers stocks, options, futures, forex, crypto and CFDs
- Includes historical bars and raw ticks for backtesting and analysis
- Options snapshots include Greeks
- Provides a Docker production image with non-root execution and hash-locked dependencies
- Codebase has been updated recently
- Requires an IBKR Pro account; IBKR Lite accounts cannot use the API
- Windows support is documented but not verified
- Depends on running a separate Interactive Brokers Gateway
- Aimed at developers, with no graphical interface for everyday portfolio review
- Version 0.5.7 indicates pre-1.0 software, so expect interface changes between releases
Is Ibkr Httpapi safe?
This program places and manages real orders, so treat it with the same care as any tool that can move money. Download only from the official website or the project's GitHub repository, and verify the SHA-256 checksum or signature before running the program. Never enter a seed phrase on third-party websites, and never give your brokerage password to anyone who offers help through a website or chat.
Keep the service off the public internet, and do not expose its port without authentication and a firewall in front of it. Review the code or the release notes before you grant it access to a live account. Automated orders can execute faster than you expect, so test every new strategy on a paper or test setup first. The project is actively maintained, but check the latest version on the official website before you install.
- Official source only. Download from github.com/psyb0t/ibkr-httpapi. Ignore ads and lookalike domains.
- Check the SHA-256. Compare the installer hash with the value the developer publishes before running it.
- Never share your seed phrase. No developer, support agent or website — including CryptApps — will ever ask for it.
Alternatives
Ibkr Httpapi is a developer tool, not an end-user application. Ticker is a terminal tracker for stocks and crypto, so it suits people who want to monitor prices from a command line without writing code. Rotki is a private, local portfolio and tax tracker that focuses on record keeping rather than broker connections. Raccoin handles crypto portfolio and tax accounting, while Binance Excel Report exports executed Binance orders into a spreadsheet for review.
The main difference is the role each program plays. Ibkr Httpapi is a data and trading interface you build on, whereas the others are finished tools for viewing or reporting. If you want to automate Interactive Brokers workflows, this service is the starting point. If you want to check your holdings or prepare records, one of the trackers will be more direct.
Specifications
- Price
- Free
- Type
- Open source
- License
- —
- Latest version
- v0.5.7
- Last update
- 19 Oct 2026
- Windows support
- Unverified (Windows mentioned in docs)
- Source code
- github.com/psyb0t/ibkr-httpapi
Frequently asked questions
Yes, Ibkr Httpapi is free and open source. The software itself costs nothing to download and run. You still need an Interactive Brokers Pro account to use the API, and your brokerage terms, market data arrangements and any trading costs apply separately.
Windows is mentioned in the project documentation, but that support has not been verified. The interactive brokers gateway it relies on is Linux-native. Many users will find Docker or a Linux environment more predictable, so test the setup carefully before using it with a live account.
The code is open source, which lets you inspect it, and the project is recently updated. Safety depends on how you install and run it. Download from the official source, verify the checksum, keep the service off the public internet and test strategies on a paper account before using real money.
Yes. The API requires an Interactive Brokers Pro account. IBKR Lite accounts have the API disabled, so the service cannot connect to them. Check your account type before installing anything, because switching account types may take time and may involve separate account terms.
Crypto is one of the supported market types, and the documentation mentions Bitcoin (BTC) as an example. Crypto symbols use the same URL pattern as stocks and futures. Check the project documentation and your brokerage's crypto offering to confirm which instruments are available to your account.
Yes. The snapshot endpoint returns bid, ask and last prices, and for options it also includes Greeks. These values help you understand how an option's price may respond to changes in the underlying asset, volatility and time. Verify the definitions in the documentation before building calculations on them.
Ibkr Httpapi gives your code access to broker data and order functions, while a portfolio tracker shows your holdings and performance in a finished interface. Trackers suit reviewing and reporting, and this service suits automation. Many developers use the API as a data source for their own custom views.
Verdict
Ibkr Httpapi suits developers and technically confident traders who want to read Interactive Brokers data and manage orders through REST or MCP. It is free, open source and recently updated, with a consistent URL structure across many market types. It is not a good fit for anyone without an IBKR Pro account or anyone who needs a visual dashboard. Because Windows support is unverified, plan on Docker or Linux, and test every workflow on a paper setup before trusting it with real capital.