DescribeSpotPriceHistory

For example, you could use an option or a filter to get the history for a particular instance type. You can specify multiple request parameters or filters (for example, limit the response to the m2.xlarge instance type, and only for Windows instances). The response includes information for a price history only if it matches all your options or filters. If there's no match, no special message is returned, the response is simply empty.

You can use wildcards in a filter value. An asterisk (*) matches zero or more characters, and a question mark (?) matches exactly one character. You can escape special characters using a backslash (\) before the character. For example, a value of \*amazon\?\\ searches for the literal string *amazon?\.

The following are the available filters.

This example returns Spot Price history for a particular day in December 2009 for Availability Zone us-east-1a.

https://ec2.amazonaws.com/?Action=DescribeSpotPriceHistory
&StartTime=2009-12-04T00:00:00.000Z
&EndTime=2009-12-04T23:59:59.000Z
&AvailabilityZone=us-east-1a
&AUTHPARAMS

This request uses filters instead of regular request parameters to achieve the same results.

https://ec2.amazonaws.com/?Action=DescribeSpotPriceHistory
&Filter.1.Name=timestamp
&Filter.1.Value.1=2009-12-04*
&Filter.2.Name=availability-zone
&Filter.2.Value.1=us-east-1a
&AUTHPARAMS

<DescribeSpotPriceHistoryResponse xmlns="http://ec2.amazonaws.com/doc/2013-02-01/">
   <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId> 
   <spotPriceHistorySet>
      <item>
         <instanceType>m1.small</instanceType>
         <productDescription>Linux/UNIX</productDescription>
         <spotPrice>0.287</spotPrice>
         <timestamp>2009-12-04T20:56:05.000Z</timestamp>
         <availabilityZone>us-east-1a</availabilityZone>
      </item>
      <item>
         <instanceType>m1.small</instanceType>
         <productDescription>Windows</productDescription>
         <spotPrice>0.033</spotPrice>
         <timestamp>2009-12-04T22:33:47.000Z</timestamp>
         <availabilityZone>us-east-1a</availabilityZone>
      </item>
   </spotPriceHistorySet>
   <nextToken/>
</DescribeSpotPriceHistoryResponse>