Catalog API: Items, Images, Providers, and FX Rates

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

All five 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" \
  "https://api.cs2c.app/items?q=AK-47&rarity_name=Covert&limit=10"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.ItemsApi(client)
    response = api.list_items(
        q="AK-47",
        rarity_name="Covert",
        limit=10,
    )

print(client.sanitize_for_serialization(response))

import { Configuration, ItemsApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

if (!accessToken) {
  throw new Error("Set CS2C_API_KEY before running this example.");
}

const api = new ItemsApi(new Configuration({ accessToken }));
const response = await api.listItems({ q: "AK-47", rarityName: "Covert", limit: 10 });

console.log(response);

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/..."
      ],
      "release_date": "2014-07-01",
      "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.

release_date

string

Item release date as YYYY-MM-DD, inferred from direct item, collection, or crate metadata.

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" \
  "https://api.cs2c.app/items/metadata"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.ItemsApi(client)
    response = api.get_item_catalog_metadata()

print(client.sanitize_for_serialization(response))

import { Configuration, ItemsApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

if (!accessToken) {
  throw new Error("Set CS2C_API_KEY before running this example.");
}

const api = new ItemsApi(new Configuration({ accessToken }));
const response = await api.getItemCatalogMetadata();

console.log(response);

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 catalog (i.e. tradable CS2 items).

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 /images — Image directory

Returns a name-keyed directory of CS2 game images hosted on the CS2Cap CDN. Keys are display names from the game catalog, and values are arrays of full CDN URLs. Some display names intentionally map to multiple images, such as service medal levels or Doppler phases. Tiers: Free, Starter, Pro, Quant

curl -sS \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  "https://api.cs2c.app/images?format=webp"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.ImagesApi(client)
    response = api.list_game_images()

print(client.sanitize_for_serialization(response))

import { Configuration, ImagesApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

if (!accessToken) {
  throw new Error("Set CS2C_API_KEY before running this example.");
}

const api = new ImagesApi(new Configuration({ accessToken }));
const response = await api.listGameImages();

console.log(response);

Parameters

format

string

default:"png"

Image URL format. Use png (default) for canonical image URLs, or webp to change only .png URL suffixes to .webp.

Response example

{
  "AK-47 | Redline": [
    "https://cdn.cs2c.app/images/econ/default_generated/weapon_ak47_cu_ak47_cobra_light_png.png"
  ],
  "2026 Service Medal": [
    "https://cdn.cs2c.app/images/econ/status_icons/service_medal_2026_lvl1_png.png",
    "https://cdn.cs2c.app/images/econ/status_icons/service_medal_2026_lvl2_png.png"
  ]
}

Response fields

array

The response is an object keyed by catalog display name. Each value is a list of one or more full https://cdn.cs2c.app/... image URLs for that name.

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" \
  "https://api.cs2c.app/providers?provider=buff163"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.ProvidersApi(client)
    response = api.list_providers(
        provider="buff163"
    )

print(client.sanitize_for_serialization(response))

import { Configuration, ProvidersApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

if (!accessToken) {
  throw new Error("Set CS2C_API_KEY before running this example.");
}

const api = new ProvidersApi(new Configuration({ accessToken }));
const response = await api.listProviders({ provider: "buff163" });

console.log(response);

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, skinswap_t, 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), P2P (peer-to-peer marketplace), ESCROW (platform-held listings), TRADING (item-to-item exchanges) or HYBRID (≤2 market models).

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" \
  "https://api.cs2c.app/fx"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.ForeignExchangeApi(client)
    response = api.get_fx_rates()

print(client.sanitize_for_serialization(response))

import { Configuration, ForeignExchangeApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

if (!accessToken) {
  throw new Error("Set CS2C_API_KEY before running this example.");
}

const api = new ForeignExchangeApi(new Configuration({ accessToken }));
const response = await api.getFxRates();

console.log(response);

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 200 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.

Overview

Market Data

Analytics

Portfolio

Account

Catalog API: Items, Images, Providers, and FX Rates

GET /items — List items

Parameters

Response example

Response fields

GET /items/metadata — Catalog metadata

Parameters

Response example

Response fields

GET /images — Image directory

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 /images — Image directory

​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 /images — Image directory

Parameters

Response example

Response fields

GET /providers — List providers

Parameters

Response example

Response fields

GET /fx — FX rates

Parameters

Response example

Response fields