# Csgoroll — 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 CS:GO marketplace listings and stats, browse available cases with detailed information, check leaderboards and case battle results, and view the latest game drops and exchange rates. Track pricing data, compare case odds, and monitor top player rankings all from one unified source.

**Category:** Marketplaces | **Website:** [csgoroll.com/](https://csgoroll.com/) | **Docs:** [parse.bot/marketplace/5a024293-4c96-4efd-bde5-84b2da0b39b5/csgoroll-com-api](https://parse.bot/marketplace/5a024293-4c96-4efd-bde5-84b2da0b39b5/csgoroll-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-csgoroll-com-api-5a024293/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_best_drops

Fetch the highest-value drop from case openings today (UTC). Returns the item details including name, rarity, value in coins, and the user who opened it.

**Estimated cost:** Metered

_No parameters required._

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

### get_case_battles_list

Fetch active and recently created case battles (PvP games). Each battle includes player information, round details with boxes, game strategy, bet amounts, team composition, and current status.

**Estimated cost:** Metered

_No parameters required._

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

### get_case_detail

Search for cases matching a given slug name. Returns matching official and community cases with their cost, risk factor, and metadata. Partial matching is supported — e.g. 'fortune' returns both the official Fortune case and community cases with 'fortune' in the name.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Case name or slug to search for (e.g. 'fortune', 'harvester') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-csgoroll-com-api-5a024293/get_case_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_cases_list

Fetch the list of available official cases/boxes for opening. Returns case name, slug, cost in coins, icon URL, risk factor, and tags. Results are ordered by the site's display order.

**Estimated cost:** Metered

_No parameters required._

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

### get_exchange_rates

Fetch current exchange rates for CSGORoll coins (TKN) to various fiat and crypto currencies. Rates are updated periodically; the updated_at timestamp indicates freshness.

**Estimated cost:** Metered

_No parameters required._

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

### get_games_list

List all available game modes on CSGORoll including their labels, links, availability status (coming soon, beta, new), and associated images. Fetched from the CMS.

**Estimated cost:** Metered

_No parameters required._

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

### get_leaderboard

Retrieve active campaign/leaderboard information including campaign names, end dates, prize pool balances in coins, and distribution strategies.

**Estimated cost:** Metered

_No parameters required._

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

### get_marketplace_listings

Fetch paginated skin listings from the P2P marketplace. Each listing includes skin name, weapon type, price in coins, markup percentage, paint wear range, stickers, and seller activity status. Paginates via cursor; use the returned end_cursor as the after param for the next page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `after` | string | No | Cursor for pagination (from end_cursor in a previous response) |
| `limit` | integer | No | Number of results per page (1-50) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-csgoroll-com-api-5a024293/get_marketplace_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"after":"<string>","limit":"<integer>"}'
```

### get_marketplace_stats

Retrieve overall marketplace statistics including 24-hour rolling trading volume in coins.

**Estimated cost:** Metered

_No parameters required._

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