getInstrumentDefinition API

The getInstrumentDefinition API 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.

All APIs

Contact Us to Get Access

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, MGEX, NASDAQ, NYMEX, NYMI, NYSE, OTC-BB, OTHER OTC, TRADAIR, SAFEX

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 

Outputs

Name / Requirement
Description
Type
guid
always returned
description
string
A sequence of characters. (example: GOOG)
id
always returned
description
string
A sequence of characters. (example: GOOG)
symbolRealtime
always returned
description
string
A sequence of characters. (example: GOOG)
symbolHistorical
always returned
description
string
A sequence of characters. (example: GOOG)
symbolDdf
always returned
description
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.<br /><br />2 = 1/8 = one digit fraction, range is 0 - 7<br />3 = 1/16 = two digit fraction, range is 0 - 15<br />4 = 1/32 = two digit fraction, range is 0 - 31<br />5 = 1/64 = two digit fraction, range is 0 - 63<br />6 = 1/128 = three digit fraction, range is 0 - 127<br />7 = 1/256 = three digit fraction, range is 0 - 255<br />8 = 0 = no decimal places, a whole number<br />9 = 0.1 = one decimal place<br />A = 0.01 = two decimal places<br />B = 0.001 = three decimal places<br />C = 0.0001 = four decimal places<br />D = 0.00001 = five decimal places<br />E = 0.000001 = six decimal places<br />F = 0.0000001 = seven decimal places<br />* = 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.
int
A numeric type defining a whole number. (example: 2)

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
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

Response

