FIX Component Instrument

GF API Documentation
Contract specification
Fields

Name

Type

Number

Required

Valid values

Description

Symbol

STRING

55

Yes

OEC base symbol should be used in this field for single leg orders. Example: 'ES' for E-Mini SP&P 500 For spread orders, this field should specify a value from Symbol tag of Security Definition that could be obtained by Security Definition Request. Naming convention of spread symbols coincides with common OEC practice. Example: "ES FTS –Z0,+H1" for futures time spread with two legs.

EleSymbol

STRING

12059

No

Full electronic contract name used by OEC in user interface

PitSymbol

STRING

12062

No

Full pit contract name used by OEC in user interface

CFICode

STRING

461

Yes

Supported values:
Futures: FXXXXS
Spreads: FMXXXN
Options: OCXFXS, OPXFXS, OCXFXN, OPXFXN

SecuritySubType

STRING

762

No

Specifies spread type. Acceptable values: Generic, PerformanceIndexBasket, NonPerformanceIndexBasket, Straddle, Strangle, FutureTimeSpread, OptionTimeSpread, PriceSpread, SyntheticUnderlying, StraddleTimeSpread, RatioSpread, RatioFutureTimeSpread, RatioOptionTimeSpread, PutCallSpread, RatioPutCallSpread, Ladder, Box, Butterfly, Condor, IronButterfly, DiagonalSpread, RatioDiagonalSpread, StraddleDiagonalSpread, ConversionReversal, CoveredOption, CurrencyFutureSpread, RateFutureSpread, IndexFutureSpread, FutureButterfly, FutureCondor, Strip, Pack, Bundle, BondDeliverableBasket, StockBasket, PriceSpreadVsOption, StraddleVsOption, BondSpread, ExchangeSpread, FuturePackSpread, FuturePackButterfly, WholeSale, CommoditySpread, JellyRoll, IronCondor, OptionsStrip, ContingentOrders, InterproductSpread, PseudoStraddle, TailorMade, FuturesGeneric, OptionsGeneric, BasisTrade, FutureTimeSpreadReducedTickSize, ButterflyCallLong, ButterflyCallShort, ButterflyPutLong, ButterflyPutShort, IronButterflyLong, IronButterflyShort, Calendar, CalendarCall, CalendarPut, DiagonalCalendarSpread, DiagonalCalendarSpreadCall, DiagonalCalendarSpreadPut, RatioSpreadCall, RatioSpreadPut, StraddleCalendarSpread, StraddleLong, StraddleShort, StrangleLong, StrangleShort, BearSpread, BearCallSpread, BearPutSpread, SyntheticUnderlyingLong, SyntheticUnderlyingShort, FutureDoubleButterfly, FutureReverseSpread, DiagonalBullSpread, DiagonalBearSpread, Synthetic, SyntheticLong, SyntheticSplit, BullVertical,BearVertical. Not all of them supported at this time. Please contact OEC Customer Service for more details.

MaturityMonthYear

MONTHYEAR

200

No

Format: YYYYMM

Factor

FLOAT

228

No

Contract size

StrikePrice

PRICE

202

No

The same currency and scale as quote prices of contract. See StrikeDisplayFactor(12075)

SecurityExchange

EXCHANGE

207

No

OEC name of exchange

SecurityDesc

STRING

107

No

Readable description

MinPriceIncrement

FLOAT

969

No

Minimum price increase for a given exchange-traded instrument. Tick size.

ExpireTime

UTCTIMESTAMP

126

No

Should be specified in conjunction with TimeInForce(59) = Good Till Date
Format: YYYYMMDD-HH:MM:SS

Currency

CURRENCY

15

No

OEC names of currencies

ContractGroup

STRING

12054

No

This field represents a group of contracts. For example, it can be Grains, Meats, Energies, Indices

TradSesStartTime

UTCTIMESTAMP

341

No

Trading session start time.
Format: 00010101-HH:MM:SS
Example: 00010101-22:00:00

TradSesCloseTime

UTCTIMESTAMP

344

No

Trading session stop time.
Format: 00010101-HH:MM:SS
Example: 00010101-22:00:00

TradSesEndTime

UTCTIMESTAMP

345

No

Day close.
Format: 00010101-HH:MM:SS
Example: 00010101-22:00:00

ContractType

INT

12055

No

0 - ELECTRONIC

1 - PIT

PriceFormat

INT

12063

No

This field specifies displaying price format.
Positive value means how many number of digits should be shown after decimal point.
Negative values of power 2 are divisors of fractional representation.
Negative values of power 2 multiplied 100 are divisors of fractional representation in cents
Examples:
ES: 2 = 0.01
ZB: -32 = 1/32
OZW: -800 = 0.01/8 (fractional cents)

FrontExpirationMonth

STRING

12071

No

Expiration month of front-month contract

StrikeDisplayFactor

DOUBLE

12075

No

A factor that should be applied to StrikePrice(202) before displaying in user interface
Used In

NewOrderSingle(D)

ExecutionReport(8)

NewOrderList(E)

OrderCancelReplaceRequest(G)

OrderCancelRequest(F)

OrderMassStatusRequest(AF)

OrderStatusRequest(H)

SecurityListRequest(x)

SecurityList(y)

SecurityDefinition(d)

PositionReport(AP)

MarginCalcRequest(UR)

Remarks

The most of fields are populated in respose to SecurityListRequest(x) and SecurityDefinitionRequest(c). But for contract identifying, only minimum set of fields required: Symbol(55), CFICode(461), MaturityMonthYear(200), StrikePrice(202)