Instrument Definition API

getInstrumentDefinition

The getInstrumentDefinition API from Barchart OnDemand is available to request metadata on financial instruments by symbol, exchange, or exchange MIC. Metadata includes instrument names, exchange codes, tick increments, base codes, expiration dates and more.

View All APIs

Contact Us to Get Access

First Name^*

Last Name^*

Email Address^*

Phone^*

Company^*

Role^*

Industry^*

Country^*

What you are looking for?^*

Please provide as much information as possible (e.g. exchanges, markets or other data sources), the APIs you are interested in (e.g. getQuote, getHistory, getChart, getCorporateActions, etc.), and your use case.

Here are some examples: Example #1, Example #2, Example #3.

By submitting this form you are opting in to receive email communications from Barchart for related product, service or company information, updates and announcements. You can unsubscribe at anytime. View our Privacy Policy.

Inputs

symbols^optional

A symbol or code that identifies a financial instrument.

Type

list (A comma or semi-colon delimited string.)

exchanges^optional

Exchange code for the marketplace where the financial instruments are listed.

Type

list-enum (A comma or semi-colon delimited string that must match a list of valid possible values.)

Example

CME

Valid Values

FOREX, RATE, RATES, SECTOR, DGCX, DME, MATBA, ROFEX, ASX, SFE, BMF, BSE, CNSX, INDEX-TSX, MNTRL, TSX, TSX-V, WCE, CFFEX, CZCE, DCE, SHFE, EEX, EUIDX, EUREX, MEFF, MATIF, HKFE, MCX, NCDEX, NSE, ISE, JPX, TOCOM, KFE, MDEX, NZX, MOEX, OMX, ICESI, TFEX, TAIWA, ICE, LCE, LIFFE, LME, LSE, AMEX, BATS, CADFUNDS, CBOT, CBOTM, CFE, CME, COMEX, CRYPTO, CXMI, ERIS, FUND, GBLX, GREEN, ICEUS, INDEX, INDEX-CBOE, INDEX-DOW, INDEX-NQ, INDEX-NY, INDEX-RL, INDEX-SP, KCBT, MIAX, NASDAQ, NYMEX, NYMI, NYSE, OTC-BB, OTHER OTC, TRADAIR, SAFEX, SIMEX, C3, C3_BUNKER, PLATTS, CXE, BXE, DXE, EURNXT_EQ_BE, EURNXT_EQ_FR, EURNXT_EQ_NL, EURNXT_EQ_PT, ENDEX, EEX_POWER, OMX_POWER

exchangeMics^optional

Market Indicator Code for the marketplace where the financial instruments are listed.

Type

list (A comma or semi-colon delimited string.)

Example

XCME

maxRecords^optional

The maximum number of records requested.

Type

int (A numeric type defining a whole number. (example: 2))

Example

20

Default

100

offset^optional

A value denoting where to start results from.

Type

int (A numeric type defining a whole number. (example: 2))

Example

10

returnExpired^optional

If you would like to request data for an expired futures contract, please set this parameter to true.

Type

boolean (A logical type representing the truth of a value as 'true' or 'false'.)

Example

1

Outputs

guid
always returned

Globally Unique Identifier of a financial instrument.

string
A sequence of characters. (example: GOOG)

id
always returned

Identifier of a financial instrument.

string
A sequence of characters. (example: GOOG)

symbolRealtime
always returned

The Realtime name of the instrument.

string
A sequence of characters. (example: GOOG)

symbolHistorical
always returned

The Historical name of the instrument.

string
A sequence of characters. (example: GOOG)

symbolDdf
always returned

The DDF name of the instrument.

string
A sequence of characters. (example: GOOG)

symbol
always returned

A symbol or code that identifies a financial instrument.

string
A sequence of characters. (example: GOOG)

symbolName
always returned

The full name of the instrument.

string
A sequence of characters. (example: GOOG)

symbolExpiration
always returned

The last day that the financial instrument is traded.

date
A date in the format of YYYY-MM-DD.

symbolCFI
always returned

The symbol's classification of financial instruments code.

string
A sequence of characters. (example: GOOG)

exchange
always returned

Exchange code for the marketplace where the financial instruments are listed.

string
A sequence of characters. (example: GOOG)

exchangeName
always returned

The name of the exchange.

string
A sequence of characters. (example: GOOG)

exchangeCode
always returned

The smallest increment at which the financial instrument can be traded.

string
A sequence of characters. (example: GOOG)

tickIncrement
always returned

The number of units that make up one tick. For example, U.S. equities are quotes in decimals, and tick in decimals, and can go up +/- .01. So the tick increment is 1. But the e-mini S&P futures contract, though quoted in decimals, goes up in .25 increments, so the tick increment is 25.

