GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

Soccer Extended API - Momentum Endpoint

We’ve added a Momentum endpoint in the Soccer Extended API. Request the Sport Event Momentum endpoint for a minute-by-minute timeline of momentum values for each team in a given match.

Each minute of a supported match includes a value from -50 to 50, signifying the advantage of the home or away team.


Benefit

Leverage this new RESTful endpoint to learn the momentum flows between competitors or to create a timeline story of momentum flow for a match.


☑️ Sample Request:

  • Sport Event Momentum - https://api.sportradar.com/soccer-extended /trial/v4/en/sport_events/{sport_event_id}/momentum.json

🔢 Versions


🔁 Endpoints Affected

  • Sport Event Momentum

⚙️ Return Sample

<sport_event_momentum xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" generated_at="2026-01-15T18:33:35+00:00" xmlns="http://schemas.sportradar.com/sportsapi/soccer-extended/v4" xsi:schemaLocation="http://schemas.sportradar.com/sportsapi/soccer-extended/v4 https://schemas.sportradar.com/sportsapi/soccer-extended/v4/schemas/sport_event_momentum.xsd">
    <sport_event id="sr:sport_event:64321031" start_time="2026-01-15T17:30:00+00:00" start_time_confirmed="true">
        <sport_event_context>
            <sport id="sr:sport:1" name="Soccer"/>
            <category id="sr:category:31" name="Italy" country_code="ITA"/>
            <competition id="sr:competition:23" name="Serie A" gender="men"/>
            <season id="sr:season:130971" name="Serie A 25/26" start_date="2025-08-23" end_date="2026-05-25" year="25/26" competition_id="sr:competition:23"/>
            <stage order="1" type="league" phase="regular season" start_date="2025-08-23" end_date="2026-05-25" year="25/26"/>
            <round number="16"/>
            <groups>
                <group id="sr:league:94759" name="Serie A 25/26"/>
            </groups>
        </sport_event_context>
        <coverage type="sport_event">
            <sport_event_properties lineups="true" formations="true" venue="true" extended_play_by_play="true" extended_player_stats="true" extended_team_stats="true" lineups_availability="pre" ballspotting="true" commentary="true" fun_facts="true" goal_scorers="true" goal_scorers_live="true" scores="live" game_clock="true" deeper_play_by_play="true" deeper_player_stats="true" deeper_team_stats="true" basic_play_by_play="true" basic_player_stats="true" basic_team_stats="true"/>
        </coverage>
        <competitors>
            <competitor id="sr:competitor:2701" name="Hellas Verona" country="Italy" country_code="ITA" abbreviation="VER" qualifier="home" gender="male"/>
            <competitor id="sr:competitor:2685" name="Bologna FC" country="Italy" country_code="ITA" abbreviation="BFC" qualifier="away" gender="male"/>
        </competitors>
        <venue id="sr:venue:687" name="Stadio Marcantonio Bentegodi" capacity="39211" city_name="Verona" country_name="Italy" map_coordinates="45.435356, 10.968647" country_code="ITA" timezone="Europe/Rome"/>
        <channels>
            <channel name="Fox Deportes" url="https://www.foxsports.com/presspass/latest-news/weekly-schedule/" country="United States" country_code="USA"/>
            <channel name="Paramount+" url="https://worldsoccertalk.com/serie-a-tv-schedule/" country="United States" country_code="USA"/>
            <channel name="CBS Sports Network" country="United States" country_code="USA"/>
            <channel name="Fubo TV" url="https://www.livesoccertv.com/channels/fubo-tv/" country="United States" country_code="USA"/>
        </channels>
        <sport_event_conditions>
            <referees>
                <referee id="sr:referee:130916" name="Mariani, Maurizio" nationality="Italy" country_code="ITA" type="main_referee"/>
                <referee id="sr:referee:130917" name="Bindoni, Daniele" nationality="Italy" country_code="ITA" type="first_assistant_referee"/>
                <referee id="sr:referee:1006803" name="Alassio, Stefano" nationality="Italy" country_code="ITA" type="second_assistant_referee"/>
                <referee id="sr:referee:126984" name="Massa, Davide" nationality="Italy" country_code="ITA" type="fourth_official"/>
                <referee id="sr:referee:895410" name="Camplone, Giacomo" nationality="Italy" country_code="ITA" type="video_assistant_referee"/>
            </referees>
            <weather pitch_conditions="good" overall_conditions="medium"/>
            <ground neutral="false"/>
            <lineups confirmed="true"/>
        </sport_event_conditions>
    </sport_event>
    <momentums>
        <momentum match_time="1" value="21" competitor="away"/>
        <momentum match_time="2" value="24" competitor="away"/>
        <momentum match_time="3" value="20" competitor="away"/>
        <momentum match_time="4" value="-12" competitor="home"/>
        <momentum match_time="5" value="-41" competitor="home"/>
        <momentum match_time="6" value="14" competitor="away"/>
        <momentum match_time="7" value="30" competitor="away"/>
        <momentum match_time="8" value="3" competitor="away"/>
        <momentum match_time="9" value="3" competitor="away"/>
        <momentum match_time="10" value="-17" competitor="home"/>
        <momentum match_time="11" value="13" competitor="away"/>
        <momentum match_time="12" value="28" competitor="away"/>
        <momentum match_time="13" value="24" competitor="away"/>
        <momentum match_time="14" value="-50" competitor="home"/>
        <momentum match_time="15" value="-15" competitor="home"/>
        <momentum match_time="16" value="-29" competitor="home"/>
        <momentum match_time="17" value="20" competitor="away"/>
        <momentum match_time="18" value="18" competitor="away"/>
        <momentum match_time="19" value="38" competitor="away"/>
        <momentum match_time="20" value="-15" competitor="home"/>
        <momentum match_time="21" value="50" competitor="away"/>
        <momentum match_time="22" value="50" competitor="away"/>
        <momentum match_time="23" value="22" competitor="away"/>
        <momentum match_time="24" value="16" competitor="away"/>
        <momentum match_time="25" value="-1" competitor="home"/>
        <momentum match_time="26" value="27" competitor="away"/>
        <momentum match_time="27" value="-24" competitor="home"/>
        <momentum match_time="28" value="13" competitor="away"/>
        <momentum match_time="29" value="0"/>
        <momentum match_time="30" value="-8" competitor="home"/>
        <momentum match_time="31" value="13" competitor="away"/>
        <momentum match_time="32" value="41" competitor="away"/>
        <momentum match_time="33" value="-11" competitor="home"/>
        <momentum match_time="34" value="-30" competitor="home"/>
        <momentum match_time="35" value="-45" competitor="home"/>
        <momentum match_time="36" value="-39" competitor="home"/>
        <momentum match_time="37" value="10" competitor="away"/>
        <momentum match_time="38" value="4" competitor="away"/>
        <momentum match_time="39" value="49" competitor="away"/>
        <momentum match_time="40" value="-21" competitor="home"/>
        <momentum match_time="41" value="-2" competitor="home"/>
        <momentum match_time="42" value="-5" competitor="home"/>
        <momentum match_time="43" value="13" competitor="away"/>
        <momentum match_time="44" value="50" competitor="away"/>
        <momentum match_time="45" value="5" competitor="away"/>
        <momentum match_time="45" stoppage_time="1" value="24" competitor="away"/>
        <momentum match_time="45" stoppage_time="2" value="16" competitor="away"/>
    </momentums>
    <timeline/>
