1 files changed, 44 insertions, 0 deletions
diff --git a/docs/emotes/top.md b/docs/emotes/top.md
new file mode 100644
index 0000000..d36a0ae
--- /dev/null
+++ b/docs/emotes/top.md
@@ -0,0 +1,44 @@
+# Emote usage leaderboard
+
+> The only supported emote provider is **7TV**
+
+
+The `!etop` command provides the ability to find out the top emotes by usage in a specified chat room.
+This is a useful tool for those who want to keep track of the popularity and frequency of use of specific emotes in the community.
+
+
+## Syntax
+
+`!etop [desc/asc] [channel name] [amount]`
+
++ `[desc/asc]` (optional) - Parameter to control sorting of emotes. 
+The default setting is **desc** *(descending)*.
++ `[channel name]` (optional) - Parameter to specify a specific channel. 
+By default, the name of the channel from which the command was sent is used.
++ `[amount]` (optional) - Parameter to set the number of emotes in the result list. 
+The default setting is 10, the maximum value is 50.
+
+## Usage
+
++ `!etop` - Shows the top 10 emotes in descending order in the current channel.
++ `!etop asc` - Shows the top 10 emotes in ascending order in the current channel.
++ `!etop forsen` - Shows the top 10 emotes in descending order in forsen's channel.
++ `!etop asc forsen 10` - Shows the top 20 emotes in ascending order in forsen's channel.
++ `!etop asc 20` - Shows the top 20 emotes in ascending order in the current channel.
+
+## Responses
+
++ `forsen's top 10 emotes (descending): forsenHoppedIn (750), FailFors (600), forsenGravity (599), ...`
++ `forsen's top 10 emotes (ascending): forsenMushroom (1), forsenDank (5), forsenPirate (60), ...`
+
+## Important notes
+
++ Emote information is stored and retrieved from an external 
+["ilotterytea/stats"](https://stats.ilotterytea.kz) service.
++ Emotes data may be temporarily unavailable if a bot has just joined a chat.
+
+## Error handling
+
++ [Not found](/wiki/errors#12)
++ [External API error](/wiki/errors#20)
++ [Something went wrong](/wiki/errors#127)