This is a collection of Rimble's pre-game odds for League of Legends, CS:GO, DOTA 2, Valorant and Rocket League (the most popular eSports). We provide odds for world-wide professional leagues, along with other useful images/logos for front-end support.

Overview

Our API only supports GET requests, and all requests must end with a trailing slash, “/”. To use this documentation page, from the top bar, select the programming language you are using to read in the data. This should give you example code for all our endpoints on the right hand side panel, along with example responses. On the left hand side panel, we also give you descriptions for our data formats.

Authentication

Our endpoints require API keys to gain access. Reach out to us to get your key.

Querying

You may query for specific games using query parameters. For example, to query by matchid, you can add the following to the end of the URL (after the trailing slash, "/") ?matchid={matchid}. To query with multiple parameters, use the following syntax: ?date={YYYY-MM-DD}&team={team name}. The permitted query parameters for each endpoint are described in their respective sections below. We highly recommend making us of query parameters while accessing our endpoints (rather than using the base endpoint). This makes sure the size of the data being sent to you is manageable.

Note: While querying team or league names, spaces are permitted in the URLs.

Relevant Terminology

In this documentation, we use the word "match" to describe the event where two teams play each other. In many cases, this means that the two teams play a "best of"-style match i.e. each match usually comprises of more than one "game" as a part of it, and the team that wins the most games wins the match. In some eSports (CS:GO and Valorant), "games" are equivalent to "maps", but for consistency, we refer to them as games throughout this documentation.

Data Updates

We update all our data feeds hourly, and this is done 10 minutes past the hour. We recommend pulling the data at the same frequency. The best time to do this is at the stroke of the hour or 30 minutes past the hour.

Api Pagination

In the case the response size is too big (meant for upcoming/completed matches) we can return the information without the odds key. please query that match individually using match status to get the odds information. Upocming/completed matches endpoint is meant for schedules and should not be used to pull all of the data!