---
title: "What the standard basket has cost at each chain, day by day"
method: GET
path: "/v1/insights/basket/history"
---

# What the standard basket has cost at each chain, day by day

`GET /v1/insights/basket/history`

## Request

- Base URL: `https://supermcp.co.il`
- URL: `https://supermcp.co.il/v1/insights/basket/history`
- Auth: none required

Recorded totals, not a reconstruction: each point is the figure this API published that day, and the last point of every series is the total `/v1/insights/basket` returns right now. Only chains that stock the whole basket appear, because a total over fewer lines is smaller for carrying less and is not comparable with the rest. Days with no record are absent rather than interpolated, so a step in `points` is always a movement between two published totals. History begins 2026-08-16; `watchingSince` is null before anything was recorded.

## Response `200`

OK

- object
  - `data` object
    - `watchingSince` string, nullable: First day covered, YYYY-MM-DD
    - `days` string[]: Every date any chain has a point on, oldest first
    - `chains` object[]
      - `chainId` string
      - `chainSlug` string
      - `chainName` string
      - `points` object[]: Oldest first
        - `date` string
        - `total` number
      - `first` number: The basket at this chain on the earliest day held
      - `latest` number: Today's total, matching /v1/insights/basket
      - `change` number: latest - first; negative is cheaper
      - `changePercent` number
    - `moves` object[]: Newest first, capped. One entry per step in any chain's points.
      - `date` string
      - `chainId` string
      - `chainSlug` string
      - `chainName` string
      - `from` number
      - `to` number

## Other responses

- `400`: Bad request. Query parameters are validated strictly: a parameter this document does not list is rejected, and `details[].keys` names it. A misspelled filter used to be dropped silently, which answered a question nobody asked with a plausible list of products.
- `401`: Unauthorized
- `404`: Not found
- `429`: Rate limited

---

[API](https://skmtc.dev/supermcp/apis/super-mcp-api.md) · [All operations](https://skmtc.dev/supermcp/apis/super-mcp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/supermcp/apis/super-mcp-api/revisions/f0dea9415b1c?raw)
