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.
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.
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.
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:
| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum allowed requests per minute for your plan. |
X-RateLimit-Remaining | Remaining requests in the current window. |
X-RateLimit-Reset | Unix epoch timestamp when the current window expires. |
If you exceed your rate limit, the API responds with HTTP status 429 Too Many Requests.
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";
}
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.
| Status | Meaning | Field Values & Behavior |
|---|---|---|
holiday | Market 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. |
pending | Pending Declaration: Market is active today; waiting for open draw numbers. | open_panna: null, jodi: null, close_panna: null, result: "***-**-***", declared_at: null. |
open | Open 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. |
closed | Fully 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. |
declared | Satta King Declared: Winning 2-digit number declared for Satta King markets. | result: "46", time: "23:15:00". |
You can identify market holidays in two ways depending on your architecture:
/api/v1/results/live, /api/v1/results/{category}, /api/v1/results/{slug}):status field. If market.status === 'holiday', the market will not hold any draw for that date. /api/v1/markets):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";
}
} Returns all active markets across Regular Matka, Satta King, and Kolkata FF, including their schedule and open/close timings.
| Parameter | Type | Required | Description |
|---|---|---|---|
type | string | Optional | Filter by market type: matka, satta, or kolkataff. |
| Field | Type | Description |
|---|---|---|
id | integer | Platform unique market ID. |
market | string | Market display name (e.g. KALYAN, MILAN DAY). |
slug | string | Unique URL-friendly slug used across results & chart endpoints. |
category | string | Market category: matka, satta, or kolkataff. |
open_time | string | Normalized open timing (e.g. 03:45 PM). Null for Satta King. |
close_time | string | Normalized close timing (e.g. 05:45 PM). |
days | integer | Operating days per week (e.g. 6 or 7). |
active | boolean | Whether the market is active on the platform. |
holiday | boolean | Market 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); {
"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
}
]
}
} 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); | Field | Type | Description |
|---|---|---|
market | string | Market display name (e.g. KALYAN). |
slug | string | Normalized slug identifier. |
category | string | matka, satta, or kolkataff. |
status | string | Lifecycle Status:holiday (no draw today), pending (awaiting open draw), open (open panna declared, close pending), closed (full result declared), or declared (Satta King declared). |
result | string | Consolidated result string (e.g. 390-24-257, 288-8, or ***-**-*** when pending or on holiday). |
open_panna | string | null | 3-digit open panna (null if pending or holiday). |
jodi | string | null | 2-digit jodi (or 1-digit open ank if status is open; null if pending or holiday). |
close_panna | string | null | 3-digit close panna (null if pending, open, or holiday). |
declared_at | string | null | Timestamp when result was updated/verified. Null if pending or holiday. |
date | string (YYYY-MM-DD) | Game session calendar date. |
{
"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"
}
]
} 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 | Category | Coverage | Description |
|---|---|---|---|
/api/v1/results/matka | matka | 194+ Markets | All regular Matka markets (Kalyan, Milan, Rajdhani, Time Bazar, Main Bazar, etc.) with open panna, jodi, and close panna. |
/api/v1/results/satta | satta | 4+ Markets | All Satta King markets (Desawar, Gali, Faridabad, Ghaziabad, etc.) with 2-digit declared numbers. |
/api/v1/results/kolkataff | kolkataff | 8 Bazis | Kolkata FF daily rounds 1 through 8. |
| Parameter | Type | Required | Description |
|---|---|---|---|
date | string (YYYY-MM-DD) | Optional | Query 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); {
"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"
}
]
}
} Get the latest result or historical results for any specific market by slug. Supports exact date filtering or date ranges.
| Parameter | Type | Required | Description |
|---|---|---|---|
market_slug | string | Required | Slug of the market (e.g., kalyan, disawer, kolkata-ff). |
| Parameter | Type | Required | Description |
|---|---|---|---|
date | string (YYYY-MM-DD) | Optional | Query specific historical date (e.g., 2026-09-15). |
from | string (YYYY-MM-DD) | Optional | Start of date range. |
to | string (YYYY-MM-DD) | Optional | End of date range. |
limit | integer | Optional | Max 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()) {
"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"
}
]
}
} Returns full historical chart panel/jodi records for any regular Matka or Satta King market. Requires charts or both plan scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
year | integer | Optional | Filter chart entries by specific 4-digit year (e.g., 2026). |
limit | integer | Optional | Number 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); {
"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
}
} 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(); {
"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
}
} All error responses return an HTTP status code accompanied by a standard JSON error envelope.
| HTTP Status | Error Code | Meaning / Remediation |
|---|---|---|
401 Unauthorized | MISSING_AUTH_HEADER / INVALID_API_KEY | Bearer token was omitted, formatted incorrectly, or revoked. |
403 Forbidden | INSUFFICIENT_SCOPE / SUBSCRIPTION_EXPIRED | Your plan scope does not cover this endpoint or your subscription has expired. |
404 Not Found | MARKET_NOT_FOUND / NO_DATA | The requested market slug or date does not exist. |
429 Too Many Requests | RATE_LIMIT_EXCEEDED | Per-minute request quota reached. Back off until X-RateLimit-Reset. |
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 Value | Coverage | Meaning / Description |
|---|---|---|
holiday | Matka / Satta | Market Holiday: No draw scheduled or held today. open_panna, jodi, close_panna are null and result is "***-**-***". |
pending | Matka / Satta | Pending: Scheduled for today; awaiting open draw declaration. |
open | Matka | Open Declared: Open panna and open ank declared; close draw pending. |
closed | Matka | Complete: Both open and close panna and complete jodi declared. |
declared | Satta | Declared: 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
}
}