Portfolio & Price Trackers

Ibkr HttpapiREST and MCP Access to Interactive Brokers

A free, open-source REST and MCP bridge to Interactive Brokers for quotes, historical bars and orders. Setup notes, requirements and safety tips.

Free Open source Windows: Unverified v0.5.7 Updated 19 Oct 2026
11 min read Last update 19 Oct 2026 github.com/psyb0t/ibkr-httpapi

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.

02

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.

03

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.

04

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.

05

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.

06

Key features

Contract Details Lookup

Send a request with a market class and a symbol to retrieve the contract details that Interactive Brokers holds for that instrument. This is usually the first call a script makes, because it confirms that a symbol resolves correctly before you request prices or place orders. Catching a wrong contract early prevents errors that are easy to miss in automated code.

Snapshot Quotes with Greeks

A single request returns the current bid, ask and last price for an instrument. For options, the snapshot also includes Greeks, which describe how sensitive an option price is to changes in the underlying asset, volatility and time. That makes the endpoint useful for quick checks inside a larger workflow.

Historical OHLC Bars

Pull historical bars with open, high, low and close values for a chosen symbol. Bars are the standard building block for charting, backtesting simple rules and comparing price ranges across sessions. Requesting history through the same URL pattern as live quotes keeps your code consistent.

Raw Historical Ticks

Retrieve historical raw ticks when bar summaries hide detail you need. Individual ticks show each recorded trade or quote update, which helps when you want to study spreads, gaps or short bursts of activity. Raw data is larger than bars, so plan storage and request limits accordingly.

Bars with Technical Enrichment

A POST endpoint returns historical bars enriched with technical analysis values produced by the wickworks integration. Instead of calculating indicators in a separate step, your script can receive bars and derived measures in one response. This is helpful for dashboards and for bots that need consistent indicator inputs.
07

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.

08

How to install Ibkr Httpapi on Windows

  1. 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. 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. 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. 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. 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.

  6. 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.

09

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
10

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.

  1. Log in to the IB Gateway with your IBKR Pro credentials and confirm that it is connected.
  2. Start the Ibkr Httpapi service, either through the Docker image or your local setup.
  3. Send a GET request to the contract details route for a test symbol to confirm that the instrument resolves.
  4. Request a snapshot for the same symbol to check that bid, ask and last values arrive.
  5. Request historical bars with a short time range to confirm that the history endpoint returns data.
  6. For options, check that the snapshot includes Greeks before using them in a calculation.
  7. Use the POST bars endpoint only after you understand which enrichment values it returns.
  8. Add your own logic gradually, logging each response so you can trace problems later.
11

Pros & cons

Pros
  • 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
Cons
  • 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
12

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.
13

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.

14

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
15

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.

16

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.

Download now