int
A numeric type defining a whole number. (example: 2)

baseCode
always returned

Indicates the fractional or decimal precision of the instrument.

2 = 1/8 = one digit fraction, range is 0 - 7
3 = 1/16 = two digit fraction, range is 0 - 15
4 = 1/32 = two digit fraction, range is 0 - 31
5 = 1/64 = two digit fraction, range is 0 - 63
6 = 1/128 = three digit fraction, range is 0 - 127
7 = 1/256 = three digit fraction, range is 0 - 255
8 = 0 = no decimal places, a whole number
9 = 0.1 = one decimal place
A = 0.01 = two decimal places
B = 0.001 = three decimal places
C = 0.0001 = four decimal places
D = 0.00001 = five decimal places
E = 0.000001 = six decimal places
F = 0.0000001 = seven decimal places
* = unchanged = transmitted by ddfplus with size only data

string
A sequence of characters. (example: GOOG)

unitCode
always returned

The corresponding unit code

int
A numeric type defining a whole number. (example: 2)

pointValue
always returned

An indicator representing the value of one point in dollar terms. This applies to futures.

double
A numeric type defining a number with fractional parts. (example: 2.14)

Status Code Responses

200

OK

Success

400

Bad Request

The request was invalid, please see the message for more information.

500

Internal Server Error

Something is not working correctly, please contact support.

JSON

GET

GET https://ondemand.websol.barchart.com/getInstrumentDefinition.json?apikey=YOUR_API_KEY&exchanges=CME&exchangeMics=XCME&maxRecords=20&offset=10&returnExpired=1
Host: ondemand.websol.barchart.com

POST

POST https://ondemand.websol.barchart.com/getInstrumentDefinition.json
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

apikey=YOUR_API_KEY&exchanges=CME&exchangeMics=XCME&maxRecords=20&offset=10&returnExpired=1

Response

