Sattaz Commercial API

Enterprise-grade REST API delivering sub-10ms real-time results and multi-year historical chart archives for all Regular Matka, Satta King, and Kolkata FF markets.

Overview & Latency < 10ms In-Memory Response

The Sattaz API is designed for commercial portals, mobile applications, bot operators, and web syndication partners. All requests return standard JSON envelopes and support HTTP Keep-Alive.

Base URL:https://sattaz.com/api/v1

Live results are served directly from an in-memory high-throughput Memcached layer to guarantee ultra-low latency (< 10ms TTFB), while historical results and charts are recorded in dedicated, indexed tables for lightning-fast date and year queries.

Authentication

All API requests require authentication using a Bearer API token sent in the Authorization HTTP request header.

Authorization: Bearer stz_live_your_api_key_here

API keys follow the prefix stz_live_. You can generate or revoke API keys at any time from your Account Settings if you have an active API Subscription.

Rate Limits & Headers

Requests are rate-limited on a sliding per-minute window based on your active subscription plan (e.g., 60 req/min for Starter, 300 req/min for Pro, 1000+ req/min for Enterprise).

Every response includes rate-limiting telemetry headers:

HeaderDescription
X-RateLimit-LimitMaximum allowed requests per minute for your plan.
X-RateLimit-RemainingRemaining requests in the current window.
X-RateLimit-ResetUnix epoch timestamp when the current window expires.

If you exceed your rate limit, the API responds with HTTP status 429 Too Many Requests.

Official PHP SDK

We provide a production-ready, zero-dependency PHP client class (SattazClient.php) supporting automatic retries, robust exception handling, and full IDE auto-completion.

Download SDK:/sdk/php/SattazClient.php

<?php
require_once __DIR__ . '/SattazClient.php';

use Sattaz\Api\SattazClient;
use Sattaz\Api\SattazApiException;

$client = new SattazClient('stz_live_your_api_key_here');

try {
    // 1. Get Live Results (<10ms)
    $live = $client->getLiveResults();
    foreach ($live['data'] as $res) {
        echo "{$res['market_name']}: {$res['open_panna']}-{$res['jodi']}-{$res['close_panna']}\n";
    }

    // 2. Query Historical Date for a Market
    $history = $client->getMarketResult('kalyan', '2026-10-01');
    print_r($history['data']);

    // 3. Fetch Full Chart Archive
    $chart = $client->getChart('milan-day', 2026);
    print_r($chart['data']);

} catch (SattazApiException $e) {
    echo "API Error: " . $e->getMessage() . " (HTTP " . $e->getHttpStatus() . ")\n";
}

Market Draw Statuses & Holidays

Every market result in the Sattaz API returns an explicit status property defining where the market sits in its daily draw lifecycle. Client applications can reliably derive whether a market is open, declared, awaiting results, or observing a holiday.

Result Status Values

StatusMeaningField Values & Behavior
holidayMarket Holiday: No draw scheduled or held today (official holiday, Sunday closure, or administrator-declared holiday).open_panna: null, jodi: null, close_panna: null, result: "***-**-***", declared_at: null.
pendingPending Declaration: Market is active today; waiting for open draw numbers.open_panna: null, jodi: null, close_panna: null, result: "***-**-***", declared_at: null.
openOpen Declared: Open panna & open ank declared; close draw is still pending.open_panna: "288", jodi: "8", close_panna: null, result: "288-8", declared_at: TIMESTAMP.
closedFully Declared: Both open and close panna and complete jodi are declared.open_panna: "578", jodi: "05", close_panna: "113", result: "578-05-113", declared_at: TIMESTAMP.
declaredSatta King Declared: Winning 2-digit number declared for Satta King markets.result: "46", time: "23:15:00".

How to Derive Market Holidays in Your App

You can identify market holidays in two ways depending on your architecture:

  • From Results Endpoints (/api/v1/results/live, /api/v1/results/{category}, /api/v1/results/{slug}):
    Inspect the status field. If market.status === 'holiday', the market will not hold any draw for that date.
  • From the Markets Directory (/api/v1/markets):
    Every market object contains a boolean holiday property (e.g. market.holiday === true). This reflects whether the market is observing a holiday today.
