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
rangestring24h,7d(default) or30d.
GET https://studio.blockoutgames.com/developer/v1/market?range=7dAuthorization: Bearer bk_live_<the game's key>The market ranges and their buckets
range | Covers | bucketSeconds | Bucket |
|---|---|---|---|
24h | The last 24 hours | 3600 | 1 hour |
7d | The last 7 days | 3600 | 1 hour |
30d | The last 30 days | 86400 | 1 day |
What GET /developer/v1/market answers: the market overview
200 with a MarketOverview:
{ "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) andplayers: 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
genrenull. Eachplayerslist has one value per point, in the same order aspoints. 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) andwithTraction(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
| Status | error.code | When |
|---|---|---|
| 400 | validation_failed | A range that is not 24h, 7d or 30d |
| 401 | unauthenticated | The key is missing, malformed, wrong or revoked, or its game left the catalog |
| 429 | rate_limited | Over a limit; wait the Retry-After seconds |
Bodies and what to do: Errors, limits and polling.
Updated