{
    "status": {
        "code": 200,
        "message": "Success."
    },
    "results": [
        {
            "guid": "BDH2008",
            "id": "1032654",
            "symbolRealtime": "BDH2008",
            "symbolHistorical": "BDH08",
            "symbolDdf": "BDH8",
            "symbol": "BDH8",
            "symbolName": "Butter Cash-Settled",
            "symbolExpiration": "2008-03-31",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 250,
            "baseCode": "B",
            "unitCode": 3,
            "pointValue": 200
        },
        {
            "guid": "BDH2009",
            "id": "1032655",
            "symbolRealtime": "BDH2009",
            "symbolHistorical": "BDH09",
            "symbolDdf": "BDH9",
            "symbol": "BDH9",
            "symbolName": "Butter Cash-Settled",
            "symbolExpiration": "2009-03-31",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 250,
            "baseCode": "B",
            "unitCode": 3,
            "pointValue": 200
        },
        {
            "guid": "BDH2010",
            "id": "1032656",
            "symbolRealtime": "BDH2010",
            "symbolHistorical": "BDH10",
            "symbolDdf": "BDH0",
            "symbol": "BDH0",
            "symbolName": "Butter Cash-Settled",
            "symbolExpiration": "2010-03-31",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 250,
            "baseCode": "B",
            "unitCode": 3,
            "pointValue": 200
        },
        {
            "guid": "BDH2011",
            "id": "1032657",
            "symbolRealtime": "BDH2011",
            "symbolHistorical": "BDH11",
            "symbolDdf": "BDH1",
            "symbol": "BDH1",
            "symbolName": "Butter Cash-Settled",
            "symbolExpiration": "2011-03-31",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 250,
            "baseCode": "B",
            "unitCode": 3,
            "pointValue": 200
        },
        {
            "guid": "BDH2012",
            "id": "1032658",
            "symbolRealtime": "BDH2012",
            "symbolHistorical": "BDH12",
            "symbolDdf": "BDH2",
            "symbol": "BDH2",
            "symbolName": "Butter Cash-Settled",
            "symbolExpiration": "2012-03-30",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 250,
            "baseCode": "B",
            "unitCode": 3,
            "pointValue": 200
        },
        {
            "guid": "BDJ2008",
            "id": "1032777",
            "symbolRealtime": "BDJ2008",
            "symbolHistorical": "BDJ08",
            "symbolDdf": "BDJ8",
            "symbol": "BDJ8",
            "symbolName": "Butter Cash-Settled",
            "symbolExpiration": "2008-04-30",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 250,
            "baseCode": "B",
            "unitCode": 3,
            "pointValue": 200
        },
        {
            "guid": "BDJ2009",
            "id": "1032778",
            "symbolRealtime": "BDJ2009",
            "symbolHistorical": "BDJ09",
            "symbolDdf": "BDJ9",
            "symbol": "BDJ9",
            "symbolName": "Butter Cash-Settled",
            "symbolExpiration": "2009-04-30",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 250,
            "baseCode": "B",
            "unitCode": 3,
            "pointValue": 200
        },
        {
            "guid": "BDJ2010",
            "id": "1032779",
            "symbolRealtime": "BDJ2010",
            "symbolHistorical": "BDJ10",
            "symbolDdf": "BDJ0",
            "symbol": "BDJ0",
            "symbolName": "Butter Cash-Settled",
            "symbolExpiration": "2010-04-30",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 250,
            "baseCode": "B",
            "unitCode": 3,
            "pointValue": 200
        },
        {
            "guid": "BDJ2011",
            "id": "1032780",
            "symbolRealtime": "BDJ2011",
            "symbolHistorical": "BDJ11",
            "symbolDdf": "BDJ1",
            "symbol": "BDJ1",
            "symbolName": "Butter Cash-Settled",
            "symbolExpiration": "2011-04-29",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 250,
            "baseCode": "B",
            "unitCode": 3,
            "pointValue": 200
        },
        {
            "guid": "BDK2008",
            "id": "1032893",
            "symbolRealtime": "BDK2008",
            "symbolHistorical": "BDK08",
            "symbolDdf": "BDK8",
            "symbol": "BDK8",
            "symbolName": "Butter Cash-Settled",
            "symbolExpiration": "2008-05-29",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 250,
            "baseCode": "B",
            "unitCode": 3,
            "pointValue": 200
        },
        {
            "guid": "BDK2009",
            "id": "1032894",
            "symbolRealtime": "BDK2009",
            "symbolHistorical": "BDK09",
            "symbolDdf": "BDK9",
            "symbol": "BDK9",
            "symbolName": "Butter Cash-Settled",
            "symbolExpiration": "2009-05-29",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 250,
            "baseCode": "B",
            "unitCode": 3,
            "pointValue": 200
        },
        {
            "guid": "BDK2010",
            "id": "1032895",
            "symbolRealtime": "BDK2010",
            "symbolHistorical": "BDK10",
            "symbolDdf": "BDK0",
            "symbol": "BDK0",
            "symbolName": "Butter Cash-Settled",
            "symbolExpiration": "2010-05-28",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 250,
            "baseCode": "B",
            "unitCode": 3,
            "pointValue": 200
        },
        {
            "guid": "BDK2011",
            "id": "1032896",
            "symbolRealtime": "BDK2011",
            "symbolHistorical": "BDK11",
            "symbolDdf": "BDK1",
            "symbol": "BDK1",
            "symbolName": "Butter Cash-Settled",
            "symbolExpiration": "2011-05-31",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 250,
            "baseCode": "B",
            "unitCode": 3,
            "pointValue": 200
        },
        {
            "guid": "BDM2008",
            "id": "1033024",
            "symbolRealtime": "BDM2008",
            "symbolHistorical": "BDM08",
            "symbolDdf": "BDM8",
            "symbol": "BDM8",
            "symbolName": "Butter Cash-Settled",
            "symbolExpiration": "2008-06-30",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 250,
            "baseCode": "B",
            "unitCode": 3,
            "pointValue": 200
        },
        {
            "guid": "BDM2009",
            "id": "1033025",
            "symbolRealtime": "BDM2009",
            "symbolHistorical": "BDM09",
            "symbolDdf": "BDM9",
            "symbol": "BDM9",
            "symbolName": "Butter Cash-Settled",
            "symbolExpiration": "2009-06-30",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 250,
            "baseCode": "B",
            "unitCode": 3,
            "pointValue": 200
        },
        {
            "guid": "BDM2010",
            "id": "1033026",
            "symbolRealtime": "BDM2010",
            "symbolHistorical": "BDM10",
            "symbolDdf": "BDM0",
            "symbol": "BDM0",
            "symbolName": "Butter Cash-Settled",
            "symbolExpiration": "2010-06-30",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 250,
            "baseCode": "B",
            "unitCode": 3,
            "pointValue": 200
        },
        {
            "guid": "BDM2011",
            "id": "1033027",
            "symbolRealtime": "BDM2011",
            "symbolHistorical": "BDM11",
            "symbolDdf": "BDM1",
            "symbol": "BDM1",
            "symbolName": "Butter Cash-Settled",
            "symbolExpiration": "2011-06-30",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 250,
            "baseCode": "B",
            "unitCode": 3,
            "pointValue": 200
        },
        {
            "guid": "BDN2008",
            "id": "1033161",
            "symbolRealtime": "BDN2008",
            "symbolHistorical": "BDN08",
            "symbolDdf": "BDN8",
            "symbol": "BDN8",
            "symbolName": "Butter Cash-Settled",
            "symbolExpiration": "2008-07-31",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 250,
            "baseCode": "B",
            "unitCode": 3,
            "pointValue": 200
        },
        {
            "guid": "BDN2009",
            "id": "1033162",
            "symbolRealtime": "BDN2009",
            "symbolHistorical": "BDN09",
            "symbolDdf": "BDN9",
            "symbol": "BDN9",
            "symbolName": "Butter Cash-Settled",
            "symbolExpiration": "2009-07-30",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 250,
            "baseCode": "B",
            "unitCode": 3,
            "pointValue": 200
        },
        {
            "guid": "BDN2010",
            "id": "1033163",
            "symbolRealtime": "BDN2010",
            "symbolHistorical": "BDN10",
            "symbolDdf": "BDN0",
            "symbol": "BDN0",
            "symbolName": "Butter Cash-Settled",
            "symbolExpiration": "2010-07-30",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 250,
            "baseCode": "B",
            "unitCode": 3,
            "pointValue": 200
        }
    ]
}

