NGM Data API

Version:
5.0.2

XSD Schemas

Data API Schemas:

ExchangeData schema 2.9

Elasticia Instrument Schemas:

Instrument schema 2.3.0

Exchange Data

URL:
search.xml

HTTP Method(s):
GET

Requires Authentication:
true

URL Parameters:

Required

String user (required): User's username
String password (required): User's password

Optional Filters

EnumString show (repeatable): list (default), levelData, closingDatas, instrumentDetail, trades, listingInfo, corporateActions, turnoverSummary
String mktSegm: {marketId:segmentId} (repeatable): Market place Id
String symbol (repeatable): Instrument symbols
EnumString instrumentState: listed (default), delisted (requires delistDate if isin is not specified)
- Date delistDate (required when instrumentState = delisted): Exact date of delisting.
String Isin: Instrument isin. If used together with instrumentState, instrumentState must use correct delisted/listed, otherwise error is thrown.
- If isin is specified, takes priority over symbol
EnumString knocked (note: works on both listed and delisted instruments): yes, no, both (default)
DateTime fromTime: Can be set if trades or closingDatas are shown (default: today 00:00)
DateTime toTime: Can be set if trades or closingDatas are shown (default: now)
EnumString sortDirection: Sorts market segmens and instruments in "natural order"; ASC (default) or DESC
BooleanString skipEmpty: Can be set to skip empty instrument nodes, for example instruments without trades
BooleanString rawPrices: Can be set to get raw (unscaled) prices, turnovers, etc. that is "1234" instead of "1.234" which makes it easier to avoid loss of precision when parsing into a double or similar.
String instrumentWildcard: Instrument wildcard name and symbol matching (similar to SQL LIKE statement), to only return information for instrument which matches the wildcard.[all]
EnumString format: Format of output - XML (default) or JSON

EnumString show (repeatable): list (default), closingDatas, trades, corporateActions
EnumString format: Format of output - XML (default) or JSON

Time representation formats:

Date: yyyy-MM-dd
DateTime: yyyy-MM-dd, yyyy-MM-ddTHH:mm:ss or yyyy-MM-ddTHH:mm:ss.SSS

Reponse:

Successful requests:
- HTTP status code: 200
- Content-Type: text/xml (or as specified by template)
Unsuccessful requests:
- HTTP status code:
  - User errors: 400. Possible causes are: malformed request url, requesting for unknown instruments, exceeding the configured throughput limit, looking for isin and instrumentsState in different category (example: listed isin in delisted state) .
  - Internal errors: 500. If the error persists, contact NGM Support.
- Content-Type: text/html

Examples - ExchangeData

Fetch an instrument's current level data

search.xml?user={username}&password={password}&symbol=testInstrumentRights1&show=levelData

<ExchangeData xmlns="http://www.ngm.se/ns/ExchangeDataSchema/2.9" instrumentCount="0" time="2017-03-03T17:44:08.547+01:00">
        <MarketSegment marketId="XNGM" segmentId="NDXN" name="NDX Norway">
                <MarketSegment marketId="XNGM" segmentId="DNKO" name="Knock-Outs NO">
                        <Instrument id="1890" isin="DE000CK69S77" name="B LONGDAX AJ CZK" symbol="testInstrumentRights1">
                                <LevelData buyPrice="10.62" buyQuantity="300000" diffPercent="0.453" diffPrice="0.46" previousClosingPrice="8.31" sellPrice="10.63" sellQuantity="300000" status="OPEN" turnover="0" volume="0"/>
                        </Instrument>
                </MarketSegment>
        </MarketSegment>
</ExchangeData>

Fetch all instruments in the NGM Equity market segment

search.xml?user={username}&password={password}&mktSegm=XNGM:NDXN

