Catalog API: Items, Providers, and FX Rates

The Catalog API gives you everything you need to build search interfaces, validate item identifiers, understand provider capabilities, and handle currency conversion.

All four endpoints are available on every tier — including free — and shouldn’t consume significant quota relative to market-data endpoints.

GET /items — List items

Searches the CS2 item catalog and returns full metadata for every match. You can filter by name, type, wear, phase, rarity, and many other attributes. Use GET /items/metadata to see the list of accepted filter values. Tiers: free · starter · pro · quant

curl -sS \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  "$CS2C_API_BASE/items?q=AK-47&item_type=Rifle&limit=10"

Parameters

string

Case-insensitive substring search by name (e.g. doppler).

item_id

integer

Exact item ID match (e.g. 4994)

market_hash_name

string

Exact market hash name match (e.g. ★ Karambit | Doppler (Factory New)).

item_type

string

Filter by item type (e.g. Weapon)

item_subtype

string

Filter by item subtype (e.g. Knives).

weapon_type

string

Filter by weapon type (e.g. Knife).

base_name

string

Exact base name match, case-insensitive (e.g. Karambit).

skin_name

string

Exact skin name match, case-insensitive (e.g. Doppler).

wear_name

string

Filter by wear condition (e.g. Factory New).

phase

string

Doppler or Gamma Doppler phase filter (e.g. Phase 1).

collection

string

Exact collection name match, case-insensitive (e.g. The Chroma Collection).

crates

string

Filter by crate name. Repeat to pass multiple values (e.g. Chroma 3 Case).

rarity_name

string

Filter by rarity name (e.g. Covert).

rarity_color

string

Filter by rarity color hex or name (e.g. eb4b4b or red).

style_name

string

Filter by finish style (e.g.Anodized Multicolored).

is_stattrak

boolean

Filter to StatTrak items only (true) or exclude them (false).

is_souvenir

boolean

Filter to Souvenir items only (true) or exclude them (false).

limit

integer

Maximum items to return. Range: 1–1000. Omit to return all matching results.

Response example

{
  "items": [
    {
      "item_id": 8470,
      "market_hash_name": "AWP | Dragon Lore (Factory New)",
      "phase": null,
      "item_type": "Weapon",
      "item_subtype": "Rifles",
      "weapon_type": "Sniper Rifle",
      "base_name": "AWP",
      "skin_name": "Dragon Lore",
      "wear_name": "Factory New",
      "def_index": "9",
      "paint_index": 344,
      "collection": "The Cobblestone Collection",
      "collection_image": "https://cdn.cs2c.app/images/...",
      "crates": [
        "Atlanta 2017 Cobblestone Souvenir Package",
        "Boston 2018 Cobblestone Souvenir Package"
      ],
      "crates_images": [
        "https://cdn.cs2c.app/images/...",
        "https://cdn.cs2c.app/images/..."
      ],
      "rarity_name": "Covert",
      "rarity_color": "eb4b4b",
      "style_name": "Custom Paint Job",
      "is_stattrak": false,
      "is_souvenir": false,
      "min_float": 0,
      "max_float": 0.7,
      "image_url": "https://cdn.cs2c.app/images/...",
      "supply": 1591
    }
  ]
}

Response fields

item_id

integer

Unique catalog item ID. Use this value in market-data endpoint parameters that accept item_id.

market_hash_name

string

Full item name as it appears in the Steam economy.

phase

string

Doppler or Gamma Doppler phase, or null for non-phased items.

item_type

string

High-level item type.

item_subtype

string

Item subtype within the type.

weapon_type

string

Weapon or wearable category.

base_name

string

Base item name without skin or wear (e.g. Specialist Gloves).

skin_name

string

Skin name without the base item or wear (e.g. Crimson Kimono).

wear_name

string

Wear condition.

def_index

string

Steam economy definition index for this item.

paint_index

integer

Paint index identifying the skin pattern.

collection

string

Collection the item belongs to, or null.

collection_image

string

Image URL for the item’s collection, or null.

crates

string[]

Names of cases or crates the item can be unboxed from.

crates_images

string[]

Image URLs for the associated cases or crates. Indexes align with the crates array.

rarity_name

string

Rarity tier name.

rarity_color

string

Rarity color as a hex string.

style_name

string

Finish style name.

is_stattrak

boolean

Whether the item is StatTrak.

is_souvenir

boolean

Whether the item is a Souvenir variant.

min_float

number

Minimum possible float value for this skin.

max_float

number

Maximum possible float value for this skin.

image_url

string

URL to the item’s image on the CS2Cap CDN.

supply

integer

Approximate circulating supply. Present only when the value is available.

Exclude limit to return all items in a single response. This is useful when you want to download the full catalog or build a local search index.

GET /items/metadata — Catalog metadata

Returns catalog summary counts and the valid filter option values for every enumerated field. Use this endpoint to pre-populate search dropdowns or validate filter inputs before calling GET /items. Tiers: free · starter · pro · quant

curl -sS \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  "$CS2C_API_BASE/items/metadata"

Parameters

This endpoint takes no parameters.

Response example

{
  "catalog": {
	"total_items": 38837
  },
  "filters": {
	"item_type": ["Agent", "Crate", "Weapon"],
	"item_subtype": ["Weapon Case", "Autograph", "Rifles"],
	"weapon_type": ["Assault Rifle", "Pistol", "Knife"],
	"wear_name": ["Factory New", "Field-Tested", "Well-Worn"],
	"phase": ["Phase 1", "Ruby", "Emerald"],
	"collection": ["The Fever Collection", "Paris 2023 Stickers"],
	"rarity_name": ["Base Grade", "Covert", "Extraordinary"],
	"rarity_color": ["b0c3d9", "white", "eb4b4b", "red"],
	"style_name": ["Case Hardening", "Custom Paint Job", "None"]
  }
}

