# Pricempire — 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.

> Search and compare CS2 skin prices across multiple marketplaces. Look up skins by name, retrieve per-condition pricing and historical data, explore order books, and browse marketplace details including fees and payment methods.

**Category:** Marketplaces | **Website:** [pricempire.com/](https://pricempire.com/) | **Docs:** [parse.bot/marketplace/aac7e89d-60dc-456d-9dda-500090d74f7a/pricempire-com-api](https://parse.bot/marketplace/aac7e89d-60dc-456d-9dda-500090d74f7a/pricempire-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-pricempire-com-api-aac7e89d/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_marketplace_detail

Get detailed information for a specific marketplace including fees, payment methods, pros/cons, supported games, and Trustpilot rating.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Marketplace slug (e.g., 'skinport', 'buff163'). Obtainable from list_marketplaces. |

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

### get_skin_detail

Get comprehensive details for a specific CS2 skin by its slug. Returns item info including all condition variants (Factory New, Minimal Wear, etc.) with prices from multiple marketplaces, price history ranges, attributes, and similar items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Skin slug (e.g., 'ak-47-wild-lotus'). Obtainable from search_skins results. |

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

### get_skin_marketplace_prices

Get current marketplace prices for all condition variants of a specific skin. Returns a flat list of price entries with condition, provider, and price in cents USD.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Skin slug (e.g., 'ak-47-wild-lotus'). Obtainable from search_skins results. |

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

### get_skin_order_book

Retrieve buy orders (order book) for a specific skin item across marketplaces, grouped by condition variant. Each entry contains the condition name and an array of buy order objects.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Skin slug (e.g., 'ak-47-wild-lotus'). Obtainable from search_skins results. |

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

### get_skin_price_history

Retrieve historical price data for a specific skin item. Returns an object with items array of [timestamp, price, volume] tuples where timestamp is Unix epoch seconds, price is in cents USD, and volume is trade count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `days` | integer | No | Number of days of history to fetch. |
| `item_id` | string | Yes | Internal item ID (obtained from search_skins results id field or get_skin_detail asset_items[].id). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pricempire-com-api-aac7e89d/get_skin_price_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"days":"<integer>","item_id":"<string>"}'
```

### get_skin_price_statistics

Get price statistics for a skin including per-condition liquidity and historical price ranges (7-day, 30-day, 90-day, yearly min/max).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Skin slug (e.g., 'ak-47-wild-lotus'). Obtainable from search_skins results. |

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

### list_marketplaces

List all supported CS2 marketplaces with their fees, payment methods, ratings, and inventory stats. No parameters required.

**Estimated cost:** Metered

_No parameters required._

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

### list_weapon_categories

List available item categories from the site menu including collections, crates, souvenirs, sticker capsules, tournaments, teams, and players.

**Estimated cost:** Metered

_No parameters required._

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

### search_skins

Search for CS2 skins by name or keyword. Returns a list of matching items with basic info and minimum prices. Results are sorted by price descending. The query matches against market_hash_name.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results to return. |
| `query` | string | Yes | Search keyword matching skin market_hash_name (e.g., 'AK-47', 'Dragon Lore', 'Karambit') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pricempire-com-api-aac7e89d/search_skins \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```