get_price_change

Get a product's 180-day price change summary from recorded history: current price, 180-day low/high/average, sample count, and where the current price sits among its own recorded observations.

When to use: answering "is now a good time to buy" style questions from historical data. This is a stored snapshot — call scrap_page for a real-time quote.

Parameters

Name	Type	Required	Description
`asin`	string	yes	10-character Amazon ASIN

Example call

{
  "jsonrpc": "2.0", "id": 11, "method": "tools/call",
  "params": {
    "name": "get_price_change",
    "arguments": {"asin": "B01MTB55WH"}
  }
}

Response shape

{
  "asin": "B01MTB55WH",
  "price_current": 29.99,
  "price_currency": "USD",
  "low_180d": 24.99,
  "high_180d": 39.99,
  "avg_180d": 32.45,
  "sample_count_180d": 6,
  "position_in_180d_range_pct": 16.7,
  "current_vs_avg_180d_pct": -7.6,
  "current_vs_low_180d_pct": 20.0,
  "current_vs_high_180d_pct": -25.0,
  "price_as_of": "2026-11-04T08:12:00Z",
  "product_url": "https://www.amazon.com/dp/B01MTB55WH",
  "notes": {"...": "..."}
}

*(abbreviated for readability)*

Field notes

Field	Description
`low_180d` / `high_180d` / `avg_180d`	Lowest, highest, and average recorded price over the trailing 180 days
`sample_count_180d`	Number of price observations behind the statistics
`position_in_180d_range_pct`	Percentile of the current price among its own recorded 180-day observations (lower = closer to the historical low)
`current_vs_avg_180d_pct`	Current price vs the 180-day average, in percent (negative = below average)
`change`	Returned as `insufficient_sample` when no usable history exists

Tool note

> Statistics come from the recorded pipeline history (see price_as_of), presented without evaluation. This tool draws no conclusion on whether to buy; interpret the numbers yourself.

Related tools

get_price — latest stored price
scrap_page — real-time price and stock
get_product — full price block with the same 180-day history