Integrations & API

Manage external integrations for deal alerts

Link your Telegram to receive deal alerts as messages.

Discord

Add a Discord webhook URL to receive deal alerts in your server.

API Keys

No API keys yet. Generate one to access the deals REST API.

API Documentation

Endpoint

GET https://cs2locker.com/api/v1/deals

Authentication

Pass your API key in the Authorization header:

Authorization: Bearer cs2l_your_key_here

Rate Limits

30 requests per minute per API key. Rate limit info is included in response headers:

X-RateLimit-Limit — max requests per window

X-RateLimit-Remaining — requests left

X-RateLimit-Reset — window reset (Unix timestamp)

Response

{
  "deals": [
    {
      "id": "listing_id",
      "name": "AK-47 | Redline (Field-Tested)",
      "wear_name": "Field-Tested",
      "float_value": 0.250123,
      "cs_price": 12.50,
      "youpin_price": 14.20,
      "youpin_discount": 88.0,
      "median_price": 13.80,
      "median_discount": 90.6,
      "phase": null,
      "type_name": "Rifle",
      "rarity_name": "Classified",
      "low_float": false,
      "created_at": "2026-03-24T18:00:00.000Z",
      "expires_at": "2026-03-24T20:00:00.000Z"
    }
  ],
  "count": 1,
  "timestamp": "2026-03-24T18:05:00.000Z"
}

Field Reference

cs_price — current CSFloat listing price (USD)

median_price — median of recent CSFloat sales for same wear (USD)

median_discount — cs_price as % of median (90 = 10% below median)

youpin_price — current Youpin market price (USD)

youpin_discount — cs_price as % of Youpin (88 = 12% below Youpin)

low_float — flagged as unusually low float for its wear

expires_at — deal expires from feed at this time (2h TTL)

Example (cURL)

curl -H "Authorization: Bearer cs2l_your_key" \
  https://cs2locker.com/api/v1/deals

Example (Python)

import requests

resp = requests.get(
    "https://cs2locker.com/api/v1/deals",
    headers={"Authorization": "Bearer cs2l_your_key"}
)
deals = resp.json()["deals"]
for d in deals:
    savings = 100 - d["median_discount"] if d["median_discount"] else None
    print(f'{d["name"]} ${d["cs_price"]:.2f} ({f"-{savings:.1f}%" if savings else "N/A"})')

Example (JavaScript)

const resp = await fetch("https://cs2locker.com/api/v1/deals", {
  headers: { Authorization: "Bearer cs2l_your_key" }
});
const { deals } = await resp.json();
deals.forEach(d => {
  const savings = d.median_discount ? (100 - d.median_discount).toFixed(1) : "N/A";
  console.log(`${d.name} $${d.cs_price} (-${savings}%)`);
});

Error Codes

401 — missing, invalid, or revoked API key

429 — rate limit exceeded (wait and retry)

500 — server error (retry with backoff)