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.
/ analytics. v1. Analytics/ GetItemPriceTrendsRequest body
application/jsonRequired
Request for the daily lowest listing price of a page of items.
dayCount?integerHow 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?stringIANA time zone whose local days the points follow. Empty means UTC. An unknown zone is rejected.
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.
trends?array<ItemPriceTrend>One entry per item with at least one observation.
Show attributes
agreedChangePercent?numberPercentage 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?numberPercentage change from the first point to the last. Unset with fewer than two points or a zero first price.
Format"double"
marketHashName?stringThe item.
points?array<ItemPriceTrendPoint>One point per local day with an observation, oldest first.
Show attributes
agreedPriceCents?stringThe 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?stringStart of the local day in the requested time zone.
Format"date-time"
lowestListingCents?stringThe lowest listing price observed that day across the sources, in US cents at the latest exchange rate.
Format"int64"
sourceLowestListingCents?stringThe 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?stringThe 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?numberPercentage 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"
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/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"
}'const res = await fetch("https://api.goldmine.to/analytics.v1.Analytics/GetItemPriceTrends", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"dayCount": 3,
"marketHashNames": [
"AK-47 | Redline (Field-Tested)"
],
"sources": [
"buff163"
],
"timeZone": "example"
}),
});
const data = await res.json();body := strings.NewReader(`{
"dayCount": 3,
"marketHashNames": [
"AK-47 | Redline (Field-Tested)"
],
"sources": [
"buff163"
],
"timeZone": "example"
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/analytics.v1.Analytics/GetItemPriceTrends", 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/GetItemPriceTrends",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"dayCount": 3,
"marketHashNames": [
"AK-47 | Redline (Field-Tested)"
],
"sources": [
"buff163"
],
"timeZone": "example"
},
)
data = res.json(){
"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
}
]
}{
"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."
}