# Rolimons — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access real-time Roblox limited item market data, search and view player profiles and inventories, track recent trade advertisements, browse top games and player counts, and read the latest site articles — all through a single API.

**Category:** Marketplaces | **Website:** [rolimons.com/](https://rolimons.com/) | **Docs:** [parse.bot/marketplace/e45beecd-84b1-43e3-b6b0-ad5883113172/rolimons-com-api](https://parse.bot/marketplace/e45beecd-84b1-43e3-b6b0-ad5883113172/rolimons-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-rolimons-com-api-e45beecd/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_articles

Collect articles and updates published on the Rolimons site. Returns all available articles with titles, summaries, links, and thumbnail paths. Articles cover Roblox trading tips, player profiles, and market analysis.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rolimons-com-api-e45beecd/get_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_games

Retrieve all Roblox games tracked by Rolimons with current player count statistics and thumbnail URLs. Returns thousands of games sorted by their internal game ID.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rolimons-com-api-e45beecd/get_games \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_items

Extract detailed item data including values, prices, demand, trend, and market information for all Roblox limited items tracked by Rolimons. Returns over 2500 items in a single call. Each item includes RAP (Recent Average Price), projected value, demand rating (1-4 scale, -1 if unrated), trend rating, and rarity flags.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rolimons-com-api-e45beecd/get_items \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_player_details

Retrieve detailed player information including their limited item inventory, verification status, online status, badges, and total value/RAP. The player_id can be obtained from search_players results. Returns inventory as a mapping of item_id to arrays of owned asset instance IDs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `player_id` | string | Yes | Roblox player ID (numeric string, obtainable from search_players.players[*].player_id). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rolimons-com-api-e45beecd/get_player_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"<string>"}'
```

### get_recent_trades

Fetch recent trade advertisements posted on Rolimons. Each trade ad is an array containing [trade_ad_id, timestamp, player_id, username, offering_object, requesting_object]. The offering and requesting objects contain item arrays and optional tags/robux fields.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rolimons-com-api-e45beecd/get_recent_trades \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_players

Search for Roblox players by username. Returns up to 15 matching results with player IDs and usernames. Partial matches are included. The player_id from results can be used with get_player_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Username or partial username to search for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rolimons-com-api-e45beecd/search_players \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```