Appearance
Jumps
The jumps section in the markings response contains one object for every instance of a player jumping. The clock must be running during at least part of the jump for the jump to be included in this data.
NOTE
We remove jumps when the game clock is not running because we have found that the player tracking data is frequently unreliable during stoppages.
Overview
At the margins, it is difficult to separate out jumps from other instances where a player may not have either foot on the floor. In particular, very slight hops are hard to distinguish from running with both feet off the ground, skips, or other movements that we might not call jumps but involve very similar movements. We currently err on the side of excluding some of the borderline jumps rather than including too much, but that means some instances that look like jumps where the player barely gets off the floor may be missing from this data.
Sample Response
json
{
"markings": {
"jumps": [
{
"did_swing_on_rim": false,
"game_id_nba": "0022500404",
"highest_max_wrist_height_in": 99.51,
"jump_distance_in": 10.94,
"jump_duration_sec": 0.48,
"jump_end_game_clock": 468,
"jump_end_he_frame": 25102,
"jump_end_shot_clock": 20,
"jump_end_wall_clock": "2025-12-23T01:17:32.836+00:00",
"jump_id_ctg": "jump_95fb43c1130765f6dd156a6998bf891f",
"jump_start_game_clock": 469,
"jump_start_he_frame": 25073,
"jump_start_shot_clock": 20,
"jump_start_wall_clock": "2025-12-23T01:17:32.353+00:00",
"jump_type": "jump",
"lowest_max_ankle_height_in": 18.71,
"lowest_max_big_toe_height_in": 12.08,
"max_hip_height_vs_standing_hip_height_diff_in": 14.55,
"max_left_ankle_height_in": 18.71,
"max_left_big_toe_height_in": 12.08,
"max_left_wrist_height_in": 99.51,
"max_mid_hip_height_he_frame": 25088,
"max_mid_hip_height_wall_clock": "2025-12-23T01:17:32.603+00:00",
"max_neck_height_in": 80.82,
"max_right_ankle_height_in": 19.17,
"max_right_big_toe_height_in": 12.82,
"max_right_wrist_height_in": 99.04,
"period": 1,
"player_id_nba": 202691
}
]
}
}Fields
Identifiers
jump_id_ctg
Type: string
CTG-generated unique identifier for this jump event
game_id_nba
Type: string
NBA game ID
player_id_nba
Type: integer
NBA player ID of the jumping player
Jump Timing
Start
The jump start frame is placed when both feet first leave the floor.
period
Type: integer
Period when the jump occurred
jump_start_he_frame
Type: integer
Hawk-Eye frame when both feet first leave the floor
jump_start_game_clock
Type: float
Game clock at jump start
jump_start_shot_clock
Type: float
Shot clock at jump start
jump_start_wall_clock
Type: string
UTC timestamp at jump start
End
The jump end frame is the last frame when both feet are still off the floor (i.e., the frame immediately before landing).
jump_end_he_frame
Type: integer
Last Hawk-Eye frame after the jump start when both feet are still off the floor (i.e., the frame immediately before landing)
jump_end_game_clock
Type: float
Game clock at jump end
jump_end_shot_clock
Type: float
Shot clock at jump end
jump_end_wall_clock
Type: string
UTC timestamp at jump end
Peak
max_mid_hip_height_he_frame
Type: integer
Hawk-Eye frame when mid hip height was highest (jump peak)
max_mid_hip_height_wall_clock
Type: string
UTC timestamp corresponding to max_mid_hip_height_he_frame.
Jump Classification
jump_type
Type: string
hop (small jump, not much height) or jump (traditional jump)
Jump Metrics
jump_duration_sec
Type: float | Unit: seconds
Time in the air
jump_distance_in
Type: float | Unit: inches
The two-dimensional distance covered by the player's mid hip from start of the jump to the end of the jump. Imagine placing a dot on the floor where the player's mid hip is when he takes off and another when he lands, and then taking a tape measure and measuring the distance between them.
max_hip_height_vs_standing_hip_height_diff_in
Type: float | Unit: inches
How many inches the player got their hips off the ground during the jump above where we estimate they would have been if they were standing on the ground straight up. A value of 25, for example, means the player’s mid hip is 25 inches higher in the air than our estimate of their standing mid hip height. If the player's jump peaks and then goes back up (e.g. when hanging on the rim), this is measured at the point where the player's hips first begin to come down from the jump.
did_swing_on_rim
Type: boolean
true if we estimate that the player who jumped swung on the rim to a degree that it will change these jump metrics relative to if he had never touched the rim.
For example, on this jump, Jayson Tatum's swing affects the time in air and max hip height:
Height Measurements
All heights are measured in inches above the floor.
Maximum Heights
max_neck_height_in
Type: float | Unit: inches
Highest neck position during jump
max_right_wrist_height_in
Type: float | Unit: inches
Highest right wrist position
max_left_wrist_height_in
Type: float | Unit: inches
Highest left wrist position
highest_max_wrist_height_in
Type: float | Unit: inches
Whichever wrist got higher
max_right_ankle_height_in
Type: float | Unit: inches
Highest right ankle position
max_left_ankle_height_in
Type: float | Unit: inches
Highest left ankle position
lowest_max_ankle_height_in
Type: float | Unit: inches
The lower of the two max ankle heights
max_right_big_toe_height_in
Type: float | Unit: inches
Highest right big toe position
max_left_big_toe_height_in
Type: float | Unit: inches
Highest left big toe position
lowest_max_big_toe_height_in
Type: float | Unit: inches
The lower of the two max toe heights