Reference for DSService.svc - GetDataBundle
Given a token and details for multiple requests, retrieves data for all the requests.
HTTP METHOD
POST
FORMATS
Xml or Json
URL
GetDataBundle
REQUEST PARAMETERS
The operation takes in a parameter of type DSGetDataBundleRequest which has the following members.
Name | Type | Description | Example Value |
---|---|---|---|
Token | String | The token retrieved through GetToken operation | n9IcXCXIq+ApBEe0zLBeTrU11D65F6BB2ED74E3467EA0EBE |
DataRequests | DSDataRequest[] | Defines the array of request details for which data must be retrieved | Refer DSDataRequest for details. |
Properties | DSStringObjectKVPair[] | Properties to customize behavior | null |
The operation returns a parameter of type DSGetDataBundleResponse which has the following members.
Name | Type | Description | Example Value |
---|---|---|---|
DataResponses | DSDataResponse[] | The array of responses corresponding to each request. | Refer DSDataResponse for more details |
Properties | DSStringObjectKVPair[] | Properties describing behavior | null |
XML
The following is a sample request.
<DSGetDataBundleRequest xmlns="http://dsws.datastream.com/client/V1/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <DataRequests> <DSDataRequest> <DataTypes> <DSDataType> <Properties i:nil="true"/> <Value>PL</Value> </DSDataType> </DataTypes> <Date> <End>-0D</End> <Frequency>D</Frequency> <Kind>TimeSeries</Kind> <Start>-3D</Start> </Date> <Instrument> <Properties i:nil="true"/> <Value>VOD</Value> </Instrument> <Tag i:nil="true"/> </DSDataRequest> <DSDataRequest> <DataTypes> <DSDataType> <Properties i:nil="true"/> <Value>NAME</Value> </DSDataType> </DataTypes> <Date> <End/> <Frequency/> <Kind>Snapshot</Kind> <Start>-0D</Start> </Date> <Instrument> <Properties i:nil="true"/> <Value>BARC</Value> </Instrument> <Tag i:nil="true"/> </DSDataRequest> </DataRequests> <Properties i:nil="true"/> <TokenValue>TNLxBuBOVWUAMbQ1EVS1u60vfUygFF17C7C73B4A31CE</TokenValue> </DSGetDataBundleRequest>
The following is a sample response.
<DSGetDataBundleResponse xmlns="http://dsws.datastream.com/client/V1/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <DataResponses> <DSDataResponse> <AdditionalResponses i:nil="true"/> <DataTypeNames i:nil="true"/> <DataTypeValues> <DSDataTypeResponseValue> <DataType>PL</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>218.12</a:double> <a:double>223.02</a:double> <a:double>223.1</a:double> <a:double>223.8</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> <DSDataResponse> <AdditionalResponses i:nil="true"/> <DataTypeNames i:nil="true"/> <DataTypeValues> <DSDataTypeResponseValue> <DataType>NAME</DataType> <SymbolValues> <DSSymbolResponseValue> <Currency>� </Currency> <Symbol>BARC</Symbol> <Type>String</Type> <Value i:type="a:string" xmlns:a="http://www.w3.org/2001/XMLSchema">BARCLAYS</Value> </DSSymbolResponseValue> </SymbolValues> </DSDataTypeResponseValue> </DataTypeValues> <Dates xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <a:dateTime>2014-11-17T00:00:00</a:dateTime> </Dates> <SymbolNames i:nil="true"/> <Tag i:nil="true"/> </DSDataResponse> </DataResponses> <Properties i:nil="true"/> </DSGetDataBundleResponse>
JSON
{ "DataRequests": [ { "DataTypes": [ { "Properties": null, "Value": "PL" } ], "Date": { "End": "-0D", "Frequency": "D", "Kind": 1, "Start": "-3D" }, "Instrument": { "Properties": null, "Value": "VOD" }, "Tag": null }, { "DataTypes": [ { "Properties": null, "Value": "NAME" } ], "Date": { "End": "", "Frequency": "", "Kind": 0, "Start": "-0D" }, "Instrument": { "Properties": null, "Value": "BARC" }, "Tag": null } ], "Properties": null, "TokenValue": "TNLxBu73B4A31CE" }
The following is a sample response.
{ "DataResponses": [ { "AdditionalResponses": null, "DataTypeNames": null, "DataTypeValues": [ { "DataType": "PL", "SymbolValues": [ { "Currency": "�", "Symbol": "VOD", "Type": 10, "Value": [ 218.12, 223.02, 223.1, 223.8 ] } ] } ], "Dates": [ "\/Date(1415750400000+0000)\/", "\/Date(1415836800000+0000)\/", "\/Date(1415923200000+0000)\/", "\/Date(1416182400000+0000)\/" ], "SymbolNames": null, "Tag": null }, { "AdditionalResponses": null, "DataTypeNames": null, "DataTypeValues": [ { "DataType": "NAME", "SymbolValues": [ { "Currency": "� ", "Symbol": "BARC", "Type": 6, "Value": "BARCLAYS" } ] } ], "Dates": [ "\/Date(1416182400000+0000)\/" ], "SymbolNames": null, "Tag": null } ], "Properties": null }