---
title: "Get historical prices for one skin (Enterprise)"
method: GET
path: "/v1/prices/{market}/history"
tags: ["Price History"]
---

# Get historical prices for one skin (Enterprise)

`GET /v1/prices/{market}/history`

## Request

- Base URL: `https://api.cspriceapi.com`
- URL: `https://api.cspriceapi.com/v1/prices/{market}/history`
- Auth: API key in header `x-api-key`

Returns historical listing prices for **exactly one**
`market_hash_name` on a given marketplace.


| `resolution` | Source | Density | Typical retention |
|--------------|--------|---------|-------------------|
| `hourly` | `price_history_*` | up to 24 points/day (`slot`) | last ~100 days |
| `daily` (default) | `price_daily_*` | 1 point/day | full history |

Requesting `hourly` for a `from`/`to` window longer than **100 days**
returns `400` — use `daily` for longer ranges.


`youpin`, `buff163`, `c5game`, `skinport`, `skinbaron`, `market-csgo`,
`csfloat`, `dmarket`, `ecosteam`, `lisskins`, `skinland`, `shadowpay`,
`waxpeer`.


Prices are decimal **strings** in the marketplace's native currency
(`currency` in the response): CNY / EUR / USD. CSFloat history is stored
in USD cents and converted to USD for the response.

## Path parameters

- `market` 'youpin' | 'buff163' | 'c5game' | 'skinport' | 'skinbaron' | 'market-csgo' | 'csfloat' | 'dmarket' | 'ecosteam' | 'lisskins' | 'skinland' | 'shadowpay' | 'waxpeer', required

## Query parameters

- `market_hash_name` string, required
- `resolution` 'hourly' | 'daily'
- `from` string, date
- `to` string, date

## Response `200`

Historical price series for the requested skin.

- PriceHistoryResponse: Envelope fields returned by every `GET /v1/prices/*` response.
  - `source` string, required: Human-readable marketplace identifier.
  - `requestor` string, email: Email address associated with the API key making the call.
  - `plan` string: Plan of the API key (e.g. `free`, `pro`, `enterprise`).
  - `timestamp` string, date-time, required: ISO-8601 UTC timestamp (millisecond precision).
  - `market` string, required
  - `market_hash_name` string, required
  - `resolution` 'hourly' | 'daily', required
  - `currency` 'CNY' | 'EUR' | 'USD', required
  - `from` string, date, required
  - `to` string, date, required
  - `count` integer, required
  - `data` union[], required
    - union
      - PriceHistoryPointDaily
        - `day` string, date, required
        - `price` string: Fixed-point decimal value serialized as a string (preserves precision across languages). Parse with an arbitrary-precision decimal library; do **not** parse as a native float.
        - `count` integer, nullable
      - PriceHistoryPointHourly
        - `day` string, date, required
        - `slot` integer, required: Hourly bucket index within the day (0–23).
        - `last_ts` string
        - `price` string: Fixed-point decimal value serialized as a string (preserves precision across languages). Parse with an arbitrary-precision decimal library; do **not** parse as a native float.
        - `count` integer, nullable

## Other responses

- `400`: Invalid parameters or hourly range too long.
- `401`: Missing, invalid, disabled or expired API key.
- `403`: The API key is valid but is not allowed to call this endpoint (endpoint ACL).
- `404`: Unknown marketplace slug.
- `429`: Rate limit exceeded (10 requests per second per key). Retry after 1 second.
- `500`: Internal server error – temporary upstream failure, etc.

---

[API](https://skmtc.dev/cspriceapi/apis/cs-price-api.md) · [All operations](https://skmtc.dev/cspriceapi/apis/cs-price-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cspriceapi/apis/cs-price-api/revisions/4a18a7641dad?raw)