---
title: "Retrieve historical prices"
method: GET
path: "/listings/prices"
tags: ["listings"]
---

# Retrieve historical prices

`GET /listings/prices`

Retrieve time-series price history for a catalog item.

Use this endpoint for pricing charts, trend indicators, and historical comparison views.

Input behavior:
- Accepts item lookup via `urn` or `slug`.
- Supports a predefined `range` window (for example `1M`).

Rules and responses:
- Returns `404` when the item cannot be resolved.
- Returns normalized series data for the resolved item across the selected range.
- Short-lived caching is applied to improve chart load times.

## Query parameters

- `urn` string — URN of the item to lookup
- `slug` string — Slug of the item to lookup
- `range` '1M' | '3M' | '6M' | '1Y'

## Response `200`

Price history

- ItemPricePoint[] — Aggregated pricing for an item
  - `time` string, required — ISO timestamp for the interval
  - `listed` PriceStats, required — Statistics for a price range
    - `min` number, required — Minimum price in pence
    - `max` number, required — Maximum price in pence
    - `avg` number, required — Average price in pence
    - `vol` number, required — Total quantity captured for the aggregation window
  - `sold` PriceStats, required — Statistics for a price range
    - `min` number, required — Minimum price in pence
    - `max` number, required — Maximum price in pence
    - `avg` number, required — Average price in pence
    - `vol` number, required — Total quantity captured for the aggregation window

## Other responses

- `404` — Item not found

---

[API](https://skmtc.net/managem/apis/managem-api.md) · [All operations](https://skmtc.net/managem/apis/managem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/managem/managem-api/versions/6367b514f6ea/schema)