</sport_event_momentum>
        "competitors": [
            {
                "id": "sr:competitor:1951",
                "name": "Queretaro FC",
                "country": "Mexico",
                "country_code": "MEX",
                "abbreviation": "QUE",
                "qualifier": "home",
                "gender": "male"
            },
            {
                "id": "sr:competitor:36525",
                "name": "Club Tijuana de Caliente",
                "country": "Mexico",
                "country_code": "MEX",
                "abbreviation": "TIJ",
                "qualifier": "away",
                "gender": "male"
            }
        ],
        "venue": {
            "id": "sr:venue:2048",
            "name": "Estadio La Corregidora",
            "capacity": 34130,
            "city_name": "Santiago de Queretaro",
            "country_name": "Mexico",
            "map_coordinates": "20.577551, -100.366341",
            "country_code": "MEX",
            "timezone": "America/Mexico_City"
        },
        "channels": [
            {
                "name": "ViX+",
                "country": "United States",
                "country_code": "USA"
            }
        ],
        "sport_event_conditions": {
            "referees": [
                {
                    "id": "sr:referee:2029469",
                    "name": "Hernandez Andrade, Karen",
                    "nationality": "Mexico",
                    "country_code": "MEX",
                    "type": "main_referee"
                }
            ],
            "weather": {
                "pitch_conditions": "good",
                "overall_conditions": "medium"
            },
            "ground": {
                "neutral": false
            },
            "lineups": {
                "confirmed": true
            }
        }
    },
    "momentums": [
        {
            "match_time": 1,
            "value": -23,
            "competitor": "home"
        },
        {
            "match_time": 2,
            "value": -22,
            "competitor": "home"
        },
        {
            "match_time": 3,
            "value": 6,
            "competitor": "away"
        },
        {
            "match_time": 4,
            "value": -37,
            "competitor": "home"
        },
        {
            "match_time": 5,
            "value": 20,
            "competitor": "away"
        },
        {
            "match_time": 6,
            "value": 22,
            "competitor": "away"
        },