<ExchangeData xmlns="http://www.ngm.se/ns/ExchangeDataSchema/2.9" instrumentCount="-1" time="2017-03-06T09:57:50.411+01:00">
        <MarketSegment marketId="XNGM" segmentId="NDXN" name="NDX Norway">
                <MarketSegment marketId="XNGM" segmentId="DNCE" name="Certificates NO">
                        <Instrument id="18LN" isin="DE000CZ354Y9" name="BEAR AKSO X3 CZ" symbol="BEAR AKSO X3 CZ"/>
                        <Instrument id="12JR" isin="DE000CZ351R9" name="BEAR AMAZ X3 CZ" symbol="BEAR AMAZ X3 CZ"/>
                        <Instrument id="12JT" isin="DE000CZ351T5" name="BEAR APPL X3 CZ" symbol="BEAR APPL X3 CZ"/>
                        <Instrument id="12JV" isin="DE000CZ351V1" name="BEAR GOOG X3 CZ" symbol="BEAR GOOG X3 CZ"/>
                        <Instrument id="12JY" isin="DE000CZ351X7" name="BEAR MCDO X3 CZ" symbol="BEAR MCDO X3 CZ"/>
                        <Instrument id="T30" isin="DE000CZ33X43" name="BEAR MHG X2 CZ" symbol="BEAR MHG X2 CZ"/>
                        <Instrument id="T31" isin="DE000CZ33X50" name="BEAR MHG X3 CZ" symbol="BEAR MHG X3 CZ"/>
                        <Instrument id="T34" isin="DE000CZ33X84" name="BEAR NHY X2 CZ" symbol="BEAR NHY X2 CZ"/>
                        <Instrument id="T35" isin="DE000CZ33X92" name="BEAR NHY X3 CZ" symbol="BEAR NHY X3 CZ"/>
                        <Instrument id="18F9" isin="GB00B8C5DL09" name="BEAR OBX X4 R" symbol="BEAR OBX X4 R"/>
                        <Instrument id="18LQ" isin="DE000CZ355A6" name="BEAR PGS X3 CZ" symbol="BEAR PGS X3 CZ"/>
                        <Instrument id="18LS" isin="DE000CZ355C2" name="BEAR RCL X3 CZ" symbol="BEAR RCL X3 CZ"/>
                        <Instrument id="18LU" isin="DE000CZ355E8" name="BEAR SDRL X3 CZ" symbol="BEAR SDRL X3 CZ"/>
                        <Instrument id="18LX" isin="DE000CZ355G3" name="BEAR STB X3 CZ" symbol="BEAR STB X3 CZ"/>
                        <Instrument id="T38" isin="DE000CZ33Y26" name="BEAR STL X2 CZ" symbol="BEAR STL X2 CZ"/>
                        <Instrument id="T39" isin="DE000CZ33Y34" name="BEAR STL X3 CZ" symbol="BEAR STL X3 CZ"/>
                        <Instrument id="18M0" isin="DE000CZ355J7" name="BEAR SUBC X3 CZ" symbol="BEAR SUBC X3 CZ"/>
                        <Instrument id="1UG5" isin="DE000CZ7VYA7" name="BEAR TESLA X3 CZ" symbol="BEAR TESLA X3 CZ"/>
                        <Instrument id="T2U" isin="DE000CZ33X01" name="BEAR YARA X2 CZ" symbol="BEAR YARA X2 CZ"/>
                        <Instrument id="T2V" isin="DE000CZ33X19" name="BEAR YARA X3 CZ" symbol="BEAR YARA X3 CZ"/>
                        <Instrument id="18LM" isin="DE000CZ354X1" name="BULL AKSO X3 CZ" symbol="BULL AKSO X3 CZ"/>
                        <Instrument id="12JQ" isin="DE000CZ351Q1" name="BULL AMAZ X3 CZ" symbol="BULL AMAZ X3 CZ"/>
                        <Instrument id="12JS" isin="DE000CZ351S7" name="BULL APPL X3 CZ" symbol="BULL APPL X3 CZ"/>
                        <Instrument id="12JU" isin="DE000CZ351U3" name="BULL GOOG X3 CZ" symbol="BULL GOOG X3 CZ"/>
                        <Instrument id="12JX" isin="DE000CZ351W9" name="BULL MCDO X3 CZ" symbol="BULL MCDO X3 CZ"/>
                        <Instrument id="T2X" isin="DE000CZ33X27" name="BULL MHG X2 CZ" symbol="BULL MHG X2 CZ"/>
                        <Instrument id="T2Y" isin="DE000CZ33X35" name="BULL MHG X3 CZ" symbol="BULL MHG X3 CZ"/>
                        <Instrument id="T32" isin="DE000CZ33X68" name="BULL NHY X2 CZ" symbol="BULL NHY X2 CZ"/>
                        <Instrument id="T33" isin="DE000CZ33X76" name="BULL NHY X3 CZ" symbol="BULL NHY X3 CZ"/>
                        <Instrument id="18LP" isin="DE000CZ354Z6" name="BULL PGS X3 CZ" symbol="BULL PGS X3 CZ"/>
                        <Instrument id="18LR" isin="DE000CZ355B4" name="BULL RCL X3 CZ" symbol="BULL RCL X3 CZ"/>
                        <Instrument id="T3A" isin="DE000CZ33Y42" name="BULL REC X2 CZ" symbol="BULL REC X2 CZ"/>
                        <Instrument id="T3B" isin="DE000CZ33Y59" name="BULL REC X3 CZ" symbol="BULL REC X3 CZ"/>
                        <Instrument id="18LT" isin="DE000CZ355D0" name="BULL SDRL X3 CZ" symbol="BULL SDRL X3 CZ"/>
                        <Instrument id="18LV" isin="DE000CZ355F5" name="BULL STB X3 CZ" symbol="BULL STB X3 CZ"/>
                        <Instrument id="T36" isin="DE000CZ33Y00" name="BULL STL X2 CZ" symbol="BULL STL X2 CZ"/>
                        <Instrument id="T37" isin="DE000CZ33Y18" name="BULL STL X3 CZ" symbol="BULL STL X3 CZ"/>
                        <Instrument id="18LY" isin="DE000CZ355H1" name="BULL SUBC X3 CZ" symbol="BULL SUBC X3 CZ"/>
                        <Instrument id="1UG4" isin="DE000CZ7VY97" name="BULL TESLA X3 CZ" symbol="BULL TESLA X3 CZ"/>
                        <Instrument id="T2S" isin="DE000CZ33W85" name="BULL YARA X2 CZ" symbol="BULL YARA X2 CZ"/>
                        <Instrument id="T2T" isin="DE000CZ33W93" name="BULL YARA X3 CZ" symbol="BULL YARA X3 CZ"/>
                </MarketSegment>
                <MarketSegment marketId="XNGM" segmentId="DNEX" name="Exotics NO"/>
                <MarketSegment marketId="XNGM" segmentId="DNKO" name="Knock-Outs NO">
                        <Instrument id="1890" isin="DE000CK69S77" name="B LONGDAX AJ CZK" symbol="testInstrumentRights1"/>
                        <Instrument id="1891" isin="DE000CK69S85" name="B LONGDAX AK CZK" symbol="testInstrumentRights2"/>
                        <Instrument id="1JSG" isin="DE000CK69TK4" name="B LONGDAX AZ CZK" symbol="B LONGDAX AZ CZK"/>
                        <Instrument id="1NU7" isin="DE000CZ5PJ47" name="B LONGDAX BI CZK" symbol="B LONGDAX BI CZK"/>
                        <Instrument id="1NU8" isin="DE000CZ5PJ54" name="B LONGDAX BJ CZK" symbol="B LONGDAX BJ CZK"/>
                        <Instrument id="1Q3S" isin="DE000CZ5PJ70" name="B LONGDAX BL CZK" symbol="B LONGDAX BL CZK"/>
                        <Instrument id="1QGR" isin="DE000CZ5PJG1" name="B LONGDAX BM CZK" symbol="B LONGDAX BM CZK"/>
                        <Instrument id="1XKT" isin="DE000CZ5PKL9" name="B LONGDAX CE CZK" symbol="B LONGDAX CE CZK"/>
                        <Instrument id="1YP5" isin="DE000CZ5PKT2" name="B LONGDAX CI CZK" symbol="B LONGDAX CI CZK"/>
                        <Instrument id="21A2" isin="DE000CZ7VX23" name="B LONGDNO H CZK" symbol="B LONGDNO H CZK"/>
                        <Instrument id="1895" isin="DE000CK6JLE0" name="B LONGFACE M CZK" symbol="B LONGFACE M CZK"/>
                        <Instrument id="1896" isin="DE000CK6JLF7" name="B LONGFACE N CZK" symbol="B LONGFACE N CZK"/>
                        <Instrument id="18XQ" isin="DE000CK6JM33" name="B LONGFACE P CZK" symbol="B LONGFACE P CZK"/>
                        <Instrument id="18XR" isin="DE000CK6JM41" name="B LONGFACE Q CZK" symbol="B LONGFACE Q CZK"/>
                        <Instrument id="1A0F" isin="DE000CK6JMH1" name="B LONGFACE S CZK" symbol="B LONGFACE S CZK"/>
                        <Instrument id="1J7G" isin="DE000CK6JPW3" name="B LONGGULL H CZK" symbol="B LONGGULL H CZK"/>
                        <Instrument id="18XX" isin="DE000CK6JM90" name="B LONGMHG H CZK" symbol="B LONGMHG H CZK"/>
                        <Instrument id="18XY" isin="DE000CK6JMA6" name="B LONGMHG I CZK" symbol="B LONGMHG I CZK"/>
                        <Instrument id="1A0H" isin="DE000CK6JMK5" name="B LONGMHG J CZK" symbol="B LONGMHG J CZK"/>
                        <Instrument id="1JE3" isin="DE000CZ1U7M2" name="B LONGMHG M CZK" symbol="B LONGMHG M CZK"/>
                        <Instrument id="21A5" isin="DE000CZ7VX56" name="B LONGMHG U CZK" symbol="B LONGMHG U CZK"/>
                        <Instrument id="21A6" isin="DE000CZ7VX64" name="B LONGMHG V CZK" symbol="B LONGMHG V CZK"/>
                        <Instrument id="189L" isin="DE000CK6JLV4" name="B LONGNHY F CZK" symbol="B LONGNHY F CZK"/>
                        <Instrument id="1AXA" isin="DE000CK6JN73" name="B LONGNHY H CZK" symbol="B LONGNHY H CZK"/>
                        <Instrument id="1U4F" isin="DE000CZ5PMU6" name="B LONGNHY J CZK" symbol="B LONGNHY J CZK"/>
                        <Instrument id="18G6" isin="DE000CK6JK76" name="B LONGOLJE L CZK" symbol="B LONGOLJE L CZK"/>
                        <Instrument id="1U3M" isin="DE000CZ5PHB6" name="B LONGOPERA A C" symbol="B LONGOPERA A C"/>
                        <Instrument id="1J7N" isin="DE000CK6JQ21" name="B LONGSOLV H CZK" symbol="B LONGSOLV H CZK"/>
                        <Instrument id="1HBX" isin="DE000CK69TG2" name="B LONGSPX H CZK" symbol="B LONGSPX H CZK"/>
                        <Instrument id="1QM4" isin="DE000CZ5PJH9" name="B LONGSPX L CZK" symbol="B LONGSPX L CZK"/>
                        <Instrument id="1RCS" isin="DE000CZ5PJN7" name="B LONGSPX M CZK" symbol="B LONGSPX M CZK"/>
                        <Instrument id="210R" isin="DE000CZ5PL43" name="B LONGSPX P CZK" symbol="B LONGSPX P CZK"/>
                        <Instrument id="2251" isin="DE000CZ5PLB8" name="B LONGSPX Q CZK" symbol="B LONGSPX Q CZK"/>
                        <Instrument id="2117" isin="DE000CZ7VWR5" name="B LONGSTL N CZK" symbol="B LONGSTL N CZK"/>
                        <Instrument id="211B" isin="DE000CZ7VWV7" name="B LONGSUBC U CZK" symbol="B LONGSUBC U CZK"/>
                        <Instrument id="1QM5" isin="DE000CZ1U9A3" name="B LONGYAR R CZK" symbol="B LONGYAR R CZK"/>
                        <Instrument id="1YHX" isin="DE000CZ7VWC7" name="B LONGYAR V CZK" symbol="B LONGYAR V CZK"/>
                        <Instrument id="211E" isin="DE000CZ7VWY1" name="B LONGYAR X CZK" symbol="B LONGYAR X CZK"/>
                        <Instrument id="18LH" isin="DE000CK6JLZ5" name="B SHRTAKSO H CZK" symbol="B SHRTAKSO H CZK"/>
                        <Instrument id="1AHY" isin="DE000CK6JMS8" name="B SHRTAKSO I CZK" symbol="B SHRTAKSO I CZK"/>
                        <Instrument id="2111" isin="DE000CZ7VWK0" name="B SHRTAKSO V CZK" symbol="B SHRTAKSO V CZK"/>
                        <Instrument id="2254" isin="DE000CZ7VXL6" name="B SHRTAKSO W CZK" symbol="B SHRTAKSO W CZK"/>
                        <Instrument id="1TUQ" isin="DE000CZ5PK36" name="B SHRTDAX BW CZK" symbol="B SHRTDAX BW CZK"/>
                        <Instrument id="1TUS" isin="DE000CZ5PK51" name="B SHRTDAX BY CZK" symbol="B SHRTDAX BY CZK"/>
                        <Instrument id="1TUT" isin="DE000CZ5PK69" name="B SHRTDAX BZ CZK" symbol="B SHRTDAX BZ CZK"/>
                        <Instrument id="20T6" isin="DE000CZ5PL35" name="B SHRTDAX CN CZK" symbol="B SHRTDAX CN CZK"/>
                        <Instrument id="224Y" isin="DE000CZ5PL92" name="B SHRTDAX CO CZK" symbol="B SHRTDAX CO CZK"/>
                        <Instrument id="1H9M" isin="DE000CK6JPN2" name="B SHRTGULL E CZK" symbol="B SHRTGULL E CZK"/>
                        <Instrument id="1H9N" isin="DE000CK6JPP7" name="B SHRTGULL F CZK" symbol="B SHRTGULL F CZK"/>
                        <Instrument id="1J7L" isin="DE000CK6JQ05" name="B SHRTGULL H CZK" symbol="B SHRTGULL H CZK"/>
                        <Instrument id="1J7M" isin="DE000CK6JQ13" name="B SHRTGULL I CZK" symbol="B SHRTGULL I CZK"/>
                        <Instrument id="2113" isin="DE000CZ7VWM6" name="B SHRTMHG AC CZK" symbol="B SHRTMHG AC CZK"/>
                        <Instrument id="21A7" isin="DE000CZ7VX72" name="B SHRTMHG AD CZK" symbol="B SHRTMHG AD CZK"/>
                        <Instrument id="2115" isin="DE000CZ7VWP9" name="B SHRTNHY L CZK" symbol="B SHRTNHY L CZK"/>
                        <Instrument id="189G" isin="DE000CK6JLR2" name="B SHRTPGS F CZK" symbol="B SHRTPGS F CZK"/>
                        <Instrument id="189H" isin="DE000CK6JLS0" name="B SHRTPGS G CZK" symbol="B SHRTPGS G CZK"/>
                        <Instrument id="1A0M" isin="DE000CK6JMP4" name="B SHRTPGS H CZK" symbol="B SHRTPGS H CZK"/>
                        <Instrument id="1AJ8" isin="DE000CK6JN16" name="B SHRTPGS I CZK" symbol="B SHRTPGS I CZK"/>
                        <Instrument id="1JE6" isin="DE000CZ1U7Q3" name="B SHRTPGS K CZK" symbol="B SHRTPGS K CZK"/>
                        <Instrument id="1JE7" isin="DE000CZ1U7R1" name="B SHRTPGS L CZK" symbol="B SHRTPGS L CZK"/>
                        <Instrument id="1H9S" isin="DE000CK6JPT9" name="B SHRTSOLV E CZK" symbol="B SHRTSOLV E CZK"/>
                        <Instrument id="1H9T" isin="DE000CK6JPU7" name="B SHRTSOLV F CZK" symbol="B SHRTSOLV F CZK"/>
                        <Instrument id="1H9U" isin="DE000CK6JPV5" name="B SHRTSOLV G CZK" symbol="B SHRTSOLV G CZK"/>
                        <Instrument id="1J7P" isin="DE000CK6JQ39" name="B SHRTSOLV H CZK" symbol="B SHRTSOLV H CZK"/>
                        <Instrument id="1J7Q" isin="DE000CK6JQ47" name="B SHRTSOLV I CZK" symbol="B SHRTSOLV I CZK"/>
                        <Instrument id="210U" isin="DE000CZ5PL76" name="B SHRTSPX T CZK" symbol="B SHRTSPX T CZK"/>
                        <Instrument id="210V" isin="DE000CZ5PL84" name="B SHRTSPX U CZK" symbol="B SHRTSPX U CZK"/>
                        <Instrument id="2119" isin="DE000CZ7VWT1" name="B SHRTSTL M CZK" symbol="B SHRTSTL M CZK"/>
                        <Instrument id="211A" isin="DE000CZ7VWU9" name="B SHRTSTL N CZK" symbol="B SHRTSTL N CZK"/>
                        <Instrument id="21AG" isin="DE000CZ7VXG6" name="B SHRTSTL O CZK" symbol="B SHRTSTL O CZK"/>
                        <Instrument id="18LL" isin="DE000CK6JM25" name="B SHRTSUBC H CZK" symbol="B SHRTSUBC H CZK"/>
                        <Instrument id="18Y4" isin="DE000CK6JMF5" name="B SHRTSUBC I CZK" symbol="B SHRTSUBC I CZK"/>
                        <Instrument id="18Y5" isin="DE000CK6JMG3" name="B SHRTSUBC J CZK" symbol="B SHRTSUBC J CZK"/>
                        <Instrument id="1B78" isin="DE000CK6JNF3" name="B SHRTSUBC M CZK" symbol="B SHRTSUBC M CZK"/>
                        <Instrument id="1JEA" isin="DE000CZ1U7U5" name="B SHRTSUBC O CZK" symbol="B SHRTSUBC O CZK"/>
                        <Instrument id="21AH" isin="DE000CZ7VXH4" name="B SHRTSUBC V CZK" symbol="B SHRTSUBC V CZK"/>
                        <Instrument id="211G" isin="DE000CZ7VX07" name="B SHRTYAR N CZK" symbol="B SHRTYAR N CZK"/>
                        <Instrument id="QT4" isin="NL0009795178" name="LONGGULL A RBS" symbol="LONGGULL A RBS"/>
                        <Instrument id="12FR" isin="GB00B7CYF813" name="LONGMHG C RBS" symbol="LONGMHG C RBS"/>
                        <Instrument id="1REX" isin="GB00BDLJ3X07" name="LONGORK G RBS" symbol="LONGORK G RBS"/>
                        <Instrument id="1SU6" isin="GB00BDLG9N33" name="LONGREC F3 RBS" symbol="LONGREC F3 RBS"/>
                        <Instrument id="1RF6" isin="GB00BDLKT915" name="LONGSOLV S RBS" symbol="LONGSOLV S RBS"/>
                        <Instrument id="1SQG" isin="GB00BDLPM869" name="LONGTSLA A G RBS" symbol="LONGTSLA A G RBS"/>
                </MarketSegment>
                <MarketSegment marketId="XNGM" segmentId="DNMP" name="Miscellaneous Investment Products NO"/>
                <MarketSegment marketId="XNGM" segmentId="DNPV" name="Plain Vanillas NO"/>
                <MarketSegment marketId="XNGM" segmentId="DNSP" name="Structured Products NO"/>
        </MarketSegment>