XML

GET

GET https://ondemand.websol.barchart.com/getInstrumentDefinition.xml?apikey=YOUR_API_KEY&exchanges=CME&exchangeMics=XCME&maxRecords=20&offset=10&returnExpired=1
Host: ondemand.websol.barchart.com

POST

POST https://ondemand.websol.barchart.com/getInstrumentDefinition.xml
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

apikey=YOUR_API_KEY&exchanges=CME&exchangeMics=XCME&maxRecords=20&offset=10&returnExpired=1

Response

<?xml version="1.0" encoding="utf-8"?>
<getInstrumentDefinition>
  <status>
    <code>200</code>
    <message>Success.</message>
  </status>
  <item>
    <guid>BDH2008</guid>
    <id>1032654</id>
    <symbolRealtime>BDH2008</symbolRealtime>
    <symbolHistorical>BDH08</symbolHistorical>
    <symbolDdf>BDH8</symbolDdf>
    <symbol>BDH8</symbol>
    <symbolName>Butter Cash-Settled</symbolName>
    <symbolExpiration>2008-03-31</symbolExpiration>
    <symbolCFI>FXXXXX</symbolCFI>
    <exchange>CME</exchange>
    <exchangeName>CME</exchangeName>
    <exchangeCode>M</exchangeCode>
    <tickIncrement>250</tickIncrement>
    <baseCode>B</baseCode>
    <unitCode>3</unitCode>
    <pointValue>200</pointValue>
  </item>
  <item>
    <guid>BDH2009</guid>
    <id>1032655</id>
    <symbolRealtime>BDH2009</symbolRealtime>
    <symbolHistorical>BDH09</symbolHistorical>
    <symbolDdf>BDH9</symbolDdf>
    <symbol>BDH9</symbol>
    <symbolName>Butter Cash-Settled</symbolName>
    <symbolExpiration>2009-03-31</symbolExpiration>
    <symbolCFI>FXXXXX</symbolCFI>
    <exchange>CME</exchange>
    <exchangeName>CME</exchangeName>
    <exchangeCode>M</exchangeCode>
    <tickIncrement>250</tickIncrement>
    <baseCode>B</baseCode>
    <unitCode>3</unitCode>
    <pointValue>200</pointValue>
  </item>
  <item>
    <guid>BDH2010</guid>
    <id>1032656</id>
    <symbolRealtime>BDH2010</symbolRealtime>
    <symbolHistorical>BDH10</symbolHistorical>
    <symbolDdf>BDH0</symbolDdf>
    <symbol>BDH0</symbol>
    <symbolName>Butter Cash-Settled</symbolName>
    <symbolExpiration>2010-03-31</symbolExpiration>
    <symbolCFI>FXXXXX</symbolCFI>
    <exchange>CME</exchange>
    <exchangeName>CME</exchangeName>
    <exchangeCode>M</exchangeCode>
    <tickIncrement>250</tickIncrement>
    <baseCode>B</baseCode>
    <unitCode>3</unitCode>
    <pointValue>200</pointValue>
  </item>
  <item>
    <guid>BDH2011</guid>
    <id>1032657</id>
    <symbolRealtime>BDH2011</symbolRealtime>
    <symbolHistorical>BDH11</symbolHistorical>
    <symbolDdf>BDH1</symbolDdf>
    <symbol>BDH1</symbol>
    <symbolName>Butter Cash-Settled</symbolName>
    <symbolExpiration>2011-03-31</symbolExpiration>
    <symbolCFI>FXXXXX</symbolCFI>
    <exchange>CME</exchange>
    <exchangeName>CME</exchangeName>
    <exchangeCode>M</exchangeCode>
    <tickIncrement>250</tickIncrement>
    <baseCode>B</baseCode>
    <unitCode>3</unitCode>
    <pointValue>200</pointValue>
  </item>
  <item>
    <guid>BDH2012</guid>
    <id>1032658</id>
    <symbolRealtime>BDH2012</symbolRealtime>
    <symbolHistorical>BDH12</symbolHistorical>
    <symbolDdf>BDH2</symbolDdf>
    <symbol>BDH2</symbol>
    <symbolName>Butter Cash-Settled</symbolName>
    <symbolExpiration>2012-03-30</symbolExpiration>
    <symbolCFI>FXXXXX</symbolCFI>
    <exchange>CME</exchange>
    <exchangeName>CME</exchangeName>
    <exchangeCode>M</exchangeCode>
    <tickIncrement>250</tickIncrement>
    <baseCode>B</baseCode>
    <unitCode>3</unitCode>
    <pointValue>200</pointValue>
  </item>
  <item>
    <guid>BDJ2008</guid>
    <id>1032777</id>
    <symbolRealtime>BDJ2008</symbolRealtime>
    <symbolHistorical>BDJ08</symbolHistorical>
    <symbolDdf>BDJ8</symbolDdf>
    <symbol>BDJ8</symbol>
    <symbolName>Butter Cash-Settled</symbolName>
    <symbolExpiration>2008-04-30</symbolExpiration>
    <symbolCFI>FXXXXX</symbolCFI>
    <exchange>CME</exchange>
    <exchangeName>CME</exchangeName>
    <exchangeCode>M</exchangeCode>
    <tickIncrement>250</tickIncrement>
    <baseCode>B</baseCode>
    <unitCode>3</unitCode>
    <pointValue>200</pointValue>
  </item>
  <item>
    <guid>BDJ2009</guid>
    <id>1032778</id>
    <symbolRealtime>BDJ2009</symbolRealtime>
    <symbolHistorical>BDJ09</symbolHistorical>
    <symbolDdf>BDJ9</symbolDdf>
    <symbol>BDJ9</symbol>
    <symbolName>Butter Cash-Settled</symbolName>
    <symbolExpiration>2009-04-30</symbolExpiration>
    <symbolCFI>FXXXXX</symbolCFI>
    <exchange>CME</exchange>
    <exchangeName>CME</exchangeName>
    <exchangeCode>M</exchangeCode>
    <tickIncrement>250</tickIncrement>
    <baseCode>B</baseCode>
    <unitCode>3</unitCode>
    <pointValue>200</pointValue>
  </item>
  <item>
    <guid>BDJ2010</guid>
    <id>1032779</id>
    <symbolRealtime>BDJ2010</symbolRealtime>
    <symbolHistorical>BDJ10</symbolHistorical>
    <symbolDdf>BDJ0</symbolDdf>
    <symbol>BDJ0</symbol>
    <symbolName>Butter Cash-Settled</symbolName>
    <symbolExpiration>2010-04-30</symbolExpiration>
    <symbolCFI>FXXXXX</symbolCFI>
    <exchange>CME</exchange>
    <exchangeName>CME</exchangeName>
    <exchangeCode>M</exchangeCode>
    <tickIncrement>250</tickIncrement>
    <baseCode>B</baseCode>
    <unitCode>3</unitCode>
    <pointValue>200</pointValue>
  </item>
  <item>
    <guid>BDJ2011</guid>
    <id>1032780</id>
    <symbolRealtime>BDJ2011</symbolRealtime>
    <symbolHistorical>BDJ11</symbolHistorical>
    <symbolDdf>BDJ1</symbolDdf>
    <symbol>BDJ1</symbol>
    <symbolName>Butter Cash-Settled</symbolName>
    <symbolExpiration>2011-04-29</symbolExpiration>
    <symbolCFI>FXXXXX</symbolCFI>
    <exchange>CME</exchange>
    <exchangeName>CME</exchangeName>
    <exchangeCode>M</exchangeCode>
    <tickIncrement>250</tickIncrement>
    <baseCode>B</baseCode>
    <unitCode>3</unitCode>
    <pointValue>200</pointValue>
  </item>
  <item>
    <guid>BDK2008</guid>
    <id>1032893</id>
    <symbolRealtime>BDK2008</symbolRealtime>
    <symbolHistorical>BDK08</symbolHistorical>
    <symbolDdf>BDK8</symbolDdf>
    <symbol>BDK8</symbol>
    <symbolName>Butter Cash-Settled</symbolName>
    <symbolExpiration>2008-05-29</symbolExpiration>
    <symbolCFI>FXXXXX</symbolCFI>
    <exchange>CME</exchange>
    <exchangeName>CME</exchangeName>
    <exchangeCode>M</exchangeCode>
    <tickIncrement>250</tickIncrement>
    <baseCode>B</baseCode>
    <unitCode>3</unitCode>
    <pointValue>200</pointValue>
  </item>
  <item>
    <guid>BDK2009</guid>
    <id>1032894</id>
    <symbolRealtime>BDK2009</symbolRealtime>
    <symbolHistorical>BDK09</symbolHistorical>
    <symbolDdf>BDK9</symbolDdf>
    <symbol>BDK9</symbol>
    <symbolName>Butter Cash-Settled</symbolName>
    <symbolExpiration>2009-05-29</symbolExpiration>
    <symbolCFI>FXXXXX</symbolCFI>
    <exchange>CME</exchange>
    <exchangeName>CME</exchangeName>
    <exchangeCode>M</exchangeCode>
    <tickIncrement>250</tickIncrement>
    <baseCode>B</baseCode>
    <unitCode>3</unitCode>
    <pointValue>200</pointValue>
  </item>
  <item>
    <guid>BDK2010</guid>
    <id>1032895</id>
    <symbolRealtime>BDK2010</symbolRealtime>
    <symbolHistorical>BDK10</symbolHistorical>
    <symbolDdf>BDK0</symbolDdf>
    <symbol>BDK0</symbol>
    <symbolName>Butter Cash-Settled</symbolName>
    <symbolExpiration>2010-05-28</symbolExpiration>
    <symbolCFI>FXXXXX</symbolCFI>
    <exchange>CME</exchange>
    <exchangeName>CME</exchangeName>
    <exchangeCode>M</exchangeCode>
    <tickIncrement>250</tickIncrement>
    <baseCode>B</baseCode>
    <unitCode>3</unitCode>
    <pointValue>200</pointValue>
  </item>
  <item>
    <guid>BDK2011</guid>
    <id>1032896</id>
    <symbolRealtime>BDK2011</symbolRealtime>
    <symbolHistorical>BDK11</symbolHistorical>
    <symbolDdf>BDK1</symbolDdf>
    <symbol>BDK1</symbol>
    <symbolName>Butter Cash-Settled</symbolName>
    <symbolExpiration>2011-05-31</symbolExpiration>
    <symbolCFI>FXXXXX</symbolCFI>
    <exchange>CME</exchange>
    <exchangeName>CME</exchangeName>
    <exchangeCode>M</exchangeCode>
    <tickIncrement>250</tickIncrement>
    <baseCode>B</baseCode>
    <unitCode>3</unitCode>
    <pointValue>200</pointValue>
  </item>
  <item>
    <guid>BDM2008</guid>
    <id>1033024</id>
    <symbolRealtime>BDM2008</symbolRealtime>
    <symbolHistorical>BDM08</symbolHistorical>
    <symbolDdf>BDM8</symbolDdf>
    <symbol>BDM8</symbol>
    <symbolName>Butter Cash-Settled</symbolName>
    <symbolExpiration>2008-06-30</symbolExpiration>
    <symbolCFI>FXXXXX</symbolCFI>
    <exchange>CME</exchange>
    <exchangeName>CME</exchangeName>
    <exchangeCode>M</exchangeCode>
    <tickIncrement>250</tickIncrement>
    <baseCode>B</baseCode>
    <unitCode>3</unitCode>
    <pointValue>200</pointValue>
  </item>
  <item>
    <guid>BDM2009</guid>
    <id>1033025</id>
    <symbolRealtime>BDM2009</symbolRealtime>
    <symbolHistorical>BDM09</symbolHistorical>
    <symbolDdf>BDM9</symbolDdf>
    <symbol>BDM9</symbol>
    <symbolName>Butter Cash-Settled</symbolName>
    <symbolExpiration>2009-06-30</symbolExpiration>
    <symbolCFI>FXXXXX</symbolCFI>
    <exchange>CME</exchange>
    <exchangeName>CME</exchangeName>
    <exchangeCode>M</exchangeCode>
    <tickIncrement>250</tickIncrement>
    <baseCode>B</baseCode>
    <unitCode>3</unitCode>
    <pointValue>200</pointValue>
  </item>
  <item>
    <guid>BDM2010</guid>
    <id>1033026</id>
    <symbolRealtime>BDM2010</symbolRealtime>
    <symbolHistorical>BDM10</symbolHistorical>
    <symbolDdf>BDM0</symbolDdf>
    <symbol>BDM0</symbol>
    <symbolName>Butter Cash-Settled</symbolName>
    <symbolExpiration>2010-06-30</symbolExpiration>
    <symbolCFI>FXXXXX</symbolCFI>
    <exchange>CME</exchange>
    <exchangeName>CME</exchangeName>
    <exchangeCode>M</exchangeCode>
    <tickIncrement>250</tickIncrement>
    <baseCode>B</baseCode>
    <unitCode>3</unitCode>
    <pointValue>200</pointValue>
  </item>
  <item>
    <guid>BDM2011</guid>
    <id>1033027</id>
    <symbolRealtime>BDM2011</symbolRealtime>
    <symbolHistorical>BDM11</symbolHistorical>
    <symbolDdf>BDM1</symbolDdf>
    <symbol>BDM1</symbol>
    <symbolName>Butter Cash-Settled</symbolName>
    <symbolExpiration>2011-06-30</symbolExpiration>
    <symbolCFI>FXXXXX</symbolCFI>
    <exchange>CME</exchange>
    <exchangeName>CME</exchangeName>
    <exchangeCode>M</exchangeCode>
    <tickIncrement>250</tickIncrement>
    <baseCode>B</baseCode>
    <unitCode>3</unitCode>
    <pointValue>200</pointValue>
  </item>
  <item>
    <guid>BDN2008</guid>
    <id>1033161</id>
    <symbolRealtime>BDN2008</symbolRealtime>
    <symbolHistorical>BDN08</symbolHistorical>
    <symbolDdf>BDN8</symbolDdf>
    <symbol>BDN8</symbol>
    <symbolName>Butter Cash-Settled</symbolName>
    <symbolExpiration>2008-07-31</symbolExpiration>
    <symbolCFI>FXXXXX</symbolCFI>
    <exchange>CME</exchange>
    <exchangeName>CME</exchangeName>
    <exchangeCode>M</exchangeCode>
    <tickIncrement>250</tickIncrement>
    <baseCode>B</baseCode>
    <unitCode>3</unitCode>
    <pointValue>200</pointValue>
  </item>
  <item>
    <guid>BDN2009</guid>
    <id>1033162</id>
    <symbolRealtime>BDN2009</symbolRealtime>
    <symbolHistorical>BDN09</symbolHistorical>
    <symbolDdf>BDN9</symbolDdf>
    <symbol>BDN9</symbol>
    <symbolName>Butter Cash-Settled</symbolName>
    <symbolExpiration>2009-07-30</symbolExpiration>
    <symbolCFI>FXXXXX</symbolCFI>
    <exchange>CME</exchange>
    <exchangeName>CME</exchangeName>
    <exchangeCode>M</exchangeCode>
    <tickIncrement>250</tickIncrement>
    <baseCode>B</baseCode>
    <unitCode>3</unitCode>
    <pointValue>200</pointValue>
  </item>
  <item>
    <guid>BDN2010</guid>
    <id>1033163</id>
    <symbolRealtime>BDN2010</symbolRealtime>
    <symbolHistorical>BDN10</symbolHistorical>
    <symbolDdf>BDN0</symbolDdf>
    <symbol>BDN0</symbol>
    <symbolName>Butter Cash-Settled</symbolName>
    <symbolExpiration>2010-07-30</symbolExpiration>
    <symbolCFI>FXXXXX</symbolCFI>
    <exchange>CME</exchange>
    <exchangeName>CME</exchangeName>
    <exchangeCode>M</exchangeCode>
    <tickIncrement>250</tickIncrement>
    <baseCode>B</baseCode>
    <unitCode>3</unitCode>
    <pointValue>200</pointValue>
  </item>
