API Reference / Market sales
List recent individual market sales for items
Returns the recorded sales of one or more items, newest first, optionally narrowed to sources and a sold time range. Prices are converted to US cents at the exchange rate in effect when each sale happened. Sales are retained for three months, and a source an operator has switched off is left out.
/ analytics. v1. Analytics/ ListMarketSalesRequest body
application/jsonRequired
Request for one page of recorded sales, newest first.
cursor?stringnext_cursor from the previous page of the same request. Empty starts at the newest sale.
filter?MarketSaleFilterWhich sales to list. market_hash_names is required.
Show attributes
marketHashNames?array<string>Exact market hash names, between 1 and 50.
soldBefore?stringSold time to stop before, exclusive. Absent includes sales up to now.
Format"date-time"
soldFrom?stringEarliest sold time to include, inclusive. Absent starts at the retention window.
Format"date-time"
sources?array<string>Sources to include, such as "market-csgo". Empty includes every enabled source.
limit?integerMaximum sales per page. Zero uses 50 and values above 200 are reduced to 200.
Format"int32"
Response body
application/json
Success
licensedSourcesWithheld?LicensedSourcesWithheldNo longer set: price reads carry no limits, so no licensed price source's figures are left out. Kept so existing clients still decode the response.
Show attributes
limit?stringThe rule that left them out.
Value in"LICENSED_"LICENSED_"LICENSED_"LICENSED_"LICENSED_
resetsAt?stringWhen the limit next admits the read, for the per-minute and per-day limits. Absent for a rule the caller fixes by changing the read.
Format"date-time"
sourceFamily?stringThe licensed provider whose figures were left out.
nextCursor?stringCursor for the next page. Empty on the last page.
sales?array<MarketSaleRecord>The sales on this page.
Show attributes
marketHashName?stringMarket hash name of the item sold.
priceCents?stringSale price in US cents, converted at the exchange rate in effect when the sale happened.
Format"int64"
quantity?integerUnits the record covers. A source that reports sales in buckets reports the bucket's count.
Format"int32"
soldAt?stringWhen the sale happened, with second precision.
Format"date-time"
source?stringMarket source that reported the sale.
application/json
The request was malformed, such as a missing required field or an unparseable cursor.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request lacks a valid API key in the Authorization header.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The API key is not allowed to perform this action on this workspace.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request was rate limited. Slow down and retry later.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
An internal server error occurred.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
curl -X POST "https://api.goldmine.to/analytics.v1.Analytics/ListMarketSales" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"filter": {
"marketHashNames": [
"AK-47 | Redline (Field-Tested)"
]
},
"limit": 50
}'const res = await fetch("https://api.goldmine.to/analytics.v1.Analytics/ListMarketSales", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"filter": {
"marketHashNames": [
"AK-47 | Redline (Field-Tested)"
]
},
"limit": 50
}),
});
const data = await res.json();body := strings.NewReader(`{
"filter": {
"marketHashNames": [
"AK-47 | Redline (Field-Tested)"
]
},
"limit": 50
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/analytics.v1.Analytics/ListMarketSales", body)
if err != nil {
return err
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("CSTRADER_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)import os, requests
res = requests.post(
"https://api.goldmine.to/analytics.v1.Analytics/ListMarketSales",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"filter": {
"marketHashNames": [
"AK-47 | Redline (Field-Tested)"
]
},
"limit": 50
},
)
data = res.json(){
"sales": [
{
"marketHashName": "AK-47 | Redline (Field-Tested)",
"source": "market-csgo",
"soldAt": "2026-11-08T06:52:32Z",
"priceCents": "2617",
"quantity": 1
}
],
"nextCursor": ""
}{
"code": "invalid_argument",
"message": "The request was malformed, such as a missing required field or an unparseable cursor."
}{
"code": "unauthenticated",
"message": "The request lacks a valid API key in the Authorization header."
}{
"code": "permission_denied",
"message": "The API key is not allowed to perform this action on this workspace."
}{
"code": "resource_exhausted",
"message": "The request was rate limited. Slow down and retry later."
}{
"code": "internal",
"message": "An internal server error occurred."
}