---
title: "Selected historical examples for widget asset pages"
method: GET
path: "/api/widgets/history.json"
---

# Selected historical examples for widget asset pages

`GET /api/widgets/history.json`

## Request

- Base URL: `https://widget.kunkafa.com`
- URL: `https://widget.kunkafa.com/api/widgets/history.json`
- Auth: none declared

Latest eligible completed result for each original duration per market, combined across both directions, ordered by record closure descending with stable ID ties. Original forecast window strictly longer than one day and confidence strictly above 80%, from a 90-day lookback. Unknown outcomes are excluded. These selected results are not an aggregate performance denominator. sourceGeneratedAt records the historical query time.

## Response `200`

Dated historical examples with per-asset coverage states.

- WidgetHistory
  - `schema` unknown, required
  - `generatedAt` string, date-time, required
  - `dataUrl` 'https://widget.kunkafa.com/api/widgets/history.json', required
  - `selection` 'latest-per-duration-over80-over1day-90days-v9', required
  - `lookbackDays` unknown, required
  - `assets` object[], required
    - `id` string, required
    - `status` 'available' | 'unavailable', required: Availability of selected results only; not a measure of aggregate performance or evidence quality.
    - `examples` WidgetHistoricalExample[], required
      - `id` string, required
      - `direction` 'up' | 'down', required
      - `openedAt` string, date-time, required
      - `closedAt` string, date-time, required
      - `moveFraction` number, required
      - `outcome` 'reached' | 'not-reached', required
      - `durationLabel` object, required: Official localized duration, matched and rounded by the server using the app catalogue. This is the single published duration label.
        - `en` string, required
        - `ar` string, required
      - `confidencePct` number, required: Recorded confidence rounded to two decimals, not historical performance. Eligibility uses the original confidence strictly above 80%; a qualifying value just above 80% can display as 80.00% after rounding.
      - `mfePercent` number, nullable: Recorded furthest favorable price movement in percentage points.
      - `targetProgressPercent` number, nullable: Favorable move as a percentage of target distance; can exceed 100. Missing is null.
  - `sourceGeneratedAt` string, date-time, required: Time the historical sample was actually queried; preserved during hourly cache reuse.

## Other responses

- `302`: The kunkafa.com alias redirects to this endpoint on widget.kunkafa.com.
- `503`: No verified historical snapshot available.

---

[API](https://skmtc.dev/kunkafa/apis/kunkafa-public-data-and-integrations.md) · [All operations](https://skmtc.dev/kunkafa/apis/kunkafa-public-data-and-integrations/llms.txt) · [OpenAPI document](https://skmtc.dev/kunkafa/apis/kunkafa-public-data-and-integrations/revisions/8217b961f423?raw)