---
title: "Results"
method: GET
path: "/api/v1/markets/{slug}/results"
tags: ["Authenticated integrations"]
---

# Results

`GET /api/v1/markets/{slug}/results`

## Request

- Base URL: `https://kunkafa.com`
- URL: `https://kunkafa.com/api/v1/markets/{slug}/results`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://kunkafa.com/oauth/authorize`, token URL `https://kunkafa.com/oauth/token`, scopes: `results:read`)

Read the same capped public results shown by Kunkafa. Pro and Publisher REST. No private archive, summary charge or change to the integration session.

## Path parameters

- `slug` string, required

## Response `200`

Complete response; 20-second request timeout and 128 KiB response ceiling.

- IntegrationResultsResponse
  - `data` object, required: Latest eligible completed result for every distinct original duration, across both directions, newest closure first. Previous 90 days; original duration strictly longer than 24 hours and recorded confidence strictly above 80%. Reached and missed targets both qualify. Selected results are not an aggregate success rate or full archive.
    - `market` string, required: Published English-name market slug returned by authorized discovery.
    - `sourceAt` string, date-time, required: ISO 8601 UTC timestamp supplied by Kunkafa.
    - `results` IntegrationResult[], required
      - `id` string, required
      - `direction` 'up' | 'down', required
      - `predictionAt` string, date-time, required: ISO 8601 UTC timestamp supplied by Kunkafa.
      - `closedAt` string, date-time, required: ISO 8601 UTC timestamp supplied by Kunkafa.
      - `probabilityPercent` number, required: Rounded to two decimal places. Eligibility uses original confidence strictly above 80%; a qualifying value just above 80% can display as 80% after rounding.
      - `movePercent` number, required
      - `outcome` 'reached' | 'not-reached', required
      - `mfePercent` number, nullable, required: Recorded furthest favorable price movement in percentage points.
      - `targetProgressPercent` number, nullable, required: Favorable move as a percentage of target distance; can exceed 100. Missing is null.
      - `durationLabel` union, required: English label in API and MCP replies; the app hand-off file keeps both languages.
        - string
        - object
          - `en` string, required
          - `ar` string, required
    - `url` string, uri, required: The market's page on kunkafa.com.
  - `usage` IntegrationUsage, required
    - `calculatedAt` string, date-time, required: ISO 8601 UTC timestamp supplied by Kunkafa.
    - `tier` 'free' | 'starter' | 'core' | 'pro' | 'publisher', required
    - `requests` object, required: Steady request rate with bounded burst capacity; metadata and repeated summaries still count toward request protection.
      - `perMinute` integer, required
      - `burst` integer, required
      - `remaining` integer, required
      - `nextRequestAt` string, date-time, required: ISO 8601 UTC timestamp supplied by Kunkafa.
    - `concurrency` object, required: Private requests that can run at the same time. Requests from one connection run side by side up to this limit (the plan burst); a request from another connection waits until they finish.
      - `limit` integer, required
      - `remaining` integer, required
      - `nextRequestAt` string, date-time, required: ISO 8601 UTC timestamp supplied by Kunkafa.
    - `windows` IntegrationWindowUsage[], required
      - `period` 'day' | 'week' | 'month', required
      - `used` integer, required
      - `limit` integer, required
      - `remaining` integer, required
      - `nextCapacityAt` string, date-time, required: ISO 8601 UTC timestamp supplied by Kunkafa.
      - `notice` unknown, required
      - `noticeId` string, nullable, required
    - `adjustment` object: An owner-approved account allowance increase. A null expiration is permanent until changed. Usage is never reset; market access and credential eligibility still follow the current plan.
      - `expiresAt` string, date-time, nullable, required
  - `notices` IntegrationNotice[], required
    - `id` string, required
    - `period` 'day' | 'week' | 'month', required
    - `kind` 'approaching_limit' | 'limit_reached', required
    - `message` string, required
    - `used` integer, required
    - `limit` integer, required
    - `remaining` integer, required
    - `nextCapacityAt` string, date-time, required: ISO 8601 UTC timestamp supplied by Kunkafa.
  - `dataUse` string, required: Use restriction on every reply: data collection is prohibited; the data may not be collected, saved, stored, exported or compiled, or used to train, retrain, fine-tune or distil any model.
  - `fieldGuide` object, required: Plain meanings of the returned fields.
    - `results` string, required
    - `probabilityPercent` string, required
    - `movePercent` string, required
    - `outcome` string, required
    - `mfePercent` string, required
    - `targetProgressPercent` string, required

## Other responses

- `400`: Invalid fields, an unknown or missing duration, a request broader than one call returns, or an invalid pagination cursor.
- `401`: Missing, invalid, expired or revoked credentials.
- `403`: Account, permission, plan or market is not authorized.
- `404`: Unknown API operation or route.
- `405`: HTTP method not supported.
- `413`: Request body exceeds the 16 KiB limit.
- `415`: Use application/json for request bodies.
- `429`: Request, concurrency, traffic or rolling summary limit. No partial private delivery or new disclosure charges.
- `503`: Temporary access/accounting failure or unavailable data. This is not exhausted allowance.

---

[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)