---
title: "Look up sales by market_hash_name (Enterprise)"
method: GET
path: "/v1/market-sales/search"
tags: ["Sales Data"]
---

# Look up sales by market_hash_name (Enterprise)

`GET /v1/market-sales/search`

## Request

- Base URL: `https://api.cspriceapi.com`
- URL: `https://api.cspriceapi.com/v1/market-sales/search`
- Auth: API key in header `x-api-key`

Returns recent 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.

Only sales from the **last 72 hours** are returned (**24 hours** for 2-day test keys).
Older sales are not available through this endpoint; a historical sales archive
(deduplicated CSV per month) is available on request.

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.

## Query parameters

- `market_hash_name` string[], required
- `marketplace` 'csfloat' | 'youpin' | 'skinport'
- `float_min` number
- `float_max` number
- `paint_index` integer[]
- `paint_seed` integer[]
- `price_min` integer
- `price_max` integer

## Response `200`

Matching sales with nested stickers and keychains.

- MarketSalesSearchResponse
  - `market_hash_names` string[], required
  - `count` integer, required
  - `data` MarketSaleSearchItem[], required
    - `marketplace` 'csfloat' | 'youpin' | 'skinport'
    - `sale_id` string: UInt64 as string.
    - `market_hash_name` string
    - `price` integer: Sale price in cents.
    - `sold_at` string
    - `def_index` integer
    - `paint_index` integer
    - `paint_seed` integer
    - `float_value` number
    - `is_stattrak` 0 | 1
    - `is_souvenir` 0 | 1
    - `rarity` integer
    - `quality` integer
    - `cs2_img` string
    - `fetched_at` string
    - `stickers` MarketSalesCsvStickersRow[], required
      - `marketplace` string
      - `sale_id` string
      - `sold_at` string
      - `position_idx` integer
      - `sticker_id` string
      - `slot` integer
      - `sticker_name` string
      - `wear` number
      - `offset_x` number
      - `offset_y` number
      - `rotation` number
      - `reference_price` integer: Reference price in cents.
      - `reference_quantity` integer
      - `reference_updated` string
      - `fetched_at` string
    - `keychains` MarketSalesCsvKeychainsRow[], required
      - `marketplace` string
      - `sale_id` string
      - `sold_at` string
      - `position_idx` integer
      - `keychain_id` string
      - `slot` integer
      - `keychain_name` string
      - `pattern` integer
      - `offset_x` number
      - `offset_y` number
      - `offset_z` number
      - `reference_price` integer
      - `reference_quantity` integer
      - `reference_updated` string
      - `fetched_at` string
  - `source` string, required
  - `requestor` string, email
  - `plan` string
  - `timestamp` string, date-time, required: ISO-8601 UTC timestamp (millisecond precision).

## Other responses

- `400`: Missing or invalid parameters.
- `401`: Missing, invalid, disabled or expired API key.
- `403`: The API key is valid but is not allowed to call this endpoint (endpoint ACL).
- `429`: Rate limit exceeded (10 requests per second per key). Retry after 1 second.
- `500`: Internal server error – temporary upstream failure, etc.

---

[API](https://skmtc.dev/cspriceapi/apis/cs-price-api.md) · [All operations](https://skmtc.dev/cspriceapi/apis/cs-price-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cspriceapi/apis/cs-price-api/revisions/4a18a7641dad?raw)