Baseball

Sport specific information, events, match statuses and XML configurations about baseball

Match statuses for baseball

ID
Match status
Description
Additional information

0

NOT_STARTED

Not started yet

-

401

FIRST_INNING_TOP

1st inning top

-

421

BREAK_TOP1_BOTTOM1

Break top1-bottom1

-

402

FIRST_INNING_BOTTOM

1st inning bottom

-

422

BREAK_TOP2_BOTTOM1

Break top2-bottom1

-

403

SECOND_INNING_TOP

2nd inning top

-

423

BREAK_TOP2_BOTTOM2

Break top2-bottom2

-

404

SECOND_INNING_BOTTOM

2nd inning bottom

-

424

BREAK_TOP3_BOTTOM2

Break top3-bottom2

-

405

THIRD_INNING_TOP

3rd inning top

-

425

BREAK_TOP3_BOTTOM3

Break top3-bottom3

-

406

THIRD_INNING_BOTTOM

3rd inning bottom

-

426

BREAK_TOP4_BOTTOM3

Break top4-bottom3

-

407

FOURTH_INNING_TOP

4th inning top

-

427

BREAK_TOP4_BOTTOM4

Break top4-bottom4

-

408

FOURTH_INNING_BOTTOM

4th inning bottom

-

428

BREAK_TOP5_BOTTOM4

Break top5-bottom4

-

409

FIFTH_INNING_TOP

5th inning top

-

429

BREAK_TOP5_BOTTOM5

Break top5-bottom5

-

410

FIFTH_INNING_BOTTOM

5th inning bottom

-

430

BREAK_TOP6_BOTTOM5

Break top6-bottom5

-

411

SIXTH_INNING_TOP

6th inning top

-

431

BREAK_TOP6_BOTTOM6

Break top6-bottom6

-

412

SIXTH_INNING_BOTTOM

6th inning bottom

-

432

BREAK_TOP7_BOTTOM6

Break top7-bottom6

-

413

SEVENTH_INNING_TOP

7th inning top

-

433

BREAK_TOP7_BOTTOM7

Break top7-bottom7

-

414

SEVENTH_INNING_BOTTOM

7th inning bottom

-

548

BREAK_TOPEI_BOTTOM7

Break topEI-bottom7

434

BREAK_TOP8_BOTTOM7

Break top8-bottom7

-

415

EIGHTH_INNING_TOP

8th inning top

-

435

BREAK_TOP8_BOTTOM8

Break top8-bottom8

-

416

EIGHTH_INNING_BOTTOM

8th inning bottom

-

436

BREAK_TOP9_BOTTOM8

Break top9-bottom8

-

417

NINTH_INNING_TOP

9th inning top

-

437

BREAK_TOP9_BOTTOM9

Break top9-bottom9

-

418

NINTH_INNING_BOTTOM

9th inning bottom

-

438

BREAK_TOPEI_BOTTOM9

Break topEI-bottom9

-

419

EXTRA_INNING_TOP

Extra inning top

-

439

BREAK_TOPEI_BOTTOMEI

Break topEI-bottomEI

-

420

EXTRA_INNING_BOTTOM

Extra inning bottom

-

100

ENDED

The match has ended

-

80

INTERRUPTED

The match has been interrupted

-

90

ABANDONED

The match has been abandoned

This match status is only sent if the corresponding XML configuration is enabled.

Events in baseball

Blue text = MLB Premium Data Points covered by device ID 5 (External Feed MLB) based on official MLB data feeds

(Δ) = Deltaupdate will deliver the richer information.

ID
Event
Description
Coverage
Extrainfo
Special MLB Attributes
Player1
Player2

60

Substitutions

Happens whenever there is a substitution for either team. Entries are assigned to teams

External feed (DC MLB & Failover)

-

  • pitchingsubstitution: is the substitution for a pitcher

    • pitchingsubstitution=”1” if pitcher is substituted

String: Outgoing player ID

String: Incoming player ID

1010

Betstart

Betstart indicates that betting markets can be activated. Betstart is not only a pre match event but is also used during the match.

External feed (DC MLB & Failover), iScout (BC)

-

-

-

-

1011

Betstop

Betstop indicates that all betting markets are closed due to strong possibility of a scoring situation or there being any unclear situation on the field.

External feed (DC MLB & Failover), iScout (BC)

Id of Betstop Reason as specified in LD - Betstart and Betstop

-

-

-

1013

Match status

Sent when the status of the match changes.

External feed (DC MLB & Failover), iScout (BC)

See above table for match statuses

-

-

-

1015

Free text / comment

Used for any kind of additional information during the match. Example: "Match interrupted due to flood light break down", etc..

External feed (DC MLB & Failover), iScout (BC)

-

-

-

-

1024

Match about to start

This event is sent when both captains, together with the referee, are selecting which team will start the match.

External feed (DC MLB & Failover)

-

-

-

-

1031

Ball in play

Used when the ball is in play

External feed (DC MLB & Failover), iScout (BC)

