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.

API hostname

All requests start with this base URL:

https://matkaboss.live

Example: https://matkaboss.live/api/v1/results

Authentication

Every request needs these headers:

HeaderDescription
X-API-KeyYour unique API key.
X-TimestampCurrent UTC time in RFC3339 format, for example 2026-09-18T12:30:00Z.
X-SignatureHMAC-SHA256 signature for the request.

Signature generation

  1. Combine in order: API_KEY + HTTP_METHOD + REQUEST_PATH + TIMESTAMP
  2. Hash the string with HMAC-SHA256 using your API secret.
  3. Send the hex digest as X-Signature.

Example path value: /api/v1/results (include the leading slash, no query string).

Endpoints

MethodPathDescription
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

PHP example

<?php
$apiKey = 'YOUR_API_KEY';
$apiSecret = 'YOUR_API_SECRET';
$baseUrl = 'https://matkaboss.live';
$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].

Back to API plans