{
    "status": {
        "code": 200,
        "message": "Success."
    },
    "results": [
        {
            "guid": "BRU2018",
            "id": "131403042",
            "symbolRealtime": "BRU2018",
            "symbolHistorical": "BRU18",
            "symbolDdf": "BRU8",
            "symbol": "BRU8",
            "symbolName": "Brazilian Real (Pit)",
            "symbolExpiration": "2018-08-31",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 5,
            "baseCode": "D",
            "unitCode": 5,
            "pointValue": 100000
        },
        {
            "guid": "BRV2018",
            "id": "131403043",
            "symbolRealtime": "BRV2018",
            "symbolHistorical": "BRV18",
            "symbolDdf": "BRV8",
            "symbol": "BRV8",
            "symbolName": "Brazilian Real (Pit)",
            "symbolExpiration": "2018-09-28",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 5,
            "baseCode": "D",
            "unitCode": 5,
            "pointValue": 100000
        },
        {
            "guid": "BRX2018",
            "id": "131403044",
            "symbolRealtime": "BRX2018",
            "symbolHistorical": "BRX18",
            "symbolDdf": "BRX8",
            "symbol": "BRX8",
            "symbolName": "Brazilian Real (Pit)",
            "symbolExpiration": "2018-10-31",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 5,
            "baseCode": "D",
            "unitCode": 5,
            "pointValue": 100000
        },
        {
            "guid": "BRZ2018",
            "id": "131403045",
            "symbolRealtime": "BRZ2018",
            "symbolHistorical": "BRZ18",
            "symbolDdf": "BRZ8",
            "symbol": "BRZ8",
            "symbolName": "Brazilian Real (Pit)",
            "symbolExpiration": "2018-11-30",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 5,
            "baseCode": "D",
            "unitCode": 5,
            "pointValue": 100000
        },
        {
            "guid": "BRF2019",
            "id": "131403046",
            "symbolRealtime": "BRF2019",
            "symbolHistorical": "BRF19",
            "symbolDdf": "BRF9",
            "symbol": "BRF9",
            "symbolName": "Brazilian Real (Pit)",
            "symbolExpiration": "2018-12-31",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 5,
            "baseCode": "D",
            "unitCode": 5,
            "pointValue": 100000
        },
        {
            "guid": "BRG2019",
            "id": "131403047",
            "symbolRealtime": "BRG2019",
            "symbolHistorical": "BRG19",
            "symbolDdf": "BRG9",
            "symbol": "BRG9",
            "symbolName": "Brazilian Real (Pit)",
            "symbolExpiration": "2019-01-31",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 5,
            "baseCode": "D",
            "unitCode": 5,
            "pointValue": 100000
        },
        {
            "guid": "BRH2019",
            "id": "131403048",
            "symbolRealtime": "BRH2019",
            "symbolHistorical": "BRH19",
            "symbolDdf": "BRH9",
            "symbol": "BRH9",
            "symbolName": "Brazilian Real (Pit)",
            "symbolExpiration": "2019-02-28",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 5,
            "baseCode": "D",
            "unitCode": 5,
            "pointValue": 100000
        },
        {
            "guid": "BRJ2019",
            "id": "131403049",
            "symbolRealtime": "BRJ2019",
            "symbolHistorical": "BRJ19",
            "symbolDdf": "BRJ9",
            "symbol": "BRJ9",
            "symbolName": "Brazilian Real (Pit)",
            "symbolExpiration": "2019-03-29",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 5,
            "baseCode": "D",
            "unitCode": 5,
            "pointValue": 100000
        },
        {
            "guid": "BRK2019",
            "id": "131403050",
            "symbolRealtime": "BRK2019",
            "symbolHistorical": "BRK19",
            "symbolDdf": "BRK9",
            "symbol": "BRK9",
            "symbolName": "Brazilian Real (Pit)",
            "symbolExpiration": "2019-04-30",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 5,
            "baseCode": "D",
            "unitCode": 5,
            "pointValue": 100000
        },
        {
            "guid": "BRM2019",
            "id": "131403051",
            "symbolRealtime": "BRM2019",
            "symbolHistorical": "BRM19",
            "symbolDdf": "BRM9",
            "symbol": "BRM9",
            "symbolName": "Brazilian Real (Pit)",
            "symbolExpiration": "2019-05-31",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 5,
            "baseCode": "D",
            "unitCode": 5,
            "pointValue": 100000
        },
        {
            "guid": "BRN2019",
            "id": "131403052",
            "symbolRealtime": "BRN2019",
            "symbolHistorical": "BRN19",
            "symbolDdf": "BRN9",
            "symbol": "BRN9",
            "symbolName": "Brazilian Real (Pit)",
            "symbolExpiration": "2019-06-28",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 5,
            "baseCode": "D",
            "unitCode": 5,
            "pointValue": 100000
        },
        {
            "guid": "BRQ2019",
            "id": "131403053",
            "symbolRealtime": "BRQ2019",
            "symbolHistorical": "BRQ19",
            "symbolDdf": "BRQ9",
            "symbol": "BRQ9",
            "symbolName": "Brazilian Real (Pit)",
            "symbolExpiration": "2019-07-31",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 5,
            "baseCode": "D",
            "unitCode": 5,
            "pointValue": 100000
        },
        {
            "guid": "BRU2019",
            "id": "131403054",
            "symbolRealtime": "BRU2019",
            "symbolHistorical": "BRU19",
            "symbolDdf": "BRU9",
            "symbol": "BRU9",
            "symbolName": "Brazilian Real (Pit)",
            "symbolExpiration": "2019-08-30",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 5,
            "baseCode": "D",
            "unitCode": 5,
            "pointValue": 100000
        },
        {
            "guid": "BRV2019",
            "id": "131403055",
            "symbolRealtime": "BRV2019",
            "symbolHistorical": "BRV19",
            "symbolDdf": "BRV9",
            "symbol": "BRV9",
            "symbolName": "Brazilian Real (Pit)",
            "symbolExpiration": "2019-09-30",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 5,
            "baseCode": "D",
            "unitCode": 5,
            "pointValue": 100000
        },
        {
            "guid": "BRX2019",
            "id": "131403056",
            "symbolRealtime": "BRX2019",
            "symbolHistorical": "BRX19",
            "symbolDdf": "BRX9",
            "symbol": "BRX9",
            "symbolName": "Brazilian Real (Pit)",
            "symbolExpiration": "2019-10-31",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 5,
            "baseCode": "D",
            "unitCode": 5,
            "pointValue": 100000
        },
        {
            "guid": "BRZ2019",
            "id": "131403057",
            "symbolRealtime": "BRZ2019",
            "symbolHistorical": "BRZ19",
            "symbolDdf": "BRZ9",
            "symbol": "BRZ9",
            "symbolName": "Brazilian Real (Pit)",
            "symbolExpiration": "2019-11-29",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 5,
            "baseCode": "D",
            "unitCode": 5,
            "pointValue": 100000
        },
        {
            "guid": "BRF2020",
            "id": "131403058",
            "symbolRealtime": "BRF2020",
            "symbolHistorical": "BRF20",
            "symbolDdf": "BRF0",
            "symbol": "BRF0",
            "symbolName": "Brazilian Real (Pit)",
            "symbolExpiration": "2019-12-31",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 5,
            "baseCode": "D",
            "unitCode": 5,
            "pointValue": 100000
        },
        {
            "guid": "BRG2020",
            "id": "131403059",
            "symbolRealtime": "BRG2020",
            "symbolHistorical": "BRG20",
            "symbolDdf": "BRG0",
            "symbol": "BRG0",
            "symbolName": "Brazilian Real (Pit)",
            "symbolExpiration": "2020-01-31",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 5,
            "baseCode": "D",
            "unitCode": 5,
            "pointValue": 100000
        },
        {
            "guid": "BRH2020",
            "id": "131403060",
            "symbolRealtime": "BRH2020",
            "symbolHistorical": "BRH20",
            "symbolDdf": "BRH0",
            "symbol": "BRH0",
            "symbolName": "Brazilian Real (Pit)",
            "symbolExpiration": "2020-02-28",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 5,
            "baseCode": "D",
            "unitCode": 5,
            "pointValue": 100000
        },
        {
            "guid": "BRJ2020",
            "id": "131403061",
            "symbolRealtime": "BRJ2020",
            "symbolHistorical": "BRJ20",
            "symbolDdf": "BRJ0",
            "symbol": "BRJ0",
            "symbolName": "Brazilian Real (Pit)",
            "symbolExpiration": "2020-03-31",
            "symbolCFI": "FXXXXX",
            "exchange": "CME",
            "exchangeName": "CME",
            "exchangeCode": "M",
            "tickIncrement": 5,
            "baseCode": "D",
            "unitCode": 5,
            "pointValue": 100000
        }
    ]
}