-

  • batballspeed: the speed at which the ball leaves the bat, mph

  • batballangle: the angle of the ball, relative from the ground, as the ball leaves the bat

  • batballdirection: the direction of the ball as it leaves the bat.

    • -45 = left field bounds,

    • 45 = right field bounds,

    • 0 = straight forward

  • posx & posy (Δ): position from where the ball is pitched in the strike zone.

    • Coordinate values are a % of total width/height of the rectangle. So if posx=50 and posy=50 then ball goes precisely through the zone centre

    • 0,0 = top-left corner of strike zone

    • 100,100 = bottom-right corner

    • values < 0 and > 100 = ball goes outside

  • pitchtype: how was the ball pitched. Possible values:

    • -1 = “Unknown”

    • 1 = “Fastball”

    • 2 = “Four-Seam FB”

    • 3 = “Two-Seam FB”

    • 4 = “Cutter”

    • 5 = “Striker”

    • 6 = “Splitter”

    • 7 = “Forkball”

    • 8 = “Changeup”

    • 9 = “Screwball”

    • 10 = “Slider”

    • 11 = “Curveball”

    • 12 = “Slow Curve”

    • 13 = “Knuckle Curve”

    • 14 = “Slurve”

    • 15 = “Slutter”

    • 16 = “Gyroball”

    • 17 = “Kluckleball”

    • 18 = “Eephus Pitch”

    • 19 = “Intentional Ball”

    • 20 = “Pitchout”

    • 21 = “Automatic Ball”

  • pitchspeed: how fast the ball was pitched in MPH numeric values

  • atbatnumber: At bat number at the timestamp.

  • atbatpitchnumber: Current number of the pitch within the at bat.

  • batballx & batbally: The “x” and “y” coordinates of the projected distance value. Field location coordinate system:

    • Origin (0,0): is the bottom tip of home plate

    • X-Axis: Parallel to the pitching rubber. Positive values are toward 1st base, and negative values toward 3rd base

    • Y-Axis: Perpendicular to the pitching rubber, along a straight line from the back tip of home plate, through the pitcher's mound and second base. Positive values are toward the outfield, and negative values are toward the backstop

  • batballdistance: The distance from the tip of home plate to the distance where the ball was projected to land had it continued to ground level. (in feet)

String: Batter ID

-

1035

Timeout

A team calls a timeout. Entries can be assigned to teams, but neutral timeouts are possible too.

External feed (DC MLB)

-

-

-

-

1044

Deleted event alert

Manual removal of an event.

External feed (DC MLB & Failover), iScout (BC)

Id of event that was deleted.

-

-

-

1047

Timeout over

The timeout is over

External feed (DC MLB)

-

-

-

-

1102

Match coverage

Sent when the coverage status for the match changes

External feed (DC MLB & Failover), iScout (BC)

Possible values:

  • 0 = Covered

  • 1 = Coverage abandoned

  • 2 = Match will not be covered

-

-

-

1310

Ball hit

Batter successfully advances to (at least) 1st base

External feed (DC MLB)

-

  • hits away: current total hits for away team

  • hits home: current total hits for home team

String: Batter ID

-

1458

Video review

-

External feed (DC Failover), iScout (BC)

-

-

-

-

1459

Video review over

-

External feed (DC Failover), iScout (BC)

-

-

-

-

1550

Score adjustment

Manual period score adjustment in RTS

External Feed (BC)

Number of period being adjusted

-

-

-

1714

Player match stats

Accumulated Player match statistics sent in real-time based on MLB data. Event will not be available in case of failover.

External feed (DC MLB)

Statistics format: Total stats will always be present.

  • homepitchersstatstotal=PLAYERSTATS|...

  • homebattersstatstotal=PLAYERSTATS|...

  • awaypitchersstatstotal=PLAYERSTATS|...

  • awaybattersstatstotal=PLAYERSTATS|...

  • PLAYERSTATS -> PID=NNNNNN;…

List of available attributes:

  • PID - playerId (int) is a basic value (present on all attributes)

  • Batters:

    • PA - Plate Appearances: Numerical value

    • AB - At bat: Numerical value

    • R - Runs: Numerical value

    • HR - Home Runs: Numerical value

    • H - Hits: Numerical value

    • E - Errors: Numerical value

    • 2B - Double: Numerical value

    • 3B - Triple: Numerical value

    • RBI - Runs batted in: Numerical value

    • BB - Walks: Numerical value

    • SO - Strikeouts: Numerical value

    • LOB - Left on base: Numerical value

    • SB - Stolen Bases: Numerical value

    • GO - Ground Outs: Numerical value

    • FO - Fly Outs: Numerical value

  • Pitchers:

    • P - Pitch count: Numerical value

    • IP - Innings pitched: Decimal value

    • H - Hits: Numerical value

    • R - Runs: Numerical value

    • ER - Earned runs: Numerical value

    • HR - Home runs: Numerical value

    • BB - Walks: Numerical value

    • SO - Strikeouts: Numerical value

    • 2B - Double: Numerical value

    • 3B - Triple: Numerical value

    • GO - Ground Outs: Numerical value

    • FO - Fly outs: Numerical value

    • AO - Air Outs: Numerical value

    • RBI - Runs Batted In: Numerical value

-

-

-

1715

Play start

Pitcher is about to throw a pitch

External feed (DC MLB & Failover), iScout (BC)

-

  • atbatnumber: At bat number at the timestamp.

  • atbatpitchnumber: Current number of the pitch within the at bat.

String: Batter ID

-

1716

Play over

Sent when the play is finished.

External feed (DC MLB & Failover), iScout (BC)

-

  • hits away: current total hits for away team

  • hits home: current total hits for home team

  • atbatnumber: At bat number at the timestamp.

  • atbatpitchnumber: Current number of the pitch within the at bat.

String: Batter ID

-

1717

Runners in motion

Runners are attempting to steal a base.

