IEX Trading open source API wrapper
Clone or download

IEXTrading4j: Open source IEX Trading API library

Build Status codecov Quality Gate Maven Central

Table of Contents

Quick Start

Java SE 8 is required to use IEXTrading4j library.




dependencies {
	compile 'pl.zankowski:iextrading4j-all:2.3.0'

Library is up to IEX Trading API version [1.24] - 09.11.2018

Supported versions: Java SE 8, Java SE 9, Java SE 10, Java SE 11


IEXTrading4j library allows to receive all data available in API provided by IEXTrading company. They allow to use their market data completly for free, so go and try it out!

Data & API description:

Unofficial library listed on IEXTrading

IEX Trading

IEX A Fair, Simple, Transparent Exchange.

IEX is a stock exchange based in the United States. Started by Brad Katsuyama, it opened for trading on October 25, 2013. The company’s offices are located at 4 World Trade Center in New York City. The matching engine is located across the Hudson River in Weehawken, New Jersey, and the initial point of presence is located in a data center in Secaucus, New Jersey. IEX's main innovation is a 38-mile coil of optical fiber placed in front of its trading engine. This 350 microsecond delay adds a round-trip delay of 0.0007 seconds and is designed to negate the certain speed advantages utilized by some high-frequency traders.

IEX was created in response to questionable trading practices that had become widely used across traditional public Wall Street exchanges as well as dark pools and other alternative trading systems. The IEX exchange aims to attract investors by promising to "play fair" by operating in a transparent and straightforward manner, while also helping to level the playing field for traders. Strategies to achieve those goals include:

  • Publishing the matching rules used in the exchanges's computerized order matching engine.
  • Offering a limited number of simple and familiar order types.
  • Charging fixed fees on most orders (or a flat percentage rate on small orders).
  • Ensuring market pricing data arrives at external points of presence simultaneously.
  • Slightly delaying market pricing data to all customers (no colocation).
  • Refusing to pay for order flow.

Check out their beautiful site: IEX Trading

How to

Synchronous requests

To build request use classes that extend IRestRequestBuilder interface. Example request:

final IEXTradingClient iexTradingClient = IEXTradingClient.create();
final Quote quote = iexTradingClient.executeRequest(new QuoteRequestBuilder()

Batch synchronous request

Instead of creating multiple requests, some data can accessed in single Batch:

final IEXTradingClient iexTradingClient = IEXTradingClient.create();
final BatchStocks batchStocks = iexTradingClient.executeRequest(new BatchStocksRequestBuilder()

Asynchronous requests

To build request use classes that extend IAsyncRequestBuilder interface. Example request:

final IEXTradingClient iexTradingClient = IEXTradingClient.create();

final Consumer<TOPS> TOPS_CONSUMER = System.out::println;
final SocketRequest<TOPS> request = new TopsAsyncRequestBuilder()
iexTradingClient.subscribe(request, TOPS_CONSUMER);

DEEP asynchronous request

To get multiple data almost in real-time using socket technology you can use DEEP request with multiple channels:

final IEXTradingClient iexTradingClient = IEXTradingClient.create();

final Consumer<DeepAsyncResponse<DeepResult>> DEEP_ASYNC_RESPONSE_CONSUMER = System.out::println;
final SocketRequest<DeepAsyncResponse<DeepResult>> request = new DeepAsyncRequestBuilder()

iexTradingClient.subscribe(request, DEEP_ASYNC_RESPONSE_CONSUMER);


Please visit Wiki to get more information.


Code and documentation released under the Apache License, Version 2.0

Data provided for free by IEX.

IEX Trading API Exhibit A: Exhibit A


IEXTrading4j HIST

IEX Trading allows users to receive their market data completly for free. Their data can be accessed in real-time during market session or can be downloaded as recorded sessions in PCAP data format. Market Data is transported in binary format and can be read according to specification shared on their site.

This library allows you to transform binary packets into human readable Market Data events in Java.

More on this topic can found here: IEX Trading Market Data

IEXTrading4j BOOK

IEXTrading4j Book library allows to build incremental Order Book based on PriceLevelUpdateMessages from DEEP market data stream. OrderBook implementation follows description from specification.

IEXTrading4j FIX

IEXTrading4j FIX project provides open source FIX dictionary that follows IEX FIX specification. It allows to easily integrate your systems with IEX FIX connectivity using libraries like QuickFIX or QuickFIX/J.