XML

GET

GET https://ondemand.websol.barchart.com/getInstrumentDefinition.xml?apikey=<YOUR API KEY>&exchanges=CME&exchangeMics=XCME&maxRecords=20&offset=10
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

Response


<?xml version="1.0" encoding="utf-8"?>
 <getInstrumentDefinition>
  <status>
   <code>200</code>
   <message>Success.</message>
  </status>
  <item>
   <guid>BRU2018</guid>
   <id>131403042</id>
   <symbolRealtime>BRU2018</symbolRealtime>
   <symbolHistorical>BRU18</symbolHistorical>
   <symbolDdf>BRU8</symbolDdf>
   <symbol>BRU8</symbol>
   <symbolName>Brazilian Real (Pit)</symbolName>
   <symbolExpiration>2018-08-31</symbolExpiration>
   <symbolCFI>FXXXXX</symbolCFI>
   <exchange>CME</exchange>
   <exchangeName>CME</exchangeName>
   <exchangeCode>M</exchangeCode>
   <tickIncrement>5</tickIncrement>
   <baseCode>D</baseCode>
   <unitCode>5</unitCode>
   <pointValue>100000</pointValue>
  </item>
  <item>
   <guid>BRV2018</guid>
   <id>131403043</id>
   <symbolRealtime>BRV2018</symbolRealtime>
   <symbolHistorical>BRV18</symbolHistorical>
   <symbolDdf>BRV8</symbolDdf>
   <symbol>BRV8</symbol>
   <symbolName>Brazilian Real (Pit)</symbolName>
   <symbolExpiration>2018-09-28</symbolExpiration>
   <symbolCFI>FXXXXX</symbolCFI>
   <exchange>CME</exchange>
   <exchangeName>CME</exchangeName>
   <exchangeCode>M</exchangeCode>
   <tickIncrement>5</tickIncrement>
   <baseCode>D</baseCode>
   <unitCode>5</unitCode>
   <pointValue>100000</pointValue>
  </item>
  <item>
   <guid>BRX2018</guid>
   <id>131403044</id>
   <symbolRealtime>BRX2018</symbolRealtime>
   <symbolHistorical>BRX18</symbolHistorical>
   <symbolDdf>BRX8</symbolDdf>
   <symbol>BRX8</symbol>
   <symbolName>Brazilian Real (Pit)</symbolName>
   <symbolExpiration>2018-10-31</symbolExpiration>
   <symbolCFI>FXXXXX</symbolCFI>
   <exchange>CME</exchange>
   <exchangeName>CME</exchangeName>
   <exchangeCode>M</exchangeCode>
   <tickIncrement>5</tickIncrement>
   <baseCode>D</baseCode>
   <unitCode>5</unitCode>
   <pointValue>100000</pointValue>
  </item>
  <item>
   <guid>BRZ2018</guid>
   <id>131403045</id>
   <symbolRealtime>BRZ2018</symbolRealtime>
   <symbolHistorical>BRZ18</symbolHistorical>
   <symbolDdf>BRZ8</symbolDdf>
   <symbol>BRZ8</symbol>
   <symbolName>Brazilian Real (Pit)</symbolName>
   <symbolExpiration>2018-11-30</symbolExpiration>
   <symbolCFI>FXXXXX</symbolCFI>
   <exchange>CME</exchange>
   <exchangeName>CME</exchangeName>
   <exchangeCode>M</exchangeCode>
   <tickIncrement>5</tickIncrement>
   <baseCode>D</baseCode>
   <unitCode>5</unitCode>
   <pointValue>100000</pointValue>
  </item>
  <item>
   <guid>BRF2019</guid>
   <id>131403046</id>
   <symbolRealtime>BRF2019</symbolRealtime>
   <symbolHistorical>BRF19</symbolHistorical>
   <symbolDdf>BRF9</symbolDdf>
   <symbol>BRF9</symbol>
   <symbolName>Brazilian Real (Pit)</symbolName>
   <symbolExpiration>2018-12-31</symbolExpiration>
   <symbolCFI>FXXXXX</symbolCFI>
   <exchange>CME</exchange>
   <exchangeName>CME</exchangeName>
   <exchangeCode>M</exchangeCode>
   <tickIncrement>5</tickIncrement>
   <baseCode>D</baseCode>
   <unitCode>5</unitCode>
   <pointValue>100000</pointValue>
  </item>
  <item>
   <guid>BRG2019</guid>
   <id>131403047</id>
   <symbolRealtime>BRG2019</symbolRealtime>
   <symbolHistorical>BRG19</symbolHistorical>
   <symbolDdf>BRG9</symbolDdf>
   <symbol>BRG9</symbol>
   <symbolName>Brazilian Real (Pit)</symbolName>
   <symbolExpiration>2019-01-31</symbolExpiration>
   <symbolCFI>FXXXXX</symbolCFI>
   <exchange>CME</exchange>
   <exchangeName>CME</exchangeName>
   <exchangeCode>M</exchangeCode>
   <tickIncrement>5</tickIncrement>
   <baseCode>D</baseCode>
   <unitCode>5</unitCode>
   <pointValue>100000</pointValue>
  </item>
  <item>
   <guid>BRH2019</guid>
   <id>131403048</id>
   <symbolRealtime>BRH2019</symbolRealtime>
   <symbolHistorical>BRH19</symbolHistorical>
   <symbolDdf>BRH9</symbolDdf>
   <symbol>BRH9</symbol>
   <symbolName>Brazilian Real (Pit)</symbolName>
   <symbolExpiration>2019-02-28</symbolExpiration>
   <symbolCFI>FXXXXX</symbolCFI>
   <exchange>CME</exchange>
   <exchangeName>CME</exchangeName>
   <exchangeCode>M</exchangeCode>
   <tickIncrement>5</tickIncrement>
   <baseCode>D</baseCode>
   <unitCode>5</unitCode>
   <pointValue>100000</pointValue>
  </item>
  <item>
   <guid>BRJ2019</guid>
   <id>131403049</id>
   <symbolRealtime>BRJ2019</symbolRealtime>
   <symbolHistorical>BRJ19</symbolHistorical>
   <symbolDdf>BRJ9</symbolDdf>
   <symbol>BRJ9</symbol>
   <symbolName>Brazilian Real (Pit)</symbolName>
   <symbolExpiration>2019-03-29</symbolExpiration>
   <symbolCFI>FXXXXX</symbolCFI>
   <exchange>CME</exchange>
   <exchangeName>CME</exchangeName>
   <exchangeCode>M</exchangeCode>
   <tickIncrement>5</tickIncrement>
   <baseCode>D</baseCode>
   <unitCode>5</unitCode>
   <pointValue>100000</pointValue>
  </item>
  <item>
   <guid>BRK2019</guid>
   <id>131403050</id>
   <symbolRealtime>BRK2019</symbolRealtime>
   <symbolHistorical>BRK19</symbolHistorical>
   <symbolDdf>BRK9</symbolDdf>
   <symbol>BRK9</symbol>
   <symbolName>Brazilian Real (Pit)</symbolName>
   <symbolExpiration>2019-04-30</symbolExpiration>
   <symbolCFI>FXXXXX</symbolCFI>
   <exchange>CME</exchange>
   <exchangeName>CME</exchangeName>
   <exchangeCode>M</exchangeCode>
   <tickIncrement>5</tickIncrement>
   <baseCode>D</baseCode>
   <unitCode>5</unitCode>
   <pointValue>100000</pointValue>
  </item>
  <item>
   <guid>BRM2019</guid>
   <id>131403051</id>
   <symbolRealtime>BRM2019</symbolRealtime>
   <symbolHistorical>BRM19</symbolHistorical>
   <symbolDdf>BRM9</symbolDdf>
   <symbol>BRM9</symbol>
   <symbolName>Brazilian Real (Pit)</symbolName>
   <symbolExpiration>2019-05-31</symbolExpiration>
   <symbolCFI>FXXXXX</symbolCFI>
   <exchange>CME</exchange>
   <exchangeName>CME</exchangeName>
   <exchangeCode>M</exchangeCode>
   <tickIncrement>5</tickIncrement>
   <baseCode>D</baseCode>
   <unitCode>5</unitCode>
   <pointValue>100000</pointValue>
  </item>
  <item>
   <guid>BRN2019</guid>
   <id>131403052</id>
   <symbolRealtime>BRN2019</symbolRealtime>
   <symbolHistorical>BRN19</symbolHistorical>
   <symbolDdf>BRN9</symbolDdf>
   <symbol>BRN9</symbol>
   <symbolName>Brazilian Real (Pit)</symbolName>
   <symbolExpiration>2019-06-28</symbolExpiration>
   <symbolCFI>FXXXXX</symbolCFI>
   <exchange>CME</exchange>
   <exchangeName>CME</exchangeName>
   <exchangeCode>M</exchangeCode>
   <tickIncrement>5</tickIncrement>
   <baseCode>D</baseCode>
   <unitCode>5</unitCode>
   <pointValue>100000</pointValue>
  </item>
  <item>
   <guid>BRQ2019</guid>
   <id>131403053</id>
   <symbolRealtime>BRQ2019</symbolRealtime>
   <symbolHistorical>BRQ19</symbolHistorical>
   <symbolDdf>BRQ9</symbolDdf>
   <symbol>BRQ9</symbol>
   <symbolName>Brazilian Real (Pit)</symbolName>
   <symbolExpiration>2019-07-31</symbolExpiration>
   <symbolCFI>FXXXXX</symbolCFI>
   <exchange>CME</exchange>
   <exchangeName>CME</exchangeName>
   <exchangeCode>M</exchangeCode>
   <tickIncrement>5</tickIncrement>
   <baseCode>D</baseCode>
   <unitCode>5</unitCode>
   <pointValue>100000</pointValue>
  </item>
  <item>
   <guid>BRU2019</guid>
   <id>131403054</id>
   <symbolRealtime>BRU2019</symbolRealtime>
   <symbolHistorical>BRU19</symbolHistorical>
   <symbolDdf>BRU9</symbolDdf>
   <symbol>BRU9</symbol>
   <symbolName>Brazilian Real (Pit)</symbolName>
   <symbolExpiration>2019-08-30</symbolExpiration>
   <symbolCFI>FXXXXX</symbolCFI>
   <exchange>CME</exchange>
   <exchangeName>CME</exchangeName>
   <exchangeCode>M</exchangeCode>
   <tickIncrement>5</tickIncrement>
   <baseCode>D</baseCode>
   <unitCode>5</unitCode>
   <pointValue>100000</pointValue>
  </item>
  <item>
   <guid>BRV2019</guid>
   <id>131403055</id>
   <symbolRealtime>BRV2019</symbolRealtime>
   <symbolHistorical>BRV19</symbolHistorical>
   <symbolDdf>BRV9</symbolDdf>
   <symbol>BRV9</symbol>
   <symbolName>Brazilian Real (Pit)</symbolName>
   <symbolExpiration>2019-09-30</symbolExpiration>
   <symbolCFI>FXXXXX</symbolCFI>
   <exchange>CME</exchange>
   <exchangeName>CME</exchangeName>
   <exchangeCode>M</exchangeCode>
   <tickIncrement>5</tickIncrement>
   <baseCode>D</baseCode>
   <unitCode>5</unitCode>
   <pointValue>100000</pointValue>
  </item>
  <item>
   <guid>BRX2019</guid>
   <id>131403056</id>
   <symbolRealtime>BRX2019</symbolRealtime>
   <symbolHistorical>BRX19</symbolHistorical>
   <symbolDdf>BRX9</symbolDdf>
   <symbol>BRX9</symbol>
   <symbolName>Brazilian Real (Pit)</symbolName>
   <symbolExpiration>2019-10-31</symbolExpiration>
   <symbolCFI>FXXXXX</symbolCFI>
   <exchange>CME</exchange>
   <exchangeName>CME</exchangeName>
   <exchangeCode>M</exchangeCode>
   <tickIncrement>5</tickIncrement>
   <baseCode>D</baseCode>
   <unitCode>5</unitCode>
   <pointValue>100000</pointValue>
  </item>
  <item>
   <guid>BRZ2019</guid>
   <id>131403057</id>
   <symbolRealtime>BRZ2019</symbolRealtime>
   <symbolHistorical>BRZ19</symbolHistorical>
   <symbolDdf>BRZ9</symbolDdf>
   <symbol>BRZ9</symbol>
   <symbolName>Brazilian Real (Pit)</symbolName>
   <symbolExpiration>2019-11-29</symbolExpiration>
   <symbolCFI>FXXXXX</symbolCFI>
   <exchange>CME</exchange>
   <exchangeName>CME</exchangeName>
   <exchangeCode>M</exchangeCode>
   <tickIncrement>5</tickIncrement>
   <baseCode>D</baseCode>
   <unitCode>5</unitCode>
   <pointValue>100000</pointValue>
  </item>
  <item>
   <guid>BRF2020</guid>
   <id>131403058</id>
   <symbolRealtime>BRF2020</symbolRealtime>
   <symbolHistorical>BRF20</symbolHistorical>
   <symbolDdf>BRF0</symbolDdf>
   <symbol>BRF0</symbol>
   <symbolName>Brazilian Real (Pit)</symbolName>
   <symbolExpiration>2019-12-31</symbolExpiration>
   <symbolCFI>FXXXXX</symbolCFI>
   <exchange>CME</exchange>
   <exchangeName>CME</exchangeName>
   <exchangeCode>M</exchangeCode>
   <tickIncrement>5</tickIncrement>
   <baseCode>D</baseCode>
   <unitCode>5</unitCode>
   <pointValue>100000</pointValue>
  </item>
  <item>
   <guid>BRG2020</guid>
   <id>131403059</id>
   <symbolRealtime>BRG2020</symbolRealtime>
   <symbolHistorical>BRG20</symbolHistorical>
   <symbolDdf>BRG0</symbolDdf>
   <symbol>BRG0</symbol>
   <symbolName>Brazilian Real (Pit)</symbolName>
   <symbolExpiration>2020-01-31</symbolExpiration>
   <symbolCFI>FXXXXX</symbolCFI>
   <exchange>CME</exchange>
   <exchangeName>CME</exchangeName>
   <exchangeCode>M</exchangeCode>
   <tickIncrement>5</tickIncrement>
   <baseCode>D</baseCode>
   <unitCode>5</unitCode>
   <pointValue>100000</pointValue>
  </item>
  <item>
   <guid>BRH2020</guid>
   <id>131403060</id>
   <symbolRealtime>BRH2020</symbolRealtime>
   <symbolHistorical>BRH20</symbolHistorical>
   <symbolDdf>BRH0</symbolDdf>
   <symbol>BRH0</symbol>
   <symbolName>Brazilian Real (Pit)</symbolName>
   <symbolExpiration>2020-02-28</symbolExpiration>
   <symbolCFI>FXXXXX</symbolCFI>
   <exchange>CME</exchange>
   <exchangeName>CME</exchangeName>
   <exchangeCode>M</exchangeCode>
   <tickIncrement>5</tickIncrement>
   <baseCode>D</baseCode>
   <unitCode>5</unitCode>
   <pointValue>100000</pointValue>
  </item>
  <item>
   <guid>BRJ2020</guid>
   <id>131403061</id>
   <symbolRealtime>BRJ2020</symbolRealtime>
   <symbolHistorical>BRJ20</symbolHistorical>
   <symbolDdf>BRJ0</symbolDdf>
   <symbol>BRJ0</symbol>
   <symbolName>Brazilian Real (Pit)</symbolName>
   <symbolExpiration>2020-03-31</symbolExpiration>
   <symbolCFI>FXXXXX</symbolCFI>
   <exchange>CME</exchange>
   <exchangeName>CME</exchangeName>
   <exchangeCode>M</exchangeCode>
   <tickIncrement>5</tickIncrement>
   <baseCode>D</baseCode>
   <unitCode>5</unitCode>
   <pointValue>100000</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
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

