Matka Game REST API
Production Base URL
Available Core Endpoints
Authentication
Every API request requires a valid api_key. Authentication can be provided via query parameter or HTTP request header.
| Method | Name | Value Format | Example |
|---|---|---|---|
| URL Query Param | api_key | String (alphanumeric) | ?api_key=YOUR_API_KEY |
| HTTP Header | X-API-Key | String (alphanumeric) | X-API-Key: YOUR_API_KEY |
Rate Limits & Quota
Your remaining daily requests are returned in both the JSON payload and the response header: X-RateLimit-Remaining. Daily quotas reset at 00:00:00 AM every night.
Get Today's Results
Returns today's active games with real-time status: waiting (open not yet declared), open (open panna + open ank declared), and closed (full result complete).
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Required | Your unique client API Key. |
| market | string | Optional | Filter by exact market name (e.g. KALYAN, MAIN BAZAR). |
cURL Example
curl -X GET "https://api.star777.in/get_today.php?api_key=YOUR_API_KEY"
Sample Response
{
"status": "success",
"provider": "Matka Result API Pro",
"date": "2026-09-16",
"total_markets": 22,
"requests_remaining": 948,
"data": [
{
"market": "KALYAN",
"date": "2026-09-16",
"open_pana": "238",
"close_pana": "339",
"jodi": "35",
"result": "238-35-339",
"market_time": "04:15 PM - 06:15 PM",
"status": "closed"
}
]
}
Get Results (Today + Yesterday)
Fetches verified results for today and yesterday. Useful for frontends, widgets, and mobile apps needing quick displays without querying older archives.
cURL Example
curl -X GET "https://api.star777.in/get_results.php?api_key=YOUR_API_KEY&market=MILAN DAY"
Get Historical Records
Query past game results with flexible date filters. Ideal for chart panels (Jodi Chart & Panel Chart).
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Required | Your API Key. |
| date | string (YYYY-MM-DD) | Optional | Single specific date (e.g. 2026-09-15). |
| from | string (YYYY-MM-DD) | Optional | Start date for range filter. |
| to | string (YYYY-MM-DD) | Optional | End date for range filter. |
| market | string | Optional | Filter specific market name. |
cURL Example
curl -X GET "https://api.star777.in/get_history.php?api_key=YOUR_API_KEY&from=2026-09-01&to=2026-09-16&market=KALYAN"
Get Active Markets
Lists all 22 active markets configured in the system along with their scheduled opening and closing times.
Sample Response
{
"status": true,
"count": 22,
"requests_remaining": 994,
"data": [
{ "id": 1, "name": "KARNATAKA DAY", "open_time": "10:00 AM", "close_time": "11:00 AM" },
{ "id": 2, "name": "MILAN MORNING", "open_time": "10:30 AM", "close_time": "11:30 AM" },
{ "id": 3, "name": "SRIDEVI", "open_time": "11:35 AM", "close_time": "12:35 PM" },
{ "id": 4, "name": "KALYAN", "open_time": "04:15 PM", "close_time": "06:15 PM" },
{ "id": 5, "name": "MAIN BAZAR", "open_time": "09:40 PM", "close_time": "12:05 AM" }
]
}
Interactive Live API Console
Test any endpoint directly from your browser. Responses are fetched live from the server.
Click "Send Live Request" above to test the API.
Integration Code Snippets
Plug and play integration code in your preferred language using our live domain path https://api.star777.in/.
<?php
$url = "https://api.star777.in/get_today.php?api_key=YOUR_KEY";
$response = json_decode(file_get_contents($url), true);
if ($response['status'] === 'success') {
foreach ($response['data'] as $market) {
echo $market['market'] . ": " . $market['result'] . "\n";
// Output: KALYAN: 238-05-339
}
}
?>
Webhooks (Real-Time Push)
Get instant push notifications sent directly to your server whenever a new Open or Close result is declared. No continuous polling required!
Webhook JSON Payload Format
{
"event": "close_declared",
"timestamp": "2026-09-16 18:20:00",
"data": {
"market_name": "KALYAN",
"open_panna": "125",
"open_ank": "8",
"jodi": "84",
"close_ank": "4",
"close_panna": "149",
"full_result": "125-84-149",
"status": "completed",
"open_time": "04:15 PM",
"close_time": "06:15 PM"
}
}
Webhook Receiver Script (PHP)
<?php
// receiver.php on your website
$input = file_get_contents('php://input');
$payload = json_decode($input, true);
if ($payload && isset($payload['event'])) {
$game = $payload['data'];
// Update your database or dispatch Telegram alert
file_put_contents("webhook_data.txt", date('Y-m-d H:i:s') . " - " . $game['market_name'] . ": " . $game['full_result'] . "\n", FILE_APPEND);
http_response_code(200);
echo json_encode(["status" => "received"]);
}
?>
Error Codes
All errors return a standard JSON structure with HTTP status code and human-readable message.
{
"status": "error",
"code": 401,
"message": "Invalid or inactive API Key"
}
{
"status": "error",
"code": 403,
"message": "Your API Key has been BLOCKED by Administrator. Contact support."
}
| HTTP Code | Meaning | Solution |
|---|---|---|
401 |
Missing or invalid API key | Check your api_key query parameter or header |
403 |
API key blocked by admin or expired | Your account is blocked by administrator or plan expired |
429 |
Daily request limit exceeded | Upgrade plan or wait until tomorrow (resets at 00:00:00 midnight) |
500 |
Internal server or database error | Temporary server unavailability. Retry in a few seconds. |