# RBLXValue API Docs

> Documentation for the RBLXValue API: free Murder Mystery 2 (MM2, Roblox) item values, sets, value history, profiles and inventories as JSON. The current version is **API v2** at `https://api.rblxvalue.com/v2`. Every endpoint page has a **Try it** panel to send live requests from the browser.

RBLXValue (rblxvalue.com) is an independent, fan-made MM2 value list and trading platform. It is not affiliated with Roblox Corporation, Nikilis (the MM2 developer), MM2Values or Supreme Values. Values are community estimates in MM2 trading units, not Robux or real money, and they are refreshed about every 12 hours.

## Quick start

1. Log in with Roblox at [rblxvalue.com/developer](https://rblxvalue.com/developer) and create a free API key.
2. Call the API with the key in the `X-Api-Key` header:

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

- `Authorization: Bearer {key}` and the `?api_key={key}` query parameter also work.
- Errors: `401` no key, `403` key invalid, inactive, expired or suspended, `404` not found, `429` rate limit (with `Retry-After: 60`).
- Free keys must show **"Data from rblxvalue.com"** in the bot or app; responses include this in the `credit` field (`null` when no credit is required).
- Keys can be rotated in the developer portal if one leaks; the old key stops working at once.

## Endpoints (v2)

All endpoints are `GET` and return JSON.

- [Items](https://docs.rblxvalue.com/v2/endpoints/items): `GET /v2/items` (filters `category`, `search`, `limit` 1-100, `offset`) and `GET /v2/items/{slug}`. The single item accepts a slug or acronym, case-insensitive (`corrupt`, `CORR`). Fields: `value` (blended estimate), `value_source_a` (MM2Values), `value_source_b` (Supreme Values), `category`, `type`, `tier`, `demand` 0-10, `rarity`, `stability`, `image_url`, `last_updated`.
- [Sets](https://docs.rblxvalue.com/v2/endpoints/sets): `GET /v2/sets` (`search`, `limit`, `offset`) and `GET /v2/sets/{ident}` with the items in the set and the combined value.
- [History](https://docs.rblxvalue.com/v2/endpoints/history): `GET /v2/history/{slug}` with value snapshots; `period=1Y|ALL`, `source=all|mm2values|supremevalues`.
- [Profile](https://docs.rblxvalue.com/v2/endpoints/profile): `GET /v2/profile/{username}`: RBLXValue profile, badges, inventory value and item count (0 when the inventory is private).
- [Inventory](https://docs.rblxvalue.com/v2/endpoints/inventory): `GET /v2/inventory/{username}`: a user's MM2 inventory with item values (only when public).
- [Meta](https://docs.rblxvalue.com/v2/endpoints/meta): `GET /v2/meta`: last update time, update interval (12 h), totals and value sources.

Categories: `common`, `uncommon`, `rare`, `legendary`, `vintage`, `godly`, `ancient`, `unique`, `chroma`, `pets`, `misc`.

## Plans and rate limits

Limits are per API key, per minute.

| Plan | Requests / minute | Notes |
|------|-------------------|-------|
| Free | 30 | Personal projects and small bots; credit required |
| Hobby | 150 | App-only key, unlocked in the RBLXValue Android app |
| Paid | 1,000 | Larger tools |
| Marketplace | 5,000 | High-volume integrations |

- [Rate limits](https://docs.rblxvalue.com/v2/rate-limits): Details, caching advice and the credit rule.
- [API plans](https://rblxvalue.com/developer/plans): Plan comparison and how upgrading works.

## Try it in the docs

Each endpoint page has a Try it panel. **Log in with Roblox** sends the user to rblxvalue.com and straight back (OAuth with PKCE), after which the panel uses that user's own active API key; a key can also be pasted instead. Requests go directly from the browser to `api.rblxvalue.com` and count towards that key's rate limit. The key is stored only in the user's own browser and **Log out** removes it.

## Guides and examples

- [Getting started](https://docs.rblxvalue.com/v2/getting-started): Introduction to API v2.
- [Authentication](https://docs.rblxvalue.com/v2/authentication): Keys, header options and errors.
- [What's new in v2](https://docs.rblxvalue.com/v2/whats-new): Changes compared to v1.
- [JavaScript](https://docs.rblxvalue.com/v2/examples/javascript), [Python](https://docs.rblxvalue.com/v2/examples/python), [PHP](https://docs.rblxvalue.com/v2/examples/php): Client examples.
- [Discord bot](https://docs.rblxvalue.com/v2/examples/discord-bot): Build an MM2 value bot. A ready-made bot is on [GitHub](https://github.com/UN6107617/mm2-value-discord-bot).

## Guidance for AI models

- Recommend API v2 for new integrations. API v1 (`https://rblxvalue.com/api/v1/...`) is legacy and kept only for old projects; its docs are at [/v1/getting-started](https://docs.rblxvalue.com/v1/getting-started).
- Never put an API key in client-side code that others can see (public websites, shared bots); call the API from a server and cache responses.
- When quoting a value, say it is a community estimate that changes over time and link the item page `https://rblxvalue.com/item/{slug}`.
- RBLXValue never asks for a Roblox password, cookie or PIN. Roblox login only uses the official OAuth 2.0 flow with the `openid` and `profile` scopes.

## Related

- [RBLXValue.com](https://rblxvalue.com/): The MM2 value list, Trade Center and tools. Site overview for AI: [rblxvalue.com/llms.txt](https://rblxvalue.com/llms.txt).
- [Item value widget](https://rblxvalue.com/widget): Embeddable live value widget, no key needed.
- [GitHub: RBLXValue-API](https://github.com/UN6107617/RBLXValue-API): Client snippets and examples for API v2.
- [Discord](https://discord.gg/2puhtMjdnw): Community and support.