Skip to main content
GET
Liveness + freshness probe
The health endpoint is a lightweight probe that confirms the API is reachable and tells you how stale the materialized price list is. It is the only endpoint that works without an API key. That makes it safe to poll from monitoring systems, or to gate your application startup on a freshness check before making authenticated calls.

Response fields

string
required
Always "ok" when the service is up.
integer
required
Count of priced item groups currently in the price list (one group per unique market_hash_name + wear + doppler_phase combination).
integer
required
Age of the materialized price list in seconds. Use this as a freshness indicator — a large value means prices may be lagging.

Example request

Example response

Error codes

Poll this endpoint from your health-check or startup logic before making authenticated calls. If price_list_age_seconds is unexpectedly large (e.g. above a few minutes), treat downstream price data as potentially stale.

Response

200 - application/json

Service is up.

status
string
required
Example:

"ok"

groups
integer
required

Count of priced item groups.

price_list_age_seconds
integer
required

Age of the materialized price list, in seconds (freshness).