</ExchangeData>

Fetch an instrument's trades for a certain time interval

search.xml?user={username}&password={userpassword}&symbol=testInstrumentRights1&show=trades&fromTime=2013-03-05&toTime=2013-03-05T09:30:00

<ExchangeData xmlns="http://www.ngm.se/ns/ExchangeDataSchema/2.9" instrumentCount="0" tradeCount="-1" time="2017-03-06T10:01:27.157+01:00">
        <MarketSegment marketId="XNGM" segmentId="NDXN" name="NDX Norway">
                <MarketSegment marketId="XNGM" segmentId="DNKO" name="Knock-Outs NO">
                        <Instrument id="1890" isin="DE000CK69S77" name="B LONGDAX AJ CZK" symbol="testInstrumentRights1">
                                <Trades fromTime="2013-03-05T00:00:00+01:00" toTime="2013-03-05T09:30:00+01:00"/>
                        </Instrument>
                </MarketSegment>
        </MarketSegment>
</ExchangeData>

Fetch an instrument's description information

search.xml?user={username}&password={userpassword}&symbol=testInstrumentRights1&show=instrumentDetail

<ExchangeData xmlns="http://www.ngm.se/ns/ExchangeDataSchema/2.9" instrumentCount="0" time="2017-03-06T10:04:13.092+01:00">
        <MarketSegment marketId="XNGM" segmentId="NDXN" name="NDX Norway">
                <MarketSegment marketId="XNGM" segmentId="DNKO" name="Knock-Outs NO">
                        <Instrument id="1890" isin="DE000CK69S77" name="B LONGDAX AJ CZK" symbol="testInstrumentRights1">
                                <InstrumentDetail>
                                        <MinTradeVol>1</MinTradeVol>
                                        <RoundLot>1</RoundLot>
                                        <Currency>EUR</Currency>
                                        <PriceType>PerUnit</PriceType>
                                        <TickRules>0.01:0.01:0.99,1:0.1:9.9,10:1:99,100:5:995,1000:100:inf</TickRules>
                                        <instrument xmlns="http://www.ngm.se/ns/InstrumentSchema/2" xmlns:xsi="http://www.w3.org/2001/XMLSchema">
                                                <identification>
                                                        <instrumentID>1890</instrumentID>
                                                        <symbol>B LONGDAX AJ CZK</symbol>
                                                        <name>B LONGDAX AJ CZK</name>
                                                        <isin>DE000CK69S77</isin>
                                                        <fisn>B LONGDAX AJ CZK</fisn>
                                                </identification>
                                                <lastUpdated>2020-09-07T12:34:56</lastUpdated>
                                                <cfi>RWXXXX</cfi>
                                                <eusipa>2200</eusipa>
                                                <productName>Example Product</productName>
                                                <link href="http://example.com/other.pdf" rel="other"/>
                                                <link href="http://example.com/kid.pdf" rel="kid"/>
                                                <firstTradedDate>2020-09-01</firstTradedDate>
                                                <lastTradedDate>2020-12-11</lastTradedDate>
                                                <issuer>
                                                    <name>Example Issuer</name>
                                                    <country>SE</country>
                                                    <symbol>EIS</symbol>
                                                    <lei>123456A78BCDEF9SG123</lei>
                                                    <bic>ABCDSEFG</bic>
                                                </issuer>
                                                <liquidityProvider>
                                                    <name>Example Provider</name>
                                                    <symbol>EPS</symbol>
                                                </liquidityProvider>
                                                <issuedQuantity>200000</issuedQuantity>
                                                <reg871m>unaffected</reg871m>
                                                <underlying>
                                                    <identification>
                                                        <symbol>EXUND</symbol>
                                                        <name>Example Underlying</name>
                                                        <isin>SE0123456789</isin>
                                                    </identification>
                                                    <category>equity</category>
                                                    <subCategory>Example</subCategory>
                                                    <referenceMarket>
                                                        <mic>EXMA</mic>
                                                        <name>Example Market</name>
                                                    </referenceMarket>
                                                </underlying>
                                                <direction>call</direction>
                                                <maturityDate>2020-12-18</maturityDate>
                                                <settlementMethod>cash</settlementMethod>
                                                <parity>1</parity>
                                                <optionType>EU</optionType>
                                                <strikePrice currency="EUR">26</strikePrice>
                                                <safetyBarrier>26</safetyBarrier>
                                        </instrument>
                                </InstrumentDetail>
                        </Instrument>
                </MarketSegment>
        </MarketSegment>
