Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
developers:fixapi.securitydefinition [2025/08/13 12:35] – rob | developers:fixapi.securitydefinition [2025/08/13 12:52] (current) – rob | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ===== Security Definition ===== | + | ====== Security Definition ====== |
+ | ^ Print ^ RSS ^ Click to enable email notifications for this page ^ | ||
- | === Defining Instruments === | + | ===== Defining Instruments |
- | The Security Definition message (Tag 35=d) is used to define the characteristics of exchanges, contracts and specific instruments (markets). The T4 FIX API returns this message as a result of queries performed with the Security Definition Request message. | + | The Security Definition message (Tag 35=d) is used to define the characteristics of exchanges, contracts, and specific instruments (markets). The T4 FIX API returns this message as a result of queries performed with the Security Definition Request message. |
- | The Security | + | The Security |
- | === Message Dictionary === | + | ===== Message Dictionary |
^ Tag ^ Field Name ^ Req'd ^ Comments ^ | ^ Tag ^ Field Name ^ Req'd ^ Comments ^ | ||
| Standard Header | Y | MsgType = d | | | Standard Header | Y | MsgType = d | | ||
Line 22: | Line 23: | ||
| 969 | MinPriceAmount | N | The minimum price movement in this market. Only present if you login with 372=D. | | | 969 | MinPriceAmount | N | The minimum price movement in this market. Only present if you login with 372=D. | | ||
| 9850 | MinCabPrice | N | The minimum cab price for this market. Only present if you login with 372=D. | | | 9850 | MinCabPrice | N | The minimum cab price for this market. Only present if you login with 372=D. | | ||
- | | 6350 | TickRule | N | The variable tick table definition. Only present if you login with 372=D. | | + | | 6350 | TickRule | N | The variable tick table definition. (e.g. 5; |
| 9800 | PriceDisplayFormat | N | The number of decimal places in a price for this market. Only present if you login with 372=D. | | | 9800 | PriceDisplayFormat | N | The number of decimal places in a price for this market. Only present if you login with 372=D. | | ||
- | | 5770 | PriceRatio | N | Obsolete. Price Ratio as a fraction of Numerator to Denominator. | | + | | 5770 | PriceRatio | N | Obsolete. Price Ratio as a fraction of Numerator to Denominator. Reduced Ticks Spreads also provide ratios as delineated with the RTS acronym. | |
- | | 1146 | MinPriceIncrementAmount | N | Currency | + | | 1146 | MinPriceIncrementAmount | N | If you login with 372=D then this is always the currency |
- | | 201 | PutOrCall | N | Put Or Call identifier (for Options Security Type). 0 = Put, 1 = Call | | + | | 201 | PutOrCall | N | Put Or Call identifier (for Options Security Type). |
| 202 | StrikePrice | N | Strike Price (for Options Security Type). | | | 202 | StrikePrice | N | Strike Price (for Options Security Type). | | ||
- | | 167 | SecurityType | N | Indicates type of security. Valid values: FUT, OPT, STK, SYN, BIN | | + | | 167 | SecurityType | N | Indicates type of security. Valid values |
- | | 762 | SecuritySubType | N | Security SubType that further describes the security. | + | | 762 | SecuritySubType | N | Security SubType that further describes the security. |
- | | 40 | OrdType | N | T4 Order Types supported by this market | + | | 40 | OrdType | N | T4 Order Types supported by this market. Order Types are provided as a bitwise |
| 15 | Currency | N | Currency of Market Prices. | | | 15 | Currency | N | Currency of Market Prices. | | ||
+ | | 864 | NoEvents | N | Number of events for contract. | | ||
+ | | 865 | EventType | N | Type of Event. The following values are allowed:< | ||
+ | | 866 | EventDate | N | Date of the event. | | ||
+ | | 1145 | EventTime | N | Time of the event (in local CST Time or string for Day Change Time Exceptions i.e. Tag 865=2). | | ||
+ | | 555 | NoLegs | N | Number of legs of multi-legged strategy. Must be provided if number of legs is greater than 1. | | ||
+ | | 600 | LegSymbol | N | Individual leg Contract for multi-leg instrument. This is the T4 Contract ID for this leg. It must be the first tag of this group. | | ||
+ | | 623 | LegRatioQty | N | Individual leg Quantity Ratio. A negative value indicates a LegSide of Sell. | | ||
+ | | 624 | LegSide | N | Individual leg Side. Valid Values are:< | ||
+ | | 609 | LegSecurityType | N | Individual leg Security Type. Valid values are:< | ||
+ | | 602 | LegSecurityID | N | Individual leg Security (Market) identifier for multi-leg instrument. This is T4 Market ID for this leg. | | ||
+ | | 556 | LegCurrency | N | Individual leg Currency for multi-leg instrument. | | ||
+ | | 610 | LegMaturityMonthYear | N | Individual leg instrument maturity. Format YYYYMM. | | ||
+ | | 612 | LegStrikePrice | N | Individual leg strike (for Options Security Type). | | ||
+ | | 1358 | LegPutOrCall | N | Individual leg Put or Call (for Options Security Type). Valid values are:< | ||
+ | | 616 | LegSecurityExchange | N | Individual leg Exchange. This is the T4 Exchange ID for this leg. | | ||
+ | | 620 | LegSecurityDesc | N | Individual leg instrument description. | | ||
+ | | 454 | NoSecurityAltID | N | Number of Alternate Security Identifiers. | | ||
+ | | 455 | SecurityAltID | N | Alternate Security Identifier. | | ||
+ | | 456 | SecurityAltIDSource | N | Identifies class or source of the SecurityAltID (Tag 455). The following values are allowed:< | ||
+ | | Standard Trailer | Y | | | ||
- | >==== Events Repeating Group ==== | + | ===== Valid Values for SecuritySubType (Tag 762) ===== |
- | >^ Tag ^ Field Name ^ Req'd ^ Comments | + | ^ Code ^ Description |
- | >| 864 | NoEvents | + | | 0 |
- | >| 865 | EventType | + | | 1 | Calendar Spread |
- | >| 866 | EventDate | + | | 2 |
- | >| 1145 | EventTime | + | | 3 | Inter Contract Spread |
+ | | 4 | ||
+ | | 5 | ||
+ | | 6 | ||
+ | | 7 | Bundle Spread | | ||
+ | | 8 | Inter Exchange Spread | | ||
+ | | 9 | Crack Spread | | ||
+ | | 10 | Spark Spread | | ||
+ | | 11 | Crush Spread | | ||
+ | | 12 | Reverse Crush Spread | | ||
+ | | 13 | Strip | | ||
+ | | 14 | Straddle | | ||
+ | | 15 | Strangle | | ||
+ | | 16 | Guts | | ||
+ | | 17 | Synthetics | | ||
+ | | 18 | Combo | | ||
+ | | 19 | Vertical Spread | | ||
+ | | 20 | Horizontal Spread | | ||
+ | | 21 | Diagonal Spread | | ||
+ | | 22 | Ratio Spread | | ||
+ | | 23 | Back Spread | | ||
+ | | 24 | Covered Call | | ||
+ | | 25 | Covered Put | | ||
+ | | 26 | Married Put | | ||
+ | | 27 | Collar | | ||
+ | | 28 | Fence | | ||
+ | | 29 | Conversion | | ||
+ | | 30 | Reverse Conversion | | ||
+ | | 31 | Box Spread | | ||
+ | | 32 | Jelly Roll | | ||
+ | | 33 | Iron Condor | | ||
+ | | 34 | Iron Butterfly | | ||
+ | | 35 | Ladder | | ||
+ | | 36 | Seagull | | ||
+ | | 37 | Strip (Option Strategy) | | ||
+ | | 38 | Strap | | ||
+ | | 39 | Synthetic Long Stock | | ||
+ | | 40 | Synthetic Short Stock | | ||
+ | | 41 | Synthetic Long Future | | ||
+ | | 42 | Synthetic Short Future | | ||
+ | | 43 | Reversal | | ||
+ | | 44 | Risk Reversal | | ||
+ | | 45 | Calendar Butterfly | | ||
+ | | 46 | Calendar Condor | | ||
+ | | 47 | Calendar Straddle | | ||
+ | | 48 | Calendar Strangle | | ||
+ | | 49 | Diagonal Butterfly | | ||
+ | | 50 | Diagonal Condor | | ||
+ | | 51 | Diagonal Straddle | | ||
+ | | 52 | Diagonal Strangle | | ||
+ | | 53 | Horizontal Butterfly | | ||
+ | | 54 | Horizontal Condor | | ||
+ | | 55 | Horizontal Straddle | | ||
+ | | 56 | Horizontal Strangle | | ||
+ | | 57 | Ratio Butterfly | | ||
+ | | 58 | Ratio Condor | | ||
+ | | 59 | Ratio Straddle | | ||
+ | | 60 | Ratio Strangle | | ||
+ | | 61 | Vertical Butterfly | | ||
+ | | 62 | Vertical Condor | | ||
+ | | 63 | Vertical Straddle | | ||
+ | | 64 | Vertical Strangle | | ||
+ | | 65 | Box (Synthetic Arbitrage) | | ||
+ | | 66 | Diagonal Box | | ||
+ | | 67 | Horizontal Box | | ||
+ | | 68 | Ratio Box | | ||
+ | | 69 | Vertical Box | | ||
+ | | 70 | Inter Contract Strip | | ||
- | >==== Legs Repeating Group ==== | + | ===== Valid Values for OrdType (Tag 40) ===== |
- | >^ Tag ^ Field Name ^ Req' | + | ^ Code ^ Description |
- | >| 555 | NoLegs | + | | 0 | Market is view only | |
- | >| 600 | LegSymbol | + | | 1 | Market orders |
- | >| 623 | LegRatioQty | + | | 2 | Limit orders |
- | >| 624 | LegSide | + | | 4 | Stop Market |
- | >| 609 | LegSecurityType | N | Individual leg Security Type: FUT, OPT | | + | | 8 | Stop Limit | |
- | >| 602 | LegSecurityID | N | Individual leg Market ID | | + | | 16 | MarketOnOpen |
- | >| 556 | LegCurrency | N | Individual leg Currency | + | | 32 |
- | >| 610 | LegMaturityMonthYear | N | Individual leg maturity YYYYMM | + | | 64 | CompleteVolume |
- | >| 612 | LegStrikePrice | N | Individual leg strike (for Options) | + | | 128 | StatusRequest |
- | >| 1358 | LegPutOrCall | + | | 256 | StopSameLimit |
- | >| 616 | LegSecurityExchange | + | | 512 | GoodTillCancelled |
- | >| 620 | LegSecurityDesc | + | | 1024 |
+ | | 2048 | ||
+ | | 4096 | ||
+ | | 8192 | MaxShow. Iceberg order type | | ||
+ | | 16384 | NoQuotes. This market does not provide any quotes | ||
+ | | 32768 | NoStrategyLegFills. This market does not provide strategy | ||
+ | | 65536 | NoDayOrders. This market does not support day orders (Time-In-Force) | ||
+ | | 131072 | ||
- | >==== Alternate Security IDs Repeating Group ==== | + | ===== Sample Messages |
- | >^ Tag ^ Field Name ^ Req'd ^ Comments ^ | + | |
- | >| 454 | NoSecurityAltID | N | Number of Alternate Security Identifiers | | + | |
- | >| 455 | SecurityAltID | N | Alternate Security Identifier | | + | |
- | >| 456 | SecurityAltIDSource | N | Identifies class/ | + | |
- | | Standard Trailer | + | ===== Sample Message for an Outright ===== |
+ | < | ||
+ | << 4/14/2014 2:06:21 PM [fixsecuritydefinition] 34=37|49=T4|56=T4Example|50=T4FIX|52=20140414-19: | ||
+ | [FIXSECURITYDEFINITION] | ||
+ | [MsgSeqNum] 34 = 37 | ||
+ | [SenderCompID] 49 = T4 | ||
+ | [TargetCompID] 56 = T4Example | ||
+ | [SenderSubID] 50 = T4FIX | ||
+ | [SendingTime] 52 = 20140414-19: | ||
+ | [SecurityReqID] 320 = sc-444-14: | ||
+ | [SecurityResponseID] 322 = sd-4/ | ||
+ | [SecurityResponseType] 323 = 4 (LIST_OF_SECURITIES_RETURNED_PER_REQUEST) | ||
+ | [TotNumReports] 911 = 1 | ||
+ | [Symbol] 55 = ES | ||
+ | [SecurityDesc] 107 = SIM:E-mini S&P 500 Jun14 | ||
+ | [SecurityID] 48 = CME_20140600_ESM4 | ||
+ | [OrdType] 40 = 2083 (MARKET | LIMIT | IMMEDIATEANDCANCEL | MARKETMODERELIABLE) | ||
+ | [SecurityExchange] 207 = CME_Eq | ||
+ | [MaturityMonthYear] 200 = 201406 | ||
+ | [MaturityDay] 205 = 20 | ||
+ | [SecurityType] 167 = FUT (FUTURE) | ||
+ | [SecuritySubType] 762 = 0 (NONE) | ||
+ | [MinTradeVol] 562 = 1 | ||
+ | [Currency] 15 = USD | ||
+ | [MinPriceIncrementAmount] 1146 = 12.5 | ||
+ | [PriceRatio] 5770 = 25/1 | ||
+ | </ | ||
+ | ===== Sample Message for a Calendar Spread ===== | ||
+ | < | ||
+ | << 4/14/2014 2:08:37 PM [fixsecuritydefinition] 34=43|49=T4|56=T4Example|50=T4FIX|52=20140414-19: | ||
+ | [FIXSECURITYDEFINITION] | ||
+ | [MsgSeqNum] 34 = 43 | ||
+ | [SenderCompID] 49 = T4 | ||
+ | [TargetCompID] 56 = T4Example | ||
+ | [SenderSubID] 50 = T4FIX | ||
+ | [SendingTime] 52 = 20140414-19: | ||
+ | [SecurityReqID] 320 = sc-89-14: | ||
+ | [SecurityResponseID] 322 = sd-4/ | ||
+ | [SecurityResponseType] 323 = 4 (LIST_OF_SECURITIES_RETURNED_PER_REQUEST) | ||
+ | [TotNumReports] 911 = 10 | ||
+ | [Symbol] 55 = ES | ||
+ | [SecurityDesc] 107 = SIM:E-mini S&P 500 -Jun14+Sep14 | ||
+ | [SecurityID] 48 = CME_20140600_ESM4-ESU4 | ||
+ | [OrdType] 40 = 2083 (MARKET | LIMIT | IMMEDIATEANDCANCEL | MARKETMODERELIABLE) | ||
+ | [SecurityExchange] 207 = CME_Eq | ||
+ | [MaturityMonthYear] 200 = 201406 | ||
+ | [MaturityDay] 205 = 20 | ||
+ | [SecurityType] 167 = FUT (FUTURE) | ||
+ | [SecuritySubType] 762 = 1 (CALENDAR_SPREAD) | ||
+ | [MinTradeVol] 562 = 1 | ||
+ | [Currency] 15 = USD | ||
+ | [MinPriceIncrementAmount] 1146 = 2.5 | ||
+ | [PriceRatio] 5770 = 5/1 | ||
+ | [NoLegs] 555 = 2 | ||
+ | [LegSymbol] 600 = ES | ||
+ | [LegRatioQty] 623 = -1 | ||
+ | [LegSide] 624 = 2 (SELL) | ||
+ | [LegSecurityType] 609 = FUT | ||
+ | [LegSecurityID] 602 = CME_20140600_ESM4 | ||
+ | [LegCurrency] 556 = USD | ||
+ | [LegMaturityMonthYear] 610 = 201406 | ||
+ | [LegSecurityExchange] 616 = CME_Eq | ||
+ | [LegSecurityDesc] 620 = SIM:E-mini S&P 500 Jun14 | ||
+ | [LegSymbol] 600 = ES | ||
+ | [LegRatioQty] 623 = 1 | ||
+ | [LegSide] 624 = 1 (BUY) | ||
+ | [LegSecurityType] 609 = FUT | ||
+ | [LegSecurityID] 602 = CME_20140900_ESU4 | ||
+ | [LegCurrency] 556 = USD | ||
+ | [LegMaturityMonthYear] 610 = 201409 | ||
+ | [LegSecurityExchange] 616 = CME_Eq | ||
+ | [LegSecurityDesc] 620 = SIM:E-mini S&P 500 Sep14 | ||
+ | </ | ||
+ | |||
+ | ===== Sample Message for a (Call) Option ===== | ||
+ | < | ||
+ | << 4/14/2014 2:11:39 PM [fixsecuritydefinition] 34=197|49=T4|56=T4Example|50=T4FIX|52=20140414-19: | ||
+ | [FIXSECURITYDEFINITION] | ||
+ | [MsgSeqNum] 34 = 197 | ||
+ | [SenderCompID] 49 = T4 | ||
+ | [TargetCompID] 56 = T4Example | ||
+ | [SenderSubID] 50 = T4FIX | ||
+ | [SendingTime] 52 = 20140414-19: | ||
+ | [SecurityReqID] 320 = sc-58-14: | ||
+ | [SecurityResponseID] 322 = sd-4/ | ||
+ | [SecurityResponseType] 323 = 4 (LIST_OF_SECURITIES_RETURNED_PER_REQUEST) | ||
+ | [TotNumReports] 911 = 235 | ||
+ | [Symbol] 55 = ES | ||
+ | [SecurityDesc] 107 = SIM:E-mini S&P 500 Jun14 181000C | ||
+ | [SecurityID] 48 = CME_20140600_ESM4 C1810 | ||
+ | [OrdType] 40 = 2082 (LIMIT | IMMEDIATEANDCANCEL | MARKETMODERELIABLE) | ||
+ | [SecurityExchange] 207 = CME_EqOp | ||
+ | [MaturityMonthYear] 200 = 201406 | ||
+ | [MaturityDay] 205 = 20 | ||
+ | [SecurityType] 167 = OPT (OPTION) | ||
+ | [SecuritySubType] 762 = 0 (NONE) | ||
+ | [PutOrCall] 201 = 1 (CALL) | ||
+ | [StrikePrice] 202 = 181000 | ||
+ | [MinTradeVol] 562 = 1 | ||
+ | [Currency] 15 = USD | ||
+ | [MinPriceIncrementAmount] 1146 = 5; | ||
+ | [PriceRatio] 5770 = 5/1 | ||
+ | </ | ||
+ | |||
+ | ===== Sample Message for multi-leg strategy (Straddle) ===== | ||
+ | < | ||
+ | << 4/14/2014 2:16:42 PM [fixsecuritydefinition] 34=393|49=T4|56=T4Example|50=T4FIX|52=20140414-19: | ||
+ | [FIXSECURITYDEFINITION] | ||
+ | [MsgSeqNum] 34 = 393 | ||
+ | [SenderCompID] 49 = T4 | ||
+ | [TargetCompID] 56 = T4Example | ||
+ | [SenderSubID] 50 = T4FIX | ||
+ | [SendingTime] 52 = 20140414-19: | ||
+ | [SecurityReqID] 320 = sc-282-14: | ||
+ | [SecurityResponseID] 322 = sd-4/ | ||
+ | [SecurityResponseType] 323 = 4 (LIST_OF_SECURITIES_RETURNED_PER_REQUEST) | ||
+ | [TotNumReports] 911 = 165 | ||
+ | [Symbol] 55 = ES | ||
+ | [SecurityDesc] 107 = SIM:E-mini S&P 500 Straddle +Jun14 181000C+(181000P) | ||
+ | [SecurityID] 48 = XCME_EqOp ES (M14C 181000)(M14P 181000) | ||
+ | [OrdType] 40 = 2082 (LIMIT | IMMEDIATEANDCANCEL | MARKETMODERELIABLE) | ||
+ | [SecurityExchange] 207 = CME_EqOp | ||
+ | [MaturityMonthYear] 200 = 201406 | ||
+ | [MaturityDay] 205 = 20 | ||
+ | [SecurityType] 167 = OPT (OPTION) | ||
+ | [SecuritySubType] 762 = 33 (STRADDLE) | ||
+ | [MinTradeVol] 562 = 1 | ||
+ | [Currency] 15 = USD | ||
+ | [MinPriceIncrementAmount] 1146 = 5; | ||
+ | [PriceRatio] 5770 = 5/1 | ||
+ | [NoLegs] 555 = 2 | ||
+ | [LegSymbol] 600 = ES | ||
+ | [LegRatioQty] 623 = 1 | ||
+ | [LegSide] 624 = 1 (BUY) | ||
+ | [LegSecurityType] 609 = OPT | ||
+ | [LegSecurityID] 602 = CME_20140600_ESM4 C1810 | ||
+ | [LegCurrency] 556 = USD | ||
+ | [LegMaturityMonthYear] 610 = 201406 | ||
+ | [LegStrikePrice] 612 = 181000 | ||
+ | [LegPutOrCall] 1358 = 1 (CALL) | ||
+ | [LegSecurityExchange] 616 = CME_EqOp | ||
+ | [LegSecurityDesc] 620 = SIM:E-mini S&P 500 Jun14 181000C | ||
+ | [LegSymbol] 600 = ES | ||
+ | [LegRatioQty] 623 = 1 | ||
+ | [LegSide] 624 = 1 (BUY) | ||
+ | [LegSecurityType] 609 = OPT | ||
+ | [LegSecurityID] 602 = CME_20140600_ESM4 P1810 | ||
+ | [LegCurrency] 556 = USD | ||
+ | [LegMaturityMonthYear] 610 = 201406 | ||
+ | [LegStrikePrice] 612 = 181000 | ||
+ | [LegPutOrCall] 1358 = 0 (PUT) | ||
+ | [LegSecurityExchange] 616 = CME_EqOp | ||
+ | [LegSecurityDesc] 620 = SIM:E-mini S&P 500 Jun14 181000P | ||
+ | </ | ||
+ | |||
+ | [[developers: |