External feed (DC MLB & Failover), iScout (BC)

-

-

-

-

1718

Checked Runner

Pitcher tried to pick runner off, runner was safe

External feed (DC MLB & Failover), iScout (BC)

-

-

String: Runner ID (Δ)

Example text: Runner MOOKIE BETTS on 1st base is checked

-

1719

Runner advances to base x

Runner advances to base x

External feed (DC Failover), iScout (BC)

Advancement types. Possible values:

  • 1 = Regular

  • 2 = Indifference

  • 3 = Steal

  • 4 = Other

-

String: Runner ID

Example text: Runner MOOKIE BETTS advances to 1st base (Single)

-

1720

Run scored

Main score event.

External feed (DC MLB & Failover), iScout (BC)

Scored run type (Δ). Possible values:

  • -1 = “Unknown”

  • 1 = “Earned Run”

  • 2 = “Unearned Run”

  • 3 = “Steal”

  • 4 = “Home Run”

  • 5 = “Other”

  • 6 = “Single”

  • 7 = “Double”

  • 8 = “Triple”

  • 9 = “Walk”

  • 10 = “Balk”

  • 11 = “Error”

  • 12 = “Field Error”

  • 13 = “Field Out”

  • 14 = “Fielder’s Choice”

  • 15 = “Sacrifice Fly”

  • 16 = “Sacrifice Bunt”

  • 17 = “Wild Pitch”

  • 18 = “Force Out”

  • 19 = “Grounded Into DP”

  • 20 = “Hit By Pitch”

  • 21 = “Passed Ball”

  • 22 = “Stolen Base Home”

  • 23 = “Runner Out”

  • atbatnumber: At bat number at the timestamp.

  • atbatpitchnumber: Current number of the pitch within the at bat.

String: Runner ID (Δ)

Example text: MOOKIE BETTS scored run (Earned Run)

String: Batter ID

1721

Runner out

Sent when the runner is out. This event includes both base and non-base cases.

External feed (DC Failover), iScout (BC)

Runner out types. Possible values:

  • 1 = Interference

  • 2 = Out of base path

  • 3 = Hit by batted ball

  • 4 = Pick off

  • 5 = Force out

  • 6 = Double off

  • 7 = Out on appeal

  • 8 = Tag out

  • 9 = Caught stealing

  • 10 = Other

-

String: Runner ID

Example text: Runner MATT KEMP at 1st base is out (Force Out)

-

1722

Strike

Strike

External feed (DC MLB & Failover), iScout (BC)

Strike type (Δ). Possible values:

  • -1 = Unknown

  • 1 = Looking

  • 2 = Swinging

  • 3 = Foul tip

  • 4 = Foul ball

  • 5 = called

  • 6 = foul bunt

  • 7 = bunt foul tip

  • 8 = missed bunt

  • 9 = swinging pitchout

  • 10 = foul pitchout

  • 11 = swinging strike blocked

  • 12 = automatic

  • 13 = strikeout

  • 14 = strikeout double play

  • 15 = strikeout triple play

  • 16 - Automatic (Pitch Timer Violation)

  • 17 - Automatic (Defensive Shift Violation)

  • posx & posy (Δ): position from where the ball is pitched in the strike zone.

    • Coordinate values are a % of total width/height of the rectangle. So if posx=50 and posy=50 then ball goes precisely through the zone centre

    • 0,0 = top-left corner of strike zone

    • 100,100 = bottom-right corner

    • values < 0 and > 100 = ball goes outside

  • pitchtype: how was the ball pitched. Possible values:

    • -1 = “Unknown”

    • 1 = “Fastball”

    • 2 = “Four-Seam FB”

    • 3 = “Two-Seam FB”

    • 4 = “Cutter”

    • 5 = “Striker”

    • 6 = “Splitter”

    • 7 = “Forkball”

    • 8 = “Changeup”

    • 9 = “Screwball”

    • 10 = “Slider”

    • 11 = “Curveball”

    • 12 = “Slow Curve”

    • 13 = “Knuckle Curve”

    • 14 = “Slurve”

    • 15 = “Slutter”

    • 16 = “Gyroball”

    • 17 = “Kluckleball”

    • 18 = “Eephus Pitch”

    • 19 = “Intentional Ball”

    • 20 = “Pitchout”

    • 21 = “Automatic Ball”

  • pitchspeed: how fast the ball was pitched in MPH numeric values

  • atbatnumber: At bat number at the timestamp.

  • atbatpitchnumber: Current number of the pitch within the at bat.

String: Batter ID

Example text: Strike looking for MOOKIE BETTS

-

1723

Ball

Ball

External feed (DC MLB & Failover), iScout (BC)

