Matka Result API Documentation
A beginner-friendly guide to using the MatkaBoss Result API.
Introduction
Welcome to the MatkaBoss Result API. This guide explains how to make secure requests to fetch live and historical matka results.
- Add the required authentication headers to every request.
- Call the documented endpoints below.
- Parse the JSON response returned by the API.
API hostname
All requests start with this base URL:
https://matkaboss.world
Example: https://matkaboss.world/api/v1/results
Authentication
Every request needs these headers:
| Header | Description |
|---|---|
X-API-Key | Your unique API key. |
X-Timestamp | Current UTC time in RFC3339 format, for example 2026-09-18T12:30:00Z. |
X-Signature | HMAC-SHA256 signature for the request. |
Signature generation
- Combine in order:
API_KEY + HTTP_METHOD + REQUEST_PATH + TIMESTAMP - Hash the string with HMAC-SHA256 using your API secret.
- Send the hex digest as
X-Signature.
Example path value: /api/v1/results (include the leading slash, no query string).
Endpoints
| Method | Path | Description |
|---|---|---|
GET |
/api/v1/markets |
List enabled markets available on your plan. |
GET |
/api/v1/results |
Latest results for all markets on your plan. |
GET |
/api/v1/results/{slug} |
Latest result for one market slug (example: kalyan). |
GET |
/api/v1/results/{slug}/history |
Recent history for one market. Optional query: limit=30 (max 100). |
GET |
/api/v1/live |
Live polling payload (same data used by the website live cards). |
Error handling
400— invalid request.401— missing or invalid API key/signature.404— market not found or not included in your plan.500— server error, retry later.
PHP example
<?php
$apiKey = 'YOUR_API_KEY';
$apiSecret = 'YOUR_API_SECRET';
$baseUrl = 'https://matkaboss.world';
$path = '/api/v1/results';
$method = 'GET';
$timestamp = gmdate('Y-m-d\TH:i:s\Z');
$message = $apiKey.$method.$path.$timestamp;
$signature = hash_hmac('sha256', $message, $apiSecret);
$headers = [
'X-API-Key: '.$apiKey,
'X-Timestamp: '.$timestamp,
'X-Signature: '.$signature,
];
$ch = curl_init($baseUrl.$path);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
Contact
Need help? Email [email protected].