---
title: "Game Pulse"
canonical_url: "https://apidocs.sportradar.com/resources/widgets/docs/widgets/match/game-pulse"
markdown_url: "https://apidocs.sportradar.com/resources/widgets/docs/widgets/match/game-pulse.md"
last_updated: "2026-03-26T13:44:48Z"
---
# Game Pulse
**Game Pulse** widget displays real-time match intensity and pressure levels using AI-powered analytics that measure attacking momentum, scoring opportunities, and match flow. The widget visualizes each team's current pressure level (Very Low to Very High) with animated pulse indicators, shows combined game pressure, and features a dynamic waveform animation representing match intensity fluctuations. It provides instant insight into which team is dominating play, how pressure shifts throughout the match, and overall game excitement levels. The widget includes customizable icon sets.
Shows the default view of the Game Pulse widget with default icons.
Shows the game pulse widget with icon version 2.
Shows the game pulse widget with icon version 3.
See the [Game Pulse widget demo](https://widgets.sir.sportradar.com/widgets-demo#widget:\(name:match.gamePulse\)).
## API Reference
### Required Parameters
- **widget-name**: `match.gamePulse`
- **matchId**: The unique identifier for the match is the only required parameter. See [Getting Identifiers](https://apidocs.sportradar.com/resources/widgets/docs/tutorials/getting-identifiers.md)
**Environment Requirements**
## Technical Requirements:
- JavaScript enabled
- XMLHttpRequest support for data fetching
- CSS3 support for styling and animations
**Supported Sports**
The Game Pulse widget supports the following sports:
- Soccer
| Property | Type | Default | Description |
| ------------- | -------- | --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `matchId` | `number` | **Required** | The unique identifier for the match.
See [Getting Identifiers](https://apidocs.sportradar.com/resources/widgets/docs/tutorials/getting-identifiers.md) |
| `iconVersion` | `number` | `1` | Icon set version for pressure indicators. Options: `1`, `2`, or `3`. Each version provides different visual styling for the five pressure levels.
See **Custom Game Pulse Icon set** tab bellow for more information. |
| `iconSet` | `object` | See **Custom Game Pulse Icon set** tab bellow | Used to set custom match pulse icons. Value for each icon should contain URL pointing to the desired icon. |
## Main Configurable Features
Illustrations of main feature variants with relevant property values below.
**Default Icons**
Shows the default view of the Game Pulse widget with default icons.
**Sample Configuration:**
- matchId: `string|number`
**Icon Version 2**
Shows the game pulse widget with icon version 2.
**Sample Configuration:**
- iconVersion: `2`
**Icon Version 3**
Shows the game pulse widget with icon version 3.
**Sample Configuration:**
- iconVersion: `3`
**Custom Game Pulse Icon set**
`iconSet` option is available to override the style of Game Pulse icons.
**Configuration:**
```js
iconSet: {
veryLow: "https://example.com/icons/pulse-very-low.svg",
low: "https://example.com/icons/pulse-low.svg",
medium: "https://example.com/icons/pulse-medium.svg",
high: "https://example.com/icons/pulse-high.svg",
veryHigh: "https://example.com/icons/pulse-very-high.svg"
}
```
> **Note**
>
> All five intensity levels must be provided when using custom icon set. Icons are used in Game Pulse visualization to indicate match intensity.
See [Game Pulse widget demo](https://widgets.sir.sportradar.com/widgets-demo#widget:\(name:match.gamePulse\))
## Integration Examples
### Property Name Transformations
Properties do not always transfer from the above table directly into integration code. Properties must be transformed differently for each integration method:
#### JavaScript/Programmatic Integration
- Property names remain unchanged in camelCase
- Properties become members of the 4th parameter object in `SIR()` call
- Example: `cardVariant: "compact"`
> **Info**
>
> In javascript integration, the properties go into an object which is passed as the 4th argument of the call ti `SIR()` function. Please see [Global SIR API](https://apidocs.sportradar.com/resources/widgets/docs/tutorials/SIR.md)
#### HTML/Declarative Integration
- Convert camelCase to lowercase with dashes, e.g. cardVariant becomes card-variant
- Add `data-sr-` prefix
- Example: `cardVariant` → `data-sr-card-variant`
- Example: `filters.sport.hidden` → Complex objects must be passed as JSON strings
> **Info**
>
> In HTML integration, the properties go into the parent HTML object as object properties, prefixed with `data-sr-` as explained above.
> **Only base property support**
>
> This method supports only simple (base) properties and does not support properties that require functions.
> **Info**
>
> In all examples replace `sportradar` in the widgetloader URL path with your clientId.
>
> Example if your clientId is `client1`:
>
> - This URL: `https://widgets.sir.sportradar.com/sportradar/widgetloader`
> - becomes: `https://widgets.sir.sportradar.com/client1/widgetloader`
**Default Icons**
### JavaScript (Programmatic)
Initialize the widget programmatically using the JavaScript API. The widget renders in the specified container element.
```js
(function(a,b,c,d,e,f,g,h,i){a[e]||(i=a[e]=function(){(a[e].q=a[e].q||[]).push(arguments)},i.l=1*new Date,i.o=f,
g=b.createElement(c),h=b.getElementsByTagName(c)[0],g.async=1,g.src=d,g.setAttribute("n",e),h.parentNode.insertBefore(g,h)
)})(window,document,"script","https://widgets.sir.sportradar.com/sportradar/widgetloader","SIR", {
language: 'en'
});
SIR('addWidget', '#sr-widget', 'match.gamePulse', {
matchId: 123
});
```
```html
```
### HTML (Declarative)
Insert the following HTML code at the target widget location. Complex object properties must be passed as JSON-encoded strings.
```html
```
**Icon Version 2**
### JavaScript (Programmatic)
Initialize the widget programmatically using the JavaScript API. The widget renders in the specified container element.
```js
(function(a,b,c,d,e,f,g,h,i){a[e]||(i=a[e]=function(){(a[e].q=a[e].q||[]).push(arguments)},i.l=1*new Date,i.o=f,
g=b.createElement(c),h=b.getElementsByTagName(c)[0],g.async=1,g.src=d,g.setAttribute("n",e),h.parentNode.insertBefore(g,h)
)})(window,document,"script","https://widgets.sir.sportradar.com/sportradar/widgetloader","SIR", {
language: 'en'
});
SIR('addWidget', '#sr-widget', 'match.gamePulse', {
iconVersion: 2
});
```
```html
```
### HTML (Declarative)
Insert the following HTML code at the target widget location. Complex object properties must be passed as JSON-encoded strings.
```html
```
**Icon Version 3**
### JavaScript (Programmatic)
Initialize the widget programmatically using the JavaScript API. The widget renders in the specified container element.
```js
(function(a,b,c,d,e,f,g,h,i){a[e]||(i=a[e]=function(){(a[e].q=a[e].q||[]).push(arguments)},i.l=1*new Date,i.o=f,
g=b.createElement(c),h=b.getElementsByTagName(c)[0],g.async=1,g.src=d,g.setAttribute("n",e),h.parentNode.insertBefore(g,h)
)})(window,document,"script","https://widgets.sir.sportradar.com/sportradar/widgetloader","SIR", {
language: 'en'
});
SIR('addWidget', '#sr-widget', 'match.gamePulse', {
iconVersion: 3
});
```
```html
```
### HTML (Declarative)
Insert the following HTML code at the target widget location. Complex object properties must be passed as JSON-encoded strings.
```html
```
**Custom Icons**
### JavaScript (Programmatic)
Initialize the widget programmatically using the JavaScript API. The widget renders in the specified container element.
```js
(function(a,b,c,d,e,f,g,h,i){a[e]||(i=a[e]=function(){(a[e].q=a[e].q||[]).push(arguments)},i.l=1*new Date,i.o=f,
g=b.createElement(c),h=b.getElementsByTagName(c)[0],g.async=1,g.src=d,g.setAttribute("n",e),h.parentNode.insertBefore(g,h)
)})(window,document,"script","https://widgets.sir.sportradar.com/sportradar/widgetloader","SIR", {
language: 'en'
});
SIR('addWidget', '#sr-widget', 'match.gamePulse', {
iconSet: {veryLow: 'https://example.com/icons/pulse-very-low.svg', low: 'https://example.com/icons/pulse-low.svg', medium: 'https://example.com/icons/pulse-medium.svg', high: 'https://example.com/icons/pulse-high.svg', veryHigh: 'https://example.com/icons/pulse-very-high.svg'}
});
```
```html
```