GetUnitSpeed

Main Menu
WoW API Lua API FrameXML Widget API Widget scripts XML schema Events CVars Macro commands Combat Log Escape sequences Hyperlinks API changes HOWTOs wowuidev

Flavors
war within  mainline  cata  wrath  vanilla
Links
Blizzard Docs  Townlong Yak  Offline /api  Wowprogramming  GitHub Search
Info
Added in 3.0.2 / 1.13.2

Returns the movement speed of the unit.

currentSpeed, runSpeed, flightSpeed, swimSpeed = GetUnitSpeed(unit)

Arguments

unit

string : UnitToken - The unit to query the speed of.

Returns

currentSpeed

number - current movement speed in yards per second (normal running: 7; an epic ground mount: 14)

runSpeed

number - the maximum speed on the ground, in yards per second (including talents such as Pursuit of Justice and ground mounts)

flightSpeed

number - the maximum speed while flying, in yards per second (the unit need to be on a flying mount to get the flying speed)

swimSpeed

number - the maximum speed while swimming, in yards per second (not tested but it should be as the flying mount)

Example

The following snippet prints your current movement speed in percent:

/script print(string.format("Current speed: %d%%", GetUnitSpeed("player") / 7 * 100))

Details

As of 4.2, runSpeed, flightSpeed, swimSpeed returns were added. It seem you can also get target unit speed (not tested on the opposite faction).
A constant exists: "BASE_MOVEMENT_SPEED" which is equal to 7 (4.2).