DTN Content Services Markets API is the current API for querying market data from DTN. It will eventually replace our previous FimiNetWS and PXWeb web service systems.
REST Based
Content Services Markets API is a REST based web service, and it does not support the SOAP web service protocol. There is an “Open API Specification” description file that can be used to generate client code in a similar way to how WSDL files could be used to generate code for SOAP clients. Documentation for generating a client from an OAS (previously called Swagger) spec is here: Using a Swagger Spec.
Authentication
Content Services requests are authenticated via a key value that is sent in an HTTP header called apikey rather than sending a username and password as query parameters. Customer Service will provide the api key.
Response Format
The default response format for content services is JSON. The format is described by the OpenAPI Specification. It is also possible to get a response format of XML by specifying the content type HTTP header with a value of application/xml.
Operations List
Below are a list of operations supported by previous APIs and corresponding calls in Content Services which return the same information. Operations fall into five groups: Quotes, History, Options, Market Scans, and Symbol Search. There are a few operations that did exist in the older APIs but are not supported by content services.
Quote Operations
FimiNetWS:
- GetQuoteSnap
- GetQuoteSnapCache
- GetQuoteSnapNC
PXWeb:
- GetQuoteSnap
Quotes are requested from content services using the following URL:
https://api.dtn.com/markets/symbols/{symbol}/quotes
Where {symbol} is a placeholder for the actual symbol. It is also possible to specify several symbols separated by commas, but the commas do need to be URL encoded.
History Operations
FimiNetWS:
- GetDailyHistory
- GetDailyHistoryV
- GetMinuteHistory
- GetTickHistory
- GetInterdayHistory
- GetInterdayHistoryV
- GetForwardCurve
PXWeb:
- GetDailyHistory
- GetMinuteHistory
- GetForwardCurve
For history queries there is now a single request for all intervals, and the desired interval is passed as a parameter. Price history requests will return a maximum of 2,000 price history records.
For history for a single symbol you can use the following URL and replace {symbol} with the desired symbol.
https://api.dtn.com/markets/{symbol}/price-history
To query multiple symbols you can use the following URL and include a comma separated list of symbols in the symbol query parameter.
https://api.dtn.com/markets/price-history?symbol=@C@1,@S@1,@W@1
Option Operations
FimiNetWS:
- GetOptionGreeks
- GetOptionGreeksSnap
https://api.dtn.com/markets/option-strikes
https://api.dtn.com/markets/symbols/{symbol}/option-greeks
Market Scan Operations
FimiNetWS:
- GetMarketScans
PXWeb:
- GetMarketScans
https://api.dtn.com/markets/market-scan/{report}
Symbol Search Operations
FimiNetWS:
- EquitySymbolLookup
PXWeb:
- FindSymbol
- SymbolSearch
In content services, searching for symbols is done through the
https://api.dtn.com/markets/symbols?searchText={query}
The markets/symbols endpoint will return symbols that contain the searchText in the symbol or its description. The search results will be the same as the PXWeb SymbolSearch operation. There is no exact match of the EquitySymbolLookup or FindSymbol endpoint in content services.
In the past some clients had used FindSymbol to get a list of all symbols in a certain category. We now recommend using the /markets/symbols/{pattern}/quotes endpoint to get lists of symbols. The quotes end point allows wildcards in the symbol, and it is also possible to specify a market with a wildcard to match all symbols in the market. If there are more symbols matched than can be returned by a single request, a pageToken is returned which allows iterating through the entire result set.
News Operations
FimiNetWS:
- GetNewsIndex
- GetNewsStory
- PublishNews
PXWeb:
- GetNewsIndex
- GetNewsStory
The Content Services Markets API does not support any news queries.
Misc Operations
FimiNetWS:
- GetCalcPrice
- PublishQuote
PXWeb:
- GetHistoryCorrections
- GetAccountStatus
- GetAccountRequests
- CrackCalculator
- CrushCalculator
These operations are not supported in Content Services.