🌐 Official Production Base Path:
https://api.star777.in/
● 99.9% UPTIME LIVE
🔐 Private API Key Required: All API endpoints require an active registered API Key. Pass ?api_key=YOUR_KEY
Client Portal Login

Matka Game REST API

Ultra fast, low-latency REST API for real-time Satta Matka results. Automatically synchronized directly from verified sources with instant Open and Close declarations.

Production Base URL

https://api.star777.in/

Available Core Endpoints

GET /get_today.php
GET /get_results.php
GET /get_history.php
GET /get_markets.php
GET /api.php?action=today

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

GET https://api.star777.in/get_today.php

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.

GET https://api.star777.in/get_results.php

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

GET https://api.star777.in/get_history.php

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.

GET https://api.star777.in/get_markets.php

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.

LIVE JSON RESPONSE:
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.

Standard Error Response Format
{
  "status": "error",
  "code": 401,
  "message": "Invalid or inactive API Key"
}
Blocked API Key Response (403 Forbidden)
{
  "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.