Ball type (Δ). Possible values:

  • -1 = Unknown

  • 1 = Ball

  • 2 = Dirt ball

  • 3 = Intentional ball

  • 4 = Pitch out

  • 5 = Enforced ball

  • 6 = blocked ball

  • 7 = passed ball

  • 8 - Automatic (Pitch Timer Violation)

  • 9 - Automatic (Defensive Shift Violation)

  • posx & posy (Δ): position from where the ball is pitched in the strike zone.

    • Coordinate values are a % of total width/height of the rectangle. So if posx=50 and posy=50 then ball goes precisely through the zone centre

    • 0,0 = top-left corner of strike zone

    • 100,100 = bottom-right corner

    • values < 0 and > 100 = ball goes outside

  • pitchtype: how was the ball pitched. Possible values:

    • -1 = “Unknown”

    • 1 = “Fastball”

    • 2 = “Four-Seam FB”

    • 3 = “Two-Seam FB”

    • 4 = “Cutter”

    • 5 = “Striker”

    • 6 = “Splitter”

    • 7 = “Forkball”

    • 8 = “Changeup”

    • 9 = “Screwball”

    • 10 = “Slider”

    • 11 = “Curveball”

    • 12 = “Slow Curve”

    • 13 = “Knuckle Curve”

    • 14 = “Slurve”

    • 15 = “Slutter”

    • 16 = “Gyroball”

    • 17 = “Kluckleball”

    • 18 = “Eephus Pitch”

    • 19 = “Intentional Ball”

    • 20 = “Pitchout”

    • 21 = “Automatic Ball”

  • pitchspeed: how fast the ball was pitched in MPH numeric values

  • atbatnumber: At bat number at the timestamp.

  • atbatpitchnumber: Current number of the pitch within the at bat.

String: Pitcher ID

Example text: CLAYTON KERSHAW pitches the ball outside the zone

String: Batter ID

1724

Foul ball

Foul ball

External feed (DC MLB & Failover), iScout (BC)

-

  • posx & posy (Δ): position from where the ball is pitched in the strike zone.

    • Coordinate values are a % of total width/height of the rectangle. So if posx=50 and posy=50 then ball goes precisely through the zone centre

    • 0,0 = top-left corner of strike zone

    • 100,100 = bottom-right corner

    • values < 0 and > 100 = ball goes outside

  • pitchtype: how was the ball pitched. Possible values:

    • -1 = “Unknown”

    • 1 = “Fastball”

    • 2 = “Four-Seam FB”

    • 3 = “Two-Seam FB”

    • 4 = “Cutter”

    • 5 = “Striker”

    • 6 = “Splitter”

    • 7 = “Forkball”

    • 8 = “Changeup”

    • 9 = “Screwball”

    • 10 = “Slider”

    • 11 = “Curveball”

    • 12 = “Slow Curve”

    • 13 = “Knuckle Curve”

    • 14 = “Slurve”

    • 15 = “Slutter”

    • 16 = “Gyroball”

    • 17 = “Kluckleball”

    • 18 = “Eephus Pitch”

    • 19 = “Intentional Ball”

    • 20 = “Pitchout”

    • 21 = “Automatic Ball”

  • pitchspeed: how fast the ball was pitched in MPH numeric values

  • atbatnumber: At bat number at the timestamp.

  • atbatpitchnumber: Current number of the pitch within the at bat.

String: Batter ID

Example text: Strike foul ball for MOOKIE BETTS

-

1725

Who throws the first pitch

Information about what team throws the first pitch.

External feed (DC MLB & Failover), iScout (BC)

-

-

String: Pitcher ID

Example text: CLAYTON KERSHAW to throw the first pitch

-

1726

Batter out

Sent when the batter is out. This event includes both base and non-base cases.

External feed (DC Failover), iScout (BC)

Batter out types. Possible values:

  • 1 = Fly out

  • 2 = Interference

  • 3 = Line out

  • 4 = Out of batters box

  • 5 = Pop out

  • 6 = Sacrifice fly

  • 7 = Strike out

  • 8 = Ground out

  • 9 = Sacrifice bunt

  • 10 = Single out

  • 11 = Double out

  • 12 = Triple out

  • 13 = Fielder choice out

  • 14 = On error out

  • 15 = Out on appeal

-

String: Batter ID

Example text: Batter MOOKIE BETTS is out (Fly Out)

-

1727

Batter advances to base x

Batter advances to base x.

External feed (DC Failover), iScout (BC)

Batter advancement types. Possible values:

  • 1 = Catcher interference

  • 2 = Hit by pitch

  • 3 = On error

  • 4 = Single

  • 5 = Double

  • 6 = Triple

  • 7 = Sacrifice bunt

  • 8 = Sacrifice fly

  • 9 = Walk

  • 10 = Fielders choice

  • 11 = Other

  • 12 = Intentional walk

-

String: Batter ID

Example text: Batter MOOKIE BETTS advances to 1st base (Single)

-

1728

Balk

After engaging the rubber pitcher commits a number of illegal motions or actions.

External feed (DC Failover), iScout (BC)

-

-

-

-

1743

Team match stats

Accumulated Team match statistics sent in real-time based on MLB data. Event will not be available in case of failover.

External Feed (DC MLB)

Statistics format: Total stats will always be present. Accumulated period stats will only be present for the affected period stats.

  • hometeamstatstotal=TEAMSTATS

  • awayteamstatstotal=TEAMSTATS

  • hometeamstatsi1=TEAMSTATS

  • awayteamstatsi1=TEAMSTATS

  • hometeamstatsi9=TEAMSTATS

  • awayteamstatsi9=TEAMSTATS

  • TEAMSTATS -> PA=NNNNNN;...

