# Time & Sales

[**Market Data Web Services API**](/apis/market-data/overview)

You use the Time & Sales service to request trades for single or multiple instruments for a defined time period.

**Table of Contents**

* [Getting Started](#get-start-id)
* [Parameters](#params-id)
* [Response](#response-id)
* [Example Requests](#example-requests-id)

### Getting Started {#get-start-id}

Information about authentication and onboarding to the service can be found on the [Market Data Web Services API](/apis/market-data/overview) page.

### Parameters {params-id}

| Parameters | Description | Required |
| :-- | :---------- | :-------------------------- |
|`instrument`|Ticker symbol.| Yes|
|`type`|Must be `tick`| Yes|
|`calendardays`|Number of calendar days to query.||
|`tradingdays`|Number of trading days to query.||
|`numbars`|Return results for specified number of bars.||
|`today`|Return data from midnight GMT to current time in GMT.||
|`listingexch`|Return the trading exchange.||
|`stime`|Start time of the time range to query.||
|`sdate`|Start date of the date range to query.||
|`etime`|End time of the time range to query.||
|`edate`|End date of the date range to query.||


### Response {#response-id}

The response contains:

* Trade time
* Morningstar exchange ID
* Last volume
* Price
* Last bid before this trade
* Last offer before this trade 

### Example Requests {#example-requests-id}

>The following sections describe some common requests to the Time & Sales service. The exchanges and instruments you can query depend on your account enablements.

### Example 1

Get all today's trades for Vodafone.

````
http://msxml.morningstar.com/indexTS?username=******&password=******&instrument=151.1.VOD&type=tick&Today&messageTypes=T

````

### Example 2

Get last 200 trades for Vodafone.

````
http://msxml.morningstar.com/indexTS/?username=******&password=******&instrument= 151.1.VOD&type=tick&numbars=200

````