# GET /v1/market-sales/search

Look up sales by market_hash_name

- Interactive docs: [https://cspriceapi.com/docs/api/market-sales-search](https://cspriceapi.com/docs/api/market-sales-search)
- OpenAPI YAML: [https://cspriceapi.com/openapi.yaml](https://cspriceapi.com/openapi.yaml)
- Data coverage: [https://cspriceapi.com/docs/data-coverage](https://cspriceapi.com/docs/data-coverage)

### GET /v1/market-sales/search

Look up sales by market_hash_name (Enterprise)

Returns historical marketplace **sales** for up to **5**
`market_hash_name` values, including nested `stickers` and `keychains` per sale.

At most **50** most recent sales are returned **per** `market_hash_name`
(so up to 250 rows when querying 5 names). Results are ordered by
`sold_at` descending.

Pass one or more names via repeated query params or a comma-separated list:

```
?market_hash_name=AK-47 | Redline (Field-Tested)
?market_hash_name=AK-47 | Redline (Field-Tested)&market_hash_name=M4A4 | Temukau (Minimal Wear)
?market_hash_name=AK-47 | Redline (Field-Tested),M4A4 | Temukau (Minimal Wear)
```

Optional filters:

- `marketplace`: `csfloat`, `youpin`, `skinport`
- `float_min`, `float_max`: float range (inclusive)
- `paint_index`: one or more paint indexes
- `paint_seed`: one or more paint seeds / patterns
- `price_min`, `price_max`: sale price range in **cents**

`price` and `reference_price` are in **cents**. `sale_id`, `sticker_id` and
`keychain_id` are returned as **strings** to avoid precision loss.


**Parameters**

| Name | In | Required | Description |
|---|---|---|---|
| `market_hash_name` | query | required | Steam `market_hash_name` to look up. Repeat up to 5 times, or pass a comma-separated list (max 5 unique names).  |
| `marketplace` | query | optional |  |
| `float_min` | query | optional | Minimum `float_value` (inclusive). |
| `float_max` | query | optional | Maximum `float_value` (inclusive). |
| `paint_index` | query | optional | Paint index filter. Repeat the parameter or pass a comma-separated list.  |
| `paint_seed` | query | optional | Paint seed / pattern filter. Repeat the parameter or pass a comma-separated list.  |
| `price_min` | query | optional | Minimum sale price in cents (inclusive). |
| `price_max` | query | optional | Maximum sale price in cents (inclusive). |

```bash
curl -s "https://api.cspriceapi.com/v1/market-sales/search" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

---

Full request/response schemas: import [openapi.yaml](https://cspriceapi.com/openapi.yaml) or use the Scalar UI on the HTML page.