{"id":7149,"date":"2025-08-28T22:36:23","date_gmt":"2025-08-29T03:36:23","guid":{"rendered":"https:\/\/librarytestdev.wpenginepowered.com\/?post_type=doc&#038;p=7149"},"modified":"2026-03-24T01:26:46","modified_gmt":"2026-03-24T06:26:46","slug":"security-definition-requests","status":"publish","type":"doc","link":"https:\/\/library-staging.tradingtechnologies.com\/tt-fix\/tt-fix-market-data\/tt-fix-message-conversations-tt-fix-market-data\/security-definition-requests\/","title":{"rendered":"Security Definition Requests"},"content":{"rendered":"\n<p>\nThe following article provides information on making Security Definition requests. \nSecurity Definitions enable you to receive the unique definitions that make up a specific instrument such as its SecurityIDs, Contract Term, ExpiryDate etc. \nSuch information can be used to help identify and specify an instrument in an Order Routing or Drop Copy session. \n<\/p>\n\n<p>\n  This article shows several examples of requesting security definitions for:\n<\/p>\n<ul>\n\n  <li>\n    <a href=\"#request-all\">All Instruments within an Asset Class<\/a>\n  <\/li>\n\n  <li>\n    <a href=\"#request-product\">All Instruments for a Product<\/a>\n  <\/li>\n\n  <li>\n    <a href=\"#request-single-instrument\">A Single Instrument<\/a>\n  <\/li>\n\n  <li>\n    <a href=\"#request-multileg\">A Multileg Product<\/a>\n  <\/li>\n\n<\/ul>\n\n<p>\n  <strong>Note:<\/strong>\n    A <b>Security Definition Request<\/b> is an <i>active subscription<\/i> by default.\n  The session will stay connected and continue to listen for updates.\n<\/p>\n\n<section>\n<h2>Making a Security Definition Request<\/h2>\n\n<p>\n  Security definitions can be retrieved by including a combination of specific tags in a request.\n  Varying combinations can return different responses. \n  One combination will return a single instrument definition, another a multileg product, and another all instruments within a product or an asset class.\n  The following examples show some ways a security definition request could be composed to yield a desired result.\n<\/p>\n<p>\n  Before sending a request, ensure that you are connected to a valid <b>Security Definition\/Market Data<\/b> FIX session. \n<\/p>\n\n<p>\n  <strong>Note: <\/strong> \n    This is a different type of session from a FIX Order Routing or Drop Copy session.  \n<\/p>\n\n<h3 id=\"request-all\">Requesting All Instruments within an Asset Class<\/h3>\n  <h4>Using Exchange (tag 207)<\/h4>\n  <p>\n    Request security definitions for <i>all<\/i> instruments in an asset class by using <b>SecurityType<\/b> tag to specify the asset class of the instrument and the <b>Exchange<\/b> tag to specify the market where the instrument trades.\n  <\/p>\n\n<table class=\"table table-striped table-bordered\" border=\"1\">\n  <caption>Required Fields<\/caption>\n\t<thead>\n\t\t<tr>\n      <th width=\"10%\">Tag #<\/th>\n\t\t\t<th width=\"20%\">Name<\/th>\n      <th width=\"70%\">Definition<\/th>\n\t\t<\/tr>\n\t<\/thead>\n  <tbody>\n\t\t<tr>\n\t\t\t<td><a href=\"\/tt-fix\/market-data\/Msg_SecurityDefinition_d.html#tag167\">167<\/a><\/td>\n\t\t\t<td>SecurityType<\/td>\n\t\t\t<td>\n\t\t\t\t<p>\n          Asset class of the instrument.\n        <\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n \t\t<tr>\n\t\t\t<td><a href=\"\/tt-fix\/market-data\/Msg_SecurityDefinition_d.html#tag207\">207<\/a><\/td>\n\t\t\t<td>Exchange<\/td>\n\t\t\t<td>\n\t\t\t\t<p>\n          Name of the market where the instrument trades.\n        <\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n  <\/tbody>\n<\/table>\n\n  <h5>Sample Request for all ICE FUTURES<\/h5>\n  The following request would return security definitions for <i>all<\/i> futures at ICE. \n  <br>\n  Set:\n  <ul>\n   <li><b>SecurityType<\/b> <i>(167)<\/i> to <b>FUT<\/b><\/li>\n   <li><b>Exchange<\/b> <i>(207)<\/i> to <b>ICE<\/b><\/li>\n  <\/ul>\n\n  <div class=\"sample-message\">\n  <span>8=FIX.4.2<\/span>\n| <span>9=91<\/span>\n| <span>35=c<\/span>\n| <span>34=171<\/span>\n| <span>49=WTEOUATSD<\/span>\n| <span>52=20220803-08:53:29<\/span>\n| <span>56=TT_SD<\/span>\n| <span class=\"highlight\">167=FUT<\/span>\n| <span class=\"highlight\">207=ICE<\/span>\n| <span>320=12345a09<\/span>\n| <span>10=164<\/span>\n| <\/div>\n\n  <br>\n  <strong>Note:<\/strong> Including a Symbol <i>(tag 55)<\/i> would return <a href=\"#request-product\">instruments within the specified product<\/a>, or including the SecurityID <i>(tag 48)<\/i> would narrow <a href=\"#request-single-instrument\">the result to a single instrument definition<\/a>.\n\n  <h4>Using ExDestination (tag 100)<\/h4>\n  <p>\n    Request security definitions for <i>all<\/i> instruments of an asset class traded in a sub-market by using <b>SecurityType<\/b> tag to specify the asset class of the instrument and the <b>ExDestination<\/b> tag to specify the sub-market where the instrument trades.\n  <\/p>\n<table class=\"table table-striped table-bordered\" border=\"1\">\n  <caption>Required Fields<\/caption>\n\t<thead>\n\t\t<tr>\n      <th width=\"10%\">Tag #<\/th>\n\t\t\t<th width=\"20%\">Name<\/th>\n      <th width=\"70%\">Definition<\/th>\n\t\t<\/tr>\n\t<\/thead>\n  <tbody>\n\t\t<tr>\n\t\t\t<td><a href=\"\/tt-fix\/market-data\/Msg_SecurityDefinition_d.html#tag167\">167<\/a><\/td>\n\t\t\t<td>SecurityType<\/td>\n\t\t\t<td>\n\t\t\t\t<p>\n          Asset class of the instrument.\n        <\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n \t\t<tr>\n\t\t\t<td><a href=\"\/tt-fix\/market-data\/Msg_SecurityDefinition_d.html#tag100\">100<\/a><\/td>\n      <td>ExDestination<\/td>\n\t\t\t<td>\n        <p>Name of the sub-market where the instrument trades.<\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n  <\/tbody>\n<\/table>\n\n  <h5>Sample Request for all SGX FUTURES<\/h5>\n  The following request would return security definitions for <i>all<\/i> futures at SGX. \n  <br>\n  Set:\n  <ul>\n   <li><b>SecurityType<\/b> <i>(167)<\/i> to <b>FUT<\/b><\/li>\n   <li><b>ExDestination<\/b> <i>(100)<\/i> to <b>XSIM<\/b><\/li>\n  <\/ul>\n\n\n  <div class=\"sample-message\">\n  <p>Send:<\/p>\n  <span>8=FIX.4.2<\/span>\n| <span>9=84<\/span>\n| <span>35=c<\/span>\n| <span>34=19<\/span>\n| <span>49=WTEOUATSD<\/span>\n| <span>52=20220901-02:23:13<\/span>\n| <span>56=TT_SD<\/span>\n| <span class=\"highlight\">167=FUT<\/span>\n| <span class=\"highlight\">100=XSIM<\/span>\n| <span>320=12345a03<\/span>\n| <span>10=062<\/span>\n|\n<\/div>\n<br>\n\n<h3 id=\"request-product\">Requesting All Instruments for a Product<\/h3>\n<h4>Using Exchange (tag 207) and Symbol (tag 55)<\/h4>\n  <p>\n    Request security definitions for a product using <b>SecurityType<\/b>, the <b>Exchange<\/b> or <b>ExDestination<\/b> tag, and the <b>Symbol<\/b> to specify product.\n  <\/p>\n<table class=\"table table-striped table-bordered\" border=\"1\">\n  <caption>Required Fields<\/caption>\n\t<thead>\n\t\t<tr>\n      <th width=\"10%\">Tag #<\/th>\n\t\t\t<th width=\"20%\">Name<\/th>\n      <th width=\"70%\">Definition<\/th>\n\t\t<\/tr>\n\t<\/thead>\n  <tbody>\n\t\t<tr>\n\t\t\t<td><a href=\"\/tt-fix\/market-data\/Msg_SecurityDefinition_d.html#tag167\">167<\/a><\/td>\n\t\t\t<td>SecurityType<\/td>\n\t\t\t<td>\n\t\t\t\t<p>\n          Asset class of the instrument.\n        <\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n \t\t<tr>\n\t\t\t<td><a href=\"\/tt-fix\/market-data\/Msg_SecurityDefinition_d.html#tag207\">207<\/a><\/td>\n\t\t\t<td>Exchange<\/td>\n\t\t\t<td>\n\t\t\t\t<p>\n          Name of the market where the instrument trades.\n        <\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n \t\t<tr>\n\t\t\t<td><a href=\"\/tt-fix\/market-data\/Msg_SecurityDefinition_d.html#tag55\">55<\/a><\/td>\n\t\t\t<td>Symbol<\/td>\n\t\t\t<td>\n        <p>Exchange-provided product symbol for the tradable product.<\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n  <\/tbody>\n<\/table>\n\n<h5>Sample Request for CME ES Week 4 OPTIONS<\/h5>\n  The following request would return security definitions for the E-Mini S&amp;P 500 Week 4 Options product at CME\n  <br>\n  Set:\n  <ul>\n   <li><b>SecurityType<\/b> <i>(167)<\/i> to <b>OPT<\/b><\/li>\n   <li><b>Exchange<\/b> <i>(207)<\/i> to <b>CME<\/b><\/li>\n   <li><b>Symbol<\/b> <i>(55)<\/i> to <b>EW4<\/b><\/li>\n  <\/ul>\n\n\n  <div class=\"sample-message\">\n    <p>Send:<\/p>\n  <span>8=FIX.4.2<\/span>\n| <span>9=91<\/span>\n| <span>35=c<\/span>\n| <span>34=86<\/span>\n| <span>49=WTEOUATSD<\/span>\n| <span>52=20220901-03:19:53<\/span>\n| <span>56=TT_SD<\/span>\n| <span class=\"highlight\">167=OPT<\/span>\n| <span class=\"highlight\">207=CME<\/span>\n| <span class=\"highlight\">55=EW4<\/span>\n| <span>320=12345a011<\/span>\n| <span>10=145<\/span>\n|\n<\/div>\n\n\n<h3 id=\"request-single-instrument\">Requesting a Single Instrument<\/h3>\n<h4>Using Symbol (tag 55) and SecurityID (tag 48)<\/h4>\n  <p>\n    Request a security definition using <b>SecurityType<\/b>, the <b>Exchange<\/b> or <b>ExDestination<\/b> tag, and the <b>Symbol<\/b> to specify product and the <b>SecurityID<\/b> to specify the instrument.\n  <\/p>\n<br>\n<table class=\"table table-striped table-bordered\" border=\"1\">\n  <caption>Required Fields<\/caption>\n\t<thead>\n\t\t<tr>\n      <th width=\"10%\">Tag #<\/th>\n\t\t\t<th width=\"20%\">Name<\/th>\n      <th width=\"70%\">Definition<\/th>\n\t\t<\/tr>\n\t<\/thead>\n  <tbody>\n\t\t<tr>\n\t\t\t<td><a href=\"\/tt-fix\/market-data\/Msg_SecurityDefinition_d.html#tag167\">167<\/a><\/td>\n\t\t\t<td>SecurityType<\/td>\n\t\t\t<td>\n\t\t\t\t<p>\n          Asset class of the instrument.\n        <\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n \t\t<tr>\n\t\t\t<td><a href=\"\/tt-fix\/market-data\/Msg_SecurityDefinition_d.html#tag100\">100<\/a><\/td>\n\t\t\t<td>ExDestination<\/td>\n\t\t\t<td>\n        <p>Name of the sub-market where the instrument trades.<\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n  \t<tr>\n\t\t\t<td><a href=\"\/tt-fix\/market-data\/Msg_SecurityDefinition_d.html#tag55\">55<\/a><\/td>\n\t\t\t<td>Symbol<\/td>\n\t\t\t<td>\n        <p>Exchange-provided product symbol for the tradable product.<\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n  \t<tr>\n\t\t\t<td><a href=\"\/tt-fix\/market-data\/Msg_SecurityDefinition_d.html#tag48\">48<\/a><\/td>\n      <td>SecurityID<\/td>\n\t\t\t<td>\n        <p>\n          TT security ID that uniquely identifies the instrument in the TT\n          platform.\n        <\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n  <\/tbody>\n<\/table>\n\n<h5>Sample Request for CME ZC Sep22 FUTURES<\/h5>\n  The following request would return a single security definition for Sep22 corn (ZC) at CME.\n  <br>\n  Set:\n  <ul>\n   <li><b>SecurityType<\/b> <i>(167)<\/i> to <b>FUT<\/b><\/li>\n   <li><b>ExDestination<\/b> <i>(100)<\/i> to <b>XCBT<\/b><\/li>\n   <li><b>Symbol<\/b> <i>(55)<\/i> to <b>ZC<\/b><\/li>\n   <li><b>SecurityID<\/b> <i>(48)<\/i> to <b>6100888309685616968<\/b><\/li>\n  <\/ul>\n\n\n  <div class=\"sample-message\">\n<p>Send:<\/p> \n  <span>8=FIX.4.2<\/span>\n| <span>9=113<\/span>\n| <span>35=c<\/span>\n| <span>34=52<\/span>\n| <span>49=WTEOUATSD<\/span>\n| <span>52=20220901-02:51:45<\/span>\n| <span>56=TT_SD<\/span>\n| <span class=\"highlight\">167=FUT<\/span>\n| <span class=\"highlight\">100=XCBT<\/span>\n| <span class=\"highlight\">55=ZC<\/span>\n| <span class=\"highlight\">48=6100888309685616968<\/span>\n| <span>320=12345a13<\/span>\n| <span>10=060<\/span>\n|\n<\/div>\n\n<h4>Using Symbol (tag 55) and MaturityYearMonth (tag 200)<\/h4>\n  <p>\n    Request a security definition using <b>SecurityType<\/b>, the <b>Exchange<\/b> or <b>ExDestination<\/b> tag, and the <b>Symbol<\/b> to specify product and the <b>MaturityYearMonth<\/b> to locate the instrument based on contract date.\n  <\/p>\n<table class=\"table table-striped table-bordered\" border=\"1\">\n  <caption>Required Fields<\/caption>\n\t<thead>\n\t\t<tr>\n      <th width=\"10%\">Tag #<\/th>\n\t\t\t<th width=\"20%\">Name<\/th>\n      <th width=\"70%\">Definition<\/th>\n\t\t<\/tr>\n\t<\/thead>\n  <tbody>\n\t\t<tr>\n\t\t\t<td><a href=\"\/tt-fix\/market-data\/Msg_SecurityDefinition_d.html#tag167\">167<\/a><\/td>\n\t\t\t<td>SecurityType<\/td>\n\t\t\t<td>\n\t\t\t\t<p>\n          Asset class of the instrument.\n        <\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n \t\t<tr>\n\t\t\t<td><a href=\"\/tt-fix\/market-data\/Msg_SecurityDefinition_d.html#tag207\">207<\/a><\/td>\n\t\t\t<td>Exchange<\/td>\n\t\t\t<td>\n\t\t\t\t<p>\n          Name of the market where the instrument trades.\n        <\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n \t\t<tr>\n\t\t\t<td><a href=\"\/tt-fix\/market-data\/Msg_SecurityDefinition_d.html#tag55\">55<\/a><\/td>\n\t\t\t<td>Symbol<\/td>\n\t\t\t<td>\n        <p>Exchange-provided product symbol for the tradable product.<\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n \t\t<tr>\n\t\t\t<td><a href=\"\/tt-fix\/market-data\/Msg_SecurityDefinition_d.html#tag200\">200<\/a><\/td>\n      <td>MaturityYearMonth<\/td>\n\t\t\t<td>\n        <p>\n          Month and year the instrument reaches maturity in the format\n          <i>YYYYMM<\/i>.\n        <\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n  <\/tbody>\n<\/table>\n\n<h5>Sample Request for JPX 225 Dec23 OPTIONS<\/h5>\n  The following request would return Nikkei Stock Average Option for Dec23 on JPX.\n  <br>\n  Set:\n  <ul>\n   <li><b>SecurityType<\/b> <i>(167)<\/i> to <b>OPT<\/b><\/li>\n   <li><b>Exchange<\/b> <i>(207)<\/i> to <b>JPX<\/b><\/li>\n   <li><b>Symbol<\/b> <i>(55)<\/i> to <b>225<\/b><\/li>\n   <li><b>MaturityYearMonth<\/b> <i>(200)<\/i> to <b>202312<\/b><\/li>\n  <\/ul>\n\n\n  <div class=\"sample-message\">\n    <p>Send:<\/p>\n  <span>8=FIX.4.2<\/span>\n| <span>9=102<\/span>\n| <span>35=c<\/span>\n| <span>34=186<\/span>\n| <span>49=WTEOUATSD<\/span>\n| <span>52=20220803-09:07:21<\/span>\n| <span>56=TT_SD<\/span>\n| <span class=\"highlight\">167=OPT<\/span>\n| <span class=\"highlight\">207=JPX<\/span>\n| <span class=\"highlight\">55=225<\/span>\n| <span class=\"highlight\">200=202312<\/span>\n| <span>320=12345a14<\/span>\n| <span>10=157<\/span>\n|\n<\/div>\n\n\n\n<h3 id=\"request-multileg\">Requesting Multileg Products: SecurityType = MLEG<\/h3>\n<h4>Using ExDestination (tag 100) and Symbol (tag 55)<\/h4>\n  <p>\n    Request security definitions using <b>SecurityType<\/b> set to <b>MLEG<\/b>, the <b>Exchange<\/b> or <b>ExDestination<\/b> tag, and the <b>Symbol<\/b> to specify product.\n  <\/p>\n<table class=\"table table-striped table-bordered\" border=\"1\">\n  <caption>Required Fields<\/caption>\n\t<thead>\n\t\t<tr>\n      <th width=\"10%\">Tag #<\/th>\n\t\t\t<th width=\"20%\">Name<\/th>\n      <th width=\"70%\">Definition<\/th>\n\t\t<\/tr>\n\t<\/thead>\n  <tbody>\n\t\t<tr>\n\t\t\t<td><a href=\"\/tt-fix\/market-data\/Msg_SecurityDefinition_d.html#tag167\">167<\/a><\/td>\n\t\t\t<td>SecurityType<\/td>\n\t\t\t<td>\n\t\t\t\t<p>\n          Asset class of the instrument.\n        <\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n \t\t<tr>\n\t\t\t<td><a href=\"\/tt-fix\/market-data\/Msg_SecurityDefinition_d.html#tag100\">100<\/a><\/td>\n      <td>ExDestination<\/td>\n\t\t\t<td>\n        <p>Name of the sub-market where the instrument trades.<\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n \t\t<tr>\n\t\t\t<td><a href=\"\/tt-fix\/market-data\/Msg_SecurityDefinition_d.html#tag55\">55<\/a><\/td>\n\t\t\t<td>Symbol<\/td>\n\t\t\t<td>\n        <p>Exchange-provided product symbol for the tradable product.<\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n  <\/tbody>\n<\/table>\n\n<h5>Sample Request for EEX DEBM MULTILEGs<\/h5>\n  Set:\n  <ul>\n   <li><b>SecurityType<\/b> <i>(167)<\/i> to <b>FUT<\/b><\/li>\n   <li><b>ExDestination<\/b> <i>(100)<\/i> to <b>XEER<\/b><\/li>\n   <li><b>Symbol<\/b> <i>(55)<\/i> to <b>DEBM<\/b><\/li>\n  <\/ul>\n\n\n  <div class=\"sample-message\">\n<p>Send:<\/p> \n  <span>8=FIX.4.2<\/span>\n| <span>9=96<\/span>\n| <span>35=c<\/span>\n| <span>34=162<\/span>\n| <span>49=WTEOUATSD<\/span>\n| <span>52=20220803-08:46:20<\/span>\n| <span>56=TT_SD<\/span>\n| <span class=\"highlight\">167=MLEG<\/span>\n| <span class=\"highlight\">100=XEER<\/span>\n| <span class=\"highlight\">55=DEBM<\/span>\n| <span>320=12345axee0<\/span>\n| <span>10=114<\/span>\n|\n<\/div>\n\n\n\t<\/section>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"excerpt":{"rendered":"<p>The following article provides information on making Security Definition requests. Security Definitions enable [&hellip;]<\/p>\n","protected":false},"author":2,"template":"","meta":{"_acf_changed":false,"footnotes":""},"docs-category":[478],"class_list":["post-7149","doc","type-doc","status-publish","hentry","docs-category-tt-fix-message-conversations-tt-fix-market-data"],"acf":[],"_links":{"self":[{"href":"https:\/\/library-staging.tradingtechnologies.com\/ja\/wp-json\/wp\/v2\/doc\/7149","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/library-staging.tradingtechnologies.com\/ja\/wp-json\/wp\/v2\/doc"}],"about":[{"href":"https:\/\/library-staging.tradingtechnologies.com\/ja\/wp-json\/wp\/v2\/types\/doc"}],"author":[{"embeddable":true,"href":"https:\/\/library-staging.tradingtechnologies.com\/ja\/wp-json\/wp\/v2\/users\/2"}],"version-history":[{"count":0,"href":"https:\/\/library-staging.tradingtechnologies.com\/ja\/wp-json\/wp\/v2\/doc\/7149\/revisions"}],"wp:attachment":[{"href":"https:\/\/library-staging.tradingtechnologies.com\/ja\/wp-json\/wp\/v2\/media?parent=7149"}],"wp:term":[{"taxonomy":"docs-category","embeddable":true,"href":"https:\/\/library-staging.tradingtechnologies.com\/ja\/wp-json\/wp\/v2\/docs-category?post=7149"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}