API Documentation

Professional REST API for real-time Satta Matka results. Auto-synced every 2 minutes from verified sources with 99.9% uptime.

Available Endpoints

Authentication

Every request must include your api_key as a query parameter. You'll receive your key after purchasing a plan.

Rate Limits

Each plan has a daily request limit. The remaining quota is returned in every response.

Get Today's Results

Fetch live results for all markets for today. Returns market status (waiting, open, closed) and calculated jodi.

<?php
$url = "https://api.matkawin.fun/api/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
    }
}
?>

const axios = require('axios');

const res = await axios.get('https://api.matkawin.fun/api/get_today.php', {
    params: { api_key: 'YOUR_KEY', market: 'KALYAN' }
});

res.data.data.forEach(m => {
    console.log(`${m.market}: ${m.result} (${m.status})`);
});

import requests

url = "https://api.matkawin.fun/api/get_today.php"
params = {"api_key": "YOUR_KEY"}

r = requests.get(url, params=params)
data = r.json()

for market in data["data"]:
    print(f"{market['market']}: {market['result']}")

curl "https://api.matkawin.fun/api/get_today.php?api_key=YOUR_KEY&market=KALYAN"

{
  "status": "success",
  "provider": "Matka Result API Pro",
  "date": "2026-05-17",
  "total_markets": 18,
  "requests_remaining": 948,
  "data": [
    {
      "market": "KALYAN",
      "date": "2026-05-17",
      "open_pana": "238",
      "close_pana": "339",
      "jodi": "35",
      "result": "238-35-339",
      "market_time": "16:00:00 - 18:00:00",
      "status": "closed"
    }
  ]
}

Get Results (Today + Yesterday)

Fetch results for today and yesterday. Useful for apps that need to show the latest available results.

Get History

Query historical results by specific date or date range. Perfect for building chart panels and analytics.

GET /api/get_history.php?api_key=KEY&date=2026-05-15

GET /api/get_history.php?api_key=KEY&from=2026-05-01&to=2026-05-15

GET /api/get_history.php?api_key=KEY&market=KALYAN&from=2026-01-01&to=2026-05-15

Get Markets

Returns a list of all active markets with their opening and closing times.

{
  "status": "success",
  "total": 18,
  "data": [
    { "name": "KALYAN", "open_time": "16:00:00", "close_time": "18:00:00" },
    { "name": "MILAN DAY", "open_time": "15:00:00", "close_time": "17:00:00" },
    { "name": "MAIN BAZAR", "open_time": "21:30:00", "close_time": "00:05:00" }
  ]
}

Error Codes

All errors return a standard JSON structure with status code and human-readable message.

{
  "status": "error",
  "code": 401,
  "message": "Invalid or inactive API Key"
}

Webhooks (Pro & Agency)

Get instant push notifications when new results are published. No polling needed — results are delivered to your server in real-time.

{
  "event": "result_update",
  "market": "KALYAN",
  "date": "2026-05-17",
  "open": "238",
  "close": "339",
  "timestamp": 1747468800
}