History

The /v1/sales/history endpoint provides aggregated data for specific in-game items that have been sold on Skinport. The response includes key statistics (min, max, avg, median prices, and sales volume) for different time periods (24 hours, 7 days, 30 days, and 90 days).

tip

This endpoint is cached for 5 minutes. To optimize performance and reduce unnecessary requests, avoid calling this endpoint more frequently than once every 5 minutes. Rely on cached responses whenever possible to minimize server load and ensure efficient usage of resources.

HTTP Request

GET /v1/sales/history

Authorization

No authorization required.

Rate Limit

8 requests per 5 minutes.

Cache

Endpoint is cached for 5 minutes.

Encoding

The 'Accept-Encoding': 'br' header is required.

warning

It is generally recommended to use 'Accept-Encoding': 'br' in requests to enable Brotli compression for faster and smaller data transfers. However, for /v1/sales/history endpoint, Brotli compression (br) is required.

Arguments

Parameter	Type	Required	Description
market_hash_name	string	Optional	The item's names, comma-delimited.
app_id	number	Optional	The app_id for the inventory's game (default 730).
currency	string	Optional	The currency for pricing (default EUR - Supported: AUD, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HRK, NOK, PLN, RUB, SEK, TRY, USD).

tip

If you do not include the market_hash_name parameter, the API will return a list of all items. Use market_hash_name only when you are searching for a specific item or a specific subset of items.

Example Request

sales-history.js

const params = new URLSearchParams({
    app_id: 730,
    currency: 'EUR',
    market_hash_name: 'Glove Case,★ Karambit | Slaughter (Minimal Wear)'
});

(async () => {
    const response = await fetch(`https://api.skinport.com/v1/sales/history?${params}`, {
        method: 'GET',
        headers: {
            'Accept-Encoding': 'br'
        }
    });

    const data = await response.json();
    console.log(data);
})();

Example Response

console.log(data)

[
  {
    "market_hash_name": "Glove Case",
    "version": null,
    "currency": "EUR",
    "item_page": "https://skinport.com/item/glove-case",
    "market_page": "https://skinport.com/market?item=Glove%20Case&cat=Container",
    "last_24_hours": {
      "min": 5,
      "max": 6.38,
      "avg": 5.9,
      "median": 5.96,
      "volume": 118
    },
    "last_7_days": {
      "min": 5,
      "max": 6.43,
      "avg": 5.83,
      "median": 5.96,
      "volume": 730
    },
    "last_30_days": {
      "min": 4.19,
      "max": 6.45,
      "avg": 5.61,
      "median": 5.58,
      "volume": 5282
    },
    "last_90_days": {
      "min": 2.82,
      "max": 6.45,
      "avg": 5.36,
      "median": 5.41,
      "volume": 14521
    }
  },
  {
    "market_hash_name": "★ Karambit | Fade (Factory New)",
    "version": null,
    "currency": "EUR",
    "item_page": "https://skinport.com/item/karambit-fade-factory-new",
    "market_page": "https://skinport.com/market?item=Fade&cat=Knife&type=Karambit",
    "last_24_hours": {
      "min": null,
      "max": null,
      "avg": null,
      "median": null,
      "volume": 0
    },
    "last_7_days": {
      "min": 2130,
      "max": 2654.31,
      "avg": 2320.78,
      "median": 2249.4,
      "volume": 4
    },
    "last_30_days": {
      "min": 2130,
      "max": 2999,
      "avg": 2418.91,
      "median": 2342.41,
      "volume": 14
    },
    "last_90_days": {
      "min": 2010.33,
      "max": 2999,
      "avg": 2374,
      "median": 2360.2,
      "volume": 44
    }
  }
]