English
Cricket terms, explained for people who work with the data.
45 terms in plain English. Where the API returns the concept, the entry names the endpoint and the plan it is on.
Updated .
Cricket data
- Ball-by-ball dataAlso: delivery data, play-by-play cricket data
A record of every delivery in a match: who bowled it, who faced it, the runs scored, any extras, and any wicket with the fielders involved. Scorecards, partnerships, phase splits and matchups can all be calculated from it.
In the API:
GET /v1/matches/{id}/deliveries· Developer plan · docs- Scorecard
The summary of an innings: each batter's runs, balls faced, fours, sixes and how they were out, each bowler's overs, maidens, runs and wickets, the extras, and the fall of wickets.
In the API:
GET /v1/matches/{id}/scorecard· Starter plan · docs- Cricsheet
A free, open source of ball-by-ball cricket data at cricsheet.org. It publishes match files under the Open Data Commons Attribution License (ODC-By 1.0). OpenCricket API is built on Cricsheet and names it on every response.
- Player registry IDAlso: stable player ID
An identifier that stays the same for a player across every match, season and competition. Cricsheet's people register assigns them, which is why OpenCricket player IDs look like player_cs_ba607b88.
- Manhattan chart
A bar chart of the runs scored in each over of an innings, often with wickets marked on the bars. The name comes from its resemblance to a city skyline.
In the API:
GET /v1/matches/{id}/overs· Developer plan · docs- Worm chart
A line chart of the cumulative runs of both innings, over by over, so you can see which team was ahead at each point of a limited-overs match.
In the API:
GET /v1/matches/{id}/overs· Developer plan · docs- MatchupAlso: batter versus bowler, head-to-head
The record of one batter against one bowler across all the matches they met: balls faced, runs, dismissals and strike rate.
In the API:
GET /v1/players/{id}/matchups· Developer plan · docs- Fantasy points
Points awarded to players for their actions in a match, such as runs, boundaries, wickets, catches and economy, under a published set of rules. Fantasy cricket games rank teams by these points.
In the API:
GET /v1/matches/{id}/fantasy-points· Developer plan · docs
Match structure
- DeliveryAlso: ball
One ball bowled by a bowler to a batter. A wide or a no-ball counts as a delivery but not as one of the six legal balls in an over.
In the API:
GET /v1/matches/{id}/deliveries· Developer plan · docs- Over
A set of six legal deliveries bowled by one bowler from one end. Then another bowler bowls the next over from the other end.
In the API:
GET /v1/matches/{id}/overs· Developer plan · docs- Maiden over
An over in which the bowler concedes no runs off the bat and no wides or no-balls.
- Innings
One team's turn to bat. A limited-overs match has one innings per team; a Test or first-class match has up to two per team.
- Toss
The coin toss before a match. The winning captain chooses whether to bat or field first.
- Powerplay
A block of overs with fielding restrictions, so fewer fielders may stand outside the inner circle. In T20 cricket it is the first six overs of an innings.
In the API:
GET /v1/matches/{id}/phases· Developer plan · docs- Middle overs
The overs between the powerplay and the death overs of a limited-overs innings, when batters usually build the innings and spin bowlers often bowl.
In the API:
GET /v1/matches/{id}/phases· Developer plan · docs- Death overs
The last overs of a limited-overs innings, when batters attack for runs. In T20 cricket the term usually means the last four or five overs.
In the API:
GET /v1/matches/{id}/phases· Developer plan · docs- Partnership
The runs two batters score together before one of them is out or the innings ends. Partnerships are counted per wicket: the first-wicket partnership, the second, and so on.
In the API:
GET /v1/matches/{id}/partnerships· Developer plan · docs- Fall of wickets
The team score at the moment each wicket fell, written as runs-wickets, for example 45-2.
In the API:
GET /v1/matches/{id}/scorecard· Starter plan · docs- Super Over
A one-over-per-side tie-breaker used in limited-overs cricket when the scores are level at the end of the match.
- DLS methodAlso: Duckworth-Lewis-Stern, Duckworth-Lewis
The method used to set a revised target when rain or other interruptions shorten a limited-overs match. It allows for the overs and wickets each team still has left.
Runs, extras and dismissals
- BoundaryAlso: four, six
A shot that reaches the edge of the field. It scores four runs if the ball touches the ground first and six if it clears the boundary in the air.
In the API:
GET /v1/matches/{id}/deliveries· Developer plan · docs- Dot ball
A legal delivery from which no runs are scored. Scorers mark it with a dot.
In the API:
GET /v1/matches/{id}/deliveries· Developer plan · docs- ExtrasAlso: sundries
Runs that are not scored off the bat: wides, no-balls, byes, leg byes and penalty runs. They count for the batting team but not for any batter.
In the API:
GET /v1/matches/{id}/deliveries· Developer plan · docs- Wide
A delivery too far from the batter to hit with a normal shot. The batting team gets one run, and the ball must be bowled again.
- No-ball
An illegal delivery, most often because the bowler's front foot lands over the crease. The batting team gets one run, the ball is bowled again, and in limited-overs cricket the next ball is usually a free hit.
- Bye
Runs taken when the ball passes the batter and the wicket-keeper without touching the bat or the batter's body.
- Leg bye
Runs taken when the ball hits the batter's body, not the bat, and the batter was trying to play a shot or avoid the ball.
- DismissalAlso: mode of dismissal, how out
How a batter is out. The common modes are bowled, caught, leg before wicket (LBW), run out and stumped; rarer ones include hit wicket and obstructing the field.
In the API:
GET /v1/matches/{id}/scorecard· Starter plan · docs- LBWAlso: leg before wicket
A dismissal in which the ball hits the batter's body, usually the leg, when it would otherwise have gone on to hit the stumps.
- Duck
A batter's score of zero when they are out. A golden duck means out to the first ball faced.
Statistics
- Run rateAlso: runs per over, current run rate
The average number of runs a team scores per over: runs divided by overs faced.
In the API:
GET /v1/matches/{id}/overs· Developer plan · docs- Required run rate
The runs per over the chasing team needs, from now on, to reach its target: runs still needed divided by overs left.
- Net run rateAlso: NRR
A tie-breaker in league tables: a team's runs per over scored minus its runs per over conceded, across the tournament. A team bowled out is counted as having faced its full quota of overs.
In the API:
GET /v1/competitions/{id}/standings· Starter plan · docs- Points tableAlso: standings, league table
The league standings of a tournament: matches played, won, lost and no result, points, and net run rate.
In the API:
GET /v1/competitions/{id}/standings· Starter plan · docs- Strike rateAlso: batting strike rate, SR
For a batter, runs scored per 100 balls faced. For a bowler, the bowling strike rate is the number of balls bowled per wicket taken.
In the API:
GET /v1/competitions/{id}/leaders· Starter plan · docs- Batting average
Runs scored divided by the number of times the batter was out. Innings in which the batter was not out add runs but not dismissals.
- Bowling average
Runs conceded divided by wickets taken: the runs a bowler gives away for each wicket. Lower is better.
- Economy rateAlso: economy, Econ
Runs a bowler concedes per over. Lower is better, and it matters most in limited-overs cricket.
In the API:
GET /v1/competitions/{id}/leaders· Starter plan · docs
Formats and competitions
- Test cricket
International cricket's longest format: two innings per team, played over up to five days between full-member nations.
- ODIAlso: One Day International
An international limited-overs match of up to 50 overs per side.
- T20IAlso: Twenty20 International, T20
An international match of up to 20 overs per side. Twenty20 (T20) is the same format at any level, including franchise leagues.
- First-class cricket
Multi-day domestic and international cricket with two innings per side, such as Test matches, the County Championship and the Sheffield Shield.
- List A cricket
Limited-overs cricket of 40 to 60 overs per side with first-class status, including ODIs and domestic one-day cups.
- Franchise T20 league
A domestic Twenty20 league of privately owned teams that sign players at auctions or drafts, such as the IPL, BBL, PSL, CPL and SA20.
Query these numbers yourself
Every statistic above can be calculated from ball-by-ball data. Read the API docs, see which competitions are covered, or compare cricket APIs.