Skip to content

API Reference / Market observations

Get the daily lowest listing price and change of a page of items

Returns, for up to 50 items, the lowest listing price per local day at the cheapest source over the last days, and the change from the first day to the last. For a list's sparkline and change columns in one read.

POST/analytics.v1.Analytics/GetItemPriceTrends

Request body

application/jsonRequired

Request for the daily lowest listing price of a page of items.

dayCount?integer

How many local days to return, ending today. Unset means 7. At most 30.

Format"int32"

marketHashNames?array<string>

Exact market hash names, at most 50.

sources?array<string>

Market sources to consider. Empty means every source.

timeZone?string

IANA time zone whose local days the points follow. Empty means UTC. An unknown zone is rejected.

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.

trends?array<ItemPriceTrend>

One entry per item with at least one observation.

Show attributes
agreedChangePercent?number

Percentage change of the agreed price from the first point that has one to the last point that has one. Unset with fewer than two such points.

Format"double"

changePercent?number

Percentage change from the first point to the last. Unset with fewer than two points or a zero first price.

Format"double"

marketHashName?string

The item.

points?array<ItemPriceTrendPoint>

One point per local day with an observation, oldest first.

Show attributes
agreedPriceCents?string

The agreed price that day: the lowest listing among the sources that a listing on at least one other market backs up within a factor of three, from each market's lowest listing that day, in US cents at the latest exchange rate. Unset when no two markets agreed that day.

Format"int64"

dayStart?string

Start of the local day in the requested time zone.

Format"date-time"

lowestListingCents?string

The lowest listing price observed that day across the sources, in US cents at the latest exchange rate.

Format"int64"

sourceLowestListingCents?string

The lowest listing price observed that day on the trend's source alone, in US cents at the latest exchange rate. Unset when the trend has no source or that source had no listing that day.

Format"int64"

source?string

The one market source the source trend is read on: the source of the item's current agreed price when that source has a listing on at least two of the days, else the source with a listing on the most days (ties to the lowest last price, then the name). Unset when no source has a listing on two days.

sourceChangePercent?number

Percentage change of the lowest listing on the trend's source from the first point that has one to the last point that has one. Unset when source is unset or the first such price is zero.

Format"double"

curl -X POST "https://api.goldmine.to/analytics.v1.Analytics/GetItemPriceTrends" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "dayCount": 3,
    "marketHashNames": [
      "AK-47 | Redline (Field-Tested)"
    ],
    "sources": [
      "buff163"
    ],
    "timeZone": "example"
  }'
{
  "licensedSourcesWithheld": {
    "limit": "LICENSED_SOURCE_LIMIT_NOT_SIGNED_IN",
    "resetsAt": "2026-11-03T16:10:00Z",
    "sourceFamily": "example"
  },
  "trends": [
    {
      "agreedChangePercent": 3,
      "changePercent": 3,
      "marketHashName": "AK-47 | Redline (Field-Tested)",
      "points": [
        {}
      ],
      "source": "buff163",
      "sourceChangePercent": 3
    }
  ]
}