# Haloskins — 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 HaloSkins CS2 marketplace items by keyword and retrieve live seller listings for a specific item, including prices, float values, stickers/keychains, and listing metadata.

**Category:** Marketplaces | **Website:** [haloskins.com/](https://haloskins.com/) | **Docs:** [parse.bot/marketplace/28ab9c20-87c9-4791-924c-5170c0e42df5/haloskins-com-api](https://parse.bot/marketplace/28ab9c20-87c9-4791-924c-5170c0e42df5/haloskins-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-haloskins-com-api-28ab9c20/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_item_listings

Get individual seller listings for a specific item. Returns detailed listing data including seller name, price, float value, stickers, keychains, and 3D inspect URL. Supports pagination and sorting.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | The item ID from search_market results (e.g., '24483' for AWP Dragon Lore FT) |
| `limit` | integer | No | Number of listings per page (max 50) |
| `page` | integer | No | Page number for pagination |
| `sort` | integer | No | Sort order: 0=default, 1=price ascending, 2=price descending |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-haloskins-com-api-28ab9c20/get_item_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>","limit":"<integer>","page":"<integer>","sort":"<integer>"}'
```

### search_and_get_listings

Combined endpoint: search by keyword, retrieve all matching results, then automatically fetch detailed seller listings for the top result. Ideal for single-call lookups. Returns null for selected_item when no results match.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keyword` | string | Yes | Search keyword (e.g., 'ak-47', 'karambit doppler', 'dragon lore') |
| `listings_limit` | integer | No | Max number of seller listings to return for the top result |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-haloskins-com-api-28ab9c20/search_and_get_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"<string>","listings_limit":"<integer>"}'
```

### search_market

Search the HaloSkins marketplace by keyword. Returns matching items with their prices, quantities, and metadata. Supports pagination. Note: requesting a page beyond total pages returns an empty items array with HTTP 200.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keyword` | string | Yes | Search keyword (e.g., 'dragon lore', 'ak-47', 'karambit doppler') |
| `limit` | integer | No | Number of results per page (max 50) |
| `page` | integer | No | Page number for pagination. Pages beyond total available return empty items. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-haloskins-com-api-28ab9c20/search_market \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"<string>","limit":"<integer>","page":"<integer>"}'
```