Response fields

catalog.total_items

integer

Total number of items in the CS2Cap catalog.

filters

object

Valid values for each enumerated filter parameter accepted by GET /items. Arrays contain only values that exist for at least one item in the current catalog.

GET /providers — List providers

Returns metadata, fee information, and live health data for all enabled CS2 marketplaces. You can optionally filter to a single provider by key. Tiers: free · starter · pro · quant

curl -sS \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  "$CS2C_API_BASE/providers?provider=buff163"

Parameters

provider

string

Optional provider key. Omit to return all providers. One of: avanmarket, buff163, buffmarket, c5, csdeals, csfloat, csgo500, csgoempire, csmoney_m, csmoney_t, cstrade, dmarket, dupefi, ecosteam, gameboost, haloskins, itradegg, lisskins, lootfarm, mannco, marketcsgo, pirateswap, rapidskins, shadowpay, skinbaron, skinflow, skinland, skinout, skinplace, skinport, skinscom, skinsmonkey, skinswap, skinvault, steam, swapgg, tradeit, waxpeer, whitemarket, youpin.

Response example

{
  "Youpin898": {
    "key": "youpin",
    "logo": "https://cdn.cs2c.app/images/providers/youpin.png",
    "code": "YOUP",
    "market_type": "P2P",
    "default_currency": "CNY",
    "fees": {
      "sell_fee": 0.01,
      "insta_sell_fee": null,
      "trading_spread_fee": null
    },
    "features": {
      "has_buy_orders": true,
      "has_recent_sales": true
    },
    "health": {
      "status": "up",
      "last_checked_at": "2026-05-09T14:36:20.999290+00:00",
      "total_offers": 6843832,
      "unique_items": 27139,
      "market_coverage": 69.57,
      "total_value": 118823350654,
      "total_value_usd": 17470733135
    }
  }
}

Response fields

The response is a map keyed by the provider’s display name. Each value is an object with the following fields:

key

string

Machine-readable provider key. Use this value in providers parameters across market-data endpoints.

code

string

Short provider code.

market_type

string

Market structure. STORE (fixed-price listings) or P2P (peer-to-peer marketplace).

default_currency

string

The provider’s native currency as an ISO 4217 code.

fees

object

Fee information for this provider. All values are decimal fractions — for example, 0.025 = 2.5%. null means that fee type does not apply.

Show fee properties

sell_fee

number

Standard sell-side fee fraction, or null.

insta_sell_fee

number

Instant-sell fee fraction, or null.

trading_spread_fee

number

Trading spread fee fraction, or null.

features

object

Flags indicating which CS2Cap API features this provider supports.

Show feature properties

has_buy_orders

boolean

Whether this provider exposes buy orders (usable via the Bids API).

has_recent_sales

boolean

Whether this provider exposes recent sale history (usable via the Sales API).

health

object

Live health and coverage data for this provider.

Show health properties

status

string

Current operational status. One of: up, degraded, down.

last_checked_at

string

ISO 8601 timestamp of the most recent health check.

total_offers

integer

Total number of active listings currently available from this provider.

unique_items

integer

Number of unique CS2 items with at least one active listing.

market_coverage

number

Percentage of the CS2Cap catalog covered by this provider.

total_value

integer

Total market value of all active listings in the provider’s native default_currency (minor units).

total_value_usd

integer

total_value converted to USD (minor units).

GET /fx — FX rates

Returns the current FX table with USD as the base currency. These rates power the automatic currency conversion that applies when you pass a currency parameter to any market-data endpoint. Tiers: free · starter · pro · quant

curl -sS \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  "$CS2C_API_BASE/fx"

Parameters

This endpoint takes no parameters.

The endpoint returns the exchange rate for 234 different currencies, including cryptocurrencies. The full list of currencies is available on browser here.

Response example

{
  "timestamp": "2026-03-20T22:00:48.904741+00:00",
  "rates": {
    "USD": 1,
    "BRL": 5.257551,
  	"BTC": 0.00001244,
    "CNY": 6.899831,
    "ETH": 0.00043217,
    "EUR": 0.866447,
    "GBP": 0.747866,
    "RUB": 74.23968886,
    "USDC": 1.00005289
  }
}

Response fields

timestamp

string

ISO 8601 timestamp of when the FX rates were last updated.

rates

object

Map of ISO 4217 currency codes to their exchange rate relative to USD. USD is always 1. Over 160 currency codes are included in the full response — the example above is abbreviated.

Instead of fetching FX rates and converting manually, pass the currency query parameter to any market-data endpoint and receive values already converted into your target currency.

Documentation Index

​GET /items — List items

​Parameters

​Response example

​Response fields

​GET /items/metadata — Catalog metadata

​Parameters

​Response example

​Response fields

​GET /providers — List providers

​Parameters

​Response example

​Response fields

​GET /fx — FX rates

​Parameters

​Response example

​Response fields

GET /items — List items

Parameters

Response example

Response fields

GET /items/metadata — Catalog metadata

Parameters

Response example

Response fields

GET /providers — List providers

Parameters

Response example

Response fields

GET /fx — FX rates

Parameters

Response example

Response fields