Reference for DSService.svc - Data

Given a token and details for a single request, retrieves data.

HTTP METHOD

GET

FORMATS

Xml or Json

URL

Data?token={TOKEN}&instrument={INSTRUMENT}&datatypes={DATATYPES}&datekind={DATEKIND}&start={START}&end={END}&freq={FREQ}&props={PROPS}&format={FORMAT}

REQUEST PARAMETERS

The operation takes in a following parameters: (Note that the query string values must be URL encoded)

Name	Type	Description	Example Value
token	String	The token retrieved using the Token method.	n9IcXCXIq+ApBEe0zLBeTrU11D65F6BB2ED74E3467EA0EBE
instrument	String	The instrument.	Ex: VOD (or) LFTSE100 (or) VOD,BARC.
datatypes	String	The datatype.	Ex: PL (or) NAME (or) PL,PH.
datekind	String	Defines whether the date is a snapshot (static) or a time series date. It is enough to specify only start date for a snapshot date.	Ex: TimeSeries, Snapshot.
start	String	The start date. The dates can be relative dates or absolute dates or string literals. Refer DSDateNames for string literals.	Ex: -30D (or) 2011-12-31 (or) BDATE.
end	String	The end date. The dates can be relative dates or absolute dates or string literals. Refer DSDateNames for string literals.	Ex: -30D (or) 2011-12-31 (or) BDATE.
freq	String	The frequency.Refer DSDateFrequencyNames for allowed frequencies.	Ex: D (or) W (or) M (or) Q (or) Y.
props	DSStringObjectKVPair[]	Optional properties to customize behavior for the instruments.	Ex: Empty string value (or) IsSymbolSet
format	String	Optional format for xml or json	Empty string value

The operation returns the following parameter:

Name	Type	Description	Example Value
DataResponse	DSDataResponse	The response corresponding to the request.	Refer DSDataResponse for more details

XML

The following is a sample request.

Data?token=TNLxBuBOVWUA6Ni73B4A31CE&instrument=VOD&datatypes=PH&datekind=TimeSeries&start=-3D&end=-0D&freq=D&props=

The following is a sample response.

<DSDataResponse xmlns="http://dsws.datastream.com/client/V1/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <AdditionalResponses i:nil="true"/>
  <DataTypeNames i:nil="true"/>
  <DataTypeValues>
    <DSDataTypeResponseValue>
      <DataType>PH</DataType>
      <SymbolValues>
        <DSSymbolResponseValue>
          <Currency>£</Currency>
          <Symbol>VOD</Symbol>
          <Type>DoubleArray</Type>
          <Value i:type="a:ArrayOfdouble" xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <a:double>222</a:double>
            <a:double>225.8</a:double>
            <a:double>226.6</a:double>
            <a:double>229.9</a:double>
          </Value>
        </DSSymbolResponseValue>
      </SymbolValues>
    </DSDataTypeResponseValue>
  </DataTypeValues>
  <Dates xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <a:dateTime>2014-11-12T00:00:00</a:dateTime>
    <a:dateTime>2014-11-13T00:00:00</a:dateTime>
    <a:dateTime>2014-11-14T00:00:00</a:dateTime>
    <a:dateTime>2014-11-17T00:00:00</a:dateTime>
  </Dates>
  <SymbolNames i:nil="true"/>
  <Tag i:nil="true"/>
</DSDataResponse>

JSON

Data?token=TNLxBuBOVWUA6Ni73B4A31CE&instrument=VOD&datatypes=PH&datekind=TimeSeries&start=-3D&end=-0D&freq=D&props=

The following is a sample response.

{
    "AdditionalResponses":null,
    "DataTypeNames":null,
    "DataTypeValues":[
    {
        "DataType":"PH",
        "SymbolValues":[
        {
            "Currency":"£",
            "Symbol":"VOD",
            "Type":10,
            "Value":[222,225.8,226.6,229.9]
        }]
    }],
    "Dates":["\/Date(1415750400000+0000)\/","\/Date(1415836800000+0000)\/","\/Date(1415923200000+0000)\/","\/Date(1416182400000+0000)\/"],
    "SymbolNames":null,
    "Tag":null
}