GET/api/v1/matches/realtime/trends

Get live match momentum

Realtime data packageactivebetacoreAvailable (scoped)

Description

Returns the momentum of live matches for both teams

Positive for the home team, negative for the away team, by minute (when there is extra time, its minutes are appended to the second half)
Suggested frequency: once a minute

Access

Request: GET https://api.sports.csap.ai/api/v1/matches/realtime/trends
Auth: Header X-API-Key: <your key> (Authorization: Bearer <key> also works; ?key= is still accepted but discouraged, because the key ends up in URLs and logs)
External keys: Available (scoped)External keys can call it, but only data inside the open scope is returned.
Rate limits: 3000 per minute · 200000 per day · Set per key (rate_per_min and quota_daily returned by /api/v1/account are authoritative; the numbers above are a trial key's). Beyond them the answer is 429. In addition, heavy requests such as whole-table snapshots and statistics lists without a match id are processed 2 at a time for the whole platform; a request that cannot get a slot receives 429 with Retry-After. Responses do not carry X-RateLimit-* headers for now. See the general guide

Request parameters 0

This endpoint takes no request parameters.

Example request

curl "https://api.sports.csap.ai/api/v1/matches/realtime/trends" \
  -H "X-API-Key: YOUR_API_KEY"

Try it

Example response

Real response with an external key at 09/11/2026, 14:28 UTC: HTTP 200, 1000 rows, 397 ms (data cut to 2 rows)

{
  "code": 0,
  "data": [
    {
      "count": null,
      "data": null,
      "incidents": null,
      "match_id": null,
      "match_source": "S2",
      "minute": 1,
      "per": null,
      "position": null,
      "time": null,
      "trend": null,
      "type": null,
      "updated_at": 1793716779383,
      "value": 4
    },
    {
      "count": null,
      "data": null,
      "incidents": null,
      "match_id": null,
      "match_source": "S2",
      "minute": 2,
      "per": null,
      "position": null,
      "time": null,
      "trend": null,
      "type": null,
      "updated_at": 1793716779383,
      "value": 1
    }
  ],
  "message": "success",
  "success": true
}

Response fields 14

countnullnullableCount

datanullnullableMomentum changes by minute · example: [[16, 0, -2], [-16, 0, 1]]

incidentsnullnullableEvent list

match_idnullnullablePlatform match id (gmid)

match_sourcestringSource code of this rowExample: "S2"

gmidintegernullablePlatform match id (gmid, unique across the platform)

minuteintegerMatch minuteExample: 1

pernullnullableLength of a half

positionnullnullablePosition

timenullnullableTime / minute

trendnullnullableMomentum value

typenullnullableType

updated_atintegerLast update time (UTC, ISO 8601; incremental sync with the time parameter goes by it)Example: 1793716779383

valueintegerValueExample: 4

Errors

HTTP	message	When
401	`missing API key / unauthorized`	No X-API-Key, or the key is invalid or disabled
429	`rate limit exceeded / daily quota exceeded`	The key's per-minute rate or daily quota is exceeded
429	`server busy, retry later`	The server's concurrency slots are full (only 2 heavy requests at a time); retry after Retry-After seconds
500	`query error`	The query failed on the server; you may retry