List of available attributes:

  • PA - Plate Appearances: Numerical value

  • AB – At bats: Numerical value

  • R - Runs: Numerical value

  • HR - Home runs: Numerical value

  • H - Hits: Numerical value

  • 2B - Double: Numerical value

  • 3B - Triple: Numerical value

  • GO - Ground Outs: Numerical value

  • FO - Fly Outs: Numerical value

  • AO - Air Outs: Numerical value

  • TB - Total bases: Numerical value

  • SB - Stolen base: Numerical value

  • LOB - Left on base: Numerical value

  • RBI - Runs Batted In: Numerical value

  • OPB - Team on-base %: Decimal value

  • SLG - Team Slugging %: Decimal value

  • OPS - On-base Plus Slugging: Decimal value

  • BBB - Walks by batter: Numerical value

  • PBB - Walks allowed by pitcher: Numerical value

  • BSO - Strikeouts by batter: Numerical value

  • PSO - Strikeouts by pitcher: Numerical value

  • AVG - Team batting average: Decimal value

  • P - Pitch count: Numerical value

  • WHIP - Walks And Hits Per Inning Pitched: Decimal

  • value

  • ER - Earned Runs: Numerical value

  • ERA - Earned run average: Decimal value

-

-

-

1832

Baseball stats correction

Baseball Stats Correction

External feed (DC MLB & Failover), iScout (BC)

Whether the score was changed. Possible values:

  • 1 = The total score or line score has changed as a result of this correction

  • 0 = The total score or line score has not changed.

  • atbatnumber: At bat number at the timestamp.

  • firstbaseplayer: playerID if first base is loaded

  • secondbaseplayer: playerID if second base is loaded

  • thirdbaseplayer: playerID if third base is loaded

  • homerunshome: number of home runs for home team

  • homerunsaway: number of home runs for away team

  • nextbatter: playerID, player who is supposed to bat next

-

-

2112

Baseball error

Describes a baseball error made by a player while interacting with either the ball or players on the field.

External feed (DC MLB)

Type of error made (Δ). Possible values:

  • 1 = fielding

  • 2 = throwing

  • 3 = interference

  • atbatnumber: At bat number at the timestamp.

  • atbatpitchnumber: Current number of the pitch within the at bat.

Player ID who made the error (Δ)

-

2143

Current pitcher baseball

Sent when match starts and whenever pitcher changes

External feed (DC MLB & Failover)

  • atbatnumber: At bat number at the timestamp.

  • atbatpitchnumber: Current number of the pitch within the at bat.

  • positionplayerpitching:

    • positionplayerpitching=”true” if current pitcher has a different position than "pitcher"

    • positionplayerpitching=”false” if current pitcher has a "pitcher" position

String: Pitcher ID

-

2144

Current batter baseball

Sent when match starts and whenever batter changes

External feed (DC MLB & Failover)

  • atbatnumber: At bat number at the timestamp.

  • atbatpitchnumber: Current number of the pitch within the at bat.

String: Batter ID

-

2149

Player out

Signifies that a player is out. Will be updated with GUMBO data to tell if the player was a batter or runner.

External feed (DC MLB)

Player out type (Δ). Possible values:

  • -1 = “Unknown"

  • 1 = "Fly Out"

  • 2 = "Batter Interference"

  • 3 = "Fan Interference"

  • 4 = "Runner Interference"

  • 5 = "Double Play"

  • 6 = "Triple Play"

  • 7 = "Fielder's Choice Out"

  • 8 = "Out on Appeal"

  • 9 = "Out on Appeal - Left Early"

  • 10 = "Out of Base Path"

  • 11 = "Tag out"

  • 12 = "Force Out"

  • 13 = "Field Out"

  • 14 = "Caught Stealing 2B"

  • 15 = "Caught Stealing 3B"

  • 16 = "Caught Stealing Home"

  • 17 = "Grounded Into DP"

  • 18 = "Grounded Into TP"

  • 19 = "Pickoff 1B"

  • 20 = "Pickoff 2B"

  • 21 = "Pickoff 3B"

  • 22 = "Pickoff Caught Stealing 2B"

  • 23 = "Pickoff Caught Stealing 3B"

  • 24 = "Pickoff Caught Stealing Home"

  • 25 = "Other Out"

  • 26 = "Sacrifice Bunt"

  • 27 = "Sacrifice Fly"

  • 28 = "Strikeout Double Play"

  • 29 = "Strikeout"

  • 38 = "Rundown"

  • 40 = "Hit by Batted Ball"

  • 43 = "Doubled Off"

  • 44 = "Runner Fielder's Choice"

  • 45 = "Advancing"

  • 46 = "Stretching"

  • 47 = "Overrunning"

  • 48 = "Returning"

  • 49 = “Ground Out”

  • 50 = “Pop Out”

  • 51 = “Line Out”

  • atbatnumber: At bat number at the timestamp.

  • atbatpitchnumber: Current number of the pitch within the at bat.

  • fieldingplayers: List of field positions & player ID’s currently in defense. Format: "Position1:Playerx;position2:playery;...). Possible MLB field position values:

    • -1 = Unspecified

    • 1 = Pitcher

    • 2 = Catcher

    • 3 = First Base

    • 4 = Second Base

    • 5 = Third Base

    • 6 = Shortstop

    • 7 = Left Field

    • 8 = Center Field

    • 9 = Right Field

  • Extrainfobaseball (Δ). Possible values:

    • -1 = “unknown"

    • 0 = "runner"

    • 1 = "batter"

String: Batter ID or Runner ID (Δ)

-

2150

Player on base x

Signifies that a player has reached a base. Will be updated with GUMBO data to tell who the player is.

External feed (DC MLB)

