Amazon Elastic Compute Cloud
API Reference (API Version 2014-10-01)
Did this page help you?  Yes | No |  Tell us about it...
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.


Describes the Spot Price history. Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current Spot Instance requests. For more information about Spot Instances, see Spot Instances in the Amazon Elastic Compute Cloud User Guide for Linux.

When you specify an Availability Zone, this operation describes the price history for the specified Availability Zone with the most recent set of prices listed first. If you don't specify an Availability Zone, you get the prices across all Availability Zones, starting with the most recent set. However, if you're using an API version earlier than 2011-05-15, you get the lowest price across the region for the specified time period. The prices returned are listed in chronological order, from the oldest to the most recent.

When you specify the start and end time options, this operation returns two pieces of data: the prices of the instance types within the time range that you specified and the time when the price changed. The price is valid within the time period that you specified; the response merely indicates the last time that the price changed.

Request Parameters

For information about the common parameters that all actions use, see Common Query Parameters.


The Availability Zone.

Type: String

Required: No


Type: Boolean

Required: No


The end date and time of the Spot Price history data.

Type: DateTime

Required: No


One or more filters.

  • availability-zone - The Availability Zone for which prices should be returned.

  • instance-type - The type of instance (for example, m1.small).

  • product-description - The product description for the Spot Price (Linux/UNIX | SUSE Linux | Windows | Linux/UNIX (Amazon VPC) | SUSE Linux (Amazon VPC) | Windows (Amazon VPC)).

  • spot-price - The Spot Price. The value must match exactly (or use wildcards; greater than or less than comparison is not supported).

  • timestamp - The timestamp of the Spot Price history (for example, 2010-08-16T05:06:11.000Z). You can use wildcards (* and ?). Greater than or less than comparison is not supported.

Type: Filter list

Required: No


One or more instance types.

Type: String list

Valid Values: t1.micro | m1.small | m1.medium | m1.large | m1.xlarge | m3.medium | m3.large | m3.xlarge | m3.2xlarge | t2.micro | t2.small | t2.medium | m2.xlarge | m2.2xlarge | m2.4xlarge | cr1.8xlarge | i2.xlarge | i2.2xlarge | i2.4xlarge | i2.8xlarge | hi1.4xlarge | hs1.8xlarge | c1.medium | c1.xlarge | c3.large | c3.xlarge | c3.2xlarge | c3.4xlarge | c3.8xlarge | cc1.4xlarge | cc2.8xlarge | g2.2xlarge | cg1.4xlarge | r3.large | r3.xlarge | r3.2xlarge | r3.4xlarge | r3.8xlarge

Required: No


The number of rows to return.

Type: Integer

Required: No


The next set of rows to return.

Type: String

Required: No


One or more basic product descriptions.

Type: String list

Required: No


The start date and time of the Spot Price history data.

Type: DateTime

Required: No

Response Elements

The following elements are returned.


The string marking the next set of results. This is empty if there are no more results.

Type: String


The ID of the request.

Type: String


The historical Spot Prices.

Type: SpotPrice list


For information about the errors that are common to all actions, see Common Client Errors.



This example gets Spot Price history for a particular day in December 2009 for the specified Availability Zone.

Sample Request

Sample Response

<DescribeSpotPriceHistoryResponse xmlns="">

Example with Filters

This example uses filters to get the same results as the previous example.

Sample Request