API Reference / Market sales
Count recorded market sales for a page of items
Returns, per item and source, how many sales were recorded in a sold time range and how many units they moved, with the oldest and newest sale. Up to 50 items per call, so a catalog page reads its volumes at once. A source an operator has switched off is left out.
/ analytics. v1. Analytics/ GetMarketSaleVolumeRequest body
application/jsonRequired
Request for the recorded sale counts of a page of items.
marketHashNames?array<string>Exact market hash names, between 1 and 50.
soldBefore?stringSold time to stop before, exclusive. Absent counts up to now.
Format"date-time"
soldFromstringEarliest sold time to count, inclusive. Required, and at most three months back, the retention window.
Format"date-time"
sources?array<string>Sources to include. Empty includes every enabled source.
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.
volumes?array<MarketSaleVolume>The volumes, ordered by market hash name then source.
Show attributes
averagePriceCents?stringAverage price of one unit sold in the range, in US cents: every sale's price weighted by its units, converted at the latest exchange rate. Absent when no sale in the range could be converted.
Format"int64"
marketHashName?stringMarket hash name of the item.
newestSoldAt?stringThe newest sale in the range.
Format"date-time"
oldestSoldAt?stringThe oldest sale in the range.
Format"date-time"
quantity?stringUnits those sales moved.
Format"int64"
saleCount?integerRecorded sales in the range.
Format"int32"
source?stringMarket source the sales were recorded at.
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/GetMarketSaleVolume" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"marketHashNames": [
"AK-47 | Redline (Field-Tested)",
"AWP | Asiimov (Field-Tested)"
],
"soldFrom": "2026-11-01T00:00:00Z"
}'const res = await fetch("https://api.goldmine.to/analytics.v1.Analytics/GetMarketSaleVolume", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"marketHashNames": [
"AK-47 | Redline (Field-Tested)",
"AWP | Asiimov (Field-Tested)"
],
"soldFrom": "2026-11-01T00:00:00Z"
}),
});
const data = await res.json();body := strings.NewReader(`{
"marketHashNames": [
"AK-47 | Redline (Field-Tested)",
"AWP | Asiimov (Field-Tested)"
],
"soldFrom": "2026-11-01T00:00:00Z"
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/analytics.v1.Analytics/GetMarketSaleVolume", 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/GetMarketSaleVolume",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"marketHashNames": [
"AK-47 | Redline (Field-Tested)",
"AWP | Asiimov (Field-Tested)"
],
"soldFrom": "2026-11-01T00:00:00Z"
},
)
data = res.json(){
"volumes": [
{
"marketHashName": "AK-47 | Redline (Field-Tested)",
"source": "market-csgo",
"saleCount": 412,
"quantity": "412",
"oldestSoldAt": "2026-11-01T00:12:09Z",
"newestSoldAt": "2026-11-08T06:52:32Z",
"averagePriceCents": "2631"
}
]
}{
"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."
}