Type of advancement (Δ). Possible values:

  • -1 = “Unknown”

  • 1 = “Single”

  • 2 = “Double”

  • 3 = “Triple”

  • 4 = “Walk”

  • 5 = “Balk”

  • 6 = “Intent Walk”

  • 7 = “Hit By Pitch”

  • 8 = “Stolen Base 2B”

  • 9 = “Stolen Base 3B”

  • 10 = “Grounded Into Double Play”

  • 11 = “Grounded Into Triple Play”

  • 12 = “Runner Placed”

  • 13 = “Passed Ball”

  • 14 = “Wild Pitch”

  • 15 = “Sac Bunt”

  • 16 = “Sac Fly”

  • 17 = “Sac Fly Double Play”

  • 18 = “Sac Bunt Double Play”

  • 19 = “Double Play”

  • 20 = “Catcher Interference”

  • 21 = “Fielder Interference”

  • 22 = “Fielder’s Choice”

  • 23 = “Fielder’s Out”

  • 24 = “Defensive Indifference”

  • 25 = “Field Out”

  • 26 = “Strikeout”

  • 27 = “Forceout”

  • 28 = “Other Out”

  • 29 = “Error”

  • 30 = “Field Error”

  • 31 = “Pickoff Error 1B”

  • 32 = “Pickoff Error 2B”

  • 33 = “Pickoff Error 3B”

  • 34 = “Pickoff Caught Stealing 2B”

  • 35 = “Pickoff Caught Stealing 3B”

  • 36 = “Pickoff Caught Stealing Home”

  • 37 = “Other Advance”

  • 38 = “No Advancement”

  • atbatnumber: At bat number at the timestamp.

  • atbatpitchnumber: Current number of the pitch within the at bat.

  • Extrainfobaseball (Δ): Whether it was a Batter or a Runnar. Possible values:

    • -1 = “unknown"

    • 0 = "runner"

    • 1 = "batter"

String: Batter ID or Runner ID (Δ)

-

2327

Pitch release

Signifies the moment in time the pitch is thrown (= ball leaves the hand of the pitcher).

External feed (DC MLB)

-

  • pitchspeed: how fast the ball was pitched in MPH numeric values

String: Pitcher ID

Example text: Pitcher ROWAN WICK releases the ball (93.7mph)

-

This section explains what elements / attributes one can expect for baseball matches in addition to the standard elements and attributes, and what the meaning of those elements and attributes is.

Elements in <match> element

<match betstatus="BETSTOP" connectionstatus="0" dc="1" device="5" distance="3755" extrainfo="0" feedtype="full" matchid="10111515"
matchtime="0:00:00" st1id="3652" st2id="3641" start="1463675700000" t1id="24442" t1name="BALTIMORE ORIOLES" t2id="24452"
t2name="SEATTLE MARINERS">
<status id="100" name="ENDED" start="1463686822000"/>
<score t1="2" t2="7" type="match"/>
<score t1="0" t2="1" type="inning1"/>
<score t1="1" t2="0" type="inning2"/>
<score t1="0" t2="1" type="inning5"/>
<score t1="0" t2="3" type="inning6"/>
<score t1="1" t2="0" type="inning8"/>
<score t1="0" t2="2" type="inning9"/>
<matchformat>
<format type="regularinnings" value="9"/>
</matchformat>
<tournament id="25" name="MLB"/>
<category id="16" name="USA"/>
<sport id="3" name="Baseball"/>
<events/>
</match>

XML elements and attributes definition

Element
Attributes
Description
Possible values

matchformat

format type="regularinnings"

This element always gets included in full feed, and in the delta feed.

  • 9

  • 7

score

Multiple occurrences possible, each occurrence describes the amount of points for the specified period in the match. This element always gets included in full feed, and in the delta feed for the following events:

Run scored (1720), Baseball stats correction (1832)

t1

Amount of points home team

Integer

t2

Amount of points away team

Integer

type

For what period in the match the points were scored

String. Possible values:

  • match

  • inning1

  • inning2

  • inning3

  • inning4

  • inning5

  • inning6

  • inning7

  • inning8

  • inning9

Attributes in <event> element

<!-- Example 1 -->
<match matchid="8820270" ... >
<events>
<event balls="0" baseinfo="0:1" errors="1" extrainfo="9" id="650825885" info="[T1] batter advances to 1st base (Walk)" inninghalf="B"
matchscore="1:6" mtime="0:00:00" outs="2" pcount="16" periodnumber="9" periodscore="0:0" side="home" stime="1465698829601"
strikes="0" type="1727"/>
</events>
</match>
<!-- Example 2 -->
<match matchid="8820270" ... >
<events>
<event balls="0" errorsaway="1" errorshome="0" extrainfo="0" firstbaseloaded="0" hitsaway="10" hitshome="6" id="650825141" info="
Statistics have been corrected" inninghalf="B" matchscore="1:6" mtime="0:00:00" outs="2" periodnumber="9" periodscore="0:0"
runsaway="6" runshome="1" secondbaseloaded="0" side="none" stime="1465698675532" strikes="0" thirdbaseloaded="1" type="1832
">
<inningscore away="0" home="0" inning="1"/>
<inningscore away="1" home="0" inning="2"/>
...
</event>
</events>
</match>

XML attributes definition

Element
Attributes
Description
Possible values

event

extrainfo

Attribute containing additional information about the event.

Long

matchscore

Score for current match.

String. Format: "[home]:[away]" Example: "1:0"

periodscore

Score for current period.

String. Format: "[home]:[away]" Example: "1:0"

extrainfobaseball

Attribute containing additional information about the event.

String

baseinfo

