---
title: "Market names and optional percentage questions"
method: GET
path: "/api/widgets/snapshot.json"
---

# Market names and optional percentage questions

`GET /api/widgets/snapshot.json`

## Request

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

Published independently on widget.kunkafa.com, scheduled hourly. Inspect generatedAt and per-asset source timestamps for freshness and availability. No latest confidence values or private forecast arrays.

## Response `200`

Hourly snapshot, with per-asset source timestamps and availability.

- WidgetSnapshot
  - `schema` unknown, required
  - `generatedAt` string, date-time, required
  - `dataUrl` 'https://widget.kunkafa.com/api/widgets/snapshot.json', required
  - `historyUrl` 'https://widget.kunkafa.com/api/widgets/history.json', required
  - `assets` WidgetAsset[], required
    - `id` string, required: Public market identity derived from the full English asset name.
    - `name` WidgetText, required
      - `en` string, required
      - `ar` string, required
    - `decimals` integer, nullable, required
    - `quote` WidgetQuote, required
      - `currency` string, nullable, required: Display currency; USDT is labeled USD. No absolute market prices are published.
      - `unit` WidgetText, required
        - `en` string, required
        - `ar` string, required
    - `sourceAt` string, date-time, nullable, required
    - `status` 'available' | 'delayed' | 'unavailable', required
    - `question` WidgetText, required
      - `en` string, required
      - `ar` string, required
    - `questionSourceAt` string, date-time, nullable, required
    - `url` string, uri, required
    - `category` WidgetText, required
      - `en` string, required
      - `ar` string, required
    - `slug` string: Public English-name route slug. Internal id remains the stable data key; clients accept older snapshots without slug.
    - `questionBasis` 'percentage', required
    - `lookupKeys` string[]: Compatibility locators for existing market links. These are not credentials and grant no access.

## Other responses

- `302`: The kunkafa.com alias redirects to this endpoint on widget.kunkafa.com.
- `503`: No verified 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)