Browse

API Documentation

Access our comprehensive API to integrate Pricempire's data into your applications.

Authentication

To use our API, you need to authenticate your requests using your API key. Follow these steps:

  1. Create an account at Pricempire
  2. Subscribe to an API plan DeveloperChoose a plan that fits your needs. Free tier available for testing.
  3. 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:

Add this header to your request:

Authorization: Bearer YOUR_API_KEY
Example using curl:
curl -H "Authorization: Bearer YOUR_API_KEY" https://api.pricempire.com/v4/paid/items/prices
9 endpoints

V4 API - Latest & Most Powerful

Item Prices

Get all items with their prices

gethttps://api.pricempire.com/v4/paid/items/prices?api_key=YOUR_API_KEY

Quick Start

curl -X GET "https://api.pricempire.com/v4/paid/items/prices?api_key=YOUR_API_KEY" \
  -H "Authorization: Bearer YOUR_API_KEY"

Parameters

NameTypeRequiredDefaultDescription
app_idnumberNoThe app_id of the gameValues: 730, 252490, 440, 570, 590830
sourcesarray<string>No["buff163","buff163_buy"]Comma-separated list of sources to get prices from
currencystringNoUSDThe currency to get the prices inValues: USD, AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, FOK, GBP, GEL, GGP, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, IMP, INR, IQD, IRR, ISK, JEP, JMD, JOD, JPY, KES, KGS, KHR, KID, KMF, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLE, SLL, SOS, SRD, SSP, STN, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TVD, TWD, TZS, UAH, UGX, UYU, UZS, VES, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMW, ZWL
avgbooleanNofalseWhether to get the average prices (7d, 30d, 60d, 90d)
medianbooleanNofalseWhether to get the median prices (7d, 30d, 60d, 90d)
inflation_thresholdnumberNo-1The inflation threshold to use (in percentage)
typearray<string>NoComma-separated list of item types to filter by
metasarray<string>No[]Comma-separated list of metadata fields to include

Example Response

