CRICKET GLOSSARY

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.

In the API: GET /v1/players/{id} · Starter plan · docs

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.

In the API: GET /v1/matches/{id} · Starter plan · docs

Toss

The coin toss before a match. The winning captain chooses whether to bat or field first.

In the API: GET /v1/venues/{id} · Developer plan · docs

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.

CenturyAlso: hundred, fifty, half-century

A score of 100 or more runs by one batter in an innings. A score of 50 to 99 is a fifty, or half-century.

In the API: GET /v1/competitions/{id}/leaders · Starter plan · docs

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.

In the API: GET /v1/live/{id} · Developer plan · docs

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.

In the API: GET /v1/players/{id} · Starter plan · docs

Bowling average

Runs conceded divided by wickets taken: the runs a bowler gives away for each wicket. Lower is better.

In the API: GET /v1/players/{id} · Starter plan · docs

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.

In the API: GET /v1/matches · Starter plan · docs

ODIAlso: One Day International

An international limited-overs match of up to 50 overs per side.

In the API: GET /v1/matches · Starter plan · docs

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.

In the API: GET /v1/matches · Starter plan · docs

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.

In the API: GET /v1/competitions · Starter plan · docs

List A cricket

Limited-overs cricket of 40 to 60 overs per side with first-class status, including ODIs and domestic one-day cups.

In the API: GET /v1/competitions · Starter plan · docs

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.

In the API: GET /v1/competitions · Starter plan · docs

Next

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.