Skip to content

API Reference / Pricing

Get the latest pricing for items across sources

Returns the most recent price, bid, listing count, volume, and liquidity figures for one or more items, optionally narrowed to specific market sources. Every monetary value is reported in US cents, and each figure carries its own observation time. A source that has been switched off is left out, and a source whose listing price is older than its stale-after window is flagged stale. The response's truncated flag is set when more matching rows exist than the deterministic row cap this endpoint returns, signalling that the entries are an incomplete prefix rather than the full match.

POST/analytics.v1.Analytics/GetPricing

Request body

application/jsonRequired

Request for the latest market figures of a set of items, a set of sources, or both. At least one of the two lists must be non-empty.

expectedCompletedFeedGeneration?string

Expected lowercase SHA256 completed-feed fingerprint from an earlier bounded batch. A mismatch before or during the read returns Aborted, including for empty results. This is a generation fence, not pagination.

marketHashNames?array<string>

Exact market hash names to return figures for. Empty returns every item at the requested sources.

sources?array<string>

Market sources to return figures from, such as "c5game" or "buff163". Empty returns every source for the requested items.

Response body

application/json

Success

completedFeedGeneration?string

Completed-feed fingerprint checked before and after this bounded read, returned even with no entries or no completed feeds. Empty on old readers means unknown. Independent catalog, primitive, sale and exchange-rate updates are not fenced. Callers calculating a full result must reject truncated responses and use this fence across batches.

entries?array<PricingEntry>

The latest figures for every matching item and source pair, up to the endpoint's row cap.

Show attributes
average30dObservedAt?string

When avg_30d_cents was observed. Absent when avg_30d_cents is absent.

Format"date-time"

average7dObservedAt?string

When avg_7d_cents was observed. Absent when avg_7d_cents is absent.

Format"date-time"

average90dObservedAt?string

When avg_90d_cents was observed. Absent when avg_90d_cents is absent.

Format"date-time"

avg30dCents?string

Average sale price over the last 30 days at the source, in US cents. Absent when the source does not report it.

Format"int64"

avg7dCents?string

Average sale price over the last 7 days at the source, in US cents. Absent when the source does not report it.

Format"int64"

avg90dCents?string

Average sale price over the last 90 days at the source, in US cents. Absent when the source does not report it.

Format"int64"

bidCents?string

Highest current buy order price at the source, in US cents. Absent when the source reports no bid.

Format"int64"

bidObservedAt?string

When bid_cents was observed. Absent when bid_cents is absent.

Format"date-time"

estimatedSaleDuration?string

The source's estimate of how long a listing takes to sell, in hours. Absent when the source does not report it.

estimatedSaleDurationObservedAt?string

When estimated_sale_duration was observed. Absent when estimated_sale_duration is absent.

Format"date-time"

liquidity?number

The source's liquidity score for the item, as reported by the source. Higher means easier to sell. Absent when the source does not report it.

Format"double"

liquidityObservedAt?string

When liquidity was observed. Absent when liquidity is absent.

Format"date-time"

listingsCount?integer

Number of active listings for the item at the source. Absent when the source does not report it. Zero means no active listings.

Format"int32"

listingsObservedAt?string

When listings_count was observed. Absent when listings_count is absent.

Format"date-time"

marketCapCents?string

Total market value of the item's supply at the source, in US cents. Absent when the source does not report it.

Format"int64"

marketCapObservedAt?string

When market_cap_cents was observed. Absent when market_cap_cents is absent.

Format"date-time"

marketHashName?string

Steam market hash name of the item these figures are for.

observedAt?string

When the listing price was observed, as an RFC 3339 UTC timestamp with second precision, such as "2026-10-05T12:00:00Z". Falls back to the item's latest observation at the source when there is no listing price.

Format"date-time"

priceCents?string

Lowest current listing price at the source, in US cents. Absent when the source reports no listing price.

Format"int64"

referenceAverage14dLag14dCents?number

Reference average sale price over the 14 days before the most recent 14 days, in US cents with a fractional part. Absent when no reference response exists or the response did not include this value.

Format"double"

referenceAverage3dCents?number

Reference average sale price over the last 3 days, in US cents with a fractional part. Absent when no reference response exists or the response did not include this value.

Format"double"

referenceAverage7dCents?number

Reference average sale price over the last 7 days, in US cents with a fractional part. Absent when no reference response exists or the response did not include this value.

Format"double"

referenceAverage7dLag7dCents?number

Reference average sale price over the 7 days before the most recent 7 days, in US cents with a fractional part. Absent when no reference response exists or the response did not include this value.

Format"double"

referenceComplete?boolean

Reference response completeness. Explicit false is an incomplete observed response. Absence means no response marker. Raw reference values require a complete same-clock cohort.

referenceCompletedCycleId?string

Completed feed publication selecting this reference response, never a staging successor. A base-only publication may inherit an older reference clock. Absent without a completed publication or reference marker.

referenceObservedAt?string

UTC reference-response timestamp with subsecond precision, independent of listing observed_at. Absent when no reference response exists.

Format"date-time"

referenceP80Last10Cents?number

80th percentile of the reference's last 10 sale prices, in US cents with a fractional part. Absent when no reference response exists or the response did not include this value.

Format"double"

referenceP90Last20Cents?number

90th percentile of the reference's last 20 sale prices, in US cents with a fractional part. Absent when no reference response exists or the response did not include this value.

Format"double"

sales7d?string

Number of sales the reference recorded over the last 7 days. Zero is a real observation of no sales. Absent when no reference response reported it.

Format"int64"

source?string

Market source the figures come from, such as "c5game", "market-csgo" or "buff163".

stale?boolean

True when observed_at is older than the source's stale-after window for its listing price, so the figures are no longer current. A source that has been switched off is not returned at all.

supply?number

Number of units of the item available at the source. Absent when the source does not report it.

Format"double"

supplyObservedAt?string

When supply was observed. Absent when supply is absent.

Format"date-time"

volume?integer

Number of units the source reports as traded in its volume window. Absent when the source does not report it.

Format"int32"

volumeObservedAt?string

When volume was observed. Absent when volume is absent.

Format"date-time"

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.

truncated?boolean

True when the request matched more rows than the endpoint's fixed row cap, so entries holds only part of the result. Narrow the request and retry. A truncated result must not be treated as complete.

curl -X POST "https://api.goldmine.to/analytics.v1.Analytics/GetPricing" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "marketHashNames": [
      "AK-47 | Redline (Field-Tested)",
      "AWP | Asiimov (Field-Tested)"
    ],
    "sources": [
      "market-csgo",
      "buff163"
    ]
  }'
{
  "entries": [
    {
      "marketHashName": "AK-47 | Redline (Field-Tested)",
      "source": "market-csgo",
      "priceCents": "150000",
      "bidCents": "148000",
      "listingsCount": 342,
      "volume": 128,
      "avg7dCents": "151200",
      "avg30dCents": "149800",
      "liquidity": 0.82,
      "observedAt": "2026-06-29T11:30:00Z",
      "supply": 342
    }
  ]
}