200400401
[
  {
    "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.

gethttps://api.pricempire.com/v4/paid/items/prices/history?api_key=YOUR_API_KEY&app_id=730&provider_key=steam

Quick Start

curl -X GET "https://api.pricempire.com/v4/paid/items/prices/history?api_key=YOUR_API_KEY&app_id=730&provider_key=steam" \
  -H "Authorization: Bearer YOUR_API_KEY"

Parameters

NameTypeRequiredDefaultDescription
app_idnumberYesThe app_id of the gameValues: 730, 570, 252490, 440, 590830
provider_keystringYesThe provider keyValues: steam, steam_buy, buff163, buff163_buy, skinport, dmarket, dmarket_buy, lootfarm, bitskins, skinbaron, csfloat, csmoney, csmoneym, tradeit, buffmarket, whitemarket, swapgg, skinbid, c5game, youpin, youpin_buy, cstrade, gamerpay, skinthunder, lisskins, shadowpay, exeskins, ecosteam, ecosteam_buy, skinsmonkey, csdeals, skinswap, snipeskins, mannco, nerf, skinflow, skinout, haloskins, rapidskins, krakatoa, waxpeer, waxpeer_buy, marketcsgo, marketcsgo_buy, rusttm, itrade, skindeck, avanmarket, csgoempire, csgoempire_store, csgo500, csgofast, clashgg, csgoroll, csgoroll_store, skinrave, rollbit, csgogem, 49skins, skinvault, skinplace, gameboost, test-market
currencystringNoUSDCurrency for prices
from_datestringNoStart date for history (YYYY-MM-DD). If not provided, defaults to 30 days ago. Maximum range is 180 days.
to_datestringNoEnd date for history (YYYY-MM-DD). If not provided, defaults to today. Maximum range is 180 days.
market_hash_namesstringNoComma-separated list of market_hash_names to filter

Example Response

200400401403
{
  "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.

gethttps://api.pricempire.com/v4/paid/items/images?api_key=YOUR_API_KEY

Quick Start

curl -X GET "https://api.pricempire.com/v4/paid/items/images?api_key=YOUR_API_KEY" \
  -H "Authorization: Bearer YOUR_API_KEY"

Parameters

NameTypeRequiredDefaultDescription
app_idnumberNoThe app_id of the gameValues: 730, 252490, 440, 570, 590830

Example Response

200401500
{
  "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

gethttps://api.pricempire.com/v4/paid/inventory?api_key=YOUR_API_KEY&steam_id=76561198040698635&app_id=%3Capp_id%3E

Quick Start

curl -X GET "https://api.pricempire.com/v4/paid/inventory?api_key=YOUR_API_KEY&steam_id=76561198040698635&app_id=%3Capp_id%3E" \
  -H "Authorization: Bearer YOUR_API_KEY"

Parameters

NameTypeRequiredDefaultDescription
steam_idstringYesThe steam_id of the user (17 digits starting with 7656)
app_idnumberYesThe app_id of the gameValues: 730, 570, 252490, 440, 590830
forcebooleanNoForce reload the inventory (allowed only once per minute)

Example Response

200400401500
{
  "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.

gethttps://api.pricempire.com/v4/paid/items?api_key=YOUR_API_KEY

Quick Start

curl -X GET "https://api.pricempire.com/v4/paid/items?api_key=YOUR_API_KEY" \
  -H "Authorization: Bearer YOUR_API_KEY"

Parameters

NameTypeRequiredDefaultDescription
languagestringNoThe language of the responseValues: bg, cs, da, de, el, en, en-ES, es-MX, fi, fr, hu, it, ja, ko, nl, no, pl, pt-BR, pt-PT, ro, ru, sv, th, tr, uk, vi, zh-CN, zh-TW

Example Response

200400
[
  {
    "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.

gethttps://api.pricempire.com/v4/paid/items/metas?api_key=YOUR_API_KEY

Quick Start

curl -X GET "https://api.pricempire.com/v4/paid/items/metas?api_key=YOUR_API_KEY" \
  -H "Authorization: Bearer YOUR_API_KEY"

Parameters

This endpoint does not document any parameters.

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.

gethttps://api.pricempire.com/v4/paid/comparison?api_key=YOUR_API_KEY&to_provider=buff163&from_provider=steam

Quick Start

curl -X GET "https://api.pricempire.com/v4/paid/comparison?api_key=YOUR_API_KEY&to_provider=buff163&from_provider=steam" \
  -H "Authorization: Bearer YOUR_API_KEY"

Parameters

NameTypeRequiredDefaultDescription
providersstringNoComma-separated list of allowed providers
pagenumberNoPage number (1-100)
sortstringNoSort order for resultsValues: roi:asc, roi:desc, profit:asc, profit:desc, liquidity.value:asc, liquidity.value:desc, from_provider.price:asc, from_provider.price:desc, to_provider.price:asc, to_provider.price:desc, asset_item.market_hash_name:asc, asset_item.market_hash_name:desc
feenumberNoCustom fee percentage to apply (-20 to 100)
max_pricenumberNoMaximum price filter
min_pricenumberNoMinimum price filter
max_roinumberNoMaximum ROI percentage (-1000 to 1000)
min_roinumberNoMinimum ROI percentage (-1000 to 1000)
liquiditynumberNoMinimum liquidity percentage (0-100)
to_qtynumberNoMinimum quantity on target provider
from_qtynumberNoMinimum quantity on source provider
volumenumberNoMinimum trade volume filter
price_agenumberNoMaximum age of prices in seconds (0-604800)
blackliststringNoComma-separated blacklist terms to exclude items
searchstringNoComma-separated search terms to filter items
app_idnumberNoThe app_id of the gameValues: 730, 252490, 440, 570, 590830
to_providerstringYesTarget provider to compare to
from_providerstringYesSource provider to compare from

Example Response

200400401
{
  "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.

gethttps://api.pricempire.com/v4/paid/items/prices/feed?api_key=YOUR_API_KEY&sources=buff163%2Cskinport%2Ccsfloat

Quick Start

curl -X GET "https://api.pricempire.com/v4/paid/items/prices/feed?api_key=YOUR_API_KEY&sources=buff163%2Cskinport%2Ccsfloat" \
  -H "Authorization: Bearer YOUR_API_KEY"

Parameters

NameTypeRequiredDefaultDescription
sourcesstringYesComma-separated list of provider keys
sincenumberNoUnix timestamp in milliseconds — only return events after this time (max 5 minutes ago)

Example Response

200401
{
  "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)

gethttps://api.pricempire.com/v4/paid/items/marketplace-ids?api_key=YOUR_API_KEY

Quick Start

curl -X GET "https://api.pricempire.com/v4/paid/items/marketplace-ids?api_key=YOUR_API_KEY" \
  -H "Authorization: Bearer YOUR_API_KEY"

Parameters

NameTypeRequiredDefaultDescription
app_idnumberNoThe app_id of the gameValues: 730, 252490, 440, 570, 590830

Example Response

200401
[
  {
    "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.

Contact us