From what base the player moved, and what base the player reached. This attribute gets added for the following events: Checked runner (1718) (Δ), Run scored (1720) (Δ), Runner out (1721), Runner advancement (1719), Batter advancement(1727), Player out (2149 with extrainfobaseball=0/runner) (Δ), Player on base X (2150) (Δ).

String. Format: "[starting base]:[reached base]" Example: "1:2"

Please note that value "999" is a valid value for a starting base and means the starting base is unknown.

periodnumber

Number of current period in match.

Integer

inninghalf

balls

This attribute gets added for the following events: Checked runner (1718), Run scored (1720), Runner out (1721), Runner advancement (1719), Batter advancement(1727), Ball (1723), Baseball stats correction (1832), Player out (2149), Player on base x (2150), Baseball error (2112), Play over (1716), Play start (1715), Current pitcher (2143).

runs

This attribute gets added for the following events: Run scored (1720)

strikes

This attribute gets added for the following events: Ball (1723), Foul Ball (1724), Strike (1722), Batter out (1726), Run scored (1720), Runner out (1721), Runner advancement (1719), Batter advancement(1727), Checked runner (1718), Player out (2149), Player on base x (2150), Baseball error (2112), Play over (1716), Play start (1715), Current pitcher (2143).

outs

This attribute gets added for the following events: Baseball stats correction (1832), Ball (1723), Foul Ball (1724), Strike (1722), Batter out (1726), Run scored (1720), Runner out (1721), Runner advancement (1719), Batter advancement(1727), Checked runner (1718), Player out (2149), Player on base x (2150), Baseball error (2112), Play over (1716), Play start (1715), Current pitcher (2143).

pcount

This attribute gets added for the following events: Ball (1723), Foul Ball (1724), Strike (1722), Batter out (1726), Run scored (1720), Runner out (1721), Runner advancement (1719), Batter advancement(1727), Player out (2149), Player on base x (2150), Baseball error (2112), Play over (1716), Play start (1715), Current pitcher (2143), Baseball stats correction (1832).

totalpitchcount

Match’s total pitch count. This attribute gets added for the following events:

Ball (1723), Foul Ball (1724), Strike (1722), Batter out (1726), Run scored (1720), Player out (2149), Player on base x (2150), Baseball error (2112), Play over (1716), Play start (1715), Current pitcher (2143), Baseball stats correction (1832), Ball in play (1031).

errors

This attribute gets added for the following events: Ball (1723), Foul Ball (1724), Strike (1722), Batter out (1726), Run scored (1720), Runner out (1721), Runner advancement (1719), Batter advancement(1727), Checked runner (1718), Player out (2149), Player on base x (2150), Baseball error (2112), Play over (1716), Play start (1715), Current pitcher (2143).

runshome

Amount of runs home team. Note that this attribute only gets added to the baseball stats correction info event (1832), after the corresponding XML configuration has been enabled.

Integer

runsaway

Amount of runs awa y team. Note that this attribute only gets added to the baseball stats correction info event (1832), after the corresponding XML configuration has been enabled.

Integer

hitshome

Amount of hits home team. Note that this attribute only gets added to the Ball hit (1310), Play over (1716) and baseball stats correction info event (1832 after the corresponding XML configuration has been enabled).

Integer

hitsaway

Amount of hits away team. Note that this attribute only gets added to the Ball hit (1310), Play over (1716) and baseball stats correction info event (1832 after the corresponding XML configuration has been enabled).

Integer

errorshome

Amount of errors home team. Note that this attribute only gets added to the Play over (1716) and baseball stats correction info event (1832), after the corresponding XML configuration has been enabled.

Integer

errorsaway

Amount of errors away team. Note that this attribute only gets added to the Play over (1716) and baseball stats correction info event (1832), after the corresponding XML configuration has been enabled.

Integer

firstbaseloaded

Whether the first base is loaded or not. Note that this attribute only gets added to the Play over (1716) and baseball stats correction info event (1832 after the corresponding XML configuration has been enabled).

Byte. Possible values: 1 = Base loaded 0 = Base not loaded

secondbaseloaded

Whether the second base is loaded or not. Note that this attribute only gets added to the Play over (1716) and baseball stats correction info event (1832 after the corresponding XML configuration has been enabled).

Byte. Possible values: 1 = Base loaded 0 = Base not loaded

thirdbaseloaded

Whether the third base is loaded or not. Note that this attribute only gets added to the Play over (1716) and baseball stats correction info event (1832 after the corresponding XML configuration has been enabled).

Byte. Possible values: 1 = Base loaded 0 = Base not loaded

inningscore

This element gets included in the delta feed for the following events: Baseball stats correction event (1832)

home

Points for home team

away

Points for away team

inning

What inning the points were awarded in

Additional recommendation for MLB Live Data XML feed handling

With the tri-feed integration, there has been a change in behavior of our feeds in pursuit of the lowest latency data possible. The change is two-fold and does have implications on our recommended handling of messages.

First, we providing data as the play unfolds on the field rather than waiting until the play and base positions are finalized to send data. As outs are recorded or runs are scored during a play, this information will come through immediately when entered. For examples as a fly-ball is caught, a “player out” message will be sent even if there are still runners trying to tag up and advance on the base paths. Similarly, on a straightforward ground into double play, a “player out” message will be sent when the first runner is out while the fielding team is still trying to complete the double-play.

Second, as runner positions on the bases are finalized, we are now sending a “player on base X” message before we receive information on who the runner is or where he advanced from. Before a “play over” message is sent, we will have provided a “player on base X” event for every base that is occupied by a batter or runner upon the conclusion of the play.

