Skip to content

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.

POST/analytics.v1.Analytics/GetMarketSaleVolume

Request 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?string

Sold time to stop before, exclusive. Absent counts up to now.

Format"date-time"

soldFromstring

Earliest 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?LicensedSourcesWithheld

No 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?string

The rule that left them out.

Value in"LICENSED_SOURCE_LIMIT_NOT_SIGNED_IN""LICENSED_SOURCE_LIMIT_UNNAMED_ITEMS""LICENSED_SOURCE_LIMIT_ITEMS_PER_REQUEST""LICENSED_SOURCE_LIMIT_REQUESTS_PER_MINUTE""LICENSED_SOURCE_LIMIT_ITEMS_PER_DAY"

resetsAt?string

When 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?string

The licensed provider whose figures were left out.

volumes?array<MarketSaleVolume>

The volumes, ordered by market hash name then source.

Show attributes
averagePriceCents?string

Average 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?string

Market hash name of the item.

newestSoldAt?string

The newest sale in the range.

Format"date-time"

oldestSoldAt?string

The oldest sale in the range.

Format"date-time"

quantity?string

Units those sales moved.

Format"int64"

saleCount?integer

Recorded sales in the range.

Format"int32"

source?string

Market source the sales were recorded at.

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"
  }'
{
  "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"
    }
  ]
}