# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/rolimons/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/rolimons/get-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/rolimons/get-games \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/rolimons/get-items \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/rolimons/get-player-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/rolimons/get-recent-trades \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/rolimons/search-players \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.