Initial commit

51 files changed, 3861 insertions, 0 deletions

diff --git a/.circleci/circle.yml b/.circleci/circle.yml
new file mode 100644
index 0000000..cf44ba8
--- /dev/null
+++ b/.circleci/circle.yml
@@ -0,0 +1,35 @@
+version: 2
+jobs:
+  build:
+    working_directory: ~/mern-starter
+    docker:
+      - image: circleci/node:8.4.0
+    steps:
+      - checkout
+      # - run:
+      #     name: update-npm
+      #     command: 'sudo npm install -g npm@latest'
+      - restore_cache:
+          key: dependency-cache-{{ checksum "package.json" }}
+      - run:
+          name: install-npm
+          command: yarn
+      - save_cache:
+          key: dependency-cache-{{ checksum "package.json" }}
+          paths:
+            - ./node_modules
+      - run:
+          name: build-docs
+          command: |
+            pushd docs &&
+            ../node_modules/.bin/gitbook install &&
+            ../node_modules/.bin/gitbook build &&
+            popd &&
+            git checkout gh-pages &&
+            git pull origin gh-pages --rebase &&
+            cp -R docs/_book/* . &&
+            git clean -fx node_modules &&
+            git clean -fx docs &&
+            git add . &&
+            git commit -a -m "Update docs" &&
+            git push origin gh-pages
diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..af2fddd
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,4 @@
+*.png filter=lfs diff=lfs merge=lfs -text
+*.ai filter=lfs diff=lfs merge=lfs -text
+*.jpg filter=lfs diff=lfs merge=lfs -text
+*.psd filter=lfs diff=lfs merge=lfs -text
diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md
new file mode 100644
index 0000000..03e8fd4
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE.md
@@ -0,0 +1,30 @@
+<!--- Provide a general summary of the issue in the Title above -->
+
+<!--- General Guidelines: -->
+<!--- If your're referencing a specific time, please report it in UTC --> 
+<!--- If your're referencing a specific field in a response, please include a nested (abridged) copy of the JSON document --> <!--- If your're referencing a long response, please use a GIST to ensure tickets are kept brief. --> 
+<!--- If this is a question about how something works, you'll find quick support in our [Discord](https://discord.me/vaingloryapi).  Come on in and join the fun! -->
+
+## Expected Behaviour
+<!--- If you're describing a bug, tell us what should happen -->
+<!--- If you're suggesting a change/improvement, tell us how it should work -->
+
+## Current Behaviour
+<!--- If describing a bug, tell us what happens instead of the expected behavior -->
+<!--- If suggesting a change/improvement, explain the difference from current behavior -->
+
+## Possible Solution
+<!--- Not obligatory, but suggest a fix/reason for the bug, -->
+<!--- or ideas how to implement the addition or change -->
+
+## Steps to Reproduce (for bugs)
+<!--- Provide a link to a live example, or an unambiguous set of steps to -->
+<!--- reproduce this bug. Include code to reproduce, if relevant -->
+1.
+2.
+3.
+4.
+
+## Context
+<!--- How has this issue affected you? What are you trying to accomplish? -->
+<!--- Providing context helps us come up with a solution that is most useful in the real world -->
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 0000000..e7cd4e3
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,7 @@
+## Fixes
+  - #123 - Issue summary
+
+## Changes proposed
+  -
+  -
+  -
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..eba7243
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,3 @@
+.DS_Store
+node_modules
+_book
diff --git a/LANGS.md b/LANGS.md
new file mode 100644
index 0000000..017128d
--- /dev/null
+++ b/LANGS.md
@@ -0,0 +1,22 @@
+# Vainglory Developer API Guide
+
+![](/assets/cover.png)
+
+## Languages
+
+* [English](en/) - Canonical Version
+* [Español](es/) - Maintained by the team at EZL
+
+***
+
+Download a .pdf, .epub, or .mobi file from:
+
+https://www.gitbook.com/book/gamelocker/vainglory/details
+
+Contribute content, suggestions, and fixes via either:
+  * [https://www.gitbook.com/book/gamelocker/vainglory](https://www.gitbook.com/book/gamelocker/vainglory)
+  * [https://github.com/gamelocker/vainglory](https://github.com/gamelocker/vainglory)
+
+***
+
+<a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-nc-nd/4.0/88x31.png" /></a><br />This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/4.0/">Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License</a>
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/README.md
diff --git a/assets/cover.png b/assets/cover.png
new file mode 100644
index 0000000..d6c3ba8
--- /dev/null
+++ b/assets/cover.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6979509c0f540cbedfb2c2941b2572a1412c50e58e47f3416726e8b8e33d7a26
+size 17187
diff --git a/book.json b/book.json
new file mode 100644
index 0000000..35413f5
--- /dev/null
+++ b/book.json
@@ -0,0 +1,46 @@
+{
+  "title": "Vainglory API Documentation",
+  "author": "MadGlory Interactive, LLC.",
+  "description": "Vainglory API Documentation",
+  "plugins": [
+    "theme-api",
+    "scripts"
+  ],
+  "pluginsConfig": {
+    "scripts": {
+        "files": [
+            "./ga.js"
+        ]
+    },
+    "theme-api": {
+      "split": false,
+      "languages": [
+        {
+          "lang": "js",
+          "name": "JavaScript",
+          "default": true
+        },
+        {
+          "lang": "go",
+          "name": "Go"
+        },
+        {
+          "lang": "java",
+          "name": "Java"
+        },
+        {
+          "lang": "shell",
+          "name": "Shell"
+        },
+        {
+          "lang": "python",
+          "name": "Python"
+        },
+        {
+          "lang": "ruby",
+          "name": "Ruby"
+        }
+      ]
+    }
+  }
+}
diff --git a/en/SUMMARY.md b/en/SUMMARY.md
new file mode 100644
index 0000000..661b8ae
--- /dev/null
+++ b/en/SUMMARY.md
@@ -0,0 +1,17 @@
+# Summary
+
+* [Versioning](versioning.md)
+* [Datacenters](datacenters.md)
+* [Authorization](authorization.md)
+* [Titles](titles.md)
+* [Making Requests](requests.md)
+* [Receiving Responses](responses.md)
+* [Matches](matches.md)
+* [Match Data Summary](matchesJSON.md)
+* [Players](players.md)
+<!-- * [Samples](samples.md) -->
+* [Telemetry](telemetry.md)
+<!-- * [Teams \(Coming Soon\)](teams.md) -->
+<!-- * [Links \(Coming Soon\)](links.md) -->
+* [Community SDK's](sdks.md)
+* [Errors](errors.md)
diff --git a/en/assets/cover.png b/en/assets/cover.png
new file mode 100644
index 0000000..d6c3ba8
--- /dev/null
+++ b/en/assets/cover.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6979509c0f540cbedfb2c2941b2572a1412c50e58e47f3416726e8b8e33d7a26
+size 17187
diff --git a/en/authorization.md b/en/authorization.md
new file mode 100644
index 0000000..1838477
--- /dev/null
+++ b/en/authorization.md
@@ -0,0 +1,98 @@
+{% method %}
+# Authorization
+
+We require a JSON Web Token ([JWT](https://jwt.io/)) be sent along with your request via the `Authorization` header.  
+JWTs are passed as bearer tokens in the Authorization header, and look like the following:
+
+`Authorization: <Enter your API Key>`
+
+
+There's no need to create JWTs manually, they will be created for you when you register for the API - [Register Here!](https://developer.vainglorygame.com/users/sign_in)
+
+In some cases an `X-API-KEY` will give you more access to information, and in all cases it means that you are operating under a per-token rate limit.
+
+{% sample lang="shell" %}
+> To specify the Headers, use this code:
+
+```shell
+  # With shell, you can just pass the correct header with each request
+  curl "<endpoint-url>" \
+  -H "Authorization: <api-key>"
+  -H "Accept: application/vnd.api+json"
+```
+{% sample lang="java" %}
+```java
+import java.io.*;
+import java.net.*;
+
+URL url = new URL("<endpoint-url>");
+HttpURLConnection conn = (HttpURLConnection) url.openConnection();
+conn.setRequestMethod("GET");
+conn.setRequestProperty("Authorization","<api-key>");
+conn.setRequestProperty("Accept", "application/vnd.api+json");
+
+conn.getInputStream()
+```
+
+{% sample lang="python" %}
+```python
+import requests
+
+url = "<endpoint-url>"
+
+header = {
+    "Authorization": "<api-key>",
+    "Accept": "application/vnd.api+json"
+}
+
+r = requests.get(url, headers=header)
+```
+{% sample lang="ruby" %}
+```ruby
+```
+{% sample lang="js" %}
+```javascript
+```
+
+{% sample lang="go" %}
+```go
+import "net/http"
+
+client := &http.Client{}
+req, _ := http.NewRequest("GET","<endpoint-url>",nil)
+req.Header.Set("Authorization", "<api-key>")
+req.Header.Set("Accept", "application/vnd.api+json")
+res, _ := client.Do(req)
+```
+
+{% sample lang="swift" %}
+```swift
+import Foundation
+
+let urlString = endpoint-url"
+
+let url = NSURL(string: urlString)
+var downloadTask = URLRequest(url: (url as URL?)!, cachePolicy: URLRequest.CachePolicy.ReloadIgnoringCacheData, timeoutInterval: 20)
+
+downloadTask.httpMethod = "GET"
+
+downloadTask.addValue("apiKey", forHTTPHeaderField: "Authorization")
+downloadTask.addValue("application/vnd.api+json", forHTTPHeaderField: "Accept")
+
+URLSession.shared.dataTask(with: downloadTask) { (data, response, error) in
+if let response = response {
+    print(response)
+}
+
+if let data = data {
+    do {
+    let jsonData = try JSONSerialization.jsonObject(with: data, options: .allowFragments) as? NSDictionary
+    print(jsonData!.value(forKey: "data") as Any)
+    } catch {
+    print(error)
+    }
+}
+}.resume()
+```
+
+{% endmethod %}
diff --git a/en/book.json b/en/book.json
new file mode 100644
index 0000000..20b0b88
--- /dev/null
+++ b/en/book.json
@@ -0,0 +1,7 @@
+{
+  "language": "en",
+  "structure": {
+    "readme": "introduction.md",
+    "summary": "summary.md"
+  }
+}
diff --git a/en/datacenters.md b/en/datacenters.md
new file mode 100644
index 0000000..1a3b311
--- /dev/null
+++ b/en/datacenters.md
@@ -0,0 +1,7 @@
+# Datacenters
+
+We operate several Datacenters around the world.  Each datacenter holds all
+information for one or more Regions of the game.  Currently all data is located
+in `DC01`, but this may change in the future.  Users will be notified prior to the
+change and an API endpoint will be made available to provide metadata describing
+where each regions data can be found.
\ No newline at end of file
diff --git a/en/errors.md b/en/errors.md
new file mode 100644
index 0000000..a23e0dd
--- /dev/null
+++ b/en/errors.md
@@ -0,0 +1,27 @@
+# Errors
+
+The server will stop processing if a problem is encountered and return the correct
+HTTP error status code.  Errors may additionally include error objects, which are
+returned as an array keyed by `errors` in the top level of a JSON API document.
+
+An error objects have the following members:
+
+* `title`: (Required) the HTTP status code applicable to this problem, expressed as a
+  string value.
+* `description`: (Optional) a short summary of the problem
+
+The Server uses the following error codes:
+
+Error Code | Meaning
+---------- | -------
+400 | Bad Request -- Your request sucks
+401 | Unauthorized -- Your API key is wrong
+403 | Forbidden -- The object requested is hidden for administrators only
+404 | Not Found -- The specified object could not be found
+405 | Method Not Allowed -- You tried to access a object with an invalid method
+406 | Not Acceptable -- You requested a format that isn't JSON
+410 | Gone -- The object requested has been removed from our servers
+418 | I'm a teapot
+429 | Too Many Requests -- You're requesting too much data! Slow down!
+500 | Internal Server Error -- We had a problem with our server. Try again later.
+503 | Service Unavailable -- We're temporarily offline for maintenance. Please try again later.
diff --git a/en/faq.md b/en/faq.md
new file mode 100644
index 0000000..39d6bf4
--- /dev/null
+++ b/en/faq.md
@@ -0,0 +1,77 @@
+### GETTING STARTED:  
+<br>
+######Q: Where can I sign up for an API key?    
+A: On the [Vainglory API Developer Portal](https://developer.vainglorygame.com)
+
+######Q: I have my API Key. What do I do now?  
+A: To get started, take a look at the [Documentation](https://developer.vainglorygame.com/docs) where you can learn how to use the API.
+
+######Q: Where is the documentation?  
+A: Documentation is [right here.](https://developer.vainglorygame.com/docs)
+
+######Q: How far along in development is the API?  
+A: The API is currently in Alpha. Alpha software can be unstable and could cause crashes or data loss. Alpha software may not contain all of the features that are planned for the final version.
+
+######Q: I’ve never coded anything before and I have a sweet idea, how do I get started?  
+A: Head over to our public [Discord](https://discord.me/vaingloryapi) and chat with some of the developers and designers who are already building tools with the API. Many of them would be happy to help you get started on your project!
+
+######Q: When I signed up, it said I was enrolled in the Community Free Tier, what does that mean?  
+A: The Community Free Tier allows you to begin developing and testing your app/tool using live data. It comes with a default rate limit of 10 requests per minute that is adequate for testing purposes. 
+
+######Q: My dashboard says that my rate limit is 10 requests per minute. How can I request a higher rate limit?  
+A: The default rate limit of 10 requests per minute is for testing/development purposes only. Once you are ready to launch your tool, you can request a higher rate limit by emailing api@superevilmegacorp.com
+
+######Q: What can I do with the data I get from the API?  
+A: Build awesome tools for yourself, or for the community! You can derive any information you’d like from the data, but you cannot scrape or store all of the data from the API.  For a full list of what is acceptable and what is not, check out the [Terms of Service](https://developer.vainglorygame.com/terms-of-service).
+
+######Q: Will you charge for use of the API?  
+A: The API is free for non-commercial use.  For a commercial license, send an email to api@superevilmegacorp.com
+
+######Q: How do I know if I need a commercial license?  
+A: If you are doing any of the following, you will need to register for a commercial license:  running ads, charging a fee to access your tool, selling aggregated data, monetizing on the data provided in any way.
+
+######Q: What can I do with a commercial license?  
+A: With the API still in Alpha, we are not distributing commercial licenses yet.  We will have more information on this soon.  In the meantime, you can check the Terms of Service to see what are acceptable uses for the API.
+
+######Q: How do I get a commercial license?  
+A: With the API still in Alpha, we are not distributing commercial licenses yet.  If you have further questions, or want to chat about it more, send an email to api@superevilmegacorp.com
+
+######Q: If I have a question regarding the API, what do I do?  
+A: Reach out to api@superevilmegacorp.com and jump into the [Discord](https://discord.me/vaingloryapi) chat server.  
+<br>
+### Development/Troubleshooting:  
+<br>
+######Q: The documentation seems wrong. What do I do now?  
+A: With the API still in Alpha, it’s very possible the docs are not completely up-to-date. We’re updating the docs as we go! You can also contribute to the docs on [Github](https://github.com/madglory/gamelocker-vainglory) if you’d like to make some changes.
+
+######Q: I just played a match but my stats haven’t showed up yet, what’s the deal?  
+A: The API defaults to searching for matches over the last 3 hours. To find any matches before then, you must specify a Created-at time.
+
+######Q: Where can I find assets to use on my project?  
+A: We are working on a way to have assets available to you directly from Vainglory. In the meantime, the community has put together some great resources for you in [Discord](https://discord.me/vaingloryapi). You can find them in the pinned files in #vaingloryapi-chat.
+
+######Q: What endpoints do I have access to with the API?  
+A: Check out the [Docs](https://developer.vainglorygame.com/docs)  
+<br>
+### API Challenge:  
+<br>
+######Q: How do I enter the API Challenge?  
+A: The 2017 API Challenge submission period ended on March 26th. Check out the [list of submissions](https://developer.vainglorygame.com/rules#results).
+
+######Q: How will API Challange prizes be distributed for my team?  
+A: You can join the API Challenge with any team size up to four total. All prizes will be adjusted based on the number of members on your team (up to four).
+
+######Q: What features will be available for the API Challenge?  
+A: Some features available include Telemetry, Bulk Sample Data,
+
+######Q:  Where do I sign up my team, or let you know I’m part of a team?  
+A: For the API Challenge, you don’t need to tell us what team you’re on. Where teams come into play is the submission portion of the challenge - when you submit your project, that’s when you’ll be asked who your team consists of!
+
+######Q:  My team is making a mobile app.  Can we submit that?  
+A:  You sure can! When submitting a mobile app, we just need to see that it works.  You can have it run on an emulator, Testflight, etc.  If you have specific questions on this reach us at api@superevilmegacorp.com  
+<br>
+### Beyond Alpha:
+<br>
+######Q:  What are some more features we can expect with the API?  
+A:  We are constantly looking to add new features to the API.  In the future you can expect things like account linking, match reservations, and many more!  If you would like to help impact what the API will look like in the future, join the conversation on our public [Discord](https://discord.me/vaingloryapi) channel! 
+
diff --git a/en/introduction.md b/en/introduction.md
new file mode 100644
index 0000000..9399d1b
--- /dev/null
+++ b/en/introduction.md
@@ -0,0 +1,27 @@
+# Vainglory Developer API Guide
+
+![](/assets/cover.png)
+
+The Vainglory Game Data Service makes it easy for players and developers to access to in-game data.
+
+Build something great!
+
+At the moment this Service is in **Preview** mode. You can see sample data, test the interface, and provide feedback to our development team.
+
+The Server now makes every attempt to implement the [JSON-API](http://jsonapi.org/) specification. Where a deviation occurs, it is likely unintentional and can be reported to the team in our [Discord](https://discord.me/vaingloryapi).
+
+We show example language bindings using CURL and plan to add libraries for Ruby, NodeJS, Java, Python and more. Community contributions are welcome and rewarded with good karma \(and swag!\) You can view code examples in the dark area to the right, and you can switch the programming language of the examples with the tabs in the top right.
+
+***
+
+Download a .pdf, .epub, or .mobi file from:
+
+https://www.gitbook.com/book/gamelocker/vainglory/details
+
+Contribute content, suggestions, and fixes via either:
+  * [https://www.gitbook.com/book/gamelocker/vainglory](https://www.gitbook.com/book/gamelocker/vainglory)
+  * [https://github.com/gamelocker/vainglory](https://github.com/gamelocker/vainglory)
+
+***
+
+<a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-nc-nd/4.0/88x31.png" /></a><br />This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/4.0/">Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License</a>
diff --git a/en/links.md b/en/links.md
new file mode 100644
index 0000000..2e600de
--- /dev/null
+++ b/en/links.md
@@ -0,0 +1,54 @@
+# Links (Coming Soon!)
+
+## Get a Link
+
+```shell
+curl "https://api.dc01.gamelockerapp.com/shards/na/link/{id}" \
+  -H "Authorization: Bearer <api-key>" \
+  -H "Accept: application/vnd.api+json"
+```
+
+This endpoint checks to see if a link object exists for a given code.
+
+### HTTP Request
+
+`GET https://api.dc01.gamelockerapp.com/link`
+
+### Query Parameters
+
+Parameter | Default | Description
+--------- | ------- | -----------
+
+## Post a Link
+
+```shell
+curl -XPOST "https://api.dc01.gamelockerapp.com/shards/na/link/{player_id}" \
+  -H "Authorization: Bearer <api-key>" \
+  -H "Accept: application/vnd.api+json"
+```
+
+This endpoint creates a PlayerLink object if the verification code matches the one provided by the game.
+
+### HTTP Request
+
+`POST https://api.dc01.gamelockerapp.com/link/{player_id}`
+
+### Query Parameters
+
+Parameter | Default | Description
+--------- | ------- | -----------
+code      |         | The verification code
+
+## PlayerLink
+
+```json
+{
+  "attributes": {
+      "playerId": "fb374a7b-78be-4fcc-83ed-6a532a8a6f55",
+      "shardId": "na",
+      "titleId": "semc-vainglory"
+  },
+  "id": "2454e5ac-0a69-4468-ad12-8616f066e817",
+  "type": "playerLink"
+}
+```
diff --git a/en/matches.md b/en/matches.md
new file mode 100644
index 0000000..f9c43b7
--- /dev/null
+++ b/en/matches.md
@@ -0,0 +1,282 @@
+
+# Matches
+
+Matches records are created every time players complete a game session. Each Match
+contains high level information about the game session, including info like
+duration, gameMode, and more.  Each Match has two Rosters.   
+
+
+## Rosters
+
+```json
+{
+  "type": "roster",
+  "id": "eca49808-d510-11e6-bf26-cec0c932ce01",
+  "attributes": {
+    "stats": {
+      "acesEarned": 2,
+      "gold": 32344,
+      "etc..."
+    }
+  },
+  "relationships": {
+    "team": {
+      "data": {
+        "type": "team",
+        "id": "753d464c-d511-11e6-bf26-cec0c932ce01"
+      }
+    },
+    "participants": {
+      "data": [
+        {
+          "type": "participant",
+          "id": "eca49a7e-d510-11e6-bf26-cec0c932ce01"
+        },
+        "etc..."
+      ]
+    }
+  }
+}
+```
+
+Rosters track the scores of each opposing group of Participants. If players entered
+matchmaking as a team, the Roster will have a related Team.  Rosters have many Participants
+objects, one for each member of the Roster. Roster objects are only meaningful
+within the context of a Match and are not exposed as a standalone resource.
+
+## Participants
+
+```json
+{
+  "type": "participant",
+  "id": "ea77c3a7-d44e-11e6-8f77-0242ac130004",
+  "attributes": {
+    "actor": "*Hero009*",
+    "stats": {
+      "assists": 4,
+      "crystalMineCaptures": 1,
+      "deaths": 2,
+      "farm": 49.25,
+      "etc..."
+    }
+  }
+}
+```
+Participant objects track each member in a Roster.  Participants may be
+anonymous Players, registered Players, or bots. In the case where the Participant
+is a registered Player, the Participant will have a single Player relationship.
+Participant objects are only meaningful within the context of a Match and are
+not exposed as a standalone resource.
+
+{% method %}
+
+## Get a collection of Matches
+
+This endpoint retrieves data from matches. Bulk scraping matches is prohibited.
+
+
+{% sample lang="shell" %}
+```shell
+curl -g "https://api.dc01.gamelockerapp.com/shards/na/matches?sort=createdAt&page[limit]=3&filter[createdAt-start]=2017-02-27T13:25:30Z&filter[playerNames]=<playerName>" \
+  -H "Authorization: Bearer <api-key>" \
+  -H "Accept: application/vnd.api+json"
+```
+
+{% sample lang="java" %}
+```java
+//There are a variety of Java HTTP libraries that support query-parameters.
+```
+
+{% sample lang="python" %}
+```python
+import requests
+url = "https://api.dc01.gamelockerapp.com/shards/na/matches"
+header = {
+    "Authorization": "<api-key>",
+    "Accept": "application/vnd.api+json"
+}
+query = {
+    "sort": "createdAt",
+    "filter[playerNames]": "<playerName>",
+    "filter[createdAt-start]": "2017-02-28T13:25:30Z",
+    "page[limit]": "3"
+}
+r = requests.get(url, headers=header, params=query)
+```
+
+{% sample lang="ruby" %}
+```ruby
+
+```
+
+{% sample lang="js" %}
+```javascript
+
+```
+
+{% sample lang="go" %}
+```go
+q := req.URL.Query()
+q.Add("sort", "createdAt")
+q.Add("filter[playerNames]", "<playerName>")
+q.Add("filter[createdAt-start]", "2017-02-27T13:25:30Z")
+q.Add("page[limit]", "3")
+req.URL.RawQuery = q.Encode()
+res, _ := client.Do(req)
+```
+
+{% common %}
+> The above command returns JSON structured like this:
+
+```json
+{
+  "data": [
+    {
+      "type": "match",
+      "id": "02b90214-c64d-11e6-9f6b-062445d3d668",
+      "attributes": {
+        "createdAt": "2017-01-06T20:30:08Z",
+        "duration": 1482195372,
+        "gameMode": "casual",
+        "patchVersion": "1.0.0",
+        "shardId": "na",
+        "stats": "acesEarned: 3, etc..."
+      },
+      "relationships": {
+        "rosters": {
+          "data": [{
+            "type": "roster",
+            "id": "ea77c2eb-d44e-11e6-8f77-0242ac130004"
+          }, {
+            "type": "roster",
+            "id": "dc2c14b4-d50c-11e6-bf26-cec0c932ce01"
+          }]
+        }
+      }
+    }
+  ]
+}
+```
+{% endmethod %}
+
+
+### HTTP Request
+
+`GET https://api.dc01.gamelockerapp.com/shards/na/matches`
+
+### Query Parameters
+
+Parameter | Default | Description
+--------- | ------- | -----------
+page[offset] | 0 | Allows paging over results
+page[limit] | 50 | The default (and current maximum) is 50.  Values less than 50 and great than 2 are supported.
+sort | createdAt | By default, Matches are sorted by creation time ascending.
+filter[createdAt-start] | 28 days prior | Must occur before end time.  Format is iso8601  Usage: filter[createdAt-start]=2017-01-01T08:25:30Z
+filter[createdAt-end] | 28 days after or current time | Queries search the last 3 hrs. Format is iso8601 i.e. filter[createdAt-end]=2017-01-01T13:25:30Z
+filter[playerNames] | none | Filters by player name. Usage: filter[playerNames]=player1,player2,...
+filter[playerIds] | none | Filters by player Id. Usage: filter[playerIds]=playerId,playerId,...
+filter[teamNames] | none | Filters by team names. Team names are the same as the in game team tags. Usage: filter[teamNames]=TSM,team2,...
+filter[gameMode] | none | filter by gameMode Usage: filter[gameMode]=casual,ranked,...
+
+<aside class="success">
+Remember — a happy match is an authenticated match!
+</aside>
+
+{% method %}
+## Get a single Match
+This endpoint retrieves a specific match.
+
+{% sample lang="shell" %}
+```shell
+curl "https://api.dc01.gamelockerapp.com/shards/na/matches/<matchID>" \
+  -H "Authorization: Bearer <api-key>" \
+  -H "Accept: application/vnd.api+json"
+```
+
+{% sample lang="java" %}
+```java
+//There are a variety of Java HTTP libraries that support URL parameters
+```
+
+{% sample lang="python" %}
+```python
+
+```
+
+{% sample lang="ruby" %}
+```ruby
+
+```
+
+{% sample lang="js" %}
+```javascript
+
+```
+
+{% sample lang="go" %}
+```go
+
+```
+
+{% common %}
+
+> The above command returns JSON structured like this:
+
+```json
+{
+  "data": {
+    "type": "match",
+    "id": "02b90214-c64d-11e6-9f6b-062445d3d668",
+    "attributes": {
+      "createdAt": "2017-01-06T20:30:08Z",
+      "duration": 1482195372,
+      "gameMode": "casual",
+      "patchVersion": "1.0.0",
+      "shardId": "na",
+      "stats": "acesEarned: 3, etc..."
+    },
+    "relationships": {
+      "rosters": {
+        "data": [{
+          "type": "roster",
+          "id": "ea77c2eb-d44e-11e6-8f77-0242ac130004"
+        }, {
+          "type": "roster",
+          "id": "dc2c14b4-d50c-11e6-bf26-cec0c932ce01"
+        }]
+      }
+    }
+  }
+}
+```
+{% endmethod %}
+
+
+### HTTP Request
+
+`GET https://api.dc01.gamelockerapp.com/shards/na/matches/<ID>`
+
+### URL Parameters
+
+Parameter | Description
+--------- | -----------
+ID | The ID of the match to retrieve
+
+## Where is my match?
+
+We purposefully do not allow certain matches to be displayed.  Specifically, for
+ a match to be valid it must meet all of the following requirements.
+
+  1.  The game mode must be one of the following:
+    * ranked
+    * casual
+    * private
+    * private_party_draft_match
+    * private_party_aral_match
+    * private_party_blitz_match
+    * casual_aral
+    * blitz_pvp_ranked
+  1. The match must NOT have ended with one of the following statuses:
+    * exitpractice
+    * notenoughplayers
+  1. In order to allow our pro-players to practice, we also reject matches where there are no ranked players and the game mode is private.
diff --git a/en/matchesJSON.md b/en/matchesJSON.md
new file mode 100644
index 0000000..7004891
--- /dev/null
+++ b/en/matchesJSON.md
@@ -0,0 +1,125 @@
+# ***Match Data Summary***
+
+Special thanks to Kashz for helping to create this! GitHub: iAm-Kashif
+
+## **Match Object**
+
+| Variable | Type | Description |
+| :---: | :---: | :---: |
+| type | str | Match |
+| id | str | Match ID |
+| createdAt | str (iso8601) | Time of Match Played |
+| duration | int | Time of match in seconds |
+| gameMode | str | Game Mode |
+| patchVersion | str | Version of API |
+| shardId | str | Match Shard |
+| stats | map | See [Match.stats](#1) |
+| assets | obj | See [Match.assets](#2)  |
+| rosters | obj | See [Rosters](#3) |
+
+### <a name="1"></a> **Match.stats** **(End of game statistics)**
+
+| Variable | Type | Description |
+| :---: | :---: |:---: |
+| endGameReason | str | "Victory" or "Defeat" |
+| queue | str | Game Mode |
+
+### <a name="2"></a> **Match.assets** **(Telemetry Data)**
+
+| Variable | Type | Description |
+| :---: | :---: |:---: |
+| type | string | asset |
+| createdAt | str (iso8601) | Time of Telemtry creation
+| description | str | "" |
+| filename | str | telemetry.json |
+| id | str | ID of Asset |
+| contentType | str | application/json |
+| name | str | telemetry |
+| url | str | Link to Telemetry.json file |
+
+## <a name="3"></a> **Rosters Object**
+
+| Variable | Type | Description |
+| :---: | :---: | :---: |
+| id | str | ID of Roster |
+| type | str | Roster
+| participants | obj | See [Participants](#4) |
+| stats | obj | See [Rosters.stats](#5) |
+| team | obj | See [Rosters.team](#6) |
+
+### <a name="5"></a>**Rosters.stats**
+| Variable | Type |
+| :---: | :---: |
+| acesEarned | int |
+| gold | int |
+| heroKills | int |
+| krakenCaptures | int |
+| side | Either "right/red" or "left/blue" |
+| turretKills | int |
+| turretRemaining | int |
+
+### <a name="6"></a>**Rosters.team**
+| Variable | Type | Description 
+| :---: | :---: | :---: |
+| id | str | ID of Team or None |
+| name | str | Name of Team or None |
+| type | str | team |
+
+## <a name="4"></a>**Participants Object**
+
+| Variable | Type | Description |
+| :---: | :---: | :---: |
+| actor | str | Hero |
+| id | str | Same as ID of Roster |
+| player | obj |See [Participants.player](#7)|
+| stats | map |See [Participants.stats](#8) |
+| type | str | participants |
+
+### <a name="7"></a>**Participants.player**
+
+| Variable | Type |Description |
+| :---: | :---: | :---: |
+| id | str | UID of player |
+| name | str | IGN of player |
+| stats | map | See [Participants.player.stats](#9) |
+| type | str | player |
+
+### <a name="8"></a>**Participants.stats**
+
+| Variable |Type |
+| :---: | :---: |
+| assists | int |
+| crystalMineCaptures | int |
+| deaths | int |
+| farm | int |
+| firstAfkTime | int: -1 for no AFK |
+| goldMineCaptures | int |
+| itemGrants | map of {itemsBought : int} |
+| itemSells | map of {itemsSold : int} |
+| itemUses | map of {itemsUsed : int} |
+| items | list of final build (Len: 6) |
+| jungleKills | int |
+| karmaLevel | int |
+| kills | int |
+| krakenCaptures | int |
+| level | int |
+| minionKills | int |
+| nonJungleMinionKills | int |
+| skillTier | int |
+| skinKey | str |
+| turretCaptures | int |
+| wentAfk | bool |
+| winner | bool |
+
+### <a name="9"></a> **Participants.player.stats**
+
+| Variable | Type | 
+| :---: | :---: | 
+| level | int |
+| lifetimeGold | float |
+| lossStreak | int |
+| played | int |
+| played\_ranked | int |
+| winStreak | int |
+| wins | int |
+| xp | int |
diff --git a/en/plans.md b/en/plans.md
new file mode 100644
index 0000000..1472ca6
--- /dev/null
+++ b/en/plans.md
@@ -0,0 +1,22 @@
+# Rate Limits
+
+The API is free for non-commercial use with a default rate limit of 10 requests per minute.  If you need a higher limit, please contact api@superevilmegacorp.com and we'll hook you up!  
+
+# Usage Tiers
+
+We do our best to give out timely and accurate data so that we can work together to create awesome experiences for our players.  We classify projects into three categories.
+
+## Hobby Tier
+When you create a new API key, you're automatically placed into this tier.  This tier is intended to support non-commercial projects, SDKs, hackathons, and any projects that don't require a higher rate limit.
+
+The default rate limit is 10 requests per minute, and there is no access to data from the public beta environment.
+
+## Community Tier
+This tier is intended to be used by small commercial projects projects (those that derive revenue from ads, subscriptions, and more).  Access is still free, but we require that these projects share data with us about the way players use the project.  We use this to make sure we deliver the best possible experience for both your project and the players that use it.  This data is not shared with any other users of the API.  
+
+Rate limits in this tier are customized to the project, and we allow select community projects access to the public beta environment.
+
+## Commercial Tier
+This tier is intended to be used by large commercial projects projects (those that derive revenue from ads, subscriptions, and more).  Commercial project need high-volume low-cost access to data.  While the data provided is exactly the same as that provided to hobby and community tiers, commercial have additional options for accessing it.  In addition, there is no requirement to share data about how data is used.  
+
+Rate limits in this tier are customized to the project, and we allow select community projects access to the public beta environment.  Commercial users also get bulk access, increased webhook limits, statistical samples, and more.
diff --git a/en/players.md b/en/players.md
new file mode 100644
index 0000000..0c0b92f
--- /dev/null
+++ b/en/players.md
@@ -0,0 +1,195 @@
+# Players
+
+Player objects contain aggregated lifetime information about each Player.  At this time Players are fairly sparse, but there are plans to add much richer data as it becomes available.
+
+{% method %}
+## Get a single Player
+
+This endpoint retrieves a specific player.
+
+* If a player has changed names, it is possible that there are multiple ID's for a single player name.
+
+* Player renames do not trigger a change on this endpoint. A minimum of 1 match after the rename is required to view the change.
+
+
+**Changes Coming!** - Player resources are not fully defined at this point, but are
+included so that consumers can get basic info (name, etc.)  This object will have
+additional data added over the next few months, and may change slightly as data
+moves from the `attributes.stats` object to the main `attributes` object.
+
+
+{% sample lang="shell" %}
+```shell
+curl "https://api.dc01.gamelockerapp.com/shards/na/players/<ID>" \
+  -H "Authorization: Bearer <api-key>" \
+  -H "Accept: application/vnd.api+json"
+```
+
+{% sample lang="java" %}
+```java
+//There are a variety of Java HTTP libraries that support query-parameters.
+```
+
+{% sample lang="python" %}
+```python
+
+```
+
+{% sample lang="ruby" %}
+```ruby
+
+```
+
+{% sample lang="js" %}
+```javascript
+
+```
+
+{% sample lang="go" %}
+```go
+
+```
+
+{% sample lang="swift" %}
+```swift
+import Foundation
+
+let urlString = "https://api.dc01.gamelockerapp.com/shards/na/players?filter[playerNames]=PlayerIGN"
+
+let url = NSURL(string: urlString)
+var downloadTask = URLRequest(url: (url as URL?)!, cachePolicy: URLRequest.CachePolicy.ReloadIgnoringCacheData, timeoutInterval: 20)
+
+downloadTask.httpMethod = "GET"
+
+downloadTask.addValue("apiKey", forHTTPHeaderField: "Authorization")
+downloadTask.addValue("application/vnd.api+json", forHTTPHeaderField: "Accept")
+
+URLSession.shared.dataTask(with: downloadTask) { (data, response, error) in
+if let response = response {
+    print(response)
+}
+
+if let data = data {
+    do {
+    let jsonData = try JSONSerialization.jsonObject(with: data, options: .allowFragments) as? NSDictionary
+    print(jsonData!.value(forKey: "data") as Any)
+    } catch {
+    print(error)
+    }
+}
+}.resume()
+
+```
+
+{% common %}
+> The above command returns JSON structured like this:
+
+```json
+{
+"data": {
+  "attributes": {
+      "stats": {
+          "lossStreak": 1,
+          "winStreak": 0,
+          "lifetimeGold": 10536.0
+      },
+      "name": "boombastic04"
+  },
+  "type": "player",
+  "id": "6abb30de-7cb8-11e4-8bd3-06eb725f8a76"
+}
+}
+```
+{% endmethod %}
+
+### HTTP Request
+
+`GET https://api.dc01.gamelockerapp.com/shards/na/players/<ID>`
+
+
+### URL Parameters
+
+Parameter | Description
+--------- | -----------
+ID | The ID of the player to retrieve
+
+{% method %}
+## Get a collection of players
+
+This endpoint retrieves a collection of up to 6 players, filtered by name. Player names are specific to each region.
+
+{% sample lang="shell" %}
+```shell
+curl "https://api.dc01.gamelockerapp.com/shards/na/players?filter[playerNames]=player1,player2" \
+  -H "Authorization: Bearer <api-key>" \
+  -H "Accept: application/vnd.api+json"
+```
+
+{% sample lang="java" %}
+```java
+//There are a variety of Java HTTP libraries that support query-parameters.
+```
+
+{% sample lang="python" %}
+```python
+
+```
+
+{% sample lang="ruby" %}
+```ruby
+
+```
+
+{% sample lang="js" %}
+```javascript
+
+```
+
+{% sample lang="go" %}
+```go
+
+```
+
+{% sample lang="swift" %}
+```swift
+import Foundation
+
+let urlString = "https://api.dc01.gamelockerapp.com/shards/na/players?filter[playerNames]=PlayerIGN1, PlayerIGN2, PlayerIGN3"
+
+let url = NSURL(string: urlString)
+var downloadTask = URLRequest(url: (url as URL?)!, cachePolicy: URLRequest.CachePolicy.ReloadIgnoringCacheData, timeoutInterval: 20)
+
+downloadTask.httpMethod = "GET"
+
+downloadTask.addValue("apiKey", forHTTPHeaderField: "Authorization")
+downloadTask.addValue("application/vnd.api+json", forHTTPHeaderField: "Accept")
+
+URLSession.shared.dataTask(with: downloadTask) { (data, response, error) in
+if let response = response {
+    print(response)
+}
+
+if let data = data {
+    do {
+    let jsonData = try JSONSerialization.jsonObject(with: data, options: .allowFragments) as? NSDictionary
+    print(jsonData!.value(forKey: "data") as Any)
+    } catch {
+    print(error)
+    }
+}
+}.resume()
+
+```
+
+{% endmethod %}
+
+### HTTP Request
+
+`GET https://api.dc01.gamelockerapp.com/shards/na/players`
+
+### Query Parameters
+
+
+Parameter | Default | Description
+--------- | ------- | -----------
+filter[playerNames] | none | Filters by player names. Usage: filter[playerNames]=player1,player2
diff --git a/en/requests.md b/en/requests.md
new file mode 100644
index 0000000..ea2ff8a
--- /dev/null
+++ b/en/requests.md
@@ -0,0 +1,245 @@
+# Making Requests
+
+## Content Negotiation
+
+Clients using the api should specify that they accept responses using the
+`application/vnd.api+json` format, for convenience we will also accept `application/json`
+since it is the default for many popular client libraries.
+
+The Server will respond with a `Content-Type` header that mirrors the format
+requested by the Client.
+
+{% method %}
+## Shards {#shards}
+{% common %}
+To specify the regional shard, use this code:
+
+{% sample lang="shell" %}
+```shell
+"...gamelockerapp.com/shards/<region>/..."
+```
+
+{% sample lang="java" %}
+```java
+"...gamelockerapp.com/shards/<region>/..."
+```
+
+{% sample lang="python" %}
+```python
+"...gamelockerapp.com/shards/<region>/..."
+```
+
+{% sample lang="ruby" %}
+```ruby
+"...gamelockerapp.com/shards/<region>/..."
+```
+
+{% sample lang="js" %}
+```javascript
+"...gamelockerapp.com/shards/<region>/..."
+```
+
+{% sample lang="go" %}
+```go
+"...gamelockerapp.com/shards/<region>/..."
+```
+
+{% endmethod %}
+
+The Vainglory Game Data Service currently supports the following regions:
+
+***General Region Shards***
+
+To find data regarding live servers, where all data is found, please use the following shards.
+
+* **China:** ```cn```
+* **North America:** ```na```
+* **Europe:** ```eu```
+* **South America:** ```sa```
+* **East Asia:** ```ea```
+* **Southeast Asia (SEA):** ```sg```
+
+***Tournament Region Shards***
+
+To find data regarding professional eSport, which take place on the private client only, please use the following shards.
+
+* **North America Tournaments:** ```tournament-na```
+* **Europe Tournaments:** ```tournament-eu```
+* **South America Tournaments:** ```tournament-sa```
+* **East Asia Tournaments:** ```tournament-ea```
+* **Southeast Asia Tournaments:** ```tournament-sg```
+
+***Public Beta Environment***
+
+For developers that have signed an agreement with SEMC to access the Public Beta Eniroment (PBE) your key has access to an
+additional shard
+
+* **Public Beta Environment (Coming Soon):** ```pbe```
+
+**Choosing a specific region is required**
+{% method %}
+## GZIP
+
+> To specify the header Accept-Encoding, use this code:
+{% sample lang="shell" %}
+```shell
+-H "Accept-Encoding: gzip"
+```
+{% sample lang="java" %}
+```java
+conn.setRequestProperty("Accept-Encoding","gzip");
+```
+{% sample lang="python" %}
+```python
+header = {"Accept-Encoding":"gzip"}
+```
+{% sample lang="ruby" %}
+```ruby
+```
+{% sample lang="js" %}
+```javascript
+```
+{% sample lang="go" %}
+```go
+req.Header.Set("Accept-Encoding", "gzip")
+```
+{% endmethod %}
+Clients can specify the header `Accept-Encoding: gzip` and the server will compress responses.  
+Responses will be returns with `Content-Encoding: gzip`.
+
+Given the size of matches, this can have significant performance benefits.
+
+
+## Pagination
+
+
+Where applicable, the server allows requests to limit the number of results
+returned via pagination. To paginate the primary data, supply pagination information
+to the query portion of the request using the limit and offset parameters.  
+To fetch items 2 through 10 you would specify a limit of 8 and an offset of 2:
+
+If not specified, the server will default for matches to`limit=5` and `offset=0`, and for players/samples to `limit=50` and `offset=0`
+
+<aside class="warning">
+Important - Currently the server will not allow responses with over 50 primary data objects
+</aside>
+
+## Time
+
+* The max search time span between createdAt-start and createdAt-end is 28 days
+* If you don't specify either createdAt-start, or createdAt-end, the default is: current time - 28 days
+* If you specify only createdAt-start, createdAt-end is 28 days after or current time, whichever hits first
+* If you specify only createdAt-end, createdAt-start is 28 days prior
+* If you specify a future time, and are within the 28 day limit, the createdAt-end will default to current time
+
+{% method %}
+## Sorting
+
+>The example below will return the oldest articles first:
+{% sample lang="shell" %}
+```shell
+".../matches?sort=createdAt"
+```
+{% sample lang="java" %}
+```java
+".../matches?sort=createdAt"
+```
+{% sample lang="python" %}
+```python
+".../matches?sort=createdAt"
+```
+{% sample lang="ruby" %}
+```ruby
+".../matches?sort=createdAt"
+```
+{% sample lang="js" %}
+```javascript
+".../matches?sort=createdAt"
+```
+{% sample lang="go" %}
+```go
+".../matches?sort=createdAt"
+```
+{% common %}
+>The example below will return the newest articles first.
+{% sample lang="shell" %}
+
+```shell
+".../matches?sort=-createdAt"
+```
+{% sample lang="java" %}
+
+```java
+".../matches?sort=-createdAt"
+```
+{% sample lang="python" %}
+
+```python
+".../matches?sort=-createdAt"
+```
+{% sample lang="ruby" %}
+```ruby
+".../matches?sort=-createdAt"
+```
+{% sample lang="js" %}
+
+```javascript
+".../matches?sort=-createdAt"
+```
+{% sample lang="go" %}
+```go
+".../matches?sort=-createdAt"
+```
+{% endmethod %}
+The default sort order is always ascending. Ascending corresponds to the
+standard order of numbers and letters, i.e. A to Z, 0 to 9).  For dates and times, ascending means that earlier values precede later ones e.g. 1/1/2000 will sort ahead of 1/1/2001.
+
+All resource collections have a default sort order.  In addition, some resources provide the ability to sort according to one or more criteria ("sort fields").
+
+If sort fields are is prefixed with a minus, the order will be changed to descending.
+
+{% method %}
+## JSON-P Callbacks
+
+{% sample lang="shell" %}
+
+```shell
+curl -g "https://api.dc01.gamelockerapp.com/status?callback=foo"
+```
+{% endmethod %}
+
+You can send a ?callback parameter to any GET call to have the results wrapped in a JSON function. This is typically used when browsers want to embed content in web pages by getting around cross domain issues. The response includes the same data output as the regular API, plus the relevant HTTP Header information.
+
+
+{% method %}
+
+## Cross Origin Resource Sharing
+
+The API supports Cross Origin Resource Sharing (CORS) for AJAX requests from any origin.
+You can read the CORS W3C Recommendation, or this intro from the HTML 5 Security Guide.
+
+Here's a sample request sent from a browser hitting http://example.com:
+
+
+{% sample lang="shell" %}
+```shell
+curl -i https://api.dc01.gamelockerapp.com/status -H "Origin: http://example.com"
+  HTTP/1.1 200 OK
+  ...
+  Access-Control-Allow-Origin: *
+  Access-Control-Expose-Headers: Content-Length
+```
+{% common %}
+This is what the CORS preflight request looks like:
+
+{% sample lang="shell" %}
+```shell
+curl -i https://api.dc01.gamelockerapp.com/status -H "Origin: http://example.com" -X OPTIONS
+  HTTP/1.1 200 OK
+  ...
+  Access-Control-Allow-Headers: Origin,X-Title-Id,Authorization
+  Access-Control-Allow-Methods: GET,POST,OPTIONS
+  Access-Control-Allow-Origin: *
+  Access-Control-Max-Age: 86400
+```
+{% endmethod %}
diff --git a/en/responses.md b/en/responses.md
new file mode 100644
index 0000000..d690dd0
--- /dev/null
+++ b/en/responses.md
@@ -0,0 +1,73 @@
+# Receiving Responses
+
+## Payload
+
+All Server responses contain a root JSON object.  
+
+```jsonjson
+{
+  "data": {
+    "type": "match",
+    "id": "skarn",
+    "attributes": {
+      // ... this matches attributes
+    },
+    "relationships": {
+      // ... this matches relationships
+    }
+  }
+}
+```
+
+```json
+{
+  "data": {
+    "type": "match",
+    "id": "1"
+  }
+}
+```
+
+A response will contain at least one of the following top-level members:
+
+  * `data`: the response's “primary data”
+  * `errors`: an array of error objects
+
+A response may contain any of these top-level members:
+
+  * `links`: a links object related to the primary data.
+  * `included`: an array of resource objects that are related to the primary data and/or each other (“included resources”).
+
+If a document does not contain a top-level data key, the included member will not be present either.
+
+Primary data will be either:
+
+  * a single [resource object][resource objects], a single [resource identifier object], or `null`
+  * an array of [resource objects], an array of [resource identifier objects][resource identifier object], or
+  an empty array (`[]`)
+
+For example, the following primary data is a single resource object:
+
+
+The following primary data is a single [resource identifier object] that
+references the same resource:
+
+
+A logical collection of resources will always be represented as an array, even if
+it only contains one item or is empty.
+
+## Rate Limits
+>The rate limit headers are defined as follows:
+
+```
+X-RateLimit-Limit - Request limit per day / per minute
+X-RateLimit-Remaining - The number of requests left for the time window
+X-RateLimit-Reset - The remaining window before the rate limit is refilled in UTC epoch nanoseconds.
+* Limit tokens are incrementally filled by 60(sec)/ rate limit. ex: 60(sec)/10(rate) gets rate token every 6 seconds up to max rate limit.  
+```
+Be nice. If you're sending too many requests too quickly, we'll send back a  
+`429` error code (server unavailable).
+
+<aside class="notice">
+Free for non-commercial use for up to 10 requests per minute! To increase your rate limit, please contact api@superevilmegacorp.com
+</aside>
diff --git a/en/samples.md b/en/samples.md
new file mode 100644
index 0000000..b7062bb
--- /dev/null
+++ b/en/samples.md
@@ -0,0 +1,110 @@
+# Samples
+
+The samples endpoint provides an easy way to access hourly batches of random match data to aggregate stats.
+
+{% method %}
+## Get a collection of Samples
+
+This endpoint retrieves a collection of randomly selected matches.
+
+{% sample lang="shell" %}
+```shell
+curl "https://api.dc01.gamelockerapp.com/shards/na/samples" \
+  -H "Authorization: Bearer <api-key>" \
+  -H "Accept: application/vnd.api+json"
+```
+
+{% sample lang="java" %}
+```java
+//There are a variety of Java HTTP libraries that support query-parameters.
+```
+
+{% sample lang="python" %}
+```python
+
+```
+
+{% sample lang="ruby" %}
+```ruby
+
+```
+
+{% sample lang="js" %}
+```javascript
+
+```
+
+{% sample lang="go" %}
+```go
+
+```
+
+{% sample lang="swift" %}
+```swift
+    let urlString = "https://api.dc01.gamelockerapp.com/shards/na/samples"
+
+func downloadJsonWithTask() {
+        let url = NSURL(string: urlString)
+        
+        var downloadTask = URLRequest(url: (url as URL?)!, cachePolicy: URLRequest.CachePolicy.reloadIgnoringCacheData, timeoutInterval: 20)
+        
+        downloadTask.httpMethod = "GET"
+        downloadTask.addValue("APIKey", forHTTPHeaderField: "Authorization")
+        downloadTask.addValue("application/vnd.api+json", forHTTPHeaderField: "Accept")
+        
+        URLSession.shared.dataTask(with: downloadTask) { (data, response, error) in
+            if let response = response {
+                print(response)
+            }
+            
+            if let data = data {
+                do {
+            let jsonData = try JSONSerialization.jsonObject(with: data, options: .allowFragments) as? NSDictionary
+            print(jsonData!.value(forKey: "data") as Any)
+                } catch {
+                    print(error)
+                }
+            }
+        }.resume()
+    }
+
+
+```
+
+{% common %}
+> The above command returns JSON structured like this:
+
+```json
+{
+      "type": "sample",
+      "id": "sample-na-2017-02-28T07:15:30Z",
+      "attributes": {
+        "URL": "URL of Sample Matches",
+        "createdAt": "2017-02-28T07:15:30Z",
+        "shardId": "na",
+        "t0": "2017-02-28T07:15:30Z",
+        "t1": "2017-02-28T08:15:30Z",
+        "titleId": "semc-vainglory"
+      },
+      "relationships": {
+        "assets": {
+          "data": []
+        }
+      }
+    }
+```
+{% endmethod %}
+
+### HTTP Request
+
+`GET https://api.dc01.gamelockerapp.com/shards/na/samples`
+
+### Query Parameters
+
+Parameter | Default | Description |
+--------- | ------- | -----------   
+page[offset] | 0 | Allows paging over results
+page[limit] | 50 | The default (and current maximum) is 50.  Values less than 50 and great than 2 are supported.
+sort | createdAt | By default, samples are sorted by creation time ascending.
+filter[createdAt-Start] | none | Must occur before time. Format is iso8601 Usage: filter[createdAt-end]=2017-01-01T08:25:30Z
+filter[createdAt-End] | none | Must occur after time. Format is iso8601 Usage: filter[createdAt-end]=2017-01-01T13:25:30Z
diff --git a/en/sdks.md b/en/sdks.md
new file mode 100644
index 0000000..0556f7e
--- /dev/null
+++ b/en/sdks.md
@@ -0,0 +1,31 @@
+# Community SDK's
+
+Community contributions are welcome and rewarded with good karma (and swag!) If you are currently working on an API, let us know on the Discord server and we will add a link!
+
+##Java
+
+A Java adaptation of the Vainglory API - [DominicGunn/flicker](http://github.com/DominicGunn/flicker)
+
+##Python
+
+Python 3 wrapper for the Gamelocker API - [schneefux/python-gamelocker](http://github.com/schneefux/python-gamelocker)
+
+Python 3 wrapper for the Gamelocker API - [ClarkThyLord/madglory-ezl](https://github.com/ClarkThyLord/madglory-ezl)
+
+##JavaScript
+
+A JavaScript API client - [seripap/vainglory](https://github.com/seripap/vainglory)
+
+##R
+
+A project providing R6 classes (for the R language) for accessing the API - [nathancarter/rvgapi](https://github.com/nathancarter/rvgapi)
+
+##Go
+
+A proof of concept go client for the Vainglory Developer API - [madglory/vainglory-go-client](https://github.com/madglory/vainglory-go-client)
+
+##Ruby
+
+A Ruby gem wrapper for the Vainglory Developer API -
+[Ruby Gem](https://rubygems.org/gems/vainglory-api) | 
+[Github](https://github.com/cbortz/vainglory-api-ruby)
diff --git a/en/teams.md b/en/teams.md
new file mode 100644
index 0000000..994c4fb
--- /dev/null
+++ b/en/teams.md
@@ -0,0 +1,67 @@
+# Teams (Coming Soon!)
+
+Team objects contain aggregated lifetime information about each Team.
+
+## Get a collection of Teams
+
+```shell
+curl "https://api.dc01.gamelockerapp.com/shards/na/teams?filter[teamNames]=team1" \
+  -H "Authorization: Bearer <api-key>" \
+  -H "Accept: application/vnd.api+json"
+```
+
+This endpoint retrieves a collection of up to 6 teams.
+
+<aside class="warning">
+Important - Team resources are not yet available in the API.
+</aside>
+
+### HTTP Request
+
+`GET https://api.dc01.gamelockerapp.com/teams`
+
+### Query Parameters
+
+Parameter | Default | Description
+--------- | ------- | -----------
+filter[teamNames] | none | Filters by team name. Usage: filter[teamNames]=team1
+filter[teamIds] | none | Filter by team id. Usage: filter[teamIds]=12345
+
+<aside class="success">
+Remember — a happy team is an authenticated team!
+</aside>
+
+## Get a single Team
+
+```shell
+curl "https://api.dc01.gamelockerapp.com/teams/<ID>" \
+  -H "Authorization: Bearer <api-key>" \
+  -H "Accept: application/vnd.api+json"
+```
+
+```python
+```
+
+> The above command returns JSON structured like this:
+
+```json
+{
+  "id": 2,
+  "name": "Max",
+  "breed": "unknown",
+  "fluffiness": 5,
+  "cuteness": 10
+}
+```
+
+This endpoint retrieves a specific team.
+
+### HTTP Request
+
+`GET https://api.dc01.gamelockerapp.com/teams/<ID>`
+
+### URL Parameters
+
+Parameter | Description
+--------- | -----------
+ID | The ID of the team to retrieve
diff --git a/en/telemetry.md b/en/telemetry.md
new file mode 100644
index 0000000..5ec5377
--- /dev/null
+++ b/en/telemetry.md
@@ -0,0 +1,559 @@
+# Telemetry
+
+The telemetry provides us insights into the match. It gives us details of various events that happened in the match alongwith the time when they happened. Some of the events also have location which can be plotted on a Vainglory Game map. Telemetry is very useful to generate a timeline visualization of how the match went for replays, or create heatmaps of where a certain hero or ability is  most useful. These are just some of the examples of where Telemetry can be used.
+
+> You will get telemetry data as part of the matches endpoint.
+
+> And a map of the Halcyon Fold [here!](https://cdn.discordapp.com/attachments/272249149473161216/284388441674874880/vainglory-map.png)
+
+ {% method %}
+## To get Telemetry data
+
+You start by pulling a list of matches using the matches endopoint.
+
+The HTTP Request to get matches is
+`GET https://api.dc01.gamelockerapp.com/shards/na/matches`
+
+{% sample lang="shell" %}
+```shell
+curl "https://api.dc01.gamelockerapp.com/shards/na/matches" \
+  -H "Authorization: Bearer <api-key>" \
+  -H "Accept: application/vnd.api+json"
+```
+{% sample lang="java" %}
+```java
+//There are a variety of Java HTTP libraries that support query-parameters.
+```
+{% sample lang="python" %}
+```python
+```
+{% sample lang="ruby" %}
+```ruby
+```
+{% sample lang="js" %}
+```javascript
+```
+{% sample lang="go" %}
+```go
+```
+{% common %}
+> The above command returns JSON structured like this:
+
+```json
+  "data": [
+    {
+      "type": "match",
+      "id": "f5373c40-0aa9-11e7-bcff-0667892d829e",
+      "attributes": {
+        "createdAt": "2017-03-17T00:38:00Z",
+        "duration": 259,
+        "gameMode": "blitz_pvp_ranked",
+        "patchVersion": "",
+        "shardId": "na",
+        "stats": {
+          "endGameReason": "victory",
+          "queue": "blitz_pvp_ranked"
+        },
+        "titleId": "semc-vainglory"
+      },
+      "relationships": {
+        "assets": {
+          "data": [
+            {
+              "type": "asset",
+              "id": "b900c179-0aaa-11e7-bb12-0242ac110005"
+            }
+          ]
+        },
+        "rosters": {
+          "data": [
+            {
+              "type": "roster",
+              "id": "b8f6640a-0aaa-11e7-bb12-0242ac110005"
+            },
+            {
+              "type": "roster",
+              "id": "b8f65271-0aaa-11e7-bb12-0242ac110005"
+            }
+          ]
+        },
+        "rounds": {
+          "data": []
+        }
+      }
+    },
+ ```
+
+
+> You need to look for Assets JSON node which points to telemetry. Check for the following in the response:
+
+```json
+      "relationships": {
+        "assets": {
+          "data": [
+            {
+              "type": "asset",
+              "id": "b900c179-0aaa-11e7-bb12-0242ac110005"
+            }
+          ]
+        },
+```
+
+> Once you have located this ID, you now have to search for the following JSON segment in the response object. The following response object will provide you a link to the Telemetry data
+
+```json
+    {
+      "type": "asset",
+      "id": "b900c179-0aaa-11e7-bb12-0242ac110005",
+      "attributes": {
+        "URL": "https://gl-prod-us-east-1.s3.amazonaws.com/assets/semc-vainglory/na/2017/03/17/00/43/b900c179-0aaa-11e7-bb12-0242ac110005-telemetry.json",
+        "contentType": "application/json",
+        "createdAt": "2017-03-17T00:43:22Z",
+        "description": "",
+        "filename": "telemetry.json",
+        "name": "telemetry"
+      }
+    },
+```
+
+> you can download the data with following commands. Please note that you **do not** need API Key to get this data.
+
+{% sample lang="shell" %}
+```shell
+curl "https://gl-prod-us-east-1.s3.amazonaws.com/assets/semc-vainglory/na/2017/03/17/00/43/b900c179-0aaa-11e7-bb12-0242ac110005-telemetry.json" \
+  -H "Accept: application/vnd.api+json"
+```
+{% sample lang="java" %}
+```java
+//There are a variety of Java HTTP libraries that support query-parameters.
+```
+{% sample lang="python" %}
+```python
+```
+{% sample lang="ruby" %}
+```ruby
+```
+{% sample lang="js" %}
+```javascript
+```
+{% sample lang="go" %}
+```go
+```
+{% common %}
+> this request will return you a response as follows:
+
+
+```json  
+   { "time": "2017-02-18T06:37:15+0000",
+     "type": "DealDamage",
+     "payload": {
+       "Team": "Left",
+       "Actor": "*Ringo*",
+       "Target": "*Turret*",
+       "Source": "Unknown",
+       "Damage": 405,
+       "Delt":  613,
+       "IsHero": 1,
+       "TargetIsHero": 0
+     }
+   }
+```
+{% endmethod %}
+
+## Event Data Dictionary
+Telemetry data is classified into several events of interest. Following is a list of every event type with an example.
+
+### General Event Info:
+
+#### Team
+In pre-match events teams will appear as ```1``` or ```2```, and in match events teams will apper as ```Left``` or ```Right``` side. Where ```1``` is ```Left``` side and ```2``` is ```Right``` side.
+
+#### Position & TargetPosition
+Positions for events are given in vectors holding three values. For example:
+
+	[-17.51, 0.01, 41.63]
+
+Where the first value represents the x coordinate, second value represents the z coordinate, and the third value represents the y coordinate. In other words, "Horizontal, Height, Vertical".
+
+The following is a list of some of the most important positions on the map:
+
+##### MAP LANDMARK COORDINATES
+
+**==LEFT SIDE==**
+
+```Base Shop (-88.50, 0.89, 2.00)
+
+Crystal (-76.12, 0.00, 19.90)
+
+Turret 5 (-75.48, 0.00, 11.96)
+Turret 4 (-68.59, 0.00, 19.97)
+Turret 3 (-54.00, 0.00, 2.92)
+Turret 2 (-35.78, 0.00, 1.17)
+Turret 1 (-17.06, 0.00, 1.93)
+
+Top Healer (-40.92, 0.00, 20.25)
+
+Backs 1 (-43.42, 0.00, 31.11)
+Backs 2 (-45, 0.00, 32.23)
+
+Crystal Miner (-35.19, 0.00, 36.03)
+
+Mid Healer (-21.95, 0.00, 24.00)
+
+Fronts 1 (-14.40, 0.00, 37.67)
+Fronts 2 (-12.51, 0.00, 37.67)
+```
+
+**==RIGHT SIDE==**
+```
+Base Shop (88.57, 1.80, 0.51)
+
+Crystal (76.12, 0.10, 19.90)
+
+Turret 5 (75.48, 0.00, 11.96)
+Turret 4 (68.59, 0.00, 19.97)
+Turret 3 (54.00, 0.00, 2.92)
+Turret 2 (35.78, 0.00, 1.17)
+Turret 1 (17.06, 0.00, 1.93)
+
+Top Healer (40.59, 0.00, 20.75)
+
+Backs 1 (43.49, 0.00, 31.28)
+Backs 2 (45.60, 0.00, 32.40)
+
+Crystal Miner (35.20, -0.00, 35.87)
+
+Mid Healer (22.50, 0.00, 23.50)
+
+Fronts 1 (14.85, 0.00, 38.12)
+Fronts 2 (12.89. 0.00, 36.74)
+```
+**==Miscellaneous==**
+```
+Gold Miner / Kraken (0.00, 0.00. 23.60)
+Elder Treant / Jungle Shop (0.20, 0.00, 42,00)
+Compass Center (.092, 0.01, 3.33)
+Map Center (0.00, 0.00, 0.00)
+```
+
+### Pre-Match Events
+The following events will only take place pre-match, such as in hero selection.
+
+#### HeroBan
+Takes place when a hero has been banned, this event will only take place in draft mode.
+
+	{
+	    "time": "2017-06-17T18:19:52+0000",
+	    "type": "HeroBan",
+	    "payload": {
+	        "Hero": "*Grumpjaw*",
+	        "Team": "1"
+	    }
+	}
+
+#### HeroSelect
+Takes place when a hero has been selected by a player, `Handle` is the in-game name of the player.
+
+	{
+	    "time": "2017-06-26T04:58:29+0000",
+	    "type": "HeroSelect",
+	    "payload": {
+	        "Hero": "*Blackfeather*",
+	        "Team": "2",
+	        "Player": "cc4069da-982b-11e4-9bf4-06eb725f8a76",
+	        "Handle": "CrownNorth"
+	    }
+	}
+
+#### HeroSkinSelect
+Takes place when a player has selected a skin, this event will typically happen after hero select, if not at the same time, and might appear more then once if the skin is changed. A list of all hero skins is present in the [resources folder](https://github.com/madglory/gamelocker-vainglory/tree/master/resources).
+
+	{
+	    "time": "2017-06-26T04:58:29+0000",
+	    "type": "HeroSkinSelect",
+	    "payload": {
+	        "Hero": "*Blackfeather*",
+	        "Skin": "Blackfeather_Skin_Dynasty_T1"
+	    }
+	}
+
+#### HeroSwap
+Takes place when a player has swapped heroes with another player, this event will only take place in draft mode. Player is the player's unique id.
+
+	{
+		"time": "2017-06-13T06:41:38+0000",
+		"type": "HeroSwap",
+		"payload": [
+			{
+				"Hero": "*Glaive*",
+				"Team": "2",
+				"Player": "85d05694-2ab2-11e5-8d94-06f4ee369f53"
+			},
+			{
+				"Hero": "*Catherine*",
+				"Team": "2",
+				"Player": "292e51d6-9640-11e4-a597-06eb725f8a76"
+			}
+		]
+	}
+
+### Match Events
+The following events will only take place during a match.
+
+#### PlayerFirstSpawn
+At the start of the game when a player spawns.
+
+	{
+		"time": "2017-03-17T00:38:32+0000",
+		"type": "PlayerFirstSpawn",
+		"payload": {
+			"Team": "Right",
+			"Actor": "*Alpha*"
+		}
+	}
+
+#### LevelUp
+When a player gains a level in the game. Depending on the game mode of the match, you will find multiple events at the exact same time for each player at the beginning of the match.
+
+
+	{
+		"time": "2017-03-17T00:38:32+0000",
+		"type": "LevelUp",
+		"payload": {
+			"Team": "Right",
+			"Actor": "*Alpha*",
+			"Level": 1,
+			"LifetimeGold": 0
+		}
+	}
+
+#### BuyItem
+When a player buys an item. Pro-Tip: Position will help you determine which shop was used to buy the item.
+
+	{
+		"time": "2017-06-26T04:59:47+0000",
+		"type": "BuyItem",
+		"payload": {
+			"Team": "Right",
+			"Actor": "*Blackfeather*",
+			"Item": "Book Of Eulogies",
+			"Cost": 300,
+			"RemainingGold:": 300,
+			"Position": [
+				83.22,
+				1.5,
+				0.72
+			]
+		}
+	}
+
+#### SellItem
+When a player sells an item.
+
+	{
+		"time": "2017-03-31T02:49:37+0000",
+		"type": "SellItem",
+		"payload": {
+			"Team": "Left",
+			"Actor": "*Lyra*",
+			"Item": "Flare",
+			"Cost": 15
+		}
+	}
+
+#### LearnAbility
+When a player puts upgrades an ability. Pro-Tip: There can be a time difference between when a player levels up and upgrades an ability.
+
+	{
+		"time": "2017-03-17T00:38:52+0000",
+		"type": "LearnAbility",
+		"payload": {
+			"Team": "Right",
+			"Actor": "*Sayoc*",
+			"Ability": "HERO_ABILITY_SAYOC_C",
+			"Level": 1
+		}
+	}
+
+#### UseAbility
+This event is recorded when a player uses an ability and it will hold information about the hero who used it together with the coordinates for the map.
+
+	{
+		"time": "2017-03-17T00:39:08+0000",
+		"type": "UseAbility",
+		"payload": {
+			"Team": "Right",
+			"Actor": "*Kestrel*",
+			"Ability": "HERO_ABILITY_KESTREL_A_NAME",
+			"Position": [
+				39.39,
+				0.01,
+				27.26
+			]
+		}
+	}
+
+#### UseItemAbility
+This event is recorded when a player uses an activatable item or a charm/taunt.
+
+	{
+		"time": "2017-03-31T03:10:17+0000",
+		"type": "UseItemAbility",
+		"payload": {
+			"Team": "Left",
+			"Actor": "*Lyra*",
+			"Ability": "Travel Boots",
+			"Position": [
+				-17.51,
+				0.01,
+				41.63
+			],
+			"TargetActor": "None",
+			"TargetPosition": [
+				-17.51,
+				0.01,
+				41.63
+			]
+		}
+	}
+
+#### EarnXP
+This event is recorded when a player gains XP from any source. it could be killing a minion, miner or a hero. Pro-Tip: This event is not shown for XP trickle(XP gained per second of the match).
+	
+	{
+		"time": "2017-03-17T00:39:09+0000",
+		"type": "EarnXP",
+		"payload": {
+			"Team": "Left",
+			"Actor": "*Koshka*",
+			"Source": "*JungleMinion_TreeEnt*",
+			"Amount": 67,
+			"Shared With": 1
+		}
+	}
+
+#### DealDamage
+This event is recorded when any actor (player, turret, minion, etc.) deals damage to any other.
+
+	{
+		"time": "2017-03-31T02:47:34+0000",
+		"type": "DealDamage",
+		"payload": {
+			  "Team": "Left",
+			  "Actor": "*Skaarf*",
+			  "Target": "*Vox*",
+			  "Source": "Unknown",
+			  "Damage": 105,
+			  "Delt": 80,
+			  "IsHero": 1,
+			  "TargetIsHero": 1
+		}
+	}
+
+
+#### KillActor
+This event is recorded when a player kills anything in game. it could be a a minion, miner or a hero. You will generally see EarnXP and KillActor events come at the same time.
+
+	{
+		"time": "2017-03-17T00:39:09+0000",
+		"type": "KillActor",
+		"payload": {
+			"Team": "Left",
+			"Actor": "*Koshka*",
+			"Killed": "*JungleMinion_TreeEnt*",
+			"KilledTeam": "Neutral",
+			"Gold": "80",
+			"IsHero": 1,
+			"TargetIsHero": 0,
+			"Position": [
+				-21.95,
+				0,
+				24
+			]
+		}
+	}
+
+#### NPCkillNPC
+When one non-player actor kills another, such as the Kraken or a minion killing a turret.
+
+	{
+		"time": "2017-03-31T03:07:21+0000",
+		"type": "NPCkillNPC",
+		"payload": {
+			"Team": "Left",
+			"Actor": "*Kraken_Captured*",
+			"Killed": "*Turret*",
+			"KilledTeam": "Right",
+			"Gold": "300",
+			"IsHero": 0,
+			"TargetIsHero": 0,
+			"Position": [
+				54,
+				0,
+				2.92
+				]
+		}
+	}
+
+#### Executed
+When a non-player kills a player, such as Kraken or a minion killing a player.
+
+	{
+	    "time": "2017-06-13T06:43:40+0000",
+	    "type": "Executed",
+	    "payload": {
+	        "Team": "Left",
+	        "Actor": "*JungleMinion_TreeEnt*",
+	        "Killed": "*Samuel*",
+	        "KilledTeam": "Left",
+	        "Gold": "0",
+	        "IsHero": 0,
+	        "TargetIsHero": 1,
+	        "Position": [
+	            -41.82,
+	            0.01,
+	            27.02
+	        ]
+	    }
+	}
+
+#### GoldFromTowerKill
+When a player earns gold from the destruction of a turret belonging to the enemy team.
+
+	{
+		"time": "2017-03-31T02:57:02+0000",
+		"type": "GoldFromTowerKill",
+		"payload": {
+			"Team": "Left",
+			"Actor": "*Idris*",
+			"Amount": 300
+		}
+	}
+
+#### GoldFromGoldMine
+When a player earns gold from his or her team capturing the gold miner.
+
+	{
+		"time": "2017-03-31T03:00:43+0000",
+		"type": "GoldFromGoldMine",
+		"payload": {
+			"Team": "Left",
+			"Actor": "*Idris*",
+			"Amount": 300
+		}
+	}
+
+#### GoldFromKrakenKill
+When a player earns gold from his or her team killing a Kraken released by the enemy team.
+
+	{
+		"time": "2017-03-31T03:07:43+0000",
+		"type": "GoldFromKrakenKill",
+		"payload": {
+			"Team": "Right",
+			"Actor": "*Kestrel*",
+			"Amount": 500
+		}
+	}
+
+Download a sample of telemetry data [here!](https://cdn.discordapp.com/attachments/272249149473161216/282627164053176320/telemetry_sample.tgz)
diff --git a/en/titles.md b/en/titles.md
new file mode 100644
index 0000000..7c1b141
--- /dev/null
+++ b/en/titles.md
@@ -0,0 +1,8 @@
+# Titles
+
+The TitleID for a request is determined by the JWT in the Authorization header automatically and may appear in responses.
+
+<aside class="notice">
+No no, this isn't a hint at more Super Evil game titles.  The Vainglory Game Data
+Service uses a platform called Gamelocker which system itself can store multiple titles.
+</aside>
diff --git a/en/versioning.md b/en/versioning.md
new file mode 100644
index 0000000..c90a385
--- /dev/null
+++ b/en/versioning.md
@@ -0,0 +1,9 @@
+## Versioning {#versioning}
+
+We following [SEMVER](http://semver.org/) standards, using a MAJOR.MINOR.PATCH versioning scheme. This means that we will increment versioning in the following way:
+
+* MAJOR version when we make incompatible API changes,
+* MINOR version when we add functionality in a backwards-compatible manner,
+* PATCH version when we make backwards-compatible bug fixes.
+
+You can see the current version and deploy date by viewing the [Status](https://api.dc01.gamelockerapp.com/status) endpoint.
diff --git a/es/SUMMARY.md b/es/SUMMARY.md
new file mode 100644
index 0000000..0db90a0
--- /dev/null
+++ b/es/SUMMARY.md
@@ -0,0 +1,17 @@
+# Summary
+
+* [Versiones](versioning.md)
+* [Centros De Datos](datacenters.md)
+* [Authorization](authorization.md)
+* [Titulos](titles.md)
+* [Haciendo Solicitudes](requests.md)
+* [Recibiendo Respuestas](responses.md)
+* [Partidas](matches.md)
+* [Resumen De Datos De Partidas](matchesJSON.md)
+* [Jugadores](players.md)
+<!-- * [Muestras](samples.md) -->
+* [Telemetría](telemetry.md)
+<!-- * [Equipos (Disponibles Pronto!)](teams.md) -->
+<!-- * [Enlaces (Disponibles Pronto!)](links.md) -->
+* [SDK De La Communidad](sdks.md)
+* [Errores](errors.md)
diff --git a/es/assets/cover.png b/es/assets/cover.png
new file mode 100644
index 0000000..d6c3ba8
--- /dev/null
+++ b/es/assets/cover.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6979509c0f540cbedfb2c2941b2572a1412c50e58e47f3416726e8b8e33d7a26
+size 17187
diff --git a/es/authorization.md b/es/authorization.md
new file mode 100644
index 0000000..daa26a9
--- /dev/null
+++ b/es/authorization.md
@@ -0,0 +1,61 @@
+{% method %}
+# Enlaces (Disponibles pronto!)
+
+## Consigue un enlace
+
+Este endpoint comprueba que un objeto link existe para un código dado.
+
+{% sample lang="shell" %}
+```shell
+curl "https://api.dc01.gamelockerapp.com/shards/na/link/{id}" \
+  -H "Authorization: Bearer <api-key>" \
+  -H "X-TITLE-ID: semc-vainglory" \
+  -H "Accept: application/vnd.api+json"
+```
+{% endmethod %}
+ 
+### Petición HTTP
+ 
+`GET https://api.dc01.gamelockerapp.com/link`
+ 
+### Parámetros de pregunta
+ 
+Parámetro | Defecto | Descripción
+--------- | ------- | ----------- 
+
+{% method %}
+# Pública un Enlace
+
+Este punto final crea un objeto de PlayerLink si el código de verificación coincide con el proporcionado por el juego 
+
+{% sample lang="shell" %}
+```shell
+curl -XPOST "https://api.dc01.gamelockerapp.com/shards/na/link/{player_id}" \
+  -H "Authorization: Bearer <api-key>" \
+  -H "Accept: application/vnd.api+json"
+```
+{% endmethod %}
+
+### HTTP Request
+
+`POST https://api.dc01.gamelockerapp.com/link/{player_id}`
+
+### Query Parameters
+
+Parameter | Default | Description
+--------- | ------- | -----------
+code      |         | The verification code
+
+## PlayerLink
+
+```json
+{
+  "attributes": {
+      "playerId": "fb374a7b-78be-4fcc-83ed-6a532a8a6f55",
+      "shardId": "na",
+      "titleId": "semc-vainglory"
+  },
+  "id": "2454e5ac-0a69-4468-ad12-8616f066e817",
+  "type": "playerLink"
+}
+```
diff --git a/es/book.json b/es/book.json
new file mode 100644
index 0000000..7b7dcea
--- /dev/null
+++ b/es/book.json
@@ -0,0 +1,7 @@
+{
+  "language": "es",
+  "structure": {
+    "readme": "introduction.md",
+    "summary": "summary.md"
+  }
+}
diff --git a/es/datacenters.md b/es/datacenters.md
new file mode 100644
index 0000000..1a3b311
--- /dev/null
+++ b/es/datacenters.md
@@ -0,0 +1,7 @@
+# Datacenters
+
+We operate several Datacenters around the world.  Each datacenter holds all
+information for one or more Regions of the game.  Currently all data is located
+in `DC01`, but this may change in the future.  Users will be notified prior to the
+change and an API endpoint will be made available to provide metadata describing
+where each regions data can be found.
\ No newline at end of file
diff --git a/es/errors.md b/es/errors.md
new file mode 100644
index 0000000..fb795e4
--- /dev/null
+++ b/es/errors.md
@@ -0,0 +1,26 @@
+# Errores
+ 
+El servidor dejará de procesar si un problema es encontrado y devuelve el HTTP error status code correcto.
+Errores podrían incluir error objects,que son devueltos como una colección llamado `errors` en el top level de un documento JSON API.
+ 
+Error objects tienen los siguientes miembros:
+ 
+* `title`: (Necesario) el HTTP status code aplicable a este problema, expresado como un string value
+  string value.
+* `description`: (Opcional) un resumen corto del problema.
+ 
+El servidor utiliza estos códigos de error:
+
+Error Code | Significado
+---------- | -------
+400 | Bad Request -- Tu petición apesta
+401 | Unauthorized -- Tu llave API está mal
+403 | Forbidden -- El object pedido está solo para administradores
+404 | Not Found -- El objeto especificado no fue encontrado
+405 | Method Not Allowed -- Intentaste acceder a un object con un metodo invalido
+406 | Not Acceptable -- Pediste un formato que no es JSON
+410 | Gone -- El objeto pedido ha sido removido de nuestros servidores
+418 | I'm a teapot
+429 | Too Many Requests -- Estás pidiendo demasiados datos! Despacio!
+500 | Internal Server Error -- Tuvimos un problema con nuestro servidor. Prueba más tarde.
+503 | Service Unavailable -- Estamos temporalmente offline por mantenimiento. Por favor prueba más tarde.
diff --git a/es/faq.md b/es/faq.md
new file mode 100644
index 0000000..a185d13
--- /dev/null
+++ b/es/faq.md
@@ -0,0 +1,76 @@
+### CÓMO COMENZAR:
+ 
+######Q: ¿Donde puedo inscribirme para tener una llave del API?
+A: En el [Vainglory API Developer Portal](https://developer.vainglorygame.com)
+ 
+######Q: Tengo mi llave del API, ¿qué debo hacer ahora?
+A: Para comenzar, échale un vistazo a la [Documentación](https://developer.vainglorygame.com/docs) donde puedes aprende a cómo usar el API.
+ 
+######Q: ¿Dónde está la documentación?
+A: La documentación esta [justo aquí](https://developer.vainglorygame.com/docs)
+ 
+######Q: ¿Cuán avanzado en desarrollo está el API?
+A: El API está actualmente en versión Alpha. El Alpha software puede ser inestable y tener algunos fallos y pérdidas de datos. El Alpha software puede no contener todas las funciones que están planeadas para la versión final
+ 
+######Q: Nunca programé nada antes y tengo una ligera idea, ¿Por donde debo empezar?
+A: Dirígete a nuestro servidor público de [Discord](https://discord.me/vaingloryapi) y escríbele a algunos programadores y diseñadores quienes ya hayan realizado una herramienta con el API. Muchos de ellos estarán contentos de ayudarte a comenzar tu proyecto.
+ 
+######Q: Cuando me inscribo, dice que me enliste en el Community Free Tier, ¿qué significa?
+A: El Community Free Tier te permite iniciar a desarrollar y probar tu aplicación/herramienta usando live data. Viene con un límite por defecto de 10 solicitudes por minuto que es adecuado para propósitos de prueba.
+ 
+######Q: Mi panel de mando dice que tengo un límite de 10 solicitudes por minuto. ¿Cómo puedo solicitar un límite más alto?
+A: El límite por defecto de solicitudes es de 10 por minuto para solo propósitos de pruebas/desarrolló. Una vez que estés listo para lanzar tu herramienta, puedes solicitar un límite más alto enviando un email a api@superevilmegacorp.com 
+ 
+######Q: ¿Qué debo hacer con la data que obtuve del API?
+A: Construir increíbles herramientas para ti mismo o para la comunidad. Puedes derivar la información que te guste de la data, pero no puedes rasguñar o almacenar toda la data del API. Para una lista de que es aceptable y que no, mira los [Terminos de Servicio](https://developer.vainglorygame.com/terms-of-service). 
+ 
+######Q: ¿Habrá cargos por usar el API?
+A: El API es gratis para usos no comerciales. Para licencias comerciales, envía un correo a api@superevilmegacorp.com
+ 
+######Q: ¿Cómo sé si necesito una licencia comercial?
+A: Si está haciendo cualquier de lo siguiente enlistado, necesitarás registro para una licencia comercial: colocando anuncios, cobrando para que accedan a tu herramienta, vendiendo data agregada, monetizando la data de cualquier manera. 
+ 
+######Q: ¿Qué puedo hacer con una licencia comercial?
+A: Con el API aún en Alpha, no estamos distribuyendo licencias comerciales todavía. Tendremos más información pronto. Mientras tanto, puedes ver los Términos de Servicio para saber cuál es el uso aceptable del API.
+ 
+######Q: ¿Cómo obtengo una licencia comercial?
+A: Con el API aún en Alpha, no estamos distribuyendo licencias comerciales todavía. Si tienes más preguntas, or quieres chatear un poco más sobre el tema, envía un correo a api@superevilmegacorp.com 
+ 
+######Q: If I have a question regarding the API, what do I do?  Si tengo una pregunta relacionada al API, ¿Qué debo hacer?
+A: Envia un correo a api@superevilmegacorp.com y entra en nuestro servidor de [Discord](https://discord.me/vaingloryapi).
+<br>
+### Desarrolló/Resolución de problemas:
+<br>
+######Q: La documentación parece estar mal, ¿Qué debo hacer?
+A: Con el API todavía en Alpha, es posible que los documentos no estén completamente actualizados. Estamos actualizando los documentos sobre la marcha. También puedes contribuir con los documentos en [Github](https://github.com/madglory/gamelocker-vainglory) si te gustaría hacer algunos cambios.
+ 
+######Q: Acabo de jugar un partido pero mis estadísticas no se muestran aún, ¿cuál es el problema?
+A: El API por defecto busca las partidas sobre las últimas 3 horas. Para encontrar una partida antes es de eso, debes especificar un Created-at time.
+ 
+######Q:¿Dónde puedo encontrar los recursos para usar mi proyecto?
+A: We are working on a way to have assets available to you directly from Vainglory. In the meantime, the community has put together some great resources for you in Estamos trabajando en una manera de tener los recursos disponibles para ti directamente desde Vainglory. Mientras tanto, la comunidad ha puesto juntos grandiosos recursos para ti en [Discord](https://discord.me/vaingloryapi). Puedes encontrarlos en los archivos anclados en #vaingloryapi-chat
+ 
+######Q: ¿A qué endpoints tengo acceso con el API?
+A: Revisa los [Documentos](https://developer.vainglorygame.com/docs)  
+<br>
+### Desafío Del API
+<br>
+######Q: ¿Como puedo entrar al desafío del API?
+A: El periodo de inscripción del Desafío del API 2017 termina el 26 de Marzo. Observa la [list of submissions](https://developer.vainglorygame.com/rules#results).
+ 
+######Q: ¿Cómo serán distribuidos los premios del Desafío del API a mí equipo?
+A: Puedes inscribirte al Desafío del API con cualquier tamaño no superior a cuatro. Todos los premios serán ajustado en base el número de mientras de tu equipo(hasta 4).
+ 
+######Q: ¿Qué características estarán disponible para el Desafío del API?
+A: Algunas características incluyen Telemetría, La mayor parte de ejemplo de la data.
+ 
+######Q: ¿Donde inscribo a mi equipo, o dejo saber que soy parte de un equipo?
+A: Para el Desafío del API, no necesitas decirnos en que equipo estas. Donde los equipos entren en la presentación de una porción del Desafío - cuando entregues tu proyecto, es cuando te preguntaremos de quien consiste tu equipo.
+ 
+######Q: Mi equipo está desarrollando una aplicación móvil, ¿Podemos enviar eso?
+A: Claro que pueden. Cuando envíes una aplicación móvil, solo necesitamos ver que funcione. Puedes correrla en un emulador, TestFlight, Etc. Si tienes una pregunta específica puedes hacerla llegar a nosotros a través de api@superevilmegacorp.com  
+<br>
+### Más allá del Alpha:
+<br>
+######Q: ¿Qué otras características podes esperar con el API?
+A: Constantemente buscamos de agregar nuevas características al API. En un futuro puedes esperar cosas como conectar cuentas, reservar partidas y mucho más. Si te gustaría ayudar con como se verá el API en un futuro,únete a la conversación en nuestro servidor público de [Discord](https://discord.me/vaingloryapi).
\ No newline at end of file
diff --git a/es/introduction.md b/es/introduction.md
new file mode 100644
index 0000000..963e629
--- /dev/null
+++ b/es/introduction.md
@@ -0,0 +1,29 @@
+# Vainglory Developer API Guide
+
+![](/assets/cover.png)
+
+La primera versión de servicio de data del juego Vainglory es un paso excitante hacia delante al hacer más fácil para los usuarios el tener un acceso abierto a data dentro del juego.
+
+Construye algo estupendo!
+
+Por el momento este servicio es una modalidad **Adelanto Alfa** . Puedes ver muestras de data, probar la interfaz y proveer feedback a nuestro equipo de desarrollo.
+
+Mientras inicialmente cogimos una aproximación diferente, basados en respuestas de la comunidad el servidor ahora intenta hacer cada intento de implementar las características necesarias de la especificación
+[JSON-API](http://jsonapi.org/)
+Donde ocurra una desviación, es probablemente involuntario y puede ser reportado a nuestro equipo en nuestro [Discord](https://discord.me/vaingloryapi).
+
+Nosotros mostramos muestras de enlaces de idioma usando CURL y planeamos añadir bibliotecas para Ruby, NodeJS, Java, Python y más. Son bienvenidas contribuciones de la comunidad y recompensadas con buen karma (y estilo!) Puedes ver muestras de código en el área negra de la derecha, y puedes cambiar el idioma programado de las muestras con las pestañas en la parte superior derecha.
+
+***
+
+Download a .pdf, .epub, or .mobi file from:
+
+https://www.gitbook.com/book/gamelocker/vainglory/details
+
+Contribute content, suggestions, and fixes via either:
+  * [https://www.gitbook.com/book/gamelocker/vainglory](https://www.gitbook.com/book/gamelocker/vainglory)
+  * [https://github.com/gamelocker/vainglory](https://github.com/gamelocker/vainglory)
+
+***
+
+<a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-nc-nd/4.0/88x31.png" /></a><br />This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/4.0/">Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License</a>
diff --git a/es/matches.md b/es/matches.md
new file mode 100644
index 0000000..37f5db6
--- /dev/null
+++ b/es/matches.md
@@ -0,0 +1,242 @@
+# Partidas
+ 
+Archivos de partidas son creados cada vez que un jugador completa una sesión de juego. Cada partida contiene información de alto nivel sobre cada sesión de juego, incluyendo información como duración, modo de juego, y más. Cada partida tiene dos listas.
+ 
+## Listas
+
+```json
+{
+  "type": "roster",
+  "id": "eca49808-d510-11e6-bf26-cec0c932ce01",
+  "attributes": {
+    "stats": {
+      "acesEarned": 2,
+      "gold": 32344,
+      "etc..."
+    }
+  },
+  "relationships": {
+    "team": {
+      "data": {
+        "type": "team",
+        "id": "753d464c-d511-11e6-bf26-cec0c932ce01"
+      }
+    },
+    "participants": {
+      "data": [
+        {
+          "type": "participant",
+          "id": "eca49a7e-d510-11e6-bf26-cec0c932ce01"
+        },
+        "etc..."
+      ]
+    }
+  }
+}
+```
+
+Listas siguen las puntuaciones de cada grupo opuesto de participantes. Si los jugadores entraron en matchmaking como un equipo, la lista tendrá un equipo relacionado. Listas tienen muchos objetos participantes, uno por cada miembro de la lista. Objetos lista sólo tienen significado dentro del contexto de una partida y no deben ser expuestos como un recurso aparte.
+
+## Participantes
+
+```json
+{
+  "type": "participant",
+  "id": "ea77c3a7-d44e-11e6-8f77-0242ac130004",
+  "attributes": {
+    "actor": "*Hero009*",
+    "stats": {
+      "assists": 4,
+      "crystalMineCaptures": 1,
+      "deaths": 2,
+      "farm": 49.25,
+      "etc..."
+    }
+  }
+}
+```
+Objetos participante siguen a cada miembro de una lista. Participantes pueden ser jugadores anónimos, jugadores registrados, o bots. En el caso donde el participante es un jugador registrado, el participante tendrá una relación de un solo jugador. 
+Objetos participante sólo tienen significado dentro del contexto de una partida y no deben ser expuestos como un recurso aparte.
+
+{% method %}
+## Consigue una colección de partidas
+
+Este endpoint devuelve datos de partidas. Bulk scraping partidas está prohibido.
+
+{% sample lang="shell" %}
+```shell
+curl -g "https://api.dc01.gamelockerapp.com/shards/na/matches?sort=createdAt&page[limit]=3&filter[createdAt-start]=2017-02-27T13:25:30Z&filter[playerNames]=<playerName>" \
+  -H "Authorization: Bearer <api-key>" \
+  -H "X-TITLE-ID: semc-vainglory" \
+  -H "Accept: application/vnd.api+json"
+```
+{% sample lang="java" %}
+```java
+//Hay una variedad de librerías Java HTTP que soportan parámetros de pregunta.
+```
+{% sample lang="python" %}
+```python
+import requests
+
+url = "https://api.dc01.gamelockerapp.com/shards/na/matches"
+
+header = {
+    "Authorization": "<api-key>",
+    "X-TITLE-ID": "semc-vainglory",
+    "Accept": "application/vnd.api+json"
+}
+
+query = {
+    "sort": "createdAt",
+    "filter[playerNames]": "<playerName>",
+    "filter[createdAt-start]": "2017-02-28T13:25:30Z",
+    "page[limit]": "3"
+}
+
+r = requests.get(url, headers=header, params=query)
+```
+{% sample lang="ruby" %}
+```ruby
+
+```
+{% sample lang="js" %}
+```javascript
+
+```
+{% sample lang="go" %}
+```go
+q := req.URL.Query()
+q.Add("sort", "createdAt")
+q.Add("filter[playerNames]", "<playerName>")
+q.Add("filter[createdAt-start]", "2017-02-27T13:25:30Z")
+q.Add("page[limit]", "3")
+req.URL.RawQuery = q.Encode()
+res, _ := client.Do(req)
+```
+{% common %}
+> El comando arriba devuelve JSON estructurado de la siguiente manera:
+
+```json
+{
+  "data": [
+    {
+      "type": "match",
+      "id": "02b90214-c64d-11e6-9f6b-062445d3d668",
+      "attributes": {
+        "createdAt": "2017-01-06T20:30:08Z",
+        "duration": 1482195372,
+        "gameMode": "casual",
+        "patchVersion": "1.0.0",
+        "region": "na",
+        "stats": "acesEarned: 3, etc..."
+      },
+      "relationships": {
+        "rosters": {
+          "data": [{
+            "type": "roster",
+            "id": "ea77c2eb-d44e-11e6-8f77-0242ac130004"
+          }, {
+            "type": "roster",
+            "id": "dc2c14b4-d50c-11e6-bf26-cec0c932ce01"
+          }]
+        }
+      }
+    }
+  ]
+}
+```
+{% endmethod %}
+
+### Petición HTTP
+
+`GET https://api.dc01.gamelockerapp.com/shards/na/matches`
+
+### Parámetros de pregunta
+ 
+Parámetro | Defecto | Descripción
+--------- | ------- | -----------
+page[offset] | 0 | Permite paginación sobre resultados
+page[limit] | 50 | El defecto (y máximo) es 50.  Valores menores que 50 y mayores 2 son soportados.
+sort | createdAt | Por defecto, partidas son ordenadas por creación de tiempo ascendente.
+filter[createdAt-start] | 3hrs ago | Debe ocurrir antes del fin del tiempo Formato es iso8601  Uso: filter[createdAt-start]=2017-01-01T08:25:30Z
+filter[createdAt-end] | Now | Preguntas buscan en las últimas tres horas. Formato es iso8601 es decir: filter[createdAt-end]=2017-01-01T13:25:30Z
+filter[playerNames] | none | Filtra con el  nombre de jugadores. Uso: filter[playerNames]=player1,player2,...
+filter[playerIds] | none | Filtra con el Id de jugadores. Uso: filter[playerIds]=playerId,playerId,...
+filter[teamNames] | none | Filtra con nombre de equipos. Nombres de equipos son lo mismo que los tags de equipo dentro del juego. Uso: filter[teamNames]=TSM,team2,...
+filter[gameMode] | none | filtra con modos de juego (gameMode). Uso: filter[gameMode]=casual,ranked,...
+
+**Recuerda** — una partida autentificada es una partida feliz!
+
+{% method %}
+## Consigue una sola partida
+
+Este endpoint recoge una partida especifica.
+
+{% sample lang="shell" %}
+```shell
+curl "https://api.dc01.gamelockerapp.com/shards/na/matches/<matchID>" \
+  -H "Authorization: Bearer <api-key>" \
+  -H "X-TITLE-ID: semc-vainglory" \
+  -H "Accept: application/vnd.api+json"
+```
+{% sample lang="java" %}
+```java
+//Hay una variedad de librerías Java HTTP que soportan parámetros URL
+```
+{% sample lang="python" %}
+```python
+
+```
+{% sample lang="ruby" %}
+```ruby
+
+```
+{% sample lang="js" %}
+```javascript
+
+```
+{% sample lang="go" %}
+```go
+
+```
+{% common %}
+> El comando arriba devuelve JSON estructurado de la siguiente manera:
+ 
+```json
+{
+  "data": {
+    "type": "match",
+    "id": "02b90214-c64d-11e6-9f6b-062445d3d668",
+    "attributes": {
+      "createdAt": "2017-01-06T20:30:08Z",
+      "duration": 1482195372,
+      "gameMode": "casual",
+      "patchVersion": "1.0.0",
+      "region": "na",
+      "stats": "acesEarned: 3, etc..."
+    },
+    "relationships": {
+      "rosters": {
+        "data": [{
+          "type": "roster",
+          "id": "ea77c2eb-d44e-11e6-8f77-0242ac130004"
+        }, {
+          "type": "roster",
+          "id": "dc2c14b4-d50c-11e6-bf26-cec0c932ce01"
+        }]
+      }
+    }
+  }
+}
+```
+{% endmethod %}
+
+### Petición HTTP
+ 
+`GET https://api.dc01.gamelockerapp.com/shards/na/matches/<ID>`
+ 
+### Parámetros URL
+ 
+Parámetro | Descripción
+--------- | -----------
+ID | El ID de la partida a recoger
\ No newline at end of file
diff --git a/es/matchesJSON.md b/es/matchesJSON.md
new file mode 100644
index 0000000..c5e4468
--- /dev/null
+++ b/es/matchesJSON.md
@@ -0,0 +1,127 @@
+# ***Resumen de datos de partidas***
+
+Muchas gracias a Kashz por ayudar a crear esto! GitHub: iAm-Kashif
+
+## **Objeto de partida**
+
+| Variable | Tipo | Descripción |
+| :---: | :---: | :---: |
+| type | str | Partida |
+| id | str | ID de partida |
+| createdAt | str (iso8601) | Tiempo de la partida jugada |
+| duration | int | Tiempo de la partida en segundos |
+| gameMode | str | Modo de juego |
+| patchVersion | str | Versión del API |
+| region | str | Región de la partida |
+| stats | map | Vea [Match.stats](#1) |
+| assets | obj | Vea [Match.assets](#2)  |
+| rosters | obj | Vea [Rosters](#3) |
+
+
+### <a name="1"></a> **Match.stats** **(Estatísticas de fin de la partida)**
+
+| Variable | Tipo | Descripción |
+| :---: | :---: |:---: |
+| endGameReason | str | "Victory" o "Defeat" |
+| queue | str | Modo de juego |
+
+### <a name="2"></a> **Match.assets** **(Datos de telemetría)**
+
+| Variable | Type | Descripción |
+| :---: | :---: |:---: |
+| type | string | Activo |
+| createdAt | str (iso8601) | Tiempo de la creación de telemetría
+| description | str | "" |
+| filename | str | telemetry.json |
+| id | str | ID del activo |
+| contentType | str | application/json |
+| name | str | telemetría |
+| url | str | Archivo de Enlaces de Telemetry.json |
+
+## <a name="3"></a> **Objeto listas**
+
+| Variable | Tipo| Descripción |
+| :---: | :---: | :---: |
+| id | str | ID de lista |
+| type | str | Lista
+| participants | obj | Vea [Participants](#4) |
+| stats | obj | Vea [Rosters.stats](#5) |
+| team | obj | Vea [Rosters.team](#6) |
+
+### <a name="5"></a>**Rosters.stats**
+
+| Variable | Type |
+| :---: | :---: |
+| acesEarned | int |
+| gold | int |
+| heroKills | int |
+| krakenCaptures | int |
+| side | O "right/red" o "left/blue" |
+| turretKills | int |
+| turretRemaining | int |
+
+### <a name="6"></a>**Rosters.team**
+| Variable | Tipo | Descripción 
+| :---: | :---: | :---: |
+| id | str | ID del equipo o nada|
+| name | str | Nombre de equipo o nada |
+| type | str | Equipo |
+
+## <a name="4"></a>**Participante Objeto**
+
+| Variable | Tipo | Descripción |
+| :---: | :---: | :---: |
+| actor | str | Hero |
+| id | str | Mismo al ID de la lista|
+| player | obj |Vea [Participants.player](#7)|
+| stats | map |Vea [Participants.stats](#8) |
+| type | str | Participantes |
+
+### <a name="7"></a>**Participants.player**
+
+| Variable | Tipo |Descripción |
+| :---: | :---: | :---: |
+| id | str | UID de jugador |
+| name | str | IGN de jugador |
+| stats | map | Vea [Participants.player.stats](#9) |
+| type | str | jugador |
+
+### <a name="8"></a>**Participants.stats**
+
+| Variable |Tipo |
+| :---: | :---: |
+| assists | int |
+| crystalMineCaptures | int |
+| deaths | int |
+| farm | int |
+| firstAfkTime | int: -1 para no AFK |
+| goldMineCaptures | int |
+| itemGrants | mapa de {itemsBought : int} |
+| itemSells | mapa de {itemsSold : int} |
+| itemUses | mapa de {itemsUsed : int} |
+| items | lista de la build final (Len: 6) |
+| jungleKills | int |
+| karmaLevel | int |
+| kills | int |
+| krakenCaptures | int |
+| level | int |
+| minionKills | int |
+| nonJungleMinionKills | int |
+| skillTier | int |
+| skinKey | str |
+| turretCaptures | int |
+| wentAfk | bool |
+| winner | bool |
+
+### <a name="9"></a> **Participants.player.stats**
+
+| Variable | Type | 
+| :---: | :---: | 
+| level | int |
+| lifetimeGold | float |
+| lossStreak | int |
+| played | int |
+| played\_ranked | int |
+| winStreak | int |
+| wins | int |
+| xp | int |
\ No newline at end of file
diff --git a/es/plans.md b/es/plans.md
new file mode 100644
index 0000000..1472ca6
--- /dev/null
+++ b/es/plans.md
@@ -0,0 +1,22 @@
+# Rate Limits
+
+The API is free for non-commercial use with a default rate limit of 10 requests per minute.  If you need a higher limit, please contact api@superevilmegacorp.com and we'll hook you up!  
+
+# Usage Tiers
+
+We do our best to give out timely and accurate data so that we can work together to create awesome experiences for our players.  We classify projects into three categories.
+
+## Hobby Tier
+When you create a new API key, you're automatically placed into this tier.  This tier is intended to support non-commercial projects, SDKs, hackathons, and any projects that don't require a higher rate limit.
+
+The default rate limit is 10 requests per minute, and there is no access to data from the public beta environment.
+
+## Community Tier
+This tier is intended to be used by small commercial projects projects (those that derive revenue from ads, subscriptions, and more).  Access is still free, but we require that these projects share data with us about the way players use the project.  We use this to make sure we deliver the best possible experience for both your project and the players that use it.  This data is not shared with any other users of the API.  
+
+Rate limits in this tier are customized to the project, and we allow select community projects access to the public beta environment.
+
+## Commercial Tier
+This tier is intended to be used by large commercial projects projects (those that derive revenue from ads, subscriptions, and more).  Commercial project need high-volume low-cost access to data.  While the data provided is exactly the same as that provided to hobby and community tiers, commercial have additional options for accessing it.  In addition, there is no requirement to share data about how data is used.  
+
+Rate limits in this tier are customized to the project, and we allow select community projects access to the public beta environment.  Commercial users also get bulk access, increased webhook limits, statistical samples, and more.
diff --git a/es/players.md b/es/players.md
new file mode 100644
index 0000000..1f10d75
--- /dev/null
+++ b/es/players.md
@@ -0,0 +1,114 @@
+# Jugadores
+ 
+Objetos jugador contienen información agregada de cada jugador desde su creación. En este momento jugadores son bastante escasos, pero hay planes de añadir más datos cuando se vuelva posible.
+
+{% method %}
+## Conseguir un solo jugador
+
+Este endpoint devuelve a un jugador específico.
+
+**Vienen Cambios!** - Recursos jugador no están completamente definidos aún, pero son incluidos para que consumidores consigan información básica (nombre, etc.) Este objeto tendrá datos adicionales añadidos en los siguientes meses, y puede cambiar un poco cuando datos se mueven desde el objeto `attributes.stats` al objeto principal `attributes`.
+
+{% sample lang="shell" %}
+```shell
+curl "https://api.dc01.gamelockerapp.com/shards/na/players/<ID>" \
+  -H "Authorization: Bearer <api-key>" \
+  -H "X-TITLE-ID: semc-vainglory" \
+  -H "Accept: application/vnd.api+json"
+```
+{% sample lang="java" %}
+```java
+//Hay una variedad de librerías Java HTTP que soportan query-parameters.
+
+```
+{% sample lang="python" %}
+```python
+
+```
+{% sample lang="ruby" %}
+```ruby
+
+```
+{% sample lang="js" %}
+```javascript
+
+```
+{% sample lang="go" %}
+```go
+
+```
+{% common %}
+> El comando arriba devuelve JSON estructurado de esta manera:
+
+```json
+{
+"data": {
+  "attributes": {
+      "stats": {
+          "lossStreak": 1,
+          "winStreak": 0,
+          "lifetimeGold": 10536.0
+      },
+      "name": "boombastic04"
+  },
+  "type": "player",
+  "id": "6abb30de-7cb8-11e4-8bd3-06eb725f8a76"
+}
+}
+```
+{% endmethod %}
+
+### Petición HTTP
+
+`GET https://api.dc01.gamelockerapp.com/shards/na/players/<ID>`
+ 
+### Parámetros URL 
+ 
+Parámetro | Descripción
+--------- | -----------
+ID | La ID del jugador que se recoge
+
+{% method %}
+## Consigue Un Grupo De Jugadores
+ 
+Este endpoint recoge un grupo de hasta 6 jugadores, filtrados por nombre. Nombres de jugador son específicos a cada región. Si un jugador ha cambiado de nombre es posible que haya varios ID para un solo nombre de jugador.
+
+{% sample lang="shell" %}
+```shell
+curl "https://api.dc01.gamelockerapp.com/shards/na/players?filter[playerNames]=player1,player2" \
+  -H "Authorization: Bearer <api-key>" \
+  -H "X-TITLE-ID: semc-vainglory" \
+  -H "Accept: application/vnd.api+json"
+```
+{% sample lang="java" %}
+```java
+//Hay una variedad de librerías Java HTTP que soportan query-parameters.
+
+```
+{% sample lang="python" %}
+```python
+
+```
+{% sample lang="ruby" %}
+```ruby
+
+```
+{% sample lang="js" %}
+```javascript
+
+```
+{% sample lang="go" %}
+```go
+
+```
+{% endmethod %}
+
+### Solicitud HTTP
+ 
+`GET https://api.dc01.gamelockerapp.com/shards/na/players`
+
+### Query Parameters
+
+Parámetro | Por Defecto | Descripción
+--------- | ------- | -----------
+filter[playerNames] | ninguno | Filtros por nombre de jugador. Uso: filter[playerNames]=player1,player2
\ No newline at end of file
diff --git a/es/requests.md b/es/requests.md
new file mode 100644
index 0000000..55da322
--- /dev/null
+++ b/es/requests.md
@@ -0,0 +1,217 @@
+# Haciendo solicitudes
+ 
+## Negociación de contenido
+ 
+Clientes utilizando el api deberían especificar que aceptan respuestas utilizando el formato
+`application/vnd.api+json`, por conveniencia también aceptamos 
+`application/json`
+porque está por defecto en muchas librerías de cliente populares.
+ 
+El servidor responderá con una cabecera `Content-Type` que imita el formato solicitado por el cliente.
+
+{% method %}
+## Regiones
+
+El Servicio de Datos de Juego de Vainglory actualmente soporta las siguientes regiones:
+
+{% common %}
+> Para especificar las regiones, utiliza este código:
+
+{% sample lang="shell" %}
+```shell
+"...gamelockerapp.com/shards/<region>/..."
+```
+{% sample lang="java" %}
+```java
+"...gamelockerapp.com/shards/<region>/..."
+```
+{% sample lang="python" %}
+```python
+"...gamelockerapp.com/shards/<region>/..."
+```
+{% sample lang="ruby" %}
+```ruby
+"...gamelockerapp.com/shards/<region>/..."
+```
+{% sample lang="js" %}
+```javascript
+"...gamelockerapp.com/shards/<region>/..."
+```
+{% sample lang="go" %}
+```go
+"...gamelockerapp.com/shards/<region>/..."
+```
+{% endmethod %}
+
+***Shards de regiones generales***
+
+Para encontrar datos respecto a servidores live, por favor utiliza los siguientes shards.
+
+* **América del Norte:** ```na```
+* **Europa:** ```eu```
+* **Suramérica:** ```sa```
+* **Asia Este:** ```ea```
+* **Asia Sureste (SEA):** ```sg```
+
+***Shards de regiones de torneo***
+ 
+Para encontrar datos respecto a eSports profesionales, los cuales solo pasan en clientes privados, utiliza los siguientes shards.
+ 
+* **Torneos de América del Norte:** 
+* **Torneos de Europa:** 
+* **Torneos de Suramérica:** `
+* **Torneos de Asia Este:** 
+* **Torneos de Asia Sureste:** 
+ 
+**Elegir una región específica es actualmente necesario**
+
+{% method %}
+## GZIP
+
+Clientes pueden especificar la cabecera `Accept-Encoding: gzip` y el servidor compresa respuestas
+Respuestas serán devueltas con `Content-Encoding: gzip`.
+ 
+Dada la grandeza de partidas, esto puede tener mejoras en rendimiento significantes.
+
+{% common %}
+> Para especificar la cabecera Accept-Encoding, utiliza este código:
+
+{% sample lang="shell" %}
+```shell
+-H "Accept-Encoding: gzip"
+```
+{% sample lang="java" %}
+```java
+conn.setRequestProperty("Accept-Encoding","gzip");
+
+```
+{% sample lang="python" %}
+```python
+header = {"Accept-Encoding":"gzip"}
+```
+{% sample lang="ruby" %}
+```ruby
+```
+{% sample lang="js" %}
+```javascript
+```
+{% sample lang="go" %}
+```go
+req.Header.Set("Accept-Encoding", "gzip")
+```
+{% endmethod %}
+ 
+## Paginación
+
+Donde aplicable, el servidor permite peticiones de limitar el número de resultados via paginación. Para paginar los datos primarios, da información de paginación a la parte de preguntas de la petición utilizando el límite y parámetros offset.
+Para conseguir items 2 hasta 10 tendrias que especificar un límite de 8 y un offset de 2:
+Si no es especificada, el servidor en partidas pondrá por defecto `limit=5` y `offset=0`, y para jugadores/muestras `limit=50` y `offset=0`
+ 
+**Importante** - Actualmente el servidor no permite más de 50 objetos de datos primarios.
+
+{% method %}
+## Sortear
+
+El orden de sorteo por defecto siempre es ascendiendo. Ascendiendo corresponde a el orden estándar para número de números y letras, es decir, A hasta Z, 0 a 9). Para datos y tiempos, ascendiendo significa que valores anteriores preceden valores posteriores es decir 1/1/2000 estará antes de 1/1/2001.
+ 
+Todas las colecciones de recursos tienen una orden de sorteo que está por defecto. Además, algunos recursos dan la habilidad de sortear acordando a una o más criterios ("sort fields").
+ 
+Si los campos de sorteo (sort fields) están prefixed con un símbolo de menos, el orden será cambiado a descendiente.
+
+{% common %}
+>El ejemplo debajo devolverá los artículos más antiguos primero:
+
+{% sample lang="shell" %}
+```shell
+".../matches?sort=createdAt"
+```
+{% sample lang="java" %}
+```java
+".../matches?sort=createdAt"
+```
+{% sample lang="python" %}
+```python
+".../matches?sort=createdAt"
+```
+{% sample lang="ruby" %}
+```ruby
+".../matches?sort=createdAt"
+```
+{% sample lang="js" %}
+```javascript
+".../matches?sort=createdAt"
+```
+{% sample lang="go" %}
+```go
+".../matches?sort=createdAt"
+```
+{% common %}
+>Los ejemplos debajo devolverá los artículos más nuevos primero.
+
+{% sample lang="shell" %}
+```shell
+".../matches?sort=-createdAt"
+```
+{% sample lang="java" %}
+```java
+".../matches?sort=-createdAt"
+```
+{% sample lang="python" %}
+```python
+".../matches?sort=-createdAt"
+```
+{% sample lang="ruby" %}
+```ruby
+".../matches?sort=-createdAt"
+```
+{% sample lang="js" %}
+```javascript
+".../matches?sort=-createdAt"
+```
+{% sample lang="go" %}
+```go
+".../matches?sort=-createdAt"
+```
+{% endmethod %}
+
+{% method %}
+## JSON-P Callbacks
+
+Puedes enviar un parámetro ?callback para cualquier llamada GET para tener los resultados envueltos en una función JSON. Esto es utilizado típicamente cuando navegadores quieren empotrar contenido en páginas web mediante pasarse problemas cross domain. La respuesta include la misma salida de datos que el API regular, más la información de la cabecera HTTP relevante. 
+
+{% sample lang="shell" %}
+```shell
+curl -g "https://api.dc01.gamelockerapp.com/status?callback=foo"
+```
+
+{% endmethod %}
+
+{% method %}
+## Cross Origin Resource Sharing
+
+El API soporta Cross Origin Resource Sharing (CORS) para peticiones AJAX de cualquier origen.
+Puedes leer el CORS W3C Recommendation, o esta introducción del HTML 5 Security Guide.
+ 
+Aquí hay una muestra de una petición enviada desde un navegador dándole a http://example.com:
+
+{% sample lang="shell" %}
+
+```shell
+curl -i https://api.dc01.gamelockerapp.com/status -H "Origin: http://example.com"
+  HTTP/1.1 200 OK
+  ...
+  Access-Control-Allow-Origin: *
+  Access-Control-Expose-Headers: Content-Length
+```
+This is what the CORS preflight request looks like:
+
+```shell
+curl -i https://api.dc01.gamelockerapp.com/status -H "Origin: http://example.com" -X OPTIONS
+  HTTP/1.1 200 OK
+  ...
+  Access-Control-Allow-Headers: Origin,X-Title-Id,Authorization
+  Access-Control-Allow-Methods: GET,POST,OPTIONS
+  Access-Control-Allow-Origin: *
+  Access-Control-Max-Age: 86400
+```
+{% endmethod %}
diff --git a/es/responses.md b/es/responses.md
new file mode 100644
index 0000000..73dd3b8
--- /dev/null
+++ b/es/responses.md
@@ -0,0 +1,67 @@
+# Recibiendo Respuestas
+ 
+## Payload
+
+Todas las respuestas de servidor contienen un objeto raíz JSON.  
+
+~~~.language-json
+{
+  "data": {
+    "type": "match",
+    "id": "skarn",
+    "attributes": {
+      // ... this matches attributes
+    },
+    "relationships": {
+      // ... this matches relationships
+    }
+  }
+}
+~~~
+
+~~~.language-json
+{
+  "data": {
+    "type": "match",
+    "id": "1"
+  }
+}
+~~~
+
+Una respuesta contendrá al menos uno de los siguientes miembros top-level:
+ 
+  * `data`: los “datos primarios” de la respuesta
+  * `errors`: una colección de objetos error
+ 
+Una respuesta puede contener cualquiera de estos miembros top-level:
+ 
+  * `links`: un objeto enlace relacionado a los datos primarios.
+  * `included`: Una colección de objetos recurso que están relacionados a los datos primarios y/o entre sí (“included resources”).
+
+Si un documento no contiene una llave de datos top-level, el miembro incluido no estará presente tampoco.
+ 
+Datos primarios serán uno de los siguientes:
+ 
+  * Un único [resource object][resource objects], Un único [resource identifier object], o `null`
+  * Una colección de [resource objects], una colección de [resource identifier objects][resource identifier object],o una colección vacía (`[]`)
+ 
+Por ejemplo, los siguientes datos primarios son un único objeto recurso (single resource object):
+
+Los siguientes datos primarios son un único [resource identifier object] que refiere al mismo recurso:
+ 
+Un grupo de recursos lógico siempre será representada como una colección, incluso si solo contiene un item o si está vacío.
+ 
+## Límites De Ratio
+>Las cabeceras de límite de ratio son definidas de la siguiente manera:
+
+~~~
+X-RateLimit-Limit - Límite de peticiones por día / minuto 
+X-RateLimit-Remaining - El número de peticiones que quedan en ese periodo de tiempo
+X-RateLimit-Reset - El tiempo que queda antes que se rellene el límite de ratio en época UTC nanosegundos.
+* Tokens de límite son incrementalmente llenados por 60(seg)/ límite de ratio. ejemplo: 60(seg)/10(ratio) consigue un token de ratio cada 6 segundos hasta llegar al límite de ratio máximo.    
+~~~
+Se bueno. Si envías demasiadas peticiones demasiado rápido, enviaremos un código de error `429` (servidor no disponible).
+ 
+<aside class="notice">
+Gratis para uso no comercial para un máximo de 10 peticiones por minuto! Para incrementar tu límite, por favor contacta api@superevilmegacorp.com
+</aside>
\ No newline at end of file
diff --git a/es/samples.md b/es/samples.md
new file mode 100644
index 0000000..eca6e46
--- /dev/null
+++ b/es/samples.md
@@ -0,0 +1,73 @@
+# Muestras
+
+El endpoint de ejemplos da una manera fácil de acceder lotes de datos aleatorios de partidas cada hora para agregar estadísticas.
+
+{% method %}
+## Conseguir una colección de muestras
+
+Este endpoint recoge una colección de partidas seleccionadas aleatoriamente. 
+
+{% sample lang="shell" %}
+```shell
+curl "https://api.dc01.gamelockerapp.com/shards/na/samples" \
+  -H "Authorization: Bearer <api-key>" \
+  -H "X-TITLE-ID: semc-vainglory" \
+  -H "Accept: application/vnd.api+json"
+```
+{% sample lang="java" %}
+```java
+//Hay una variedad de librerías Java HTTP que soportan parámetros de pregunta.
+```
+{% sample lang="python" %}
+```python
+
+```
+{% sample lang="ruby" %}
+```ruby
+
+```
+{% sample lang="js" %}
+```javascript
+
+```
+{% sample lang="go" %}
+```go
+
+```
+{% common %}
+> El comando arriba devuelve JSON estructurado de esta manera:
+
+```json
+{
+      "type": "sample",
+      "id": "sample-na-2017-02-28T07:15:30Z",
+      "attributes": {
+        "URL": "URL of Sample Matches",
+        "createdAt": "2017-02-28T07:15:30Z",
+        "shardId": "na",
+        "t0": "2017-02-28T07:15:30Z",
+        "t1": "2017-02-28T08:15:30Z",
+        "titleId": "semc-vainglory"
+      },
+      "relationships": {
+        "assets": {
+          "data": []
+        }
+      }
+    }
+```
+{% endmethod %}
+
+### Petición HTTP
+
+`GET https://api.dc01.gamelockerapp.com/shards/na/samples`
+ 
+### Parámetros de pregunta
+ 
+Parámetro | Defecto | Descripción |
+--------- | ------- | -----------   
+page[offset] | 0 | Permite paginación sobre resultados 
+page[limit] | 50 | El defecto (y el máximo) es 50. Valores menores que 50 y mayores 2 son soportados.
+sort | createdAt | Por defecto, muestras son sorteados por tiempo de creación ascendiente. 
+filter[createdAt-Start] | none | Debe ocurrir antes del tiempo. El formato es iso8601 Uso: filter[createdAt-end]=2017-01-01T08:25:30Z
+filter[createdAt-End] | none | Debe ocurrir antes del tiempo. El formato es iso8601 Uso: filter[createdAt-end]=2017-01-01T13:25:30Z
\ No newline at end of file
diff --git a/es/sdks.md b/es/sdks.md
new file mode 100644
index 0000000..33bd66a
--- /dev/null
+++ b/es/sdks.md
@@ -0,0 +1,31 @@
+# SDK De La Comunidad
+ 
+Contribuciones de la comunidad son bienvenidos y recompensados con buen karma (y mucho swag!) Si estás trabajando con un API, déjanos saber en el servidor de Discord y añadiremos un enlace! 
+ 
+##Java
+ 
+Una adaptación Java del API de Vainglory - [DominicGunn/flicker](http://github.com/DominicGunn/flicker)
+ 
+##Python
+ 
+Python 3 wrapper para el Gamelocker API - [schneefux/python-gamelocker](http://github.com/schneefux/python-gamelocker)
+ 
+Python 3 wrapper para el Gamelocker API - [ClarkThyLord/madglory-ezl](https://github.com/ClarkThyLord/madglory-ezl)
+ 
+##JavaScript
+ 
+Un cliente JavaScript API - [seripap/vainglory](https://github.com/seripap/vainglory)
+ 
+##R
+ 
+Un proyecto dando clases de R6 (para el lenguaje R) para acceder el API - [nathancarter/rvgapi](https://github.com/nathancarter/rvgapi)
+ 
+##Go
+ 
+Una prueba de un concepto de cliente go para el Vainglory Developer API - [madglory/vainglory-go-client](https://github.com/madglory/vainglory-go-client)
+ 
+##Ruby
+ 
+Un Ruby gem wrapper para el Vainglory Developer API -
+[Ruby Gem](https://rubygems.org/gems/vainglory-api) | 
+[Github](https://github.com/cbortz/vainglory-api-ruby)
\ No newline at end of file
diff --git a/es/teams.md b/es/teams.md
new file mode 100644
index 0000000..e846402
--- /dev/null
+++ b/es/teams.md
@@ -0,0 +1,77 @@
+# Equipos (Disponible pronto!)
+ 
+Objetos equipo contienen información agregada durante la existencia de cada equipo.
+
+Este endpoint recoge una colección de hasta 6 equipos.
+
+<aside class="warning">
+Importante - Recursos de equipo aún no están disponibles en el API..
+</aside>
+
+{% method %}
+## Conseguir una colección de equipos 
+
+{% sample lang="shell" %}
+```shell
+curl "https://api.dc01.gamelockerapp.com/shards/na/teams?filter[teamNames]=team1" \
+  -H "Authorization: Bearer <api-key>" \
+  -H "X-TITLE-ID: semc-vainglory" \
+  -H "Accept: application/vnd.api+json"
+```
+{% endmethod %}
+
+### Petición HTTP
+
+`GET https://api.dc01.gamelockerapp.com/teams`
+ 
+### Parámetros de pregunta
+ 
+Parámetro | Defecto | Descripción
+--------- | ------- | -----------
+filter[teamNames] | none | Flirta por nombre del equipo. Uso: filter[teamNames]=team1
+filter[teamIds] | none | Filtra por id del equipo. Uso: filter[teamIds]=12345
+
+<aside class="success">
+Recuerda — un equipo autentificado es un equipo feliz!
+</aside>
+
+{% method %}
+## Conseguir un Solo Equipo
+
+Este endpoint devuelve un equipo específico.
+
+{% sample lang="shell" %}
+```shell
+curl "https://api.dc01.gamelockerapp.com/teams/<ID>" \
+  -H "Authorization: Bearer <api-key>" \
+  -H "X-TITLE-ID: semc-vainglory" \
+  -H "Accept: application/vnd.api+json"
+```
+{% sample lang="python" %}
+```python
+
+```
+{% common %}
+> El comando arriba devuelve JSON estructurado de esta manera:
+
+```json
+{
+  "id": 2,
+  "name": "Max",
+  "breed": "unknown",
+  "fluffiness": 5,
+  "cuteness": 10
+}
+```
+
+{% endmethod %}
+
+### Petición HTTP
+
+`GET https://api.dc01.gamelockerapp.com/teams/<ID>`
+ 
+### Parámetros URL
+ 
+Parámetro | Descripción
+--------- | -----------
+ID | El ID del equipo a recoger
diff --git a/es/telemetry.md b/es/telemetry.md
new file mode 100644
index 0000000..52b6a6a
--- /dev/null
+++ b/es/telemetry.md
@@ -0,0 +1,440 @@
+# Telemetría
+
+La telemetría nos da puntos de vista a la partida. Nos da detalles de varios eventos que ocurrieron en la partida y donde ocurrieron. Algunos de los eventos también tienen una localización que pueden ser puestos en el mapa de juego
+de Vainglory. Telemetría es muy útil para generar una vidualización de una línea de tiempo de cómo fue la partida para replays, o crear mapas de calor de donde un héroe o habilidad en especial es lo más útil. Estos son solo algunos ejemplos de dónde se puede utilizar telemetría.
+
+
+> Conseguirás datos de telemetría como parte del endpoint de la partida.
+
+> Y un mapa del Halcyon Fold [aquí!](https://cdn.discordapp.com/attachments/272249149473161216/284388441674874880/vainglory-map.png)
+
+{% method %}
+## Para conseguir datos de telemetría
+ 
+Empiezas consiguiendo una lista de partidas utilizando el endpoint de partidas. 
+
+La petición HTTP para conseguir partidas es
+`GET https://api.dc01.gamelockerapp.com/shards/na/matches`
+
+{% sample lang="shell" %}
+```shell
+curl "https://api.dc01.gamelockerapp.com/shards/na/matches" \
+  -H "Authorization: Bearer <api-key>" \
+  -H "X-TITLE-ID: semc-vainglory" \
+  -H "Accept: application/vnd.api+json"
+```
+{% sample lang="java" %}
+```java
+//Hay una variedad de librerías Java HTTP que soportan parámetros de pregunta.
+```
+{% sample lang="python" %}
+```python
+
+```
+{% sample lang="ruby" %}
+```ruby
+
+```
+{% sample lang="js" %}
+```javascript
+
+```
+{% sample lang="go" %}
+```go
+
+```
+{% common %}
+> El comando arriba devuelve JSON estructurado de la siguiente manera:
+
+```json
+  "data": [
+    {
+      "type": "match",
+      "id": "f5373c40-0aa9-11e7-bcff-0667892d829e",
+      "attributes": {
+        "createdAt": "2017-03-17T00:38:00Z",
+        "duration": 259,
+        "gameMode": "blitz_pvp_ranked",
+        "patchVersion": "",
+        "shardId": "na",
+        "stats": {
+          "endGameReason": "victory",
+          "queue": "blitz_pvp_ranked"
+        },
+        "titleId": "semc-vainglory"
+      },
+      "relationships": {
+        "assets": {
+          "data": [
+            {
+              "type": "asset",
+              "id": "b900c179-0aaa-11e7-bb12-0242ac110005"
+            }
+          ]
+        },
+        "rosters": {
+          "data": [
+            {
+              "type": "roster",
+              "id": "b8f6640a-0aaa-11e7-bb12-0242ac110005"
+            },
+            {
+              "type": "roster",
+              "id": "b8f65271-0aaa-11e7-bb12-0242ac110005"
+            }
+          ]
+        },
+        "rounds": {
+          "data": []
+        }
+      }
+    }, 
+ ```
+
+
+> Tienes que buscar el nodo que lleva a telemetría. You need to look for Assets JSON node which points to telemetry. Busca por los siguientes en la respuesta:
+
+```json
+      "relationships": {
+        "assets": {
+          "data": [
+            {
+              "type": "asset",
+              "id": "b900c179-0aaa-11e7-bb12-0242ac110005"
+            }
+          ]
+        },
+```
+
+> Cuando hayas encontrado esta ID, ahora tienes que buscar por el siguiente segmento JSON en el objeto respuesta. El siguiente objeto respuesta te dará un enlace a los datos de telemetría.
+
+```json
+    {
+      "type": "asset",
+      "id": "b900c179-0aaa-11e7-bb12-0242ac110005",
+      "attributes": {
+        "URL": "https://gl-prod-us-east-1.s3.amazonaws.com/assets/semc-vainglory/na/2017/03/17/00/43/b900c179-0aaa-11e7-bb12-0242ac110005-telemetry.json",
+        "contentType": "application/json",
+        "createdAt": "2017-03-17T00:43:22Z",
+        "description": "",
+        "filename": "telemetry.json",
+        "name": "telemetry"
+      }
+    },
+```
+
+> Puedes descargar los datos con los siguientes comandos. Por favor ten en cuenta que **no debes** tener la Llave API para conseguir esta información.
+
+{% endmethod %}
+
+{% method %}
+
+{% sample lang="shell" %}
+```shell
+curl "https://gl-prod-us-east-1.s3.amazonaws.com/assets/semc-vainglory/na/2017/03/17/00/43/b900c179-0aaa-11e7-bb12-0242ac110005-telemetry.json" \
+  -H "X-TITLE-ID: semc-vainglory" \
+  -H "Accept: application/vnd.api+json"
+```
+{% sample lang="java" %}
+```java
+//Hay una variedad de librerías Java HTTP que soportan parámetros de pregunta.
+```
+{% sample lang="python" %}
+```python
+
+```
+{% sample lang="ruby" %}
+```ruby
+
+```
+{% sample lang="js" %}
+```javascript
+
+```
+{% sample lang="go" %}
+```go
+
+```
+{% common %}
+> Esta petición devolverá una respuesta de la siguiente manera:
+
+```json  
+   { "time": "2017-02-18T06:37:15+0000",
+     "type": "DealDamage",
+     "payload": {
+       "Team": "Left",
+       "Actor": "*Ringo*",
+       "Target": "*Turret*",
+       "Source": "Unknown",
+       "Damage": 405,
+       "Delt":  613,
+       "IsHero": 1,
+       "TargetIsHero": 0 
+     }
+   }
+```
+{% endmethod %}
+
+## Diccionario de Datos de Eventos
+Datos de telemetría está clasificada en varios eventos de interés. Lo siguiente es una lista de cada tipo de evento con un ejemplo.
+
+### PlayerFirstSpawn
+Al principio de la partida cuando aparecen los jugadores.
+
+
+```json
+  {
+    "time": "2017-03-17T00:38:32+0000",
+    "type": "PlayerFirstSpawn",
+    "payload": {
+      "Team": "Right",
+      "Actor": "*Alpha*"
+    }
+  }
+```
+
+### LevelUp
+Cuando un jugador gana un nivel en el juego. En modos de juego Partida rápida, encontrarás 9 eventos en exactamente el mismo tiempo. 
+
+
+```json
+  {
+    "time": "2017-03-17T00:38:32+0000",
+    "type": "LevelUp",
+    "payload": {
+      "Team": "Right",
+      "Actor": "*Alpha*",
+      "Level": 1,
+      "LifetimeGold": 0
+    }
+  }
+```
+
+### BuyItem
+Cuando un jugador compra un ítem.
+
+
+```json
+  {
+    "time": "2017-03-17T00:38:45+0000",
+    "type": "BuyItem",
+    "payload": {
+      "Team": "Left",
+      "Actor": "*Vox*",
+      "Item": "Breaking Point",
+      "Cost": 2600
+    }
+  }
+```
+
+### SellItem
+Cuando un jugador vende un ítem.
+
+```json
+  {
+    "time": "2017-03-31T02:49:37+0000",
+    "type": "SellItem",
+    "payload": {
+      "Team": "Left",
+      "Actor": "*Lyra*",
+      "Item": "Flare",
+      "Cost": 15
+    }
+  }
+```
+
+### LearnAbility
+Cuando un jugador pone un punto a uno de las habilidades. Por favor ten en cuenta que puede haber una diferencia de tiempo entre que un jugador gana un nivel y aprende una habilidad.
+
+```json
+  {
+    "time": "2017-03-17T00:38:52+0000",
+    "type": "LearnAbility",
+    "payload": {
+      "Team": "Right",
+      "Actor": "*Sayoc*",
+      "Ability": "HERO_ABILITY_SAYOC_C",
+      "Level": 1
+    }
+  },
+```
+
+### UseAbility
+Este evento es registrado cuando un jugador utiliza una habilidad y tiene información sobre qué héroe lo utilizó junto con las coordenadas para el mapa. 
+
+```json
+ {
+    "time": "2017-03-17T00:39:08+0000",
+    "type": "UseAbility",
+    "payload": {
+      "Team": "Right",
+      "Actor": "*Kestrel*",
+      "Ability": "HERO_ABILITY_KESTREL_A_NAME",
+      "Position": [
+        39.39,
+        0.01,
+        27.26
+      ]
+    }
+  },
+```
+
+### UseItemAbility
+Este evento es registrado cuando un jugador utiliza un ítem activable o un charm/taunt.
+
+```json
+  {
+    "time": "2017-03-31T03:10:17+0000",
+    "type": "UseItemAbility",
+    "payload": {
+      "Team": "Left",
+      "Actor": "*Lyra*",
+      "Ability": "Travel Boots",
+      "Position": [
+        -17.51,
+        0.01,
+        41.63
+      ],
+      "TargetActor": "None",
+      "TargetPosition": [
+        -17.51,
+        0.01,
+        41.63
+      ]
+    }
+  }
+```
+
+### EarnXP
+Este evento es registrado cuando un jugador gana XP de cualquier fuente. Podría ser matar un minion, minero o un héroe.
+
+```json
+  {
+    "time": "2017-03-17T00:39:09+0000",
+    "type": "EarnXP",
+    "payload": {
+      "Team": "Left",
+      "Actor": "*Koshka*",
+      "Source": "*JungleMinion_TreeEnt*",
+      "Amount": 67,
+      "Shared With": 1
+    }
+  },
+```
+
+### DealDamage
+Este evento es registrado cuando cualquier actor (jugador, torreta, minion, etc.) hace daño a cualquier otro.
+
+```json
+  {
+    "time": "2017-03-31T02:47:34+0000",
+    "type": "DealDamage",
+    "payload": {
+      "Team": "Left",
+      "Actor": "*Skaarf*",
+      "Target": "*Vox*",
+      "Source": "Unknown",
+      "Damage": 105,
+      "Delt": 80,
+      "IsHero": 1,
+      "TargetIsHero": 1
+    }
+ }
+```
+
+### KillActor
+Este evento es registrado cuando un jugador mata cualquier cosa en la partida. Puede ser un minion, minero o un héroe. Generalmente verás los eventos EarnXP y KillActor pasando al mismo tiempo.
+
+
+```json
+  {
+    "time": "2017-03-17T00:39:09+0000",
+    "type": "KillActor",
+    "payload": {
+      "Team": "Left",
+      "Actor": "*Koshka*",
+      "Killed": "*JungleMinion_TreeEnt*",
+      "KilledTeam": "Neutral",
+      "Gold": "80",
+      "IsHero": 1,
+      "TargetIsHero": 0,
+      "Position": [
+        -21.95,
+        0,
+        24
+      ]
+    }
+  },
+```
+
+### NPCkillNPC
+Cuando un actor no-jugador mata a otro, como el Kraken o cuando un minion destruye una torreta.
+
+```json
+  {
+    "time": "2017-03-31T03:07:21+0000",
+    "type": "NPCkillNPC",
+    "payload": {
+      "Team": "Left",
+      "Actor": "*Kraken_Captured*",
+      "Killed": "*Turret*",
+      "KilledTeam": "Right",
+      "Gold": "300",
+      "IsHero": 0,
+      "TargetIsHero": 0,
+      "Position": [
+        54,
+        0,
+        2.92
+      ]
+    }
+  }
+```
+
+### GoldFromTowerKill
+Cuando un jugador gana oro de la destrucción de una torreta que pertenece al equipo contrario.
+
+```json
+  {
+    "time": "2017-03-31T02:57:02+0000",
+    "type": "GoldFromTowerKill",
+    "payload": {
+      "Team": "Left",
+      "Actor": "*Idris*",
+      "Amount": 300
+    }
+  }
+```
+
+### GoldFromGoldMine
+Cuando un jugador consigue oro de que su equipo captura el minero de oro.
+
+```json
+  {
+    "time": "2017-03-31T03:00:43+0000",
+    "type": "GoldFromGoldMine",
+    "payload": {
+      "Team": "Left",
+      "Actor": "*Idris*",
+      "Amount": 300
+    }
+  }
+```
+
+### GoldFromKrakenKill
+Cuando un jugador consigue oro de que su equipo mata al Kraken capturado por el equipo enemigo.
+
+```json
+  {
+    "time": "2017-03-31T03:07:43+0000",
+    "type": "GoldFromKrakenKill",
+    "payload": {
+      "Team": "Right",
+      "Actor": "*Kestrel*",
+      "Amount": 500
+    }
+  }
+```
+
+Descarga muestras de datos de telemetría [aquí!](https://cdn.discordapp.com/attachments/272249149473161216/282627164053176320/telemetry_sample.tgz)
+...
diff --git a/es/titles.md b/es/titles.md
new file mode 100644
index 0000000..883a72e
--- /dev/null
+++ b/es/titles.md
@@ -0,0 +1,10 @@
+# Titulos 
+ 
+Todos los endpoints requieren el siguiente encabezado `X-TITLE-ID` en orden para nosotros responder el pedido. 
+
+`X-TITLE-ID: semc-vainglory`
+ 
+<aside class="notice">
+No no, esto no es una pista de más nombre de juegos de Super Evil. El Vainglory Game Data
+Service usa una plataforma llamada Gamelocker, cuyo sistema puede albergar múltiples títulos.
+</aside>
\ No newline at end of file
diff --git a/es/versioning.md b/es/versioning.md
new file mode 100644
index 0000000..3a1fbd1
--- /dev/null
+++ b/es/versioning.md
@@ -0,0 +1,9 @@
+## Versiones
+
+Seguimos normas [SEMVER](http://semver.org/), utilizando un esquema de versiones MAJOR.MINOR.PATCH. Esto significa que incrementamos las versiones de la siguiente manera:
+
+  * MAJOR versión cuando hacemos cambios API incompatibles,
+  * MINOR versión cuando añadimos funcionalidad retro-compatible,
+  * PATCH versión cuando hagamos arreglos de bugs retrocompatibles.
+
+Puedes ver la versión actual y la fecha de llegada mirando el [Status](https://api.dc01.gamelockerapp.com/status) endpoint.
diff --git a/ga.js b/ga.js
new file mode 100644
index 0000000..a747735
--- /dev/null
+++ b/ga.js
@@ -0,0 +1,13 @@
+/*
+ * Google Tag Manager Tracking
+ */
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-88281046-1', 'auto');
+ ga('send', 'pageview');
+/*
+ * End Google Tag Manager
+ */