Files
Alexandre Catarino 3a39c58f21 Add KOSPI 200 Index (KM) Futures (#9585)
* Add KOSPI 200 Index (KM) Futures support

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* Fix Forex-interactivebrokers formatting and add KRX futures holidays

Expand the compact single-line session arrays in Forex-interactivebrokers-[*]
to the multi-line style used throughout the market-hours database.

Add South Korean (KRX) market-closure holidays (2000-2027) to Future-krx-[*]
and Future-krx-KM, including lunar holidays (Seollal, Buddha's Birthday,
Chuseok), substitute holidays, election-day closures, year-end closures, and
the reinstated Constitution Day (7/17/2026 onward).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* Add USD/KRW forex entry for Interactive Brokers

Enables USD/KRW live trading/pricing through the Interactive Brokers
brokerage.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* Fix KM futures expiry and market hours, add KM index support

- Roll non-quarterly contract months forward to the HMUZ cycle in the
  Kospi200 expiry function, with regression tests covering the cycle
  normalization and holiday walk-backs (2002 election day, Chuseok
  2003 double walk-back, Chuseok 2019)
- Remove holidays duplicated in Future-krx-KM: they are inherited from
  Future-krx-[*] at load time (MarketHoursDatabaseJsonConverter unions
  specific entries with the market wildcard)
- Add missing KRX closures: Constitution Day 2000-2007 (holiday until
  abolished in 2008), 7/1/2002 World Cup temporary holiday and
  1/3/2000 Y2K closure
- Fix KRX derivatives sessions per exchange specs: regular session
  08:45-15:45 (pre-open auction 08:30-08:45) and night session
  18:00-06:00 as extended hours
- Add late opens (09:45) for the first trading day of each year and
  CSAT exam days 2000-2027, which delay the exchange open by one hour
- Add Index-krx market hours entries (09:00-15:30, 10:00 late opens)
  and map the KM index ticker to Market.KRX in IndexSymbol

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-authored-by: Martin Molinero <martin.molinero1@gmail.com>
2026-07-14 16:37:19 -03:00
..
2020-04-28 16:29:54 -03:00

alt tag

LEAN Data Formats / Futures

QuantConnect hosts futures data provided by AlgoSeek. The data contains quotes, trades, and open interest data. You can explore futures data on our website at https://www.quantconnect.com/data/tree/future

The data are stored as compressed ZIP files, each capable of containing a single, or multiple CSV files, depending on the resolution requested.

Futures data can be used with the following Resolutions:

  • Tick
  • Second
  • Minute

The markets we currently support are:

  • CBOT
  • CME
  • NYMEX
  • COMEX
  • CBOE
  • ICE

tickType in this documentation can refer to one of the following:

  • trade
  • quote
  • openinterest

Minute and Second File Format

Second/Minute files are located in the future / market / resolution / symbol folder. The zip file contains multiple csv entries, varying by the symbol's expiration date.

The zip files have the filename format: YYYYMMDD_tickType.zip. The CSV file contained within has the filename: YYYYMMDD_symbol_resolution_tickType_symbolExpirationDate.csv

Second/Minute trade schema and example data is as follows:

Time Open High Low Close Volume
63271000 85.22 85.24 85.21 85.24 126
  • Time - Milliseconds since midnight
  • Open - Opening price
  • High - High price
  • Low - Low price
  • Close - Closing price
  • Volume - Total contracts traded

Second/Minute quote schema and example data is as follows:

Time Bid Open Bid High Bid Low Bid Close Last Bid Size Ask Open Ask High Ask Low Ask Close Last Ask Size
10920000 1666.5 1666.5 1666.25 1666.25 47 1666.75 1666.75 1666.5 1666.5 37
  • Time - Milliseconds since midnight
  • Bid Open - Opening price for the best bid
  • Bid High - Highest recorded bid price
  • Bid Low - Lowest recorded bid price
  • Bid Close - Closing price for the best bid
  • Last Bid Size - Size of best bid at close
  • Ask Open - Opening price for the best ask
  • Ask High - Highest recorded ask price
  • Ask Low - Lowest recorded ask price
  • Ask Close - Closing price for the best ask
  • Last Ask Size - Size of best ask at close

Second/Minute open interest schema and example data is as follows:

Time Open Interest
42660000 2693575
  • Time - Milliseconds since midnight
  • Open Interest - outstanding contracts

Hour and Daily File Format

Hour/Daily files are located in the future / market / resolution folder. The zip file contains only a single entry.

The zip files have the filename format: symbol_tickType.zip. The CSV file contained within has the filename format: symbol_tickType_symbolExpirationDate.csv

Hour/Daily trades schema and example data is as follows:

Time Open High Low Close Volume
20160601 00:00 43.20 43.50 43.10 43.45 513
  • Time - Formatted as YYYYMMDD HH:mm
  • Open - Opening price
  • High - High price
  • Low - Low price
  • Close - Closing price
  • Volume - Total contracts traded

Hour/Daily quote schema and example data is as follows:

Time Bid Open Bid High Bid Low Bid Close Last Bid Size Ask Open Ask High Ask Low Ask Close Last Ask Size
20170719 00:00 583.20 583.40 583.10 583.40 2932 583.21 583.50 583.11 583.44 392

Hour/Daily open interest schema and example data is as follows:

Time Open Interest
20190203 00:00 3902
  • Time - Formatted as YYYYMMDD HH:mm
  • Open Interest - outstanding contracts

Tick File Format

Tick data is stored in the future / market / tick / symbol folder. The zip file contains multiple csv entries, varying by the symbol's expiration date.

The zip files have the filename format: YYYYMMDD_tickType.zip. The CSV files contained within have the filename format: YYYYMMDD_symbol_tick_tickType_symbolExpirationDate.csv

Tick trades schema and example data is as follows:

Time Last Price Quantity Exchange Sale Condition Suspicious
939243 402.01 203 usa null 0
  • Time - Milliseconds since midnight
  • Last Price - Last traded price
  • Quantity - Amount traded
  • Exchange - Where transaction took place
  • Sale Condition - always null, not used
  • Suspicious - Not used, will always be "0"