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/v1/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;

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

integer

Exact item ID match (e.g. 4994)

string

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

string

Filter by item type (e.g. Weapon)

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

boolean

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

boolean

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

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

integer

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

string

Full item name as it appears in the Steam economy.

string

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

string

High-level item type.

string

Item subtype within the type.

string

Weapon or wearable category.

string

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

string

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

string

Wear condition.

string

Steam economy definition index for this item.

integer

Paint index identifying the skin pattern.

string

Collection the item belongs to, or null.

string

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

string[]

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

string[]

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

string

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

string

Rarity tier name.

string

Rarity color as a hex string.

string

Finish style name.

boolean

Whether the item is StatTrak.

boolean

Whether the item is a Souvenir variant.

number

Minimum possible float value for this skin.

number

Maximum possible float value for this skin.

string

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

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/v1/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;

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

integer

Total number of items in the catalog (i.e. tradable CS2 items).

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/v1/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;

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

console.log(response);

Parameters

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/v1/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;

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

console.log(response);

Parameters

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:

string

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

string

Short provider code.

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

string

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

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

number

Standard sell-side fee fraction, or null.

number

Instant-sell fee fraction, or null.

number

Trading spread fee fraction, or null.

object

Flags indicating which CS2Cap API features this provider supports.

Show feature properties

boolean

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

boolean

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

object

Live health and coverage data for this provider.

Show health properties

string

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

string

ISO 8601 timestamp of the most recent health check.

integer

Total number of active listings currently available from this provider.

integer

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

number

Percentage of the CS2Cap catalog covered by this provider.

integer

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

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/v1/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;

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

string

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

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

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