/v1/market-sales/search

GET

Look up sales by market_hash_name

GET/v1/market-sales/search

Look up sales by market_hash_name (Enterprise)

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.

Parameters

NameInRequiredDescription
market_hash_name
array
queryyesSteam market_hash_name to look up. Repeat up to 5 times, or pass a comma-separated list (max 5 unique names).
marketplace
string
queryno
Example: csfloat
float_min
number
querynoMinimum float_value (inclusive).
float_max
number
querynoMaximum float_value (inclusive).
paint_index
array
querynoPaint index filter. Repeat the parameter or pass a comma-separated list.
paint_seed
array
querynoPaint seed / pattern filter. Repeat the parameter or pass a comma-separated list.
price_min
integer
querynoMinimum sale price in cents (inclusive).
price_max
integer
querynoMaximum sale price in cents (inclusive).

Example request

curl -s "https://api.cspriceapi.com/v1/market-sales/search" \
  -H "x-api-key: YOUR_API_KEY"

Responses

  • 200Matching sales with nested stickers and keychains.
  • 400Missing or invalid parameters.
  • 401Missing, invalid, disabled or expired API key.
  • 403The API key is valid but is not allowed to call this endpoint (endpoint ACL).
  • 429Rate limit exceeded (10 requests per second per key). Retry after 1 second.
  • 500Internal server error – temporary upstream failure, etc.

Interactive explorer

Try requests with your API key and browse the full request/response schemas.

Loading endpoint…

This endpoint as Markdown (.md)