Skip to content

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.

POST/analytics.v1.Analytics/ListMarketSales

Request body

application/jsonRequired

Request for one page of recorded sales, newest first.

cursor?string

next_cursor from the previous page of the same request. Empty starts at the newest sale.

filter?MarketSaleFilter

Which sales to list. market_hash_names is required.

Show attributes
marketHashNames?array<string>

Exact market hash names, between 1 and 50.

soldBefore?string

Sold time to stop before, exclusive. Absent includes sales up to now.

Format"date-time"

soldFrom?string

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

Maximum sales per page. Zero uses 50 and values above 200 are reduced to 200.

Format"int32"

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.

nextCursor?string

Cursor for the next page. Empty on the last page.

sales?array<MarketSaleRecord>

The sales on this page.

Show attributes
marketHashName?string

Market hash name of the item sold.

priceCents?string

Sale price in US cents, converted at the exchange rate in effect when the sale happened.

Format"int64"

quantity?integer

Units the record covers. A source that reports sales in buckets reports the bucket's count.

Format"int32"

soldAt?string

When the sale happened, with second precision.

Format"date-time"

source?string

Market source that reported the sale.

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
  }'
{
  "sales": [
    {
      "marketHashName": "AK-47 | Redline (Field-Tested)",
      "source": "market-csgo",
      "soldAt": "2026-11-08T06:52:32Z",
      "priceCents": "2617",
      "quantity": 1
    }
  ],
  "nextCursor": ""
}