</getInstrumentDefinition>

CSV

GET

GET https://ondemand.websol.barchart.com/getInstrumentDefinition.csv?apikey=YOUR_API_KEY&exchanges=CME&exchangeMics=XCME&maxRecords=20&offset=10&returnExpired=1
Host: ondemand.websol.barchart.com

POST

POST https://ondemand.websol.barchart.com/getInstrumentDefinition.csv
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

apikey=YOUR_API_KEY&exchanges=CME&exchangeMics=XCME&maxRecords=20&offset=10&returnExpired=1

Response

guid,id,symbolRealtime,symbolHistorical,symbolDdf,symbol,symbolName,symbolExpiration,symbolCFI,exchange,exchangeName,exchangeCode,tickIncrement,baseCode,unitCode,pointValue
"BDH2008","1032654","BDH2008","BDH08","BDH8","BDH8","Butter Cash-Settled","2008-03-31","FXXXXX","CME","CME","M","250","B","3","200"
"BDH2009","1032655","BDH2009","BDH09","BDH9","BDH9","Butter Cash-Settled","2009-03-31","FXXXXX","CME","CME","M","250","B","3","200"
"BDH2010","1032656","BDH2010","BDH10","BDH0","BDH0","Butter Cash-Settled","2010-03-31","FXXXXX","CME","CME","M","250","B","3","200"
"BDH2011","1032657","BDH2011","BDH11","BDH1","BDH1","Butter Cash-Settled","2011-03-31","FXXXXX","CME","CME","M","250","B","3","200"
"BDH2012","1032658","BDH2012","BDH12","BDH2","BDH2","Butter Cash-Settled","2012-03-30","FXXXXX","CME","CME","M","250","B","3","200"
"BDJ2008","1032777","BDJ2008","BDJ08","BDJ8","BDJ8","Butter Cash-Settled","2008-04-30","FXXXXX","CME","CME","M","250","B","3","200"
"BDJ2009","1032778","BDJ2009","BDJ09","BDJ9","BDJ9","Butter Cash-Settled","2009-04-30","FXXXXX","CME","CME","M","250","B","3","200"
"BDJ2010","1032779","BDJ2010","BDJ10","BDJ0","BDJ0","Butter Cash-Settled","2010-04-30","FXXXXX","CME","CME","M","250","B","3","200"
"BDJ2011","1032780","BDJ2011","BDJ11","BDJ1","BDJ1","Butter Cash-Settled","2011-04-29","FXXXXX","CME","CME","M","250","B","3","200"
"BDK2008","1032893","BDK2008","BDK08","BDK8","BDK8","Butter Cash-Settled","2008-05-29","FXXXXX","CME","CME","M","250","B","3","200"
"BDK2009","1032894","BDK2009","BDK09","BDK9","BDK9","Butter Cash-Settled","2009-05-29","FXXXXX","CME","CME","M","250","B","3","200"
"BDK2010","1032895","BDK2010","BDK10","BDK0","BDK0","Butter Cash-Settled","2010-05-28","FXXXXX","CME","CME","M","250","B","3","200"
"BDK2011","1032896","BDK2011","BDK11","BDK1","BDK1","Butter Cash-Settled","2011-05-31","FXXXXX","CME","CME","M","250","B","3","200"
"BDM2008","1033024","BDM2008","BDM08","BDM8","BDM8","Butter Cash-Settled","2008-06-30","FXXXXX","CME","CME","M","250","B","3","200"
"BDM2009","1033025","BDM2009","BDM09","BDM9","BDM9","Butter Cash-Settled","2009-06-30","FXXXXX","CME","CME","M","250","B","3","200"
"BDM2010","1033026","BDM2010","BDM10","BDM0","BDM0","Butter Cash-Settled","2010-06-30","FXXXXX","CME","CME","M","250","B","3","200"
"BDM2011","1033027","BDM2011","BDM11","BDM1","BDM1","Butter Cash-Settled","2011-06-30","FXXXXX","CME","CME","M","250","B","3","200"
"BDN2008","1033161","BDN2008","BDN08","BDN8","BDN8","Butter Cash-Settled","2008-07-31","FXXXXX","CME","CME","M","250","B","3","200"
"BDN2009","1033162","BDN2009","BDN09","BDN9","BDN9","Butter Cash-Settled","2009-07-30","FXXXXX","CME","CME","M","250","B","3","200"
"BDN2010","1033163","BDN2010","BDN10","BDN0","BDN0","Butter Cash-Settled","2010-07-30","FXXXXX","CME","CME","M","250","B","3","200"