</ExchangeData>

Fetch instruments that are delisted because of a knock out on a specific date.

search.xml?user={username}&password={userpassword}&instrumentState=delisted&knocked=yes&delistDate=2014-05-22

<ExchangeData xmlns="http://www.ngm.se/ns/ExchangeDataSchema/2.9" instrumentCount="-1" time="2017-03-16T10:05:33.25+01:00">
    <MarketSegment marketId="XNGM" segmentId="NDXF" name="NDX Finland">
    <MarketSegment marketId="XNGM" segmentId="DFBO" name="Bonds FI"/>
    <MarketSegment marketId="XNGM" segmentId="DFCE" name="Certificates FI"/>
    <MarketSegment marketId="XNGM" segmentId="DFEX" name="Exotics FI"/>
    <MarketSegment marketId="XNGM" segmentId="DFKO" name="Knock-Outs FI">
        <Instrument id="1Y0D" isin="DE000CZ6JKN6" name="B SHRTNDX BL CZB" symbol="B SHRTNDX BL CZB"/>
        <Instrument id="1XDC" isin="DE000CZ6JAL1" name="B SHRTNOK FJ CZB" symbol="B SHRTNOK FJ CZB"/>
        <Instrument id="1YKC" isin="DE000CZ6JB83" name="B SHRTNOK FP CZB" symbol="B SHRTNOK FP CZB"/>
        <Instrument id="1UPQ" isin="GB00BDLN6B10" name="SHRTNOK1V AA RBS" symbol="SHRTNOK1V AA RBS"/>
    </MarketSegment>
    <MarketSegment marketId="XNGM" segmentId="DFMP" name="Miscellaneous Investment Products FI"/>
    <MarketSegment marketId="XNGM" segmentId="DFPV" name="Plain Vanillas FI"/>
    <MarketSegment marketId="XNGM" segmentId="DFSP" name="Structured Products FI"/>
    </MarketSegment>
        <MarketSegment marketId="XNGM" segmentId="NDXN" name="NDX Norway">
        <MarketSegment marketId="XNGM" segmentId="DNCE" name="Certificates NO"/>
        <MarketSegment marketId="XNGM" segmentId="DNEX" name="Exotics NO"/>
        <MarketSegment marketId="XNGM" segmentId="DNKO" name="Knock-Outs NO"/>
        <MarketSegment marketId="XNGM" segmentId="DNMP" name="Miscellaneous Investment Products NO"/>
        <MarketSegment marketId="XNGM" segmentId="DNPV" name="Plain Vanillas NO"/>
        <MarketSegment marketId="XNGM" segmentId="DNSP" name="Structured Products NO"/>
    </MarketSegment>
    <MarketSegment marketId="XNGM" segmentId="NDXS" name="NDX Sweden">
        <MarketSegment marketId="XNGM" segmentId="DSKO" name="Knock-Outs SE">
            <Instrument id="1YQA" isin="DE000CZ9G9H8" name="B SHRTNOK DR CBK" symbol="B SHRTNOK DR CBK"/>
            <Instrument id="1VNH" isin="GB00BDLRWC60" name="MINISHRT MTG AA" symbol="MINISHRT MTG AA"/>
            <Instrument id="1VY6" isin="NL0010665311" name="MINISHRT MTG BNP18" symbol="MINISHRT MTG BNP18"/>
            <Instrument id="1X2R" isin="DE000SG39J24" name="MINISHRT MTG D3 SG" symbol="MINISHRT MTG D3 SG"/>
            <Instrument id="1Y6J" isin="DE000SG39MC3" name="MINISHRT NASD A8 SG" symbol="MINISHRT NASD A8 SG"/>
            <Instrument id="1UBE" isin="DE000SG39C05" name="MINISHRT NDA C5 SG" symbol="MINISHRT NDA C5 SG"/>
            <Instrument id="1XMP" isin="GB00BDLLQP93" name="MINISHRT NFLX V" symbol="MINISHRT NFLX V"/>
            <Instrument id="2041" isin="DE000SG39QR2" name="MINISHRT NOK F2 SG" symbol="MINISHRT NOK F2 SG"/>
            <Instrument id="1PCS" isin="GB00B9QF7T91" name="MINISHRT OLJA W4" symbol="MINISHRT OLJA W4"/>
            <Instrument id="11JX" isin="GB00B7CYTM34" name="MINISHRT OMX A9 RBS" symbol="MINISHRT OMX A9"/>
            <Instrument id="1LQH" isin="NL0010238994" name="MINISHRT OMX BNP29 BNP PARIBAS" symbol="MINISHRT OMX BNP29"/>
            <Instrument id="1EKL" isin="DE000SG3TWB7" name="MINISHRT SSA A2 SG" symbol="MINISHRT SSA A2 SG"/>
            <Instrument id="1EKM" isin="DE000SG3TWC5" name="MINISHRT SSA A3 SG" symbol="MINISHRT SSA A3 SG"/>
            <Instrument id="1CAX" isin="NL0010233318" name="MINISHRT SSAB BP3 BNP PARIBAS" symbol="MINISHRT SSAB BP3"/>
            <Instrument id="200S" isin="NL0010668620" name="TOXS4R 1390BNP" symbol="TOXS4R 1390BNP"/>
            <Instrument id="2036" isin="DE000CB5U045" name="TOXS4R 1390CBK" symbol="TOXS4R 1390CBK"/>
        </MarketSegment>
        <MarketSegment marketId="XNGM" segmentId="DSSP" name="Structured Products SE"/>
    </MarketSegment>
    <MarketSegment marketId="XNGM" segmentId="NEST" name="NGM Equity">
        <MarketSegment marketId="XNGM" segmentId="EQST" name="Equity Stockholm"/>
    </MarketSegment>
