# Csgoroll — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/csgoroll/`
**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 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.beta.paywithlocus.com/api/wrapped/credits/csgoroll/get-best-drops \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/csgoroll/get-case-battles-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/csgoroll/get-case-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/csgoroll/get-cases-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/csgoroll/get-exchange-rates \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/csgoroll/get-games-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/csgoroll/get-leaderboard \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/csgoroll/get-marketplace-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/csgoroll/get-marketplace-stats \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

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