PHP

<?php

$ondemand = new SoapClient('https://ondemand.websol.barchart.com/service?wsdl');

$params = [
    'apikey' => 'YOUR_API_KEY',
    'exchanges' => 'CME',
    'exchangeMics' => 'XCME',
    'maxRecords' => '20',
    'offset' => '10',
    'returnExpired' => '1',
];

$result = $ondemand->getInstrumentDefinition($params);
var_dump($result);

Classic ASP

Dim ondemand
Dim result

Set ondemand = Server.CreateObject("MSSOAP.SoapClient30")
ondemand.ClientProperty("ServerHTTPRequest") = True
ondemand.MSSoapInit("https://ondemand.websol.barchart.com/service?wsdl")

Set result = ondemand.getInstrumentDefinition("YOUR_API_KEY", "CME", "XCME", "20", "10", "1")

Perl

use SOAP::Lite;
use SOAP::WSDL;

my $ondemand = SOAP::Lite
    -> service('https://ondemand.websol.barchart.com/service?wsdl');

my $result = $ondemand->getInstrumentDefinition('YOUR_API_KEY', 'CME', 'XCME', '20', '10', '1');

print $result;

Python

from suds.client import Client
ondemand = Client('https://ondemand.websol.barchart.com/service?wsdl')

result = ondemand.service.getInstrumentDefinition('YOUR_API_KEY', 'CME', 'XCME', '20', '10', '1')

print(result)

Ruby

require 'savon'

ondemand = Savon.client(wsdl: 'https://ondemand.websol.barchart.com/service?wsdl')

response = ondemand.call(
    :getInstrumentDefinition,
    message: {
        apikey: 'YOUR_API_KEY',
        exchanges: 'CME',
        exchangeMics: 'XCME',
        maxRecords: '20',
        offset: '10',
        returnExpired: '1',
    }
)

response.body