</ExchangeData>

Fetch instruments that are still listed but have financial status knock out. Show listing info.

search.xml?user={username}&password={userpassword}&instrumentState=listed&knocked=yes&show=listingInfo

<ExchangeData xmlns="http://www.ngm.se/ns/ExchangeDataSchema/2.9" instrumentCount="-1" time="2017-03-06T10:21:35.421+01:00">
    <MarketSegment marketId="XNGM" segmentId="NDXN" name="NDX Norway">
            <MarketSegment marketId="XNGM" segmentId="DNCE" name="Certificates NO">
                    <Instrument id="18LS" isin="DE000CZ355C2" name="BEAR RCL X3 CZ" symbol="BEAR RCL X3 CZ">
                            <ListingInfo listed="true" knockStatus="KNOCK_OUT_BUYBACK"/>
                    </Instrument>
            </MarketSegment>
            <MarketSegment marketId="XNGM" segmentId="DNEX" name="Exotics NO"/>
            <MarketSegment marketId="XNGM" segmentId="DNKO" name="Knock-Outs NO"/>
            <MarketSegment marketId="XNGM" segmentId="DNMP" name="Miscellaneous Investment Products NO"/>
            <MarketSegment marketId="XNGM" segmentId="DNPV" name="Plain Vanillas NO"/>
            <MarketSegment marketId="XNGM" segmentId="DNSP" name="Structured Products NO"/>
    </MarketSegment>
