API docs by Redocly

CS2BlueGem Public API (1.0.0)

Download OpenAPI specification:

Authentication

  1. Request API access by email at csgobluegems@gmail.com.
  2. Send your key in the x-api-key request header.

Header format:

  • x-api-key: <YOUR_API_KEY>

Environment note

  • dev returns mock/obfuscated data. Use prod for production integrations.

ItemsCatalog

Catalog attributes by item and paint seed.

Get catalog attributes by item and paint seed

Returns official catalog attributes for the requested item and paint seed.

Authorizations:
ApiKeyAuth
path Parameters
itemName
required
string non-empty
Enum: "AK-47 | Case Hardened" "Bayonet | Case Hardened" "Bowie Knife | Case Hardened" "Butterfly Knife | Case Hardened" "Classic Knife | Case Hardened" "Desert Eagle | Heat Treated" "Falchion Knife | Case Hardened" "Flip Knife | Case Hardened" "Gut Knife | Case Hardened" "Huntsman Knife | Case Hardened" "Karambit | Case Hardened" "Kukri Knife | Case Hardened" "M9 Bayonet | Case Hardened" "MAC-10 | Case Hardened" "Navaja Knife | Case Hardened" "Nomad Knife | Case Hardened" "Paracord Knife | Case Hardened" "Shadow Daggers | Case Hardened" "Skeleton Knife | Case Hardened" "Stiletto Knife | Case Hardened" "Survival Knife | Case Hardened" "Talon Knife | Case Hardened" "Ursus Knife | Case Hardened"
Example: AK-47 | Case Hardened

Exact CS2 item name supported by this API.

paintseed
required
integer [ 0 .. 1000 ]
Example: 661

Paint seed value in the inclusive range 0-1000.

Responses

Response samples

Content type
application/json
{
  • "metadata": {
    },
  • "data": {
    }
}

Pricing

Pricing aggregates by item and paint seed.

Get pricing aggregates by item and paint seed

Returns pricing aggregates from real market transactions over the last 3 months, grouped by wear condition and currency. When 3-month aggregate coverage is unavailable, values fall back to the latest tracked transaction. Updated multiple times daily.

Authorizations:
ApiKeyAuth
path Parameters
itemName
required
string non-empty
Enum: "AK-47 | Case Hardened" "Bayonet | Case Hardened" "Bowie Knife | Case Hardened" "Butterfly Knife | Case Hardened" "Classic Knife | Case Hardened" "Desert Eagle | Heat Treated" "Falchion Knife | Case Hardened" "Flip Knife | Case Hardened" "Gut Knife | Case Hardened" "Huntsman Knife | Case Hardened" "Karambit | Case Hardened" "Kukri Knife | Case Hardened" "M9 Bayonet | Case Hardened" "MAC-10 | Case Hardened" "Navaja Knife | Case Hardened" "Nomad Knife | Case Hardened" "Paracord Knife | Case Hardened" "Shadow Daggers | Case Hardened" "Skeleton Knife | Case Hardened" "Stiletto Knife | Case Hardened" "Survival Knife | Case Hardened" "Talon Knife | Case Hardened" "Ursus Knife | Case Hardened"
Example: AK-47 | Case Hardened

Exact CS2 item name supported by this API.

paintseed
required
integer [ 0 .. 1000 ]
Example: 661

Paint seed value in the inclusive range 0-1000.

Responses

Response samples

Content type
application/json
{
  • "metadata": {
    },
  • "data": {
    }
}

SalesDataDump

Latest 30-day sales data export.

Get pre-signed URL for latest sales data dump report

Returns a short-lived download URL for the latest sales data dump JSON report. Restricted to authorized customers; returns 403 otherwise.

How to use

  1. Call this endpoint with your x-api-key.
  2. Read data.url from the 200 response.
  3. Perform an HTTPS GET to that URL from your backend process.

What to expect

  • The URL is temporary and should be treated as a secret.
  • If it expires, call this endpoint again to get a new URL.

Downloaded report example

{
  "metadata": {
    "entity": "SalesDataDumpReport",
    "schema_version": 1,
    "environment": "dev",
    "generated_at": "2026-02-24T14:10:12Z",
    "row_count": 2
  },
  "data": [
    {
      "market_hash_name": "AK-47 | Case Hardened (Field-Tested)",
      "item_name": "AK-47 | Case Hardened",
      "paintseed": 25,
      "floatvalue": 0.137421,
      "market": "CSFloat",
      "sale_price_cents": 12499,
      "price_currency_code": "USD",
      "transacted_at_ep": 1739980800,
      "transacted_at_ts": "2025-02-20T00:00:00Z",
      "record_type": "SALE"
    },
    ...
  ]
}
Authorizations:
ApiKeyAuth

Responses

Response samples

Content type
application/json
{}