Heatmaps

The data behind the MM2 Market Heatmap: the 50 most valuable tradeable items of a day, week or month, with their value at the end of that period and at the end of the period before. Use it for "biggest risers" lists, daily market posts in Discord or your own heatmap.

GET /v2/heatmaps
GET /v2/heatmaps/daily
GET /v2/heatmaps/weekly
GET /v2/heatmaps/monthly
GET /v2/heatmaps/{period}/{YYYY-MM-DD}

Without a date you get the newest finished period: yesterday, last week or last month. The current day, week or month is saved once it has ended.
With a date you get the day, week or month that contains that date. Weeks run Monday to Sunday, so /v2/heatmaps/weekly/2026-11-11 returns the week of 9 to 15 November.
Every period since July 2026 is stored, so you can go back in time.

Rate limit

Free keys can call /v2/heatmaps 5 times per minute, Hobby keys 10 times per minute. Paid and Marketplace keys have no separate limit, only their normal one. A heatmap changes at most once a day, so cache the response. See Rate Limits.

Parameters

Parameter	Description
`category`	`all` (default), `ancient`, `chroma`, `godly`, `vintage`, `legendary`, `rare`, `uncommon`, `common` or `pets`. Corrupt is listed under `ancient`. Untradeable items are never included.

curl "https://api.rblxvalue.com/v2/heatmaps/weekly?category=godly" -H "X-Api-Key: your_key_here"

{
  "period": "weekly",
  "period_start": "2026-11-02",
  "period_end": "2026-11-08",
  "category": "godly",
  "close_time": "2026-11-08 12:02:40",
  "previous_close_time": "2026-11-01 23:40:00",
  "timezone": "Europe/Amsterdam",
  "summary": { "items": 50, "up": 6, "down": 14, "unchanged": 30, "new": 0 },
  "items": [
    {
      "rank": 1,
      "id": 412,
      "name": "Travelers Gun",
      "slug": "travelers-gun",
      "category": "godly",
      "image": "https://cdn.un6107617.dev/rblxvalue/items/godly/Travelers_Gun-resize.webp",
      "value": 5175,
      "previous_value": 5175,
      "change": 0,
      "change_percent": 0
    }
  ],
  "url": "https://rblxvalue.com/heatmap?period=week&cat=godly&date=2026-11-02",
  "credit": null
}

Field	Description
`period_start` / `period_end`	First and last day of the period (inclusive)
`close_time`	The value update used as the end of this period
`previous_close_time`	The value update used as the end of the period before
`items`	Up to 50 items, most valuable first
`previous_value` / `change` / `change_percent`	`null` when the item had no value yet in the period before
`url`	The same heatmap on rblxvalue.com

GET /v2/heatmaps lists the periods, the categories and the first and latest date that is available.

A date in the future, before July 2026 or in a period that has not ended yet returns 404.

Parameters​

Parameters