</ExchangeData>

Fetch instruments that are delisted a specific date and show listing info.

search.xml?user={username}&password={userpassword}&instrumentState=delisted&delistDate=2013-02-15&show=listingInfo

<ExchangeData xmlns="http://www.ngm.se/ns/ExchangeDataSchema/2.9" instrumentCount="-1" time="2017-03-06T10:22:52.845+01:00">
        <MarketSegment marketId="XNGM" segmentId="NDXN" name="NDX Norway">
                <MarketSegment marketId="XNGM" segmentId="DNCE" name="Certificates NO"/>
                <MarketSegment marketId="XNGM" segmentId="DNEX" name="Exotics NO"/>
                <MarketSegment marketId="XNGM" segmentId="DNKO" name="Knock-Outs NO">
                        <Instrument id="1D2X" isin="DE000CK6JNU2" name="B LONGAKSO L CZK" symbol="B LONGAKSO L CZK">
                                <ListingInfo listed="false" knockStatus="KNOCK_OUT" delistDate="2013-02-15"/>
                        </Instrument>
                        <Instrument id="19VK" isin="DE000CK6JP55" name="B LONGGULL C CBK" symbol="B LONGGULL C CBK">
                                <ListingInfo listed="false" knockStatus="KNOCK_OUT" delistDate="2013-02-15"/>
                        </Instrument>
                        <Instrument id="17NX" isin="GB00B8C5P582" name="LONGGULL J1 RBS" symbol="LONGGULL J1 RBS">
                                <ListingInfo listed="false" knockStatus="KNOCK_OUT_BUYBACK" delistDate="2013-02-15"/>
                        </Instrument>
                </MarketSegment>
                <MarketSegment marketId="XNGM" segmentId="DNMP" name="Miscellaneous Investment Products NO"/>
                <MarketSegment marketId="XNGM" segmentId="DNPV" name="Plain Vanillas NO">
                        <Instrument id="1DB2" isin="DE000CZ1U780" name="SUBC3B 135CZK" symbol="SUBC3B 135CZK">
                                <ListingInfo listed="false" delistDate="2013-02-15"/>
                        </Instrument>
                        <Instrument id="1DB3" isin="DE000CZ1U798" name="SUBC3N 125CZK" symbol="SUBC3N 125CZK">
                                <ListingInfo listed="false" delistDate="2013-02-15"/>
                        </Instrument>
                </MarketSegment>
                <MarketSegment marketId="XNGM" segmentId="DNSP" name="Structured Products NO"/>
        </MarketSegment>