Response

guid,id,symbolRealtime,symbolHistorical,symbolDdf,symbol,symbolName,symbolExpiration,symbolCFI,exchange,exchangeName,exchangeCode,tickIncrement,baseCode,unitCode,pointValue
"BRU2018","131403042","BRU2018","BRU18","BRU8","BRU8","Brazilian Real (Pit)","2018-08-31","FXXXXX","CME","CME","M","5","D","5","100000"
"BRV2018","131403043","BRV2018","BRV18","BRV8","BRV8","Brazilian Real (Pit)","2018-09-28","FXXXXX","CME","CME","M","5","D","5","100000"
"BRX2018","131403044","BRX2018","BRX18","BRX8","BRX8","Brazilian Real (Pit)","2018-10-31","FXXXXX","CME","CME","M","5","D","5","100000"
"BRZ2018","131403045","BRZ2018","BRZ18","BRZ8","BRZ8","Brazilian Real (Pit)","2018-11-30","FXXXXX","CME","CME","M","5","D","5","100000"
"BRF2019","131403046","BRF2019","BRF19","BRF9","BRF9","Brazilian Real (Pit)","2018-12-31","FXXXXX","CME","CME","M","5","D","5","100000"
"BRG2019","131403047","BRG2019","BRG19","BRG9","BRG9","Brazilian Real (Pit)","2019-01-31","FXXXXX","CME","CME","M","5","D","5","100000"
"BRH2019","131403048","BRH2019","BRH19","BRH9","BRH9","Brazilian Real (Pit)","2019-02-28","FXXXXX","CME","CME","M","5","D","5","100000"
"BRJ2019","131403049","BRJ2019","BRJ19","BRJ9","BRJ9","Brazilian Real (Pit)","2019-03-29","FXXXXX","CME","CME","M","5","D","5","100000"
"BRK2019","131403050","BRK2019","BRK19","BRK9","BRK9","Brazilian Real (Pit)","2019-04-30","FXXXXX","CME","CME","M","5","D","5","100000"
"BRM2019","131403051","BRM2019","BRM19","BRM9","BRM9","Brazilian Real (Pit)","2019-05-31","FXXXXX","CME","CME","M","5","D","5","100000"
"BRN2019","131403052","BRN2019","BRN19","BRN9","BRN9","Brazilian Real (Pit)","2019-06-28","FXXXXX","CME","CME","M","5","D","5","100000"
"BRQ2019","131403053","BRQ2019","BRQ19","BRQ9","BRQ9","Brazilian Real (Pit)","2019-07-31","FXXXXX","CME","CME","M","5","D","5","100000"
"BRU2019","131403054","BRU2019","BRU19","BRU9","BRU9","Brazilian Real (Pit)","2019-08-30","FXXXXX","CME","CME","M","5","D","5","100000"
"BRV2019","131403055","BRV2019","BRV19","BRV9","BRV9","Brazilian Real (Pit)","2019-09-30","FXXXXX","CME","CME","M","5","D","5","100000"
"BRX2019","131403056","BRX2019","BRX19","BRX9","BRX9","Brazilian Real (Pit)","2019-10-31","FXXXXX","CME","CME","M","5","D","5","100000"
"BRZ2019","131403057","BRZ2019","BRZ19","BRZ9","BRZ9","Brazilian Real (Pit)","2019-11-29","FXXXXX","CME","CME","M","5","D","5","100000"
"BRF2020","131403058","BRF2020","BRF20","BRF0","BRF0","Brazilian Real (Pit)","2019-12-31","FXXXXX","CME","CME","M","5","D","5","100000"
"BRG2020","131403059","BRG2020","BRG20","BRG0","BRG0","Brazilian Real (Pit)","2020-01-31","FXXXXX","CME","CME","M","5","D","5","100000"
"BRH2020","131403060","BRH2020","BRH20","BRH0","BRH0","Brazilian Real (Pit)","2020-02-28","FXXXXX","CME","CME","M","5","D","5","100000"
"BRJ2020","131403061","BRJ2020","BRJ20","BRJ0","BRJ0","Brazilian Real (Pit)","2020-03-31","FXXXXX","CME","CME","M","5","D","5","100000"


PHP

<?php

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

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

$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("CME", "XCME", "20", "10")

Perl

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

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

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

print $result;

Python

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

result = client.service.getInstrumentDefinition('CME', 'XCME', '20', '10')

print result

Ruby

require 'savon'

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

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

response.body