Feed updates
Crypto.CARDS/USDwent liveCrypto.AI/NVDAwent liveEquity.US.SIMO/USDwent liveCommodities.Index.TGAS1M/USDaddedEquity.TW.2454/TWDaddedEquity.TW.3231/TWDaddedEquity.TW.2382/TWDaddedEquity.TW.2317/TWDaddedEquity.TW.2330/TWDaddedEquity.US.GTLB/USDaddedEquity.US.PATH/USDaddedCommodities.LCQ6/UScremovedCommodities.BRENTF7/USDwent liveEquity.Index.SAMSUNG/USDwent live
View all
Developer Hub

Futures Terminology

Understanding futures feed ticker symbols and expiration dates on Pyth Pro

Pyth Pro provides price feeds for futures feeds across multiple asset classes including commodities and more. This guide explains how to interpret futures ticker symbols.

Ticker Symbol Format

Futures tickers on Pyth follow the standard format:

[ROOT][MONTH][YEAR]

For example: WTIJ6 breaks down as:

  • WTI = West Texas Intermediate (Crude Oil)
  • J = April (month code)
  • 6 = 2026 (last digit of year)

Month Codes

Futures feeds use single-letter codes to represent expiration months:

CodeMonth
FJanuary
GFebruary
HMarch
JApril
KMay
MJune
NJuly
QAugust
USeptember
VOctober
XNovember
ZDecember

Why these letters? The letters skip I, L, O, P, R, S, W, and Y to avoid confusion with numbers (1, 0) and other abbreviations commonly used in trading.

Year Codes

The year is represented by the last digit of the year:

  • 5 = 2025
  • 6 = 2026
  • 7 = 2027

Examples

Crude Oil (WTI)

SymbolFeedExpiration
WTIJ6WTI April 2026Apr 21, 2026
WTIK6WTI May 2026May 19, 2026
WTIM6WTI June 2026Jun 22, 2026

Brent Crude Oil

SymbolFeedExpiration
BRENTK6Brent May 2026Mar 31, 2026
BRENTM6Brent June 2026Apr 30, 2026
BRENTN6Brent July 2026May 29, 2026

Copper

SymbolFeedExpiration
CCH6Copper March 2026Mar 27, 2026
CCK6Copper May 2026May 27, 2026
CCN6Copper July 2026Jul 29, 2026

Natural Gas

SymbolFeedExpiration
NGDJ6HH Natural Gas April 2026Apr 28, 2026
NGDK6HH Natural Gas May 2026May 27, 2026
NGDM6HH Natural Gas June 2026Jun 26, 2026

LS Gasoil

SymbolFeedExpiration
GOJ6LS Gasoil April 2026Apr 10, 2026
GOK6LS Gasoil May 2026May 12, 2026

Corn

SymbolFeedExpiration
COH6Corn March 2026Mar 13, 2026
COK6Corn May 2026May 14, 2026
CON6Corn July 2026Jul 14, 2026

Pyth Symbol Format

On Pyth, futures symbols include the asset class prefix. The table below lists all available futures assets:

Commodities

AssetSymbol RootExample Symbol
WTI Crude OilWTICommodities.WTIJ6/USD
Brent Crude OilBRENTCommodities.BRENTK6/USD
HH Natural GasNGDCommodities.NGDJ6/USD
LS GasoilGOCommodities.GOJ6/USD
CopperCCCommodities.CCH6/USD
PalladiumPDCommodities.PDH6/USD
PlatinumPTCommodities.PTJ6/USD
CornCOCommodities.COH6/USD
SoybeanSOCommodities.SOK6/USD
Dutch TTF GasTGECommodities.TGEM6/EUR
WheatWHCommodities.WHK6/USD

Equity Indices

AssetSymbol RootExample Symbol
E-mini S&P 500EMEquity.US.EMH6/USD
E-mini Nasdaq 100NMEquity.US.NMH6/USD
E-mini DowDMEquity.US.DMH6/USD
Nikkei 225 Dividend IndexNIDEquity.US.NIDH6/USD
KOSPI 200KSEquity.KR.KSH6/KRW
KOSDAQ 150KQEquity.KR.KQH6/KRW
Hang SengHKHEquity.HK.HKHH6/HKD
FTSE China A50 IndexFCDEquity.US.FCDH6/USD

Chain Metadata

Every dated feed belongs to a chain: the family of feeds on the same underlying that differ only by expiration. The symbols API exposes three chain-level fields on each feed, with identical values across the whole chain. See Symbology & Reference Data for the full field definitions.

For the WTI chain (WTIV6, WTIX6, WTIZ6, ...):

{
  "symbol_chain_id": "WTI",
  "expiration_pattern": [
    "jan",
    "feb",
    "mar",
    "apr",
    "may",
    "jun",
    "jul",
    "aug",
    "sep",
    "oct",
    "nov",
    "dec"
  ],
  "availability_pattern": [
    "F",
    "G",
    "H",
    "J",
    "K",
    "M",
    "N",
    "Q",
    "U",
    "V",
    "X",
    "Z"
  ]
}

symbol_chain_id is the bare symbol root (WTI), not a fully-qualified Pyth symbol. expiration_pattern is the chain's full annual expiration cycle, written as month abbreviations; availability_pattern is the subset Pyth prices, written as the month codes above.

Values are per-chain. WTI expires monthly and Pyth prices every month, so both patterns cover all twelve. Copper (CC) also expires monthly, but its availability_pattern is ["H", "K", "N", "U", "Z"] — only the March, May, July, September, and December feeds are published.

Expiration and Rollover

Futures feeds expire on specific dates. When a feed approaches expiration:

  1. Liquidity shifts to the next feed month
  2. Price feeds transition to the new front-month feed
  3. Rollover dates vary by commodity — check the Symbology and Reference Data API for exact expiration dates, or see Symbology & Reference Data for the field definitions

Which feed months exist at all is given by the chain's expiration_pattern, and which of those Pyth publishes by its availability_pattern — see Chain Metadata above.

Expiration Handling: Ensure your application handles feed rollovers gracefully. Monitor for feed transitions as feeds approach expiration.

Additional Resources

On this page