API reference · Charts

List Roblox’s charts

GET/api/v1/charts

Roblox’s own charts (Top Earning, Top Trending, Up-and-Coming and the rest), as RoTerminal keeps them day by day, and what each can be read for: the 60 countries, the devices and Top Trending’s genres.

Parameters

This endpoint has no parameters.

Example

curl https://roterminal.co/api/v1/charts \
  -H "Authorization: Bearer $ROTERMINAL_API_KEY"

import RoTerminal from 'roterminal'

const rt = new RoTerminal({ apiKey: process.env.ROTERMINAL_API_KEY })

const { data } = await rt.charts.list()

from roterminal import RoTerminal

rt = RoTerminal()  # reads ROTERMINAL_API_KEY

data = rt.charts.list()["data"]

Response

{
  "data": {
    "link": "https://roterminal.co/charts",
    "charts": [
      {
        "id": "top-earning",
        "name": "Top Earning",
        "what_it_ranks": "Most Robux spent this week"
      },
      {
        "id": "top-trending",
        "name": "Top Trending",
        "what_it_ranks": "Growing fastest this week"
      },
      {
        "id": "up-and-coming",
        "name": "Up-and-Coming",
        "what_it_ranks": "New games growing fastest"
      },
      …
    ],
    "countries": [
      {
        "code": "US",
        "name": "United States"
      },
      {
        "code": "BR",
        "name": "Brazil"
      },
      {
        "code": "ID",
        "name": "Indonesia"
      },
      …
    ],
    "devices": [
      {
        "id": "all",
        "name": "All Devices"
      },
      {
        "id": "computer",
        "name": "Computer"
      },
      {
        "id": "phone",
        "name": "Standard Phone"
      },
      …
    ],
    "trending_genres": [
      {
        "id": "action",
        "name": "Action"
      },
      {
        "id": "adventure",
        "name": "Adventure"
      },
      {
        "id": "entertainment",
        "name": "Entertainment"
      },
      …
    ]
  },
  "link": "https://roterminal.co/charts",
  "as_of": "2026-10-24T07:52:00-04:00"
}

Fields

The fields in data. A field with nothing to say is left out.

linkuri

Its page on roterminal.co.

chartslist of object

Roblox’s charts.

4 fields

idstring: The chart’s ID, for Retrieve a chart.
namestring: The chart’s name, as Roblox shows it.
what_it_ranksstring: What Roblox says the chart ranks.
same_everywhereboolean: True for a chart that’s the same in every country and on every device (Top Rated, Top Paid Access, Top Playing Now).

countrieslist of object

The countries RoTerminal keeps Roblox’s charts for, as two letters (code, for country) and their names.

2 fields

codestring: Two letters, for country.
namestring: Its name, as Roblox shows it.

deviceslist of object

The devices a chart can be read for (id, for device).

2 fields

idstring: For device.
namestring: Its name, as Roblox shows it.

trending_genreslist of object

Top Trending’s genres, each its own Trending list (id, for genre).

2 fields

idstring: For genre.
namestring: Its name, as Roblox shows it.