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.

About this API

Available plans

Capability	Basic	Intermediate	Ultimate
Knife coverage	All knives except BFK, Karambit, Nomad, Skeleton, and Talon	Full	Full
Deagle Heat-Treated	Yes	Yes	Yes
MAC-10, AK-47, and Five-SeveN Case-Hardened	—	Yes	Yes
Price metric	3-month average per paintseed	Rolling 3-month average, with fallback to the latest tracked sale	Rolling 3-month average, with fallback to the latest tracked sale
Wear condition segmentation	—	Yes	Yes
Playside Blue %	—	Yes	Yes
Backside Blue %	—	—	Yes
StatTrak vs non-StatTrak segmentation	—	—	Yes
Machine-learning Skin "True Value" (Price Checker)	—	—	Yes
Price	$39 per month	$59 per month	$129 per month

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:

Plan	Pricing access
Basic	`PricingBasic`
Intermediate	`PricingIntermediate`
Ultimate	`PricingUltimate`

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

Getting started

API access

To request an API key, send an email to csgobluegems@gmail.com.

Authentication

Include your API key on every request via the x-api-key header:

x-api-key: <YOUR_API_KEY>

Environments

Development — mock/obfuscated data and a free trial window for integration testing.
Production — live data for production integrations.

Start on Development to validate your integration, then move to Production when you are ready for live data.

ApiKeyAuth

API key issued for your customer account.

Security Scheme Type: API Key

Header parameter name: x-api-key

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
}
}

PricingBasic

Basic pricing access. This API is currently under development.

Basic pricing API (coming soon)

The BASIC pricing API is currently under development. This endpoint is not yet available.

Authorizations:

ApiKeyAuth

Responses

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"
}
}