Due to this change, we have added full game state information (balls, strikes, outs, pcount, errors, hitshome, hitsaway, errorshome, errorsaway, firstbaseloaded, secondbaseloaded and thirdbaseloaded attributes) to the play over event ID 1716 to eliminate or minimize any need to track intermediate states as a play unfolds.

XML configurations for baseball

This section explains what XML configurations one can expect for this sport in addition to the standard XML configurations, and what the meaning of these configurations is.

(ID: 50) Include baseball stats correction info

If this setting is enabled, the baseball stats correction event (1832) will include new attributes and child elements.

<event balls="1" errorsaway="2" errorshome="1" extrainfo="0" firstbaseloaded="0" hitsaway="1" hitshome="6" id="13119818" info="
Statistics have been corrected" inninghalf="T" matchscore="6:1" mtime="0:00:00" outs="1" periodnumber="2" periodscore="0:0"
runsaway="1" runshome="6" secondbaseloaded="0" side="none" stime="1455109903000" strikes="1" thirdbaseloaded="0" type="1832"
>
<inningscore away="1" home="6" inning="1" />
<inningscore away="0" home="0" inning="2" />
...
</event>

XML attributes definition

Element
Attributes
Description
Possible values

event

runshome

Total runs for home team.

Integer

runsaway

Total runs for away team.

Integer

hitshome

Total hits for home team.

Integer

hitsaway

Total hits for away team.

Integer

errorshome

Total errors for home team.

Integer

errorsaway

Total errors for away team.

Integer

firstbaseloaded

Whether the first base is loaded.

Byte. 1 = First base is loaded 0 = First base is not loaded

secondbaseloaded

Whether the second base is loaded.

Byte. 1 = Second base is loaded 0 = Second base is not loaded

thirdbaseloaded

Whether the third base is loaded.

Byte. 1 = Third base is loaded 0 = Third base is not loaded

inningscore

-

Child element of the <event>- element containing the inning score. Multiple occurrences possible.

inning

Inning number

Integer

home

Total runs for home team in this inning.

Integer

away

Total runs for away team in this inning.

Integer

(ID: 113) Include player IDs in baseball events

If this setting is enabled, it will add player IDs to supported baseball events.

(ID: 115) Send lineups for baseball matches

If this setting is enabled, lineups are sent for baseball matches.

XML attributes definition

Atribute
Description
Possible values

position

Where the player is playing in the field

String

order

Batting order at match start

Integer

Position definitions:

  • 1 = Pitcher

  • 2 = Catcher

  • 3 = First Base

  • 4 = Second Base

  • 5 = Third Base

  • 6 = Shortstop

  • 7 = Left Field

  • 8 = Centerfield

  • 9 = Right Field

  • 10 = Designated Hitter

  • 11 = Pinch Hitter

  • 12 = Pinch Runner

(ID: 142) Include player positions in lineup

Enabling this setting will add the attribute position to the <player> element.

<lineups matchid="17132705">
<player id="1097538" name="O'Neill, Tyler" shirtnumber="0" substitute="false" team="1" position="Left Field" order="7"/>
<player id="972985" name="DeJong, Paul" shirtnumber="12" substitute="false" team="1" position="Shortstop" order="5"/>
<player id="841983" name="Wong, Kolten" shirtnumber="16" substitute="false" team="1" position="Second Base" order="6"/>
<player id="1410115" name="Edman, Tommy" shirtnumber="19" substitute="false" team="1" position="Third Base" order="1"/>
<player id="842621" name="Fowler, Dexter" shirtnumber="25" substitute="false" team="1" position="Center Field" order="2"/>
<player id="846689" name="Wieters, Matt" shirtnumber="32" substitute="false" team="1" position="Catcher" order="8"/>
<player id="927646" name="Martinez, Jose" shirtnumber="38" substitute="false" team="1" position="Right Field" order="3"/>
<player id="1373225" name="Mikolas, Miles" shirtnumber="39" substitute="false" team="1" position="Pitcher" order="9"/>
<player id="841919" name="Goldschmidt, Paul" shirtnumber="46" substitute="false" team="1" position="First Base" order="4"/>
</lineups>

(ID: 53) Allow inning score types

The attribute type in the <score> element (subelement from <match> element) has a set list of possible values. If this setting is enabled, the attribute type can have one of the following values, in addition to the regular values matches:

  • Inning1

  • Inning2

  • .

  • .

  • Inning9

XML example
<match matchid="7440630" ... >
<score t1="14" t2="20" type="inning2"/>
<!-- Remaining message truncated -->
</match>

(ID: 55) Allow overtime score types

The attribute type in the <score> element (subelement from <match> element) has a set list of possible values. If this setting is enabled, the attribute type can have one of the following values, in addition to the regular values matches:

  • overtime

  • overtime1

  • overtime2

XML example
<match matchid="7440630" ... >
<score t1="14" t2="20" type="overtime1"/>
<!-- Remaining message truncated -->
</match>

(ID: 57) Allow penalties score type

The attribute type in the <score> element (subelement from <match> element) has a set list of possible values. If this setting is enabled it will allow the <score> element in the feed to have the "penalties" type.

XML example
<match matchid="7440630" ... >
<score t1="14" t2="20" type="penalties"/>
<!-- Remaining message truncated -->
</match>

Last updated

Was this helpful?