Data Format

Futures

Introduction

Futures data has trade, quote, and open interest data. The files store the actual prices. The data time zone depends on the market. For example, the data time zone of the cme and comex markets is UTC.

Folder Structure

The following table shows the paths of the Futures data files:

ResolutionZip FileCSV File
Tick, second, and minutefuture / <market> / <resolution> / <ticker> / <date>_<tickType>.zip<date>_<ticker>_<resolution>_<tickType>_<contractMonth>.csv
Hour and dailyfuture / <market> / <resolution> / <ticker>_<tickType>.zip<ticker>_<tickType>_<contractMonth>.csv

Each zip file contains one CSV file for each contract. For example, future / cme / minute / es / 20131006_quote.zip contains 20131006_es_minute_quote_201312.csv, which holds the quotes of the December 2013 ES contract. The daily file of the same contract is es_quote_201312.csv in future / cme / daily / es_quote.zip.

Bar Data

The following table shows the bar data, with example rows from the minute files of the December 2013 ES contract on October 6, 2013:

Data TypeResolutionsExample
Trade barSecond, minute, hour, and daily79200000,1676.75,1677.25,1673.5,1675.25,1884
Quote barSecond, minute, hour, and daily68400000,1681.5,1681.5,1681.5,1681.5,5,1682,1682,1682,1682,19
Open interestSecond, minute, hour, and daily72360000,2691941

Tick Data

Futures tick files have trade, quote, and open interest ticks. The following table describes the columns of trade ticks, with an example row from 20131007_gc_tick_trade_201310.csv in future / comex / tick / gc / 20131007_trade.zip:

ColumnDescriptionExample
TimeMilliseconds since midnight4933381
PriceTrade price1313.8
QuantityNumber of contracts traded1
ExchangeExchange of the tradeusa
Sale ConditionSale condition of the tradeEmpty
Suspicious1 if the tick is suspicious and 0 otherwise0

The following table describes the columns of quote ticks, with an example row from 20131007_gc_tick_quote_201310.csv in future / comex / tick / gc / 20131007_quote.zip:

ColumnDescriptionExample
TimeMilliseconds since midnight0
Bid PriceBest bid price1313.4
Bid SizeNumber of contracts at the bid4
Ask PriceBest ask price0
Ask SizeNumber of contracts at the ask0
ExchangeExchange of the quoteusa
Suspicious1 if the tick is suspicious and 0 otherwise0

The following table describes the open interest tick columns, with an example row from 20131007_gc_tick_openinterest_201310.csv in future / comex / tick / gc / 20131007_openinterest.zip:

ColumnDescriptionExample
TimeMilliseconds since midnight22068523
Open InterestNumber of open contracts458

You can also see our Videos. You can also get in touch with us via Discord.

Did you find this page helpful?

Contribute to the documentation: