# Quickstart

Get live CS2 skin prices in a few minutes. Base URL: `https://api.cspriceapi.com`.

## 1. Get a Testkey

Join the [Discord](https://discord.gg/XT3rpfH4Tx) to receive your testkey.

Send it as a Bearer token:

```
Authorization: Bearer YOUR_API_KEY
```

For production keys and plans, see [Plans & Pricing](https://cspriceapi.com/pricing).

## 2. Fetch latest prices

All listing markets in one call (omit `markets` for every market your key allows):

```bash
curl -s "https://api.cspriceapi.com/v1/prices/latest" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

Limit markets with a CSV query:

```bash
curl -s "https://api.cspriceapi.com/v1/prices/latest?markets=youpin,buff163,skinport" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

Or look up specific items (max 100):

```bash
curl -s "https://api.cspriceapi.com/v1/prices/latest" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items":["AK-47 | Redline (Field-Tested)"],"markets":"youpin,buff163"}'
```

Interactive docs for this endpoint: [Latest prices](https://cspriceapi.com/docs/api/prices-latest).

## 3. Doppler phases

Doppler and Gamma Doppler items are priced **per phase**, not averaged. Look for `doppler_phase` on the item (Phase 1–4, Ruby, Sapphire, Black Pearl, Emerald). A Ruby is never compared against a Phase 2.

## 4. Specs and interactive docs

| Format | URL |
|---|---|
| OpenAPI YAML | [https://cspriceapi.com/openapi.yaml](https://cspriceapi.com/openapi.yaml) |
| OpenAPI JSON | [https://cspriceapi.com/api/openapi](https://cspriceapi.com/api/openapi) |
| Docs | [https://cspriceapi.com/docs/introduction](https://cspriceapi.com/docs/introduction) |

Import the YAML into Postman, Insomnia, or a code generator. Most prices update about every 5 minutes, depending on the marketplace. Doppler phases included.

## Next

- [Introduction](https://cspriceapi.com/docs/introduction)
- [AI coding agents](https://cspriceapi.com/docs/ai-coding-agents)
- [CS2 price API](https://cspriceapi.com/cs2-api)
- [Pricing](https://cspriceapi.com/pricing)
