Skip to content

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.

POST/analytics.v1.Analytics/GetMarketObservationTimeSeries

Request body

application/jsonRequired

Request for the history of one or more source and metric pairs of an item over a time range.

endTimestring

Inclusive end of the time range as an RFC 3339 timestamp. Required. An unparseable value is rejected with invalid_argument.

Format"date-time"

marketHashName?string

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

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

Market source name, such as "c5game", "market-csgo" or "buff163".

startTimestring

Inclusive 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?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.

series?array<TimeSeries>

The requested series, each with its points in ascending time order.

Show attributes
historyStartsAt?string

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

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

When the value was observed, as an RFC 3339 UTC timestamp.

Format"date-time"

value?number

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

Market source of this series.

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"
  }'
{
  "series": [
    {
      "source": "market-csgo",
      "metric": "listing-price",
      "points": [
        {
          "timestamp": "2026-06-22T00:00:00Z",
          "value": 151200
        },
        {
          "timestamp": "2026-06-23T00:00:00Z",
          "value": 150400
        }
      ]
    }
  ]
}