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

> Browse and retrieve CS2 skin listings on Skinport. Search and filter the marketplace by category, exterior, and price; pull full item details and sales history; and access aggregated pricing data across the entire catalog.

**Category:** Marketplaces | **Website:** [skinport.com/](https://skinport.com/) | **Docs:** [parse.bot/marketplace/a901a86b-1154-4b50-9cc1-9221924a2e16/skinport-com-api](https://parse.bot/marketplace/a901a86b-1154-4b50-9cc1-9221924a2e16/skinport-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-skinport-com-api-a901a86b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_item_details

Fetch full details for a specific marketplace listing by its sale ID and URL slug. Returns the item with seller info, enriched with similarity counts, rating, offer count, price trends, sale history, and related variants. Both sale_id and item_slug must refer to the same listing; a mismatched pair returns a not-found error.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_slug` | string | Yes | The URL slug of the item (from get_market_items results items[*].url, e.g. 'talon-knife-doppler-factory-new+phase-2'). |
| `sale_id` | string | Yes | The numeric sale ID of the listing (from get_market_items results items[*].saleId). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-skinport-com-api-a901a86b/get_item_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_slug":"<string>","sale_id":"<string>"}'
```

### get_market_items

Browse the Skinport marketplace for CS2 item listings. Supports filtering by category, exterior condition, and free-text search. Results are paginated via skip offset and sortable by date or price. Returns up to 60 items per page plus filter metadata (total count, available exterior/other filters).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category filter for item type. |
| `exterior` | string | No | Exterior condition filter. |
| `order` | string | No | Sort direction for results. |
| `query` | string | No | Free-text search query to filter items by name. |
| `skip` | integer | No | Number of items to skip for pagination. |
| `sort` | string | No | Sort field for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-skinport-com-api-a901a86b/get_market_items \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","exterior":"<string>","order":"<string>","query":"<string>","skip":"<integer>","sort":"<string>"}'
```

### get_price_list

Fetch the full catalog of CS2 items with current pricing metadata from the public Skinport API. Each entry includes min/max/mean/median prices, listing quantity, and suggested price. Returns thousands of items in a single response. Optionally filter to tradable-only items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `currency` | string | No | Currency code for prices. |
| `tradable` | boolean | No | When true, filter to only tradable items. When false or omitted, returns all items. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-skinport-com-api-a901a86b/get_price_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"currency":"<string>","tradable":"<boolean>"}'
```

### get_sales_history

Fetch aggregated sales statistics for a specific item by its market hash name. Returns price and volume data bucketed into 24-hour, 7-day, 30-day, and 90-day windows (min, max, avg, median, volume) from the public Skinport API.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `market_hash_name` | string | Yes | The market hash name of the item (e.g. 'AK-47 \| Redline (Field-Tested)', '★ M9 Bayonet \| Fade (Factory New)'). |

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