Skip to main content

Futures

Futures are served as contract families on their venues, each with one continuous front-month price series. Positioning is on Commitments of Traders, supply and demand on commodity supply and demand.

Families span equity index, rate, currency, crypto, energy, metal, agricultural, and livestock futures, each with instrument_type future (asset class and instrument type).

Routes​

you needroute
a family: venue, name, its continuous seriesGET /v1/futures/{root}
the continuous series' quoteGET /v1/futures/{root}/continuous/quote
its daily barsGET /v1/futures/{root}/continuous/history
its technical indicatorsGET /v1/futures/{root}/continuous/technicals
the family's CFTC positioningGET /v1/futures/{root}/positioning (Commitments of Traders)
a commodity's supply and demandGET /v1/futures/{root}/supply-demand (commodity supply and demand)
the commodity viewsGET /v1/markets/commodity/energy, /metals, /agriculture, /livestock, /benchmarks

Every parameter and response schema is in the API reference.

bash
curl "https://api.tauric.ai/v1/futures/XCME:ES" \
-H "Authorization: Bearer $TAURIC_API_KEY"
curl "https://api.tauric.ai/v1/futures/XCME:ES/continuous/quote" \
-H "Authorization: Bearer $TAURIC_API_KEY"
curl "https://api.tauric.ai/v1/futures/XNYM:CL/continuous/history?start=2025-11-14" \
-H "Authorization: Bearer $TAURIC_API_KEY"

Families and continuous series​

A family (future:XCME:ES) is priced only through its continuous series (future:XCME:ES/continuous); dated contracts are not served. The family's continuous block names the series' key and says whether it is served; when it is not, its routes answer 404 not_supported. The series follows the front month, and its roll dates are not published (roll_boundaries is null).

A bar-to-bar change or an indicator window across a roll mixes two contracts and is not marked.

The previous close is on quotes, the session calendar on price history.

Price quotation​

A continuous series' prices are in the contract's own quotation, stated by instrument.currency and instrument.price_scale (values and data quality):

quotationfamiliesprice_scale
US dollars per unit of the commodityenergy, metals, cocoa, soybean meal, Class III milk1
US cents per unitthe other grains, softs, and livestock0.01
index pointsthe equity-index e-minis (ES, NQ, YM, RTY)null
percent of par, as a decimalthe Treasury futures (ZT, ZF, ZN, ZB)null

A future quoted in index points has its price in points, with no currency amount per point. The commodity unit (barrel, troy ounce, bushel) is not stated.

A Treasury futures price is a price, not a yield: "price": 106.15625 for ZN is 106.15625% of par (106-05 in 32nds is not used), and its change.percent is a percent of that price. A Treasury yield is a rate series, such as series:us.treasury.yield_index.10y (economic and market series).

Commodity views​

GET /v1/markets/commodity/energy, /metals, /agriculture, and /livestock list each subclass's served continuous series; /benchmarks lists OVX, GVZ, the S&P GSCI, and the DBC and DBA funds. Each member is a quote; shared rules are on batch quotes and market views.