CS2BlueGem Public API (1.0.0)

Download OpenAPI specification:

Pattern-level analytics for Case-Hardened skins.

The CS2BlueGem API provides structured access to the most complete datasets available for Case-Hardened skins, including paintseed pricing, blue percentages and machine-learning value estimation.

The dataset is built from years of aggregated marketplace sales data and continuously updated with rolling market information.

Available plans

Basic

Knife coverage: all knives except BFK / Karambit / Nomad / Skeleton / Talon
Deagle Heat-Treated data
3-month average sale price per paintseed

Intermediate

Full knife coverage
MAC-10 Case-Hardened data
AK-47 Case-Hardened data
Wear condition price segmentation
Playside Blue %
Rolling 3-month average price with fallback to latest tracked sale

Ultimate

Everything included in Intermediate
Backside Blue %
StatTrak vs non-StatTrak price segmentation
Machine learning Skin "True Value" estimation

Why developers build with CS2BlueGem API

Unlike generic skin price APIs, CS2BlueGem API focuses on pattern-dependent skins where value changes significantly depending on paintseed.

This makes the API especially useful for:

Skin price checkers
Trading platforms
Inventory valuation tools
Sniping bots
Pattern analysis dashboards

Developers use CS2BlueGem API when they need:

Pattern-level pricing
Blue percentage analysis
Market-verified sales history
Machine-learning valuation

This enables accurate pricing of Case-Hardened skins, something traditional APIs typically cannot provide.

Technical endpoint access

All plans include access to ItemsCatalog.

Pricing access depends on your plan tier:

Basic → PricingBasic
Intermediate → PricingIntermediate
Ultimate → PricingUltimate

SalesDataDump is available only via customer allowlist and is not included in standard plans.

Usage Notes

Authentication

Request API access by email at csgobluegems@gmail.com.
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

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

200
400
401
404
500

Content type

application/json

{"metadata": {"entity": "ItemsCatalog",
"schema_version": 1,
"environment": "dev"
},
"data": {"item_name": "AK-47 | Case Hardened",
"paintseed": 661,
"gem_tier": 1,
"blue_pct_playside": 0.8123,
"blue_rank": 7,
"playside_rank": 3,
"backside_rank": 42
}
}

PricingIntermediate

Pricing aggregates by item and paint seed.

Get pricing aggregates by item and paint seed (INTERMEDIATE plan)

Returns the INTERMEDIATE pricing report for the requested item and paint seed. Data is grouped by wear condition and currency, using a rolling 3-month average with fallback to the latest tracked sale when recent coverage is unavailable. Updated multiple times daily.

Authorizations:

ApiKeyAuth

path Parameters

itemName

required

string non-empty

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

200
400
401
404
500

Content type

application/json

{"metadata": {"entity": "SalesData",
"schema_version": 1,
"environment": "dev"
},
"data": {"item_name": "AK-47 | Case Hardened",
"paintseed": 661,
"blue_pct_playside": 0.8123,
"data_points_by_wear": {"Factory New": {"USD": {"avg_sale_price": 1234,
"data_source": "ACTIVE_3M"
},
"EUR": {"avg_sale_price": 1180,
"data_source": "ACTIVE_3M"
},
"CNY": {"avg_sale_price": 9050,
"data_source": "ACTIVE_3M"
}
},
"Minimal Wear": {"USD": {"avg_sale_price": 1090,
"data_source": "FALLBACK_HISTORICAL"
},
"EUR": {"avg_sale_price": 1150,
"data_source": "FALLBACK_HISTORICAL"
}
},
"Field-Tested": {"USD": {"avg_sale_price": 980,
"data_source": "ACTIVE_3M"
}
},
"Well-Worn": {"CNY": {"avg_sale_price": 6400,
"data_source": "FALLBACK_HISTORICAL"
}
},
"Battle-Scarred": {"USD": {"avg_sale_price": 760,
"data_source": "ACTIVE_3M"
}
}
}
}
}

PricingUltimate

Pricing reports with category split and Pricechecker predictions.

Get pricing report by item, paint seed, and category (ULTIMATE plan)

Returns the ULTIMATE pricing report for the requested item and paint seed. In addition to the standard wear/currency pricing aggregates, this endpoint supports category-based segmentation (normal or stattrak), includes both playside and backside blue percentages, and adds a wear-level Pricechecker estimate report (estimated price, bounds and confidence) for knives requests only.

Authorizations:

ApiKeyAuth

path Parameters

itemName

required

string non-empty

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.

query Parameters

Responses

Response samples

Content type

application/json

{"metadata": {"entity": "UltimateSalesData",
"schema_version": 1,
"environment": "dev"
},
"data": {"item_name": "Karambit | Case Hardened",
"paintseed": 661,
"category": "normal",
"is_stattrak": false,
"blue_pct_playside": 0.8123,
"blue_pct_backside": 0.231,
"data_points_by_wear": {"Factory New": {"USD": {"avg_sale_price": 1234,
"data_source": "ACTIVE_3M"
}
},
"Minimal Wear": {"USD": {"avg_sale_price": 1090,
"data_source": "ACTIVE_3M"
}
},
"Field-Tested": {"USD": {"avg_sale_price": 980,
"data_source": "ACTIVE_3M"
}
},
"Well-Worn": {"USD": {"avg_sale_price": 860,
"data_source": "FALLBACK_HISTORICAL"
}
},
"Battle-Scarred": {"USD": {"avg_sale_price": 760,
"data_source": "ACTIVE_3M"
}
}
},
"pricechecker_by_wear": {"Factory New": {"estimated_price": 1425.2,
"price_range": {"low": 1330,
"high": 1510.8
},
"confidence": {"uncertainty": 0.12
}
},
"Minimal Wear": {"estimated_price": 1260.4,
"price_range": {"low": 1185,
"high": 1338.6
},
"confidence": {"uncertainty": 0.15
}
},
"Field-Tested": {"estimated_price": 1098,
"price_range": {"low": 1020,
"high": 1164.2
},
"confidence": {"uncertainty": 0.18
}
},
"Well-Worn": {"estimated_price": 941.6,
"price_range": {"low": 880.2,
"high": 1008
},
"confidence": {"uncertainty": 0.22
}
},
"Battle-Scarred": null
}
}
}

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

Call this endpoint with your x-api-key.
Read data.url from the 200 response.
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

200
401
403
404
500

Content type

application/json

{"metadata": {"entity": "SalesDataDumpDownloadUrl",
"schema_version": 1,
"environment": "dev"
},
"data": {"url": "https://downloads.example.com/report?token=eyJhbGciOi...",
"object_key": "reports/raw-data-latest.json",
"expires_in_seconds": 180,
"expires_at": "2026-02-24T15:04:05Z"
}
}