Introduction

Tricks #

This API provides endpoints that return data regarding street and flatland tricks. The data is always returned in JSON format.

/tricks/all #

Returns a list of trick names. Example:

["Crankflip", "Treyflip", "Bigspin", "etc..."]

/tricks/<name>/ #

Returns a single trick’s data.

Here’s an example from calling /tricks/crankflip.


{
	"alternate_names" : ["Flip"],
	"bv_amount" : 0,
	"custom_description" : "",
	"flip_amount" : 1,
	"overflip_amount" : 0,
	"underflip_amount" : 0,
	"ht_amount" : 0,
	"name" : "Crank flip",
	"requirements" : [],
	"spin_amount" : 0,
	"start_sif" : false,
	"url" : "crankflip",
	"variations" : [
		"doubleflip",
		"tripleflip",
		"quadflip",
		"quintflip",
		"180flip"
	]
}

bv_amount indicates the “bodyvarial” component of the trick, i.e. how much you should rotate your body around the unicycle. The value is in degrees.

custom_decription is deprecated, shouldn’t be used anymore. It used to contain complete trick descriptions for certain tricks that were not composed of unispins / crankflips. For example no-footer is such trick.

flip_amount indicates the number of revolutions cranks should be rotated in the air during a trick. Positive numbers mean regular crankflips, negative numbers mean backflips.

overflip_amount shows how many revolutions of overflips the trick contains. This is needed to separate a doubleflip and a flip-overflip from one another, as they are very different despite both including 2 full revolutions of crankflips during the trick.

underflip_amount, is same as overflip_amount, but for underflips.

ht_amount stands for “hoptwist amount”, i.e. how much you should rotate yourself with the unicycle during the trick.

name is pretty self-explanatory.

requirements contains the list of other tricks that should be mastered before this one. E.g. before going for hickflips, one should probably learn unispin 180s and crankflips.

spin_amount the amount of unispins the trick contains, i.e. how much the unicycle should be rotated in the air.

start_sif stands for “Start seat-in-front”. It’s a boolean value indicating if you should ride seat in or SIF when starting to perform the trick.

url is the name of the trick for the endpoint, i.e. the <name> in /tricks/<name>.

variations contains the list of tricks that are based on this one. For crankflip for example, variations might include 180 flips and late crankflips.


/tricks/dump #

Returns all data regarding all tricks. Format is similar as the previous endpoint, but instead of a single JSON object, it returns an array of similar objects.


Known issues #

  • The variations and requirements fields aren’t working properly and don’t contain data.
  • Missing alternate names. Many tricks are known by different names, and these should be included.