// Detect holiday in JavaScript / Node.js
const res = await fetch("https://sattaz.com/api/v1/results/live", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const { data } = await res.json();

for (const market of data.results) {
  if (market.status === 'holiday') {
    console.log(`🏖️ ${market.market} is on holiday today (${market.date}). No draw scheduled.`);
  } else if (market.status === 'closed') {
    console.log(`✅ ${market.market}: ${market.result}`);
  } else if (market.status === 'open') {
    console.log(`⏳ ${market.market} Open declared: ${market.open_panna}-${market.jodi}`);
  } else {
    console.log(`⏱️ ${market.market} is pending today's draw.`);
  }
}
# Detect holiday in Python
import requests

resp = requests.get(
    "https://sattaz.com/api/v1/results/live",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
).json()

for m in resp.get("data", {}).get("results", []):
    if m.get("status") == "holiday":
        print(f"🏖️ {m['market']} is on HOLIDAY today. No game.")
    else:
        print(f"Status: {m['status']} | {m['market']}: {m.get('result')}")
<?php
// Detect holiday in PHP
$client = new \Sattaz\Api\SattazClient('YOUR_API_KEY');
$live = $client->getLiveResults();

foreach ($live['data']['results'] as $market) {
    if ($market['status'] === 'holiday') {
        echo "🏖️ {$market['market']} is on holiday today.\n";
    }
}

Markets Directory

GET/api/v1/markets

Returns all active markets across Regular Matka, Satta King, and Kolkata FF, including their schedule and open/close timings.

Query Parameters

ParameterTypeRequiredDescription
typestringOptionalFilter by market type: matka, satta, or kolkataff.

Response Attributes

FieldTypeDescription
idintegerPlatform unique market ID.
marketstringMarket display name (e.g. KALYAN, MILAN DAY).
slugstringUnique URL-friendly slug used across results & chart endpoints.
categorystringMarket category: matka, satta, or kolkataff.
open_timestringNormalized open timing (e.g. 03:45 PM). Null for Satta King.
close_timestringNormalized close timing (e.g. 05:45 PM).
daysintegerOperating days per week (e.g. 6 or 7).
activebooleanWhether the market is active on the platform.
holidaybooleanMarket Holiday Indicator:true if this market is observing a holiday today (no draw will be held), false if operating normally.
curl -X GET "https://sattaz.com/api/v1/markets?type=matka" \
  -H "Authorization: Bearer stz_live_your_api_key_here"
$client = new \Sattaz\Api\SattazClient('stz_live_your_api_key_here');
$response = $client->getMarkets('matka');
import requests

headers = {"Authorization": "Bearer stz_live_your_api_key_here"}
res = requests.get("https://sattaz.com/api/v1/markets?type=matka", headers=headers)
print(res.json())
const res = await fetch("https://sattaz.com/api/v1/markets?type=matka", {
  headers: { "Authorization": "Bearer stz_live_your_api_key_here" }
});
const data = await res.json();
console.log(data);

Sample Response

{
  "status": "success",
  "timestamp": "2026-11-13T06:40:00Z",
  "data": {
    "total": 197,
    "markets": [
      {
        "id": 4,
        "market": "KALYAN",
        "slug": "kalyan",
        "category": "matka",
        "open_time": "03:45 PM",
        "close_time": "05:45 PM",
        "days": 6,
        "active": true,
        "holiday": true
      },
      {
        "id": 9,
        "market": "SRIDEVI",
        "slug": "sridevi",
        "category": "matka",
        "open_time": "11:35 AM",
        "close_time": "12:35 PM",
        "days": 7,
        "active": true,
        "holiday": false
      },
      {
        "id": 4,
        "market": "GALI",
        "slug": "gali",
        "category": "satta",
        "open_time": null,
        "close_time": "11:15 PM",
        "days": 7,
        "active": true,
        "holiday": false
      }
    ]
  }
}

Live Results (High Throughput) < 10ms

GET/api/v1/results/live

Ultra-low latency endpoint returning all current live results for today. Cached in-memory (< 10ms). Requires results or both plan scope.

curl -X GET "https://sattaz.com/api/v1/results/live" \
  -H "Authorization: Bearer stz_live_your_api_key_here"
$client = new \Sattaz\Api\SattazClient('stz_live_your_api_key_here');
$live = $client->getLiveResults();
import requests

headers = {"Authorization": "Bearer stz_live_your_api_key_here"}
res = requests.get("https://sattaz.com/api/v1/results/live", headers=headers)
print(res.json())
const res = await fetch("https://sattaz.com/api/v1/results/live", {
  headers: { "Authorization": "Bearer stz_live_your_api_key_here" }
});
const data = await res.json();
console.log(data);

Response Attributes

FieldTypeDescription
marketstringMarket display name (e.g. KALYAN).
slugstringNormalized slug identifier.
categorystringmatka, satta, or kolkataff.
statusstringLifecycle Status:holiday (no draw today), pending (awaiting open draw), open (open panna declared, close pending), closed (full result declared), or declared (Satta King declared).
resultstringConsolidated result string (e.g. 390-24-257, 288-8, or ***-**-*** when pending or on holiday).
open_pannastring | null3-digit open panna (null if pending or holiday).
jodistring | null2-digit jodi (or 1-digit open ank if status is open; null if pending or holiday).
close_pannastring | null3-digit close panna (null if pending, open, or holiday).
declared_atstring | nullTimestamp when result was updated/verified. Null if pending or holiday.
datestring (YYYY-MM-DD)Game session calendar date.

Sample Response

{
  "status": "success",
  "timestamp": "2026-11-13T06:45:00Z",
  "data": [
    {
      "market": "KALYAN",
      "slug": "kalyan",
      "category": "matka",
      "open_panna": null,
      "jodi": null,
      "close_panna": null,
      "result": "***-**-***",
      "status": "holiday",
      "declared_at": null,
      "open_time": "03:45 PM",
      "close_time": "05:45 PM",
      "date": "2026-11-13"
    },
    {
      "market": "SRIDEVI",
      "slug": "sridevi",
      "category": "matka",
      "open_panna": "288",
      "jodi": "8",
      "close_panna": null,
      "result": "288-8",
      "status": "open",
      "declared_at": "2026-11-13 11:56:21",
      "open_time": "11:35 AM",
      "close_time": "12:35 PM",
      "date": "2026-11-13"
    },
    {
      "market": "LUCKY MORNING",
      "slug": "lucky-morning",
      "category": "matka",
      "open_panna": "578",
      "jodi": "05",
      "close_panna": "113",
      "result": "578-05-113",
      "status": "closed",
      "declared_at": "2026-11-13 08:31:01",
      "open_time": "07:30 AM",
      "close_time": "08:30 AM",
      "date": "2026-11-13"
    },
    {
      "market": "CHANDI",
      "slug": "chandi",
      "category": "matka",
      "open_panna": null,
      "jodi": null,
      "close_panna": null,
      "result": "***-**-***",
      "status": "pending",
      "declared_at": null,
      "open_time": "05:00 PM",
      "close_time": "06:00 PM",
      "date": "2026-11-13"
    },
    {
      "market": "GALI",
      "slug": "gali",
      "category": "satta",
      "result": "46",
      "time": "23:15:00",
      "status": "declared",
      "date": "2026-11-13"
    }
  ]
}

Category Results by Date (All Markets)

GET/api/v1/results/{category}

Retrieve all market results for an entire category (Matka, Satta King, or Kolkata FF). By default, returns today's results for all markets in that category. Provide the optional ?date=YYYY-MM-DD parameter to fetch declared results for any specific calendar date.

Path Options

PathCategoryCoverageDescription
/api/v1/results/matkamatka194+ MarketsAll regular Matka markets (Kalyan, Milan, Rajdhani, Time Bazar, Main Bazar, etc.) with open panna, jodi, and close panna.
/api/v1/results/sattasatta4+ MarketsAll Satta King markets (Desawar, Gali, Faridabad, Ghaziabad, etc.) with 2-digit declared numbers.
/api/v1/results/kolkataffkolkataff8 BazisKolkata FF daily rounds 1 through 8.

Query Parameters

ParameterTypeRequiredDescription
datestring (YYYY-MM-DD)OptionalQuery a specific historical date (e.g. 2026-10-06). When omitted, defaults to today's live results across all markets.
# 1. Today's results for all 194+ Matka markets
curl -X GET "https://sattaz.com/api/v1/results/matka" \
  -H "Authorization: Bearer stz_live_your_api_key_here"

# 2. Specific date results for all Matka markets
curl -X GET "https://sattaz.com/api/v1/results/matka?date=2026-10-06" \
  -H "Authorization: Bearer stz_live_your_api_key_here"

# 3. Specific date results for all Satta King markets
curl -X GET "https://sattaz.com/api/v1/results/satta?date=2026-10-06" \
  -H "Authorization: Bearer stz_live_your_api_key_here"

# 4. Kolkata FF results for a specific date
curl -X GET "https://sattaz.com/api/v1/results/kolkataff?date=2026-10-06" \
  -H "Authorization: Bearer stz_live_your_api_key_here"
$client = new \Sattaz\Api\SattazClient('stz_live_your_api_key_here');

// 1. Get today's declared results for all 194+ Matka markets
$todayMatka = $client->getMatkaResults();

// 2. Query historical date across all Matka markets
$dateMatka = $client->getMatkaResults('2026-10-06');

// 3. Query Satta King results for a specific date
$dateSatta = $client->getSattaResults('2026-10-06');

// 4. Query Kolkata FF results for a specific date
$kolkataff = $client->getKolkataFfResults('2026-10-06');
import requests

headers = {"Authorization": "Bearer stz_live_your_api_key_here"}

# Query all Matka markets for a specific date
response = requests.get(
    "https://sattaz.com/api/v1/results/matka",
    params={"date": "2026-10-06"},
    headers=headers
)
data = response.json()
print(f"Total markets: {data['data']['count']}")
for market in data['data']['results']:
    print(f"{market['market_name']}: {market['raw_display']}")
const res = await fetch("https://sattaz.com/api/v1/results/matka?date=2026-10-06", {
  headers: { "Authorization": "Bearer stz_live_your_api_key_here" }
});
const { data } = await res.json();
console.log(`Fetched ${data.count} markets for ${data.date}:`, data.results);

Sample Response

{
  "status": "success",
  "timestamp": "2026-11-13T06:45:00Z",
  "data": {
    "category": "matka",
    "date": "2026-11-13",
    "count": 194,
    "results": [
      {
        "market": "KALYAN",
        "slug": "kalyan",
        "category": "matka",
        "open_panna": null,
        "jodi": null,
        "close_panna": null,
        "result": "***-**-***",
        "status": "holiday",
        "declared_at": null,
        "open_time": "03:45 PM",
        "close_time": "05:45 PM",
        "date": "2026-11-13"
      },
      {
        "market": "SRIDEVI",
        "slug": "sridevi",
        "category": "matka",
        "open_panna": "288",
        "jodi": "8",
        "close_panna": null,
        "result": "288-8",
        "status": "open",
        "declared_at": "2026-11-13 11:56:21",
        "open_time": "11:35 AM",
        "close_time": "12:35 PM",
        "date": "2026-11-13"
      },
      {
        "market": "LUCKY MORNING",
        "slug": "lucky-morning",
        "category": "matka",
        "open_panna": "578",
        "jodi": "05",
        "close_panna": "113",
        "result": "578-05-113",
        "status": "closed",
        "declared_at": "2026-11-13 08:31:01",
        "open_time": "07:30 AM",
        "close_time": "08:30 AM",
        "date": "2026-11-13"
      }
    ]
  }
}

Market Result & Historical Query

GET/api/v1/results/{market_slug}

Get the latest result or historical results for any specific market by slug. Supports exact date filtering or date ranges.

Path Parameters

ParameterTypeRequiredDescription
market_slugstringRequiredSlug of the market (e.g., kalyan, disawer, kolkata-ff).

Query Parameters

ParameterTypeRequiredDescription
datestring (YYYY-MM-DD)OptionalQuery specific historical date (e.g., 2026-09-15).
fromstring (YYYY-MM-DD)OptionalStart of date range.
tostring (YYYY-MM-DD)OptionalEnd of date range.
limitintegerOptionalMax records to return (Default: 30, Max: 365).
curl -X GET "https://sattaz.com/api/v1/results/kalyan?date=2026-10-01" \
  -H "Authorization: Bearer stz_live_your_api_key_here"
$client = new \Sattaz\Api\SattazClient('stz_live_your_api_key_here');
$res = $client->getMarketResult('kalyan', '2026-10-01');
import requests

res = requests.get(
    "https://sattaz.com/api/v1/results/kalyan?date=2026-10-01",
    headers={"Authorization": "Bearer stz_live_your_api_key_here"}
)
print(res.json())

Sample Response

{
  "status": "success",
  "timestamp": "2026-11-13T06:45:00Z",
  "data": {
    "slug": "kalyan",
    "latest": {
      "market": "KALYAN",
      "slug": "kalyan",
      "category": "matka",
      "open_panna": null,
      "jodi": null,
      "close_panna": null,
      "result": "***-**-***",
      "status": "holiday",
      "declared_at": null,
      "open_time": "03:45 PM",
      "close_time": "05:45 PM",
      "date": "2026-11-13"
    },
    "history": [
      {
        "market": "KALYAN",
        "slug": "kalyan",
        "category": "matka",
        "date": "2026-11-12",
        "open_panna": "390",
        "jodi": "24",
        "close_panna": "257",
        "result": "390-24-257",
        "status": "closed",
        "declared_at": "2026-11-12 17:48:10"
      }
    ]
  }
}

Historical Charts Archive

GET/api/v1/charts/{market_slug}

Returns full historical chart panel/jodi records for any regular Matka or Satta King market. Requires charts or both plan scope.

Query Parameters

ParameterTypeRequiredDescription
yearintegerOptionalFilter chart entries by specific 4-digit year (e.g., 2026).
limitintegerOptionalNumber of chart entries (Default: 100, Max: 1000).
curl -X GET "https://sattaz.com/api/v1/charts/milan-day?year=2026" \
  -H "Authorization: Bearer stz_live_your_api_key_here"
$client = new \Sattaz\Api\SattazClient('stz_live_your_api_key_here');
$chart = $client->getChart('milan-day', 2026);

Sample Response

{
  "success": true,
  "data": {
    "market": {
      "slug": "milan-day",
      "name": "MILAN DAY",
      "type": "matka"
    },
    "entries": [
      {
        "result_date": "2026-10-05",
        "open_panna": "238",
        "jodi": "39",
        "close_panna": "135"
      },
      {
        "result_date": "2026-10-06",
        "open_panna": "149",
        "jodi": "44",
        "close_panna": "239"
      }
    ]
  },
  "meta": {
    "count": 2,
    "timestamp": 1760000000,
    "response_time_ms": 7.1
  }
}

Usage & Quota

GET/api/v1/usage

Inspect key status, authorized scopes, active plan details, rate limit per minute, and remaining requests.

curl -X GET "https://sattaz.com/api/v1/usage" \
  -H "Authorization: Bearer stz_live_your_api_key_here"
$client = new \Sattaz\Api\SattazClient('stz_live_your_api_key_here');
$usage = $client->getUsage();

Sample Response

{
  "success": true,
  "data": {
    "key_prefix": "stz_live_4a1...",
    "key_name": "Production Server",
    "status": "active",
    "scope": "both",
    "rate_limit_per_minute": 300,
    "remaining_this_minute": 284,
    "plan": {
      "id": 15,
      "name": "API Pro Monthly",
      "expires_at": "2026-11-06 12:00:00"
    }
  },
  "meta": {
    "timestamp": 1760000000,
    "response_time_ms": 1.9
  }
}

Status & Error Codes

All error responses return an HTTP status code accompanied by a standard JSON error envelope.

HTTP StatusError CodeMeaning / Remediation
401 UnauthorizedMISSING_AUTH_HEADER / INVALID_API_KEYBearer token was omitted, formatted incorrectly, or revoked.
403 ForbiddenINSUFFICIENT_SCOPE / SUBSCRIPTION_EXPIREDYour plan scope does not cover this endpoint or your subscription has expired.
404 Not FoundMARKET_NOT_FOUND / NO_DATAThe requested market slug or date does not exist.
429 Too Many RequestsRATE_LIMIT_EXCEEDEDPer-minute request quota reached. Back off until X-RateLimit-Reset.

Market Result Lifecycle Statuses

Every market item returned across all results endpoints (/api/v1/results/live, /api/v1/results/{category}, and /api/v1/results/{market_slug}) contains a status property:

Status ValueCoverageMeaning / Description
holidayMatka / SattaMarket Holiday: No draw scheduled or held today. open_panna, jodi, close_panna are null and result is "***-**-***".
pendingMatka / SattaPending: Scheduled for today; awaiting open draw declaration.
openMatkaOpen Declared: Open panna and open ank declared; close draw pending.
closedMatkaComplete: Both open and close panna and complete jodi declared.
declaredSattaDeclared: Winning 2-digit number declared for Satta King.
{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Limit is 300 per minute."
  },
  "meta": {
    "timestamp": 1760000000,
    "response_time_ms": 1.2
  }
}