Authentication
Authentication Progress
- Create an account at Pricempire
- Subscribe to an API planChoose a plan that fits your needs. Free tier available for testing.View plans
- Get your API key
This is your personal API key. Keep it secure and never share it.
There are two ways to include your API key in your requests:
Using Authorization Header Recommended
Add this header to your request:
curl -H "Authorization: Bearer YOUR_API_KEY" https://api.pricempire.com/v4/paid/items/pricesUsing Query Parameter
Add this parameter to your request URL:
curl "https://api.pricempire.com/v4/paid/items/prices?api_key=YOUR_API_KEY"Item Prices
Get all items with their prices
Parameters
app_idnumberThe app_id of the game
- Default
—
730252490440570590830sourcesarray<string>Comma-separated list of sources to get prices from
- Default
["buff163","buff163_buy"]
buff163buff163_buylootfarmitradeitrade_tradeskinbarontradeittradeit_tradebuffmarketbitskinsswapggcsfloatyoupinsteamcstradecstrade_tradeskinthunderlisskinsskinbidmarketcsgogamerpayshadowpayskinsmonkeyskinsmonkey_tradeskinportc5gamemannconerfskinswapskinswap_tradekrakatoawaxpeercsmoneycsmoney_tradeskinflowskinflow_tradeskinouthaloskinsrapidskinssteam_buydmarketcsmoneymwhitemarketdmarket_buymarketcsgo_buycsdealsyoupin_buycsgoempirecsgorollcsgoempire_storecsgoroll_storecsgogem49skinsskinsexeskinsecosteamecosteam_buyskinswap_cnsnipeskinswaxpeer_buyrusttmskindeckdupefiavanmarketpirateswapskinvaultskinplacegameboostuuskinsskinlandmoonmarketrustskinsrustskins_buymoonmarket_buygsolgsol_buywowskinsbuffmarket_buybalticskinscsmoney_buycurrencystringThe currency to get the prices in
- Default
USD
USDAEDAFNALLAMDANGAOAARSAUDAWGAZNBAMBBDBDTBGNBHDBIFBMDBNDBOBBRLBSDBTNBWPBYNBZDCADCDFCHFCLPCNYCOPCRCCUPCVECZKDJFDKKDOPDZDEGPERNETBEURFJDFKPFOKGBPGELGGPGHSGIPGMDGNFGTQGYDHKDHNLHRKHTGHUFIDRILSIMPINRIQDIRRISKJEPJMDJODJPYKESKGSKHRKIDKMFKRWKWDKYDKZTLAKLBPLKRLRDLSLLYDMADMDLMGAMKDMMKMNTMOPMRUMURMVRMWKMXNMYRMZNNADNGNNIONOKNPRNZDOMRPABPENPGKPHPPKRPLNPYGQARRONRSDRUBRWFSARSBDSCRSDGSEKSGDSHPSLESLLSOSSRDSSPSTNSYPSZLTHBTJSTMTTNDTOPTRYTTDTVDTWDTZSUAHUGXUYUUZSVESVNDVUVWSTXAFXCDXDRXOFXPFYERZARZMWZWLavgbooleanWhether to get the average prices (7d, 30d, 60d, 90d)
- Default
false
medianbooleanWhether to get the median prices (7d, 30d, 60d, 90d)
- Default
false
inflation_thresholdnumberThe inflation threshold to use (in percentage)
- Default
-1
typearray<string>Comma-separated list of item types to filter by
- Default
—
containerstickersticker-capsuletournament-stickerautograph-stickerautograph-capsuleskinglovesouvenir-packagekeyagentpatch-packpatchgraffiti-capsulegraffitimusic-kit-boxmusic-kitpin-capsulepinothergiftcollection-packageviewer-passtournament-team-sticker-capsulecharmweaponarmorclothingmiscresourcemetasarray<string>Comma-separated list of metadata fields to include
- Default
[]
liquiditysteam_last_7dsteam_last_30dsteam_last_90dmarketcaptrades_7dtrades_30dtrades_90dcountrankimage
Code Example
curl -X GET "https://api.pricempire.com/v4/paid/items/prices" \
-H "Authorization: Bearer YOUR_API_KEY"Example Response
200[
{
"market_hash_name": "Sticker | FURIA | Rio 2022",
"image": "/panorama/images/econ/stickers/rio2022/furi_png.png",
"liquidity": 34,
"count": 246,
"rank": 19826,
"prices": [
{
"price": 0,
"count": 1461,
"updated_at": "2024-10-11T10:26:43.128Z",
"provider_key": "buff163",
"meta": {
"original_price": 38,
"original_currency": "CNY",
"rate": 0.1232323
}
},
{
"price": null,
"count": null,
"updated_at": null,
"provider_key": "lootfarm"
},
{
"price": 3,
"count": 4340,
"updated_at": "2024-10-12T13:16:06.929Z",
"provider_key": "dmarket",
"avg_7": 3,
"avg_30": 3,
"avg_60": 3,
"avg_90": 3,
"median_7": 3,
"median_30": 3,
"median_60": 3,
"median_90": 3
}
]
},
{
"market_hash_name": "SG 553 | Danger Close (Factory New)",
"image": "/panorama/images/econ/default_generated/weapon_sg556_gs_sg553_over_heated_light_png.png",
"liquidity": 98,
"count": 67690,
"rank": 9698,
"prices": [
{
"price": 38,
"count": 169,
"updated_at": "2024-10-11T10:25:59.360Z",
"provider_key": "buff163",
"meta": {
"original_price": 38,
"original_currency": "CNY",
"rate": 0.1232323
}
},
{
"price": 34,
"count": 0,
"updated_at": "2024-10-26T10:34:05.943Z",
"provider_key": "lootfarm",
"meta": null
},
{
"price": 32,
"count": 11,
"updated_at": "2024-10-12T13:15:31.150Z",
"provider_key": "dmarket"
}
]
}
]Item Prices History (Enterprise Only)
Get all items with their prices history. This endpoint is available only for Enterprise subscribers. Maximum date range is 180 days. If no dates are provided, defaults to the last 30 days.
Parameters
app_idnumberRequiredThe app_id of the game
- Default
—
730570252490440590830provider_keystringRequiredThe provider key
- Default
—
steamsteam_buybuff163buff163_buyskinportdmarketdmarket_buylootfarmbitskinsskinbaroncsfloatcsmoneycsmoneymcsmoney_buycsmoney_tradetradeittradeit_tradebuffmarketbuffmarket_buywhitemarketswapggskinbidc5gameyoupinyoupin_buycstradecstrade_tradegamerpayskinthunderlisskinsshadowpayexeskinsecosteamecosteam_buyskinsmonkeyskinsmonkey_tradecsdealsskinswapskinswap_cnskinswap_tradeskinssnipeskinsmannconerfskinflowskinflow_tradeskinouthaloskinsrapidskinskrakatoawaxpeerwaxpeer_buymarketcsgomarketcsgo_buyrusttmitradeitrade_tradeskindeckavanmarketpirateswapdupefiuuskinsskinlandmoonmarketmoonmarket_buyrustskinsrustskins_buygsolgsol_buywowskinsbalticskinscsgoempirecsgoempire_storecsgo500csgofastclashggcsgorollcsgoroll_storeskinraverollbitcsgogem49skinsskinvaultskinplacegameboosttest-marketcurrencystringCurrency for prices
- Default
USD
from_datestringStart date for history (YYYY-MM-DD). If not provided, defaults to 30 days ago. Maximum range is 180 days.
- Default
—
to_datestringEnd date for history (YYYY-MM-DD). If not provided, defaults to today. Maximum range is 180 days.
- Default
—
market_hash_namesstringComma-separated list of market_hash_names to filter
- Default
—
Code Example
curl -X GET "https://api.pricempire.com/v4/paid/items/prices/history?app_id=730&provider_key=steam" \
-H "Authorization: Bearer YOUR_API_KEY"Example Response
200{
"metadata": {
"app_id": 730,
"provider_key": "steam",
"currency": "USD",
"exchange_rate": 1,
"from_date": "2024-01-01",
"to_date": "2024-12-31",
"requested_from_date": "2024-01-01",
"requested_to_date": "2024-12-31",
"total_items": 2,
"total_data_points": 16,
"max_date_range_days": 180,
"generated_at": "2024-01-15T12:00:00Z"
},
"data": {
"Sticker | FURIA | Rio 2022": {
"1758644397": 53,
"1758730797": 54,
"1758817197": 55,
"1758903597": 56,
"1758989997": 57,
"1759076397": 58,
"1759162797": 59,
"1759249197": 60
},
"AK-47 | Redline (Field-Tested)": {
"1758644397": 2500,
"1758730797": 2550,
"1758817197": 2600,
"1758903597": 2580,
"1758989997": 2620,
"1759076397": 2650,
"1759162797": 2700,
"1759249197": 2680
}
}
}Item Images
Get all items with their images. You should use https://cs2-cdn.pricempire.com prefix.
Parameters
app_idnumberThe app_id of the game
- Default
—
730252490440570590830
Code Example
curl -X GET "https://api.pricempire.com/v4/paid/items/images" \
-H "Authorization: Bearer YOUR_API_KEY"Example Response
200{
"cdn_sizes": [
50,
150,
300,
450
],
"cdn_url": "https://cs2-cdn.pricempire.com",
"example_resized": "https://cs2-cdn.pricempire.com/panorama/images/econ/default_generated/weapon_sg556_gs_sg553_over_heated_light_png_50.avif",
"images": {
"★ Karambit | Slaughter (Factory New)": {
"steam": "/panorama/images/econ/default_generated/weapon_knife_karambit_am_zebra_light_png.png",
"cdn": "/panorama/images/econ/default_generated/weapon_knife_karambit_am_zebra_light_png.avif"
},
"Sealed Graffiti | Toasted (Frog Green)": {
"steam": "/panorama/images/econ/stickers/default/moly_01_png.png",
"cdn": "/panorama/images/econ/stickers/default/moly_09_png.avif"
}
},
"collections": {
"the-graphic-design-collection": {
"steam": "/panorama/images/econ/set_icons/set_graphic_design_png.png",
"cdn": "/panorama/images/econ/set_icons/set_graphic_design_png.avif"
}
},
"weapons": {
"m4a4": {
"steam": "/panorama/images/econ/weapons/base_weapons/weapon_m4a1_png.png",
"cdn": "/panorama/images/econ/weapons/base_weapons/weapon_m4a1_png.avif"
}
}
}Inventory
Parameters
steam_idstringRequiredThe steam_id of the user (17 digits starting with 7656)
- Default
—
app_idnumberRequiredThe app_id of the game
- Default
—
730570252490440590830forcebooleanForce reload the inventory (allowed only once per minute)
- Default
—
truefalse
Code Example
curl -X GET "https://api.pricempire.com/v4/paid/inventory?steam_id=76561198040698635&app_id=%3Capp_id%3E" \
-H "Authorization: Bearer YOUR_API_KEY"Example Response
200{
"id": "1",
"value": 0,
"created_at": "2024-09-14T22:05:46.475Z",
"items": [
{
"asset_id": "30503045023",
"d": "7512750226289779146",
"low_rank": null,
"high_rank": null,
"float_value": 0.2859826982021332,
"paint_seed": 81,
"amount": 1,
"stickers": [
{
"name": "100 Thieves | 2020 RMR",
"slot": 0,
"wear": null,
"offset_x": null,
"offset_y": null,
"stickerId": 4769
}
],
"charms": null,
"item": {
"id": 189,
"app_id": 730,
"market_hash_name": "StatTrak™ P250 | Asiimov (Field-Tested)",
"weapon_name": "P250",
"category": "Pistol",
"image": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpopujwezhjxszYI2gS092lnYmGmOHLPr7Vn35cppNw2rCZ99rx3Qzmrhc_Yz2mcYORJ1A2YQ2C_FDvlOi5hZDv7pnIySB9-n51-GWPoLQ",
"type": "StatTrak™ Classified Pistol",
"rarity": "Classified",
"rarity_color": "d32ce6",
"exterior": "Field-Tested",
"float_min": 0.1,
"float_max": 1,
"weapon_id": 36,
"paint_id": 551
}
}
]
}All Items
Get all items with their images, metas, containers and other data.
Parameters
languagestringThe language of the response
- Default
—
bgcsdadeelenen-ESes-MXfifrhuitjakonlnoplpt-BRpt-PTrorusvthtrukvizh-CNzh-TW
Code Example
curl -X GET "https://api.pricempire.com/v4/paid/items" \
-H "Authorization: Bearer YOUR_API_KEY"Example Response
200[
{
"name": "M4A4 | Polysoup (Factory New)",
"description": "More accurate but less damaging than its AK-47 counterpart, the M4A4 is the full-auto assault rifle of choice for CTs. It has been custom painted with multicolored crystals and finished with pearlescent accents.\\n\\n<i>Don't stew on it</i>",
"textures": [
{
"type": "g_tPaintRoughness",
"file": "default_rough_tga_4b61db16.png"
},
{
"type": "g_tPaintMetalness",
"file": "default_metal_tga_a207b0ba.png"
},
{
"type": "g_tPearlescenceMask",
"file": "black_tga_7b4f0ab5.png"
},
{
"type": "g_tOverlay",
"file": "soo_polysoup_m4a4_overlay_texture_psd_70de03db.png"
},
{
"type": "g_tNormal",
"file": "custom_template_pattern_normal_tga_9bf1e72d.png"
},
{
"type": "g_tPaintByNumberMasks",
"file": "soo_polysoup_m4a4_paint_by_number_masks_psd_ccf743af.png"
},
{
"type": "g_tFinalAmbientOcclusion",
"file": "default_ao_tga_e5dd0c66.png"
},
{
"type": "g_tWear",
"file": "paint_wear_psd_19141e79.png"
},
{
"type": "g_tGrunge",
"file": "gun_grunge_psd_66b72907.png"
}
],
"style": {
"name": "Solid Color",
"description": "A simple yet effective finish style that applies a uniform, solid color across the surface of the weapon. This style emphasizes simplicity and consistency, ensuring that the color covers the weapon entirely without any patterns, gradients, or other embellishments."
},
"vcompmatFile": "/materials/weapons/paints/set_graphic_design/soo_polysoup_m4a4.vcompmat",
"weapon": {
"name": "M4A4",
"object_id": 16,
"description": null,
"image": "/panorama/images/econ/weapons/base_weapons/weapon_m4a1_png.png",
"sticker_count": 5
},
"category": "Rifles",
"pattern": "Polysoup",
"min_float": 0,
"max_float": 0.64,
"wear": "Factory New",
"stattrak": false,
"souvenir": false,
"paint_index": 874,
"rarity": {
"name": "Restricted",
"color": "#8847ff"
},
"collections": [
{
"name": "The Graphic Design Collection",
"image": "/panorama/images/econ/set_icons/set_graphic_design_png.png"
}
],
"crates": [],
"market_hash_name": "M4A4 | Polysoup (Factory New)",
"team": "Counter-Terrorist",
"image": "/panorama/images/econ/default_generated/weapon_m4a1_soo_polysoup_m4a4_light_png.png"
}
]Item Metadatas
Get all item metadatas.
Parameters
This endpoint does not document any parameters.
Code Example
curl -X GET "https://api.pricempire.com/v4/paid/items/metas" \
-H "Authorization: Bearer YOUR_API_KEY"Example Response
200[
{
"market_hash_name": "Glock-18 | Gamma Doppler (Factory New)",
"description": "The Glock 18 is a serviceable first-round pistol that works best against unarmored opponents and is capable of firing three-round bursts. It has been painted with black and silver metallic paints using a marbleizing medium, then candy coated.",
"image": "/panorama/images/econ/default_generated/weapon_glock_am_gamma_doppler_phase4_glock_light_png.png",
"trades_1d": "107",
"trades_7d": "687",
"trades_30d": "2096",
"trades_90d": "4836",
"trades_180d": "8254",
"rank": "1292",
"marketcap": "50527620",
"liquidity": "100",
"count": "9060",
"steam_last_90d": "1699",
"steam_last_30d": "587",
"steam_last_7d": "34",
"market_first_date": "1632265200000"
}
]Market Comparison
Compare prices between different markets/providers to find arbitrage opportunities.
Parameters
from_providerstringRequiredSource provider to compare from
- Default
steam
to_providerstringRequiredTarget provider to compare to
- Default
steam
app_idnumberThe app_id of the game
- Default
—
730252490440570590830searchstringComma-separated search terms to filter items
- Default
[]
blackliststringComma-separated blacklist terms to exclude items
- Default
[]
rarityarray<string>Required- Default
[]
price_agenumberMaximum age of prices in seconds (0-604800)
- Default
10
volumenumberMinimum trade volume filter
- Default
0
from_qtynumberMinimum quantity on source provider
- Default
0
to_qtynumberMinimum quantity on target provider
- Default
0
liquiditynumberMinimum liquidity percentage (0-100)
- Default
0
min_roinumberMinimum ROI percentage (-1000 to 1000)
- Default
-1000
max_roinumberMaximum ROI percentage (-1000 to 1000)
- Default
1000
min_pricenumberMinimum price filter
- Default
0
max_pricenumberMaximum price filter
- Default
10000000
feenumberCustom fee percentage to apply (-20 to 100)
- Default
0
sortstringSort order for results
- Default
—
roi:ascroi:descprofit:ascprofit:descliquidity.value:ascliquidity.value:descfrom_provider.price:ascfrom_provider.price:descto_provider.price:ascto_provider.price:descasset_item.market_hash_name:ascasset_item.market_hash_name:descpagenumberPage number (1-100)
- Default
1
providersstringComma-separated list of allowed providers
- Default
[]
myItemsbooleanRequired- Default
false
hide_without_listingsbooleanRequired- Default
false
Code Example
curl -X GET "https://api.pricempire.com/v4/paid/comparison?from_provider=steam&to_provider=buff163&rarity=%5B%5D&myItems=false&hide_without_listings=false" \
-H "Authorization: Bearer YOUR_API_KEY"Example Response
200{
"items": [
{
"market_hash_name": "AK-47 | Redline (Field-Tested)",
"discriminator": "normal",
"name": "Redline",
"image": "/panorama/images/econ/default_generated/weapon_ak47_gs_ak47_supercharged_light_png.png",
"liquidity": 98.5,
"volume": 12543,
"app_id": 730,
"from_provider": 3200,
"to_provider": 3550,
"to_provider_fee": 3372.5,
"profit": 172.5,
"roi": 5.39,
"asset_item_id": 12345,
"discriminator_slug": "normal",
"slug": "redline",
"type": "Rifle",
"to_provider_key": "buff163"
}
],
"total": 1523,
"page": 1,
"totalPages": 31
}Price Feed Events (Enterprise Only)
Backup endpoint to retrieve recent price update events (same format as the WebSocket price-feed). Returns all price updates within the requested window (max 5 minutes). Use this to catch up after a WebSocket disconnection.
Parameters
sourcesstringRequiredComma-separated list of provider keys
- Default
—
sincenumberUnix timestamp in milliseconds — only return events after this time (max 5 minutes ago)
- Default
—
Code Example
curl -X GET "https://api.pricempire.com/v4/paid/items/prices/feed?sources=buff163%2Cskinport%2Ccsfloat" \
-H "Authorization: Bearer YOUR_API_KEY"Example Response
200{
"oldest": 1710000000000,
"newest": 1710000300000,
"count": 1542,
"events": [
{
"asset_item_id": 123,
"market_hash_name": "AK-47 | Redline (Field-Tested)",
"provider_key": "buff163",
"price": 1500,
"count": 42,
"updated_at": "2024-03-10T12:00:00.000Z"
}
]
}Marketplace IDs
Get all items with their marketplace IDs (buff163_id, buffmarket_id, youpin_id)
Parameters
app_idnumberThe app_id of the game
- Default
—
730252490440570590830
Code Example
curl -X GET "https://api.pricempire.com/v4/paid/items/marketplace-ids" \
-H "Authorization: Bearer YOUR_API_KEY"Example Response
200[
{
"market_hash_name": "AK-47 | Redline (Field-Tested)",
"buff163_id": "12345",
"buffmarket_id": "67890",
"youpin_id": "54321"
},
{
"market_hash_name": "AWP | Asiimov (Field-Tested)",
"buff163_id": "11111",
"buffmarket_id": null,
"youpin_id": "22222"
}
]Need help finding something?
The documentation structure is still growing. Contact the team if a guide is missing or a workflow needs clearer coverage.