</ExchangeData>

Fetch all instruments that have reached knock-out level today and show listing info.

search.xml?user={username}&password={userpassword}&instrumentState=listed&knocked=yes&show=listingInfo

For this information we need two queries, one for the listed instruments with knock-out flag and one for the delisted instruments that were delisted as a result of a knock-out. First fetch all instruments that have reached knock-out level today and are still listed with the following query:

<ExchangeData xmlns="http://www.ngm.se/ns/ExchangeDataSchema/2.9" instrumentCount="-1" time="2017-03-06T10:25:03.797+01:00">
        <MarketSegment marketId="XNGM" segmentId="NDXN" name="NDX Norway">
                <MarketSegment marketId="XNGM" segmentId="DNCE" name="Certificates NO">
                        <Instrument id="18LS" isin="DE000CZ355C2" name="BEAR RCL X3 CZ" symbol="BEAR RCL X3 CZ">
                                <ListingInfo listed="true" knockStatus="KNOCK_OUT_BUYBACK"/>
                        </Instrument>
                </MarketSegment>
                <MarketSegment marketId="XNGM" segmentId="DNEX" name="Exotics NO"/>
                <MarketSegment marketId="XNGM" segmentId="DNKO" name="Knock-Outs NO"/>
                <MarketSegment marketId="XNGM" segmentId="DNMP" name="Miscellaneous Investment Products NO"/>
                <MarketSegment marketId="XNGM" segmentId="DNPV" name="Plain Vanillas NO"/>
                <MarketSegment marketId="XNGM" segmentId="DNSP" name="Structured Products NO"/>
        </MarketSegment>
</ExchangeData>

search.xml?user={username}&password={userpassword}&instrumentState=delisted&knocked=no&delistDate=2012-03-05&show=listingInfo

Secondly, fetch all instruments that are delisted today with delist reason knock-out as in the example below. Please note that the value of the delistDate parameter should be changed to the current date.

<ExchangeData xmlns="http://www.ngm.se/ns/ExchangeDataSchema/2.9" instrumentCount="-1" time="2017-03-06T10:25:58.489+01:00">
        <MarketSegment marketId="XNGM" segmentId="NDXN" name="NDX Norway">
                <MarketSegment marketId="XNGM" segmentId="DNCE" name="Certificates NO"/>
                <MarketSegment marketId="XNGM" segmentId="DNEX" name="Exotics NO"/>
                <MarketSegment marketId="XNGM" segmentId="DNKO" name="Knock-Outs NO"/>
                <MarketSegment marketId="XNGM" segmentId="DNMP" name="Miscellaneous Investment Products NO"/>
                <MarketSegment marketId="XNGM" segmentId="DNPV" name="Plain Vanillas NO"/>
                <MarketSegment marketId="XNGM" segmentId="DNSP" name="Structured Products NO"/>
        </MarketSegment>
</ExchangeData>

Fetch turnover summary without listing instruments. [turnoverSummary, skipEmpty]

search.xml?user={username}&password={userpassword}&skipEmpty=true&show=turnoverSummary

<ExchangeData xmlns="http://www.ngm.se/ns/ExchangeDataSchema/2.9" instrumentCount="-1" time="2017-03-06T10:27:00.322+01:00">
        <MarketSegment marketId="XNGM" segmentId="NDXN" name="NDX Norway">
                <MarketSegment marketId="XNGM" segmentId="DNCE" name="Certificates NO">
                        <TurnoverSummary currency="NOK" priceType="PER_UNIT" turnover="273229.00" volume="19100"/>
                </MarketSegment>
                <MarketSegment marketId="XNGM" segmentId="DNEX" name="Exotics NO"/>
                <MarketSegment marketId="XNGM" segmentId="DNKO" name="Knock-Outs NO">
                        <TurnoverSummary currency="NOK" priceType="PER_UNIT" turnover="32860.85" volume="24805"/>
                </MarketSegment>
                <MarketSegment marketId="XNGM" segmentId="DNMP" name="Miscellaneous Investment Products NO"/>
                <MarketSegment marketId="XNGM" segmentId="DNPV" name="Plain Vanillas NO"/>
                <MarketSegment marketId="XNGM" segmentId="DNSP" name="Structured Products NO"/>
        </MarketSegment>
</ExchangeData>

Sort markets and instruments in descending order. [sortDirection]

search.xml?user={username}&password={userpassword}&symbol=testInstrumentRights1&symbol=testInstrumentRights2&sortDirection=DESC

<ExchangeData xmlns="http://www.ngm.se/ns/ExchangeDataSchema/2.9" instrumentCount="0" time="2017-03-06T10:29:21.529+01:00">
        <MarketSegment marketId="XNGM" segmentId="NDXN" name="NDX Norway">
                <MarketSegment marketId="XNGM" segmentId="DNKO" name="Knock-Outs NO">
                        <Instrument id="1891" isin="DE000CK69S85" name="B LONGDAX AK CZK" symbol="testInstrumentRights2"/>
                        <Instrument id="1890" isin="DE000CK69S77" name="B LONGDAX AJ CZK" symbol="testInstrumentRights1"/>
                </MarketSegment>
        </MarketSegment>
</ExchangeData>

Get turnover in fixed point notation instead of floating point. [rawPrices, turnoverSummary]

search.xml?user={username}&password={userpassword}&symbol=SBC&rawPrices=true&show=turnoverSummary

<ExchangeData xmlns="http://www.ngm.se/ns/ExchangeDataSchema/2.9" instrumentCount="0" time="2017-03-16T12:59:58.917+01:00">
    <MarketSegment marketId="XNGM" segmentId="NEST" name="NGM Equity">
        <MarketSegment marketId="XNGM" segmentId="EQST" name="Equity Stockholm">
            <Instrument id="7YF" isin="SE0005932605" name="SVERIGES BOSTADSRÄTTSCENTRUM" symbol="SBC"/>
            <TurnoverSummary currency="SEK" priceType="PER_UNIT" turnover="4480000" volume="350"/>
        </MarketSegment>
    </MarketSegment>
</ExchangeData>

Get all shares with a name or symbol starting with a G. [instrumentWildcard]

search.xml?user={username}&password={userpassword}&mktSegm=XNGM:EQST&instrumentWildcard=G%25

<ExchangeData xmlns="http://www.ngm.se/ns/ExchangeDataSchema/2.9" instrumentCount="-1" time="2017-03-16T10:24:32.055+01:00">
    <MarketSegment marketId="XNGM" segmentId="NEST" name="NGM Equity">
        <MarketSegment marketId="XNGM" segmentId="EQST" name="Equity Stockholm">
            <Instrument id="2E" isin="SE0000524530" name="GLYCOREX TRANSPLANTATION B" symbol="GTAB B"/>
            <Instrument id="20E" isin="SE0005562014" name="GUIDELINE GEO" symbol="GGEO"/>
        </MarketSegment>
    </MarketSegment>
</ExchangeData>

Fetch instruments listed as closing data in JSON format

search.xml?user={username}&password={password}&symbol=testInstrumentRights1&show=closingDatas&format=json

{"ExchangeData":{"MarketSegments":[{"MarketSegments":[{"Instruments":[{"parentMarketSegment":"XNGM:DNKO","closingDatas":{"fromTime":"2017-03-06T00:00:00.000+01:00","toTime":"2017-03-06T12:18:42.077+01:00"},"id":"1890","isin":"DE000CK69S77","name":"B LONGDAX AJ CZK","symbol":"testInstrumentRights1"}],"marketId":"XNGM","segmentId":"DNKO","name":"Knock-Outs NO"}],"marketId":"XNGM","segmentId":"NDXN","name":"NDX Norway"}],"instrumentCount":0,"time":"2017-03-06T12:18:42.093+01:00"}}

Search instrument only by isin

search.xml?user=paout&password=heslo&isin=SE0000598278

<ExchangeData xmlns="http://www.ngm.se/ns/ExchangeDataSchema/2.9" instrumentCount="0" time="2017-03-16T13:48:56.877+01:00">
    <MarketSegment marketId="XNGM" segmentId="NEST" name="NGM Equity">
        <MarketSegment marketId="XNGM" segmentId="EQST" name="Equity Stockholm">
            <Instrument id="2X7" isin="SE0000598278" name="AIK FOTBOLL B" symbol="AIK B"/>
        </MarketSegment>
    </MarketSegment>
</ExchangeData>

Search for delisted instrument by isin

search.xml?user={username}&password={userpassword}&isin=GB00B8RSFD07&instrumentState=delisted

Note: Algorithm will return error, if we seek isin's (in example down here) state in listed instruments.

<ExchangeData xmlns="http://www.ngm.se/ns/ExchangeDataSchema/2.9" instrumentCount="0" time="2017-03-16T14:21:49.966+01:00">
    <MarketSegment marketId="XNGM" segmentId="NDXS" name="NDX Sweden">
        <MarketSegment marketId="XNGM" segmentId="DSKO" name="Knock-Outs SE">
            <Instrument id="1BPE" isin="GB00B8RSFD07" name="MINILONG ASSA M RBS" symbol="MINILONG ASSA M"/>
        </MarketSegment>
    </MarketSegment>
</ExchangeData>