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

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/skinport/`
**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 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.beta.paywithlocus.com/api/wrapped/credits/skinport/get-item-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/skinport/get-market-items \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/skinport/get-price-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/skinport/get-sales-history \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"market_hash_name":"<string>"}'
```

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