API Reference / Market observations
Get historical market metric time series for an item
Returns historical data points for the requested source and metric combinations of an item over a time range. Each series is a list of timestamped values suitable for plotting price and volume history.
/ analytics. v1. Analytics/ GetMarketObservationTimeSeriesRequest body
application/jsonRequired
Request for the history of one or more source and metric pairs of an item over a time range.
endTimestringInclusive end of the time range as an RFC 3339 timestamp. Required. An unparseable value is rejected with invalid_argument.
Format"date-time"
marketHashName?stringExact Steam market hash name of the item.
sourceMetrics?array<SourceMetric>Source and metric pairs to return, at most 200. GetAvailableMetrics lists the pairs that have data.
Show attributes
metric?stringMetric name from the canonical vocabulary, such as "listing-price", "bid-price", "listings", "supply", "volume", "average-7d", "average-30d", "average-90d", "liquidity", "market-cap" or "estimated-sale-time-hours".
source?stringMarket source name, such as "c5game", "market-csgo" or "buff163".
startTimestringInclusive start of the time range as an RFC 3339 timestamp, such as "2026-10-01T00:00:00Z". Required. An unparseable value is rejected with invalid_argument.
Format"date-time"
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.
series?array<TimeSeries>The requested series, each with its points in ascending time order.
Show attributes
historyStartsAt?stringThe earliest retained observation of this pair for the item, so a chart can say where its history begins rather than imply a flat line before it. Gaps after it are not filled: a range with no observation has no point.
Format"date-time"
metric?stringMetric of this series.
points?array<TimeSeriesPoint>Observed values in ascending time order, at most the earliest 10000 in the range. Empty when the pair has no observations in the range.
Show attributes
timestamp?stringWhen the value was observed, as an RFC 3339 UTC timestamp.
Format"date-time"
value?numberThe observed value. Prices are in US cents converted at the exchange rate in effect at the observation. Counts and scores are reported as is.
Format"double"
source?stringMarket source of this series.
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/GetMarketObservationTimeSeries" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"marketHashName": "AK-47 | Redline (Field-Tested)",
"sourceMetrics": [
{
"source": "market-csgo",
"metric": "listing-price"
}
],
"startTime": "2026-06-22T00:00:00Z",
"endTime": "2026-06-29T00:00:00Z"
}'const res = await fetch("https://api.goldmine.to/analytics.v1.Analytics/GetMarketObservationTimeSeries", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"marketHashName": "AK-47 | Redline (Field-Tested)",
"sourceMetrics": [
{
"source": "market-csgo",
"metric": "listing-price"
}
],
"startTime": "2026-06-22T00:00:00Z",
"endTime": "2026-06-29T00:00:00Z"
}),
});
const data = await res.json();body := strings.NewReader(`{
"marketHashName": "AK-47 | Redline (Field-Tested)",
"sourceMetrics": [
{
"source": "market-csgo",
"metric": "listing-price"
}
],
"startTime": "2026-06-22T00:00:00Z",
"endTime": "2026-06-29T00:00:00Z"
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/analytics.v1.Analytics/GetMarketObservationTimeSeries", 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/GetMarketObservationTimeSeries",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"marketHashName": "AK-47 | Redline (Field-Tested)",
"sourceMetrics": [
{
"source": "market-csgo",
"metric": "listing-price"
}
],
"startTime": "2026-06-22T00:00:00Z",
"endTime": "2026-06-29T00:00:00Z"
},
)
data = res.json(){
"series": [
{
"source": "market-csgo",
"metric": "listing-price",
"points": [
{
"timestamp": "2026-06-22T00:00:00Z",
"value": 151200
},
{
"timestamp": "2026-06-23T00:00:00Z",
"value": 150400
}
]
}
]
}{
"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."
}