​
Overview

The MatchPossessionLive endpoint returns real-time possession statistics for an ongoing or recently updated match. It provides two main possession metrics for both teams:
  • Accumulative Possession — Overall possession percentage throughout the match.
  • Last Five Minutes Possession — Possession percentage during the most recent 5 minutes of play.
This endpoint is useful for:
  • Live match dashboards
  • Broadcast overlays
  • Match momentum analysis
  • Real-time analytics platforms

​
Parameters

​
module
string
Always use api
​
api
string
API name. Use MatchPossessionLive
​
version
string
API version. Use V2
​
response
string
Output format (json or xml)
​
lang
string
Language of returned text (en or ar)
​
match_id
integer
Unique identifier of the match
​
since
string
Optional timestamp used for incremental synchronization.
Format: YYYY-MM-DD HH:MM:SS
​
key
string
API authentication key

​
Example Request

curl --request GET \
--url "https://korastats.pro/pro/api.php?module=api&api=MatchPossessionLive&version=V2&response=json&lang=en&match_id=25997&since=2024-03-09%2005:31:02&key=YOUR_API_KEY"

{
  "result": "Success",
  "message": "Live match possession retrieved",
  "data": {
    "_type": "MATCH",
    "matchId": 25997,
    "tournament": "string",
    "season": "string",
    "round": "integer",
    "dateTime": "YYYY-MM-DD HH:MM:SS",

    "score": {
      "home": "integer",
      "away": "integer"
    },

    "home": {
      "_type": "TEAM",
      "id": "integer",
      "name": "string"
    },

    "away": {
      "_type": "TEAM",
      "id": "integer",
      "name": "string"
    },

    "possession": {
      "Home": {
        "accumulative": "float",
        "lastFiveMinutes": "float"
      },
      "Away": {
        "accumulative": "float",
        "lastFiveMinutes": "float"
      }
    }
  }
}

​
Possession Metrics

MetricDescription
accumulativeOverall possession percentage accumulated throughout the match
lastFiveMinutesPossession percentage during the last five minutes of play
Values are returned as decimal percentages (0–1 range).

​
Example

  • 0.53 = 53% possession
  • 0.47 = 47% possession

​
Notes

  • Possession values are continuously updated as the match progresses.
  • The lastFiveMinutes metric highlights recent momentum shifts.
  • Home and away values typically sum close to 1 (100%) for each metric.
  • Useful for live analytics dashboards and broadcast data feeds.