Blog MM2 Values API Reference: Endpoints, JSON Fields and Examples

MM2 Values API Reference: Endpoints, JSON Fields and Examples

UN6107617 · 10 November 2026

This is a reference for developers and AI assistants: every endpoint of the RBLXValue MM2 values API (v2), the exact JSON fields, real example responses, errors and limits. Use it to build Discord bots, trade calculators, websites or apps with Murder Mystery 2 item values.

Short answer:
Base URL: https://api.rblxvalue.com/v2. All endpoints are GET and return JSON.
Auth: header X-Api-Key: rbx_… (also Authorization: Bearer … or ?api_key=). /v2/meta needs no key.
Free key: 30 requests/minute, show "Data from rblxvalue.com". Get it at rblxvalue.com/developer.
Data: 1,000+ MM2 items with values from MM2Values and Supreme Values, demand, rarity, stability, acronyms, 120+ sets and value history. Refreshed about every 12 hours.

Endpoints

Endpoint	Returns	Parameters
`/v2/items`	List of items	`search`, `category`, `limit` (1–100), `offset`
`/v2/items/{slug}`	One item	slug or acronym, case-insensitive
`/v2/sets`, `/v2/sets/{slug}`	Sets with items and combined value	`search`, `limit`, `offset`
`/v2/history/{slug}`	Value snapshots, oldest first	`period=1Y\|ALL`, `source=all\|mm2values\|supremevalues`
`/v2/profile/{username}`	RBLXValue profile, badges, inventory value	username or Roblox user ID
`/v2/inventory/{username}`	Public MM2 inventory with values	username or Roblox user ID
`/v2/meta`	Last update, interval, totals (no key)	–

One item

curl "https://api.rblxvalue.com/v2/items/corrupt" -H "X-Api-Key: rbx_your_key"

{
  "item": {
    "id": 16,
    "name": "Corrupt",
    "slug": "corrupt",
    "acronym": "CORR",
    "value": 230,
    "value_source_a": 230,
    "value_source_b": 230,
    "category": "unique",
    "type": "Knife",
    "tier": 9,
    "stability": "Stable",
    "demand": 3,
    "rarity": 3,
    "range": "N/A",
    "event_name": null,
    "description": "Corrupt is a unique knife in Murder Mystery 2, originally awarded to victims of the Data Loss Glitch. ...",
    "image_url": "https://cdn.un6107617.dev/rblxvalue/items/Corrupt_Transparent-resize.webp",
    "fandom_url": "https://murder-mystery-2.fandom.com/wiki/Corrupt",
    "last_updated": "2026-11-10 00:02:40"
  },
  "credit": "Data from rblxvalue.com"
}

Field	Type	Meaning
`name`, `slug`, `acronym`	string	Display name, URL slug (`chroma-evergun`) and trading acronym (`CEGUN`)
`value`	number	RBLXValue estimate: average of both sources when both list the item, otherwise the one that does. Can have decimals (`26.5`).
`value_source_a`	number	Value on MM2Values (`0` = not listed there)
`value_source_b`	number	Value on Supreme Values (`0` = not listed there)
`category`	string	Rarity tier: `common`, `uncommon`, `rare`, `legendary`, `vintage`, `godly`, `ancient`, `unique`, `chroma`, `pets`, `misc`
`type`	string	Knife, gun, pet or misc
`demand`	0–10	How much traders want the item
`rarity`	0–10	How hard the item is to find in trades
`stability`	string	Trend label, e.g. `Stable`, `Rising`, `Overpaid for`, `Untradeable`
`tier`	number	Internal tier used for sorting
`event_name`	string\|null	Event the item came from, e.g. `Halloween 2021 Event`
`image_url`, `fandom_url`	string	Item image (transparent WebP) and MM2 wiki page
`last_updated`	datetime\|null	When the values were last refreshed

Values are MM2 trading values, not Robux or real money. 0 in a source field means that list does not have the item.

Search and filter items

curl "https://api.rblxvalue.com/v2/items?category=chroma&limit=2" -H "X-Api-Key: rbx_your_key"

{
  "total": 46,
  "limit": 2,
  "offset": 0,
  "count": 2,
  "items": [
    { "name": "Chroma Travelers Gun", "slug": "chroma-travelers-gun", "acronym": "CTG", "value": 140000, "category": "chroma", "demand": 7, "rarity": 10, "stability": "Stable", "...": "..." },
    { "name": "Chroma Evergun", "slug": "chroma-evergun", "acronym": "CEGUN", "value": 47000, "category": "chroma", "demand": 6, "rarity": 8, "stability": "Stable", "...": "..." }
  ],
  "credit": "Data from rblxvalue.com"
}

Use total, limit and offset to page through results. search matches partial names (harvester returns Harvester, Gold Harvester, …).

Value history

curl "https://api.rblxvalue.com/v2/history/corrupt?period=1Y" -H "X-Api-Key: rbx_your_key"

{
  "item": { "id": 16, "name": "Corrupt", "slug": "corrupt" },
  "period": "1Y",
  "source": "all",
  "count": 572,
  "history": [
    { "date": "2026-07-21 14:00:01", "source": "mm2values", "value": 475 },
    { "date": "2026-07-21 14:00:01", "source": "supremevalues", "value": 470 },
    "..."
  ]
}

With source=all, each snapshot appears once per list. Filter with source=mm2values to compare one list over time, for example for a "last 7 days" change.

Update status

curl "https://api.rblxvalue.com/v2/meta"

{
  "last_updated": "2026-11-10 00:02:40",
  "update_interval_hours": 12,
  "totals": { "items": 1091, "sets": 123 },
  "sources": ["mm2values", "supremevalues"],
  "credit": "Data from rblxvalue.com"
}

Errors

401: no key sent.
403: key invalid, not activated yet (click the email link), expired or suspended.
404: item or set not found:

{ "error": true, "message": "Item 'doesnotexist' not found (searched slug and acronym)." }

429: rate limit reached; wait Retry-After (60) seconds.

Plans and rate limits

Free: 30 requests/minute, credit "Data from rblxvalue.com" required.
Hobby: 150/minute, unlocked in the RBLXValue Android app.
Paid: 1,000/minute, €9.99/month, no credit required.
Marketplace: 5,000/minute, €24.99/month.

Values change about every 12 hours, so cache responses (5–15 minutes) instead of calling the API for every message. Call the API from a server or bot, never from public browser code, so your key stays private.

Example code

Complete MM2 value Discord bot in Python (discord.py)
Complete MM2 value Discord bot in JavaScript (discord.js v14)
JavaScript, Python and PHP examples in the docs
No code needed: the item value widget embeds a live value on any website.

FAQ

Is there an API for Murder Mystery 2 item values?

Yes. The RBLXValue API v2 at https://api.rblxvalue.com/v2 returns MM2 item values, demand, rarity, stability, sets and value history as JSON. A free key is available at rblxvalue.com/developer.

Where do the MM2 values in the API come from?

From the two main MM2 value lists, MM2Values (value_source_a) and Supreme Values (value_source_b). The value field is the RBLXValue estimate: the average when both lists have the item.

Does the API support MM2 item acronyms?

Yes. GET /v2/items/{slug} accepts acronyms such as CORR (Corrupt) or CEGUN (Chroma Evergun), case-insensitive.

How often does the MM2 values API update?

About every 12 hours. GET /v2/meta shows the last update time and needs no key.

Can I use the API in a public website?

Yes, but call it from your server and cache the results, so the key is not visible in the browser. For a no-code option use the embeddable widget at rblxvalue.com/widget.

Links: Get a free API key · API v2 docs · docs for LLMs (llms.txt) · rblxvalue.com/llms.txt · open-source bot on GitHub

10 Nov 2026