# How to Get CSFloat Doppler Listing Price History

> cs2.sh records CSFloat Doppler listing-floor OHLC separately for Phase 1-4, Ruby, Sapphire, and Black Pearl. Ask history begins December 24, 2025; bid history begins July 18, 2026.

A parent Doppler candle blends a different market identity from a phase candle. Phase-specific analysis must stay inside the requested variant rather than substituting the base item.

## How CSFloat Doppler history is structured

Request the base Doppler `market_hash_name`. The result nests each covered phase under `variants`, keyed by display name. Every variant carries `display_name` and a stable `version`:

- `p1`, `p2`, `p3`, and `p4` for numbered phases.
- `ruby`, `sapphire`, and `blackpearl` for Doppler gems.
- A sparse marketplace object appears only when CSFloat has data for that phase.

Each CSFloat bucket can include ask and bid open, high, low, and close fields. `ask_volume` is the last listing count in the bucket. CSFloat has no `bid_volume`. The top-level `bucket` is the UTC boundary; `open_time` and `close_time` show the actual source observation window; `sample_count` counts observations.

## Query a phase series

Send the base name to `POST /v1/prices/history`, select `csfloat`, and choose an interval. Read the desired phase under `variants`, then traverse its chronological `data[]` buckets.

`5m` supports at most 14 days, `30m` 90 days, `1h` 365 days, and `1d` an unlimited range. Up to 100 base item names fit in one request, with item-level failures returned in `errors[]` beside successful results.

For realized prices, `POST /v1/archive/csfloat` returns daily completed-sale averages and counts from 2022, including per-phase series when data exists. [CSFloat Doppler sales history](/resources/how-to-get-csfloat-doppler-sales-history) explains that archive.

## Applicable endpoints

| Endpoint | Returns | Plans |
| --- | --- | --- |
| `POST /v1/prices/history` | Phase-specific CSFloat ask and bid OHLC | Scale, Enterprise |
| `POST /v1/archive/csfloat` | Phase-specific completed-sale aggregates where present | Scale, Enterprise |
| `GET /v1/prices/latest` | Current phase quotes | All plans |

## Details that change the series

- A `close_ask` is the last observed cheapest listing in a bucket, not a completed sale.
- Bid fields before July 18, 2026 are absent even though ask history can exist. Do not convert that boundary into zero bids.
- Missing phase buckets are gaps. Parent candles and another phase are not substitutes.
- `sample_count` measures observations, while CSFloat archive `volume` measures completed sales.

The [OHLC response reference](/docs/api-reference/prices-history) documents the per-source fields.
