GET /developer/v1/market

Reference for the market overview - players in the 1,000 most played games over time, split by genre, and the new games of each of the last 12 weeks.

Endpoints / Market data / The market over time

Answers the market as a whole over a range: players in today's most played games over time, how they split by genre, and how many new games appeared each week. It answers what the panel's Market overview reads.

Request to GET /developer/v1/market

GET/developer/v1/market

Query

rangestring
24h, 7d (default) or 30d.
HTTP
GET https://studio.blockoutgames.com/developer/v1/market?range=7dAuthorization: Bearer bk_live_<the game's key>

The market ranges and their buckets

rangeCoversbucketSecondsBucket
24hThe last 24 hours36001 hour
7dThe last 7 days36001 hour
30dThe last 30 days864001 day

What GET /developer/v1/market answers: the market overview

200 with a MarketOverview:

JSON
{  "range": "7d",  "bucketSeconds": 3600,  "trackedGames": 48210,  "games": 1000,  "points": [    { "t": "2026-10-17T10:00:00Z", "players": 6100000 },    { "t": "2026-10-17T11:00:00Z", "players": 6350000 }  ],  "genres": [    { "genre": "Simulation", "players": [2300000, 2410000] },    { "genre": null, "players": [900000, 940000] }  ],  "newGames": [    { "week": "2026-08-03", "created": 310, "withTraction": 12 },    { "week": "2026-08-10", "created": 295, "withTraction": 9 }  ]}

MarketOverview

rangestring
The range answered.
bucketSecondsnumber
The width of each point.
trackedGamesnumber
Every game the platform stores, including games awaiting their first reading and games no longer live.
gamesnumber
How many games the history adds up: today's most played, at most 1,000.
pointsMarketPoint[]
Oldest first. Each is t (the bucket's start, UTC) and players: each game's mean players in the bucket, added up. Empty until the games have readings in the range.
genresMarketGenreSeries[]
The 6 largest genres over the range, largest first, then everything else together with genre null. Each players list has one value per point, in the same order as points.
newGamesMarketWeek[]
The last 12 weeks, oldest first, empty weeks as zeros: week (its Monday, YYYY-MM-DD, UTC), created (tracked games created on Roblox that week) and withTraction (of those, how many have at least 100 players now).

The 1,000 games are the most played at the moment of the request (not dead, read at least once), and their history comes from the platform's hourly means of each game's players.

How GET /developer/v1/market is cached

From the platform's read cache, fresh for 60 seconds and replaced when the collector stores new market data. The Template's PlatformService.market(range) keeps an answer for 300 seconds and returns it unchecked beyond being an object.

Errors from GET /developer/v1/market

Statuserror.codeWhen
400validation_failedA range that is not 24h, 7d or 30d
401unauthenticatedThe key is missing, malformed, wrong or revoked, or its game left the catalog
429rate_limitedOver a limit; wait the Retry-After seconds

Bodies and what to do: Errors, limits and polling.

Updated