Browse

Authentication

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

Authentication Progress

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

Using Authorization Header Recommended

Add this header to your request:

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

Using Query Parameter

Add this parameter to your request URL:

Example using curl
curl "https://api.pricempire.com/v4/paid/items/prices?api_key=YOUR_API_KEY"

Item Prices

get/v4/paid/items/prices

Get all items with their prices

Parameters

  • app_idnumber

    The app_id of the game

    Default
    730
    252490
    440
    570
    590830
  • sourcesarray<string>

    Comma-separated list of sources to get prices from

    Default
    ["buff163","buff163_buy"]
    buff163
    buff163_buy
    lootfarm
    itrade
    itrade_trade
    skinbaron
    tradeit
    tradeit_trade
    buffmarket
    bitskins
    swapgg
    csfloat
    youpin
    steam
    cstrade
    cstrade_trade
    skinthunder
    lisskins
    skinbid
    marketcsgo
    gamerpay
    shadowpay
    skinsmonkey
    skinsmonkey_trade
    skinport
    c5game
    mannco
    nerf
    skinswap
    skinswap_trade
    krakatoa
    waxpeer
    csmoney
    csmoney_trade
    skinflow
    skinflow_trade
    skinout
    haloskins
    rapidskins
    steam_buy
    dmarket
    csmoneym
    whitemarket
    dmarket_buy
    marketcsgo_buy
    csdeals
    youpin_buy
    csgoempire
    csgoroll
    csgoempire_store
    csgoroll_store
    csgogem
    49skins
    skins
    exeskins
    ecosteam
    ecosteam_buy
    skinswap_cn
    snipeskins
    waxpeer_buy
    rusttm
    skindeck
    dupefi
    avanmarket
    pirateswap
    skinvault
    skinplace
    gameboost
    uuskins
    skinland
    moonmarket
    rustskins
    rustskins_buy
    moonmarket_buy
    gsol
    gsol_buy
    wowskins
    buffmarket_buy
    balticskins
    csmoney_buy
  • currencystring

    The currency to get the prices in

    Default
    USD
    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
  • avgboolean

    Whether to get the average prices (7d, 30d, 60d, 90d)

    Default
    false
  • medianboolean

    Whether to get the median prices (7d, 30d, 60d, 90d)

    Default
    false
  • inflation_thresholdnumber

    The inflation threshold to use (in percentage)

    Default
    -1
  • typearray<string>

    Comma-separated list of item types to filter by

    Default
    container
    sticker
    sticker-capsule
    tournament-sticker
    autograph-sticker
    autograph-capsule
    skin
    glove
    souvenir-package
    key
    agent
    patch-pack
    patch
    graffiti-capsule
    graffiti
    music-kit-box
    music-kit
    pin-capsule
    pin
    other
    gift
    collection-package
    viewer-pass
    tournament-team-sticker-capsule
    charm
    weapon
    armor
    clothing
    misc
    resource
  • metasarray<string>

    Comma-separated list of metadata fields to include

    Default
    []
    liquidity
    steam_last_7d
    steam_last_30d
    steam_last_90d
    marketcap
    trades_7d
    trades_30d
    trades_90d
    count
    rank
    image

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/v4/paid/items/prices/history

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_idnumberRequired

    The app_id of the game

    Default
    730
    570
    252490
    440
    590830
  • provider_keystringRequired

    The provider key

    Default
    steam
    steam_buy
    buff163
    buff163_buy
    skinport
    dmarket
    dmarket_buy
    lootfarm
    bitskins
    skinbaron
    csfloat
    csmoney
    csmoneym
    csmoney_buy
    csmoney_trade
    tradeit
    tradeit_trade
    buffmarket
    buffmarket_buy
    whitemarket
    swapgg
    skinbid
    c5game
    youpin
    youpin_buy
    cstrade
    cstrade_trade
    gamerpay
    skinthunder
    lisskins
    shadowpay
    exeskins
    ecosteam
    ecosteam_buy
    skinsmonkey
    skinsmonkey_trade
    csdeals
    skinswap
    skinswap_cn
    skinswap_trade
    skins
    snipeskins
    mannco
    nerf
    skinflow
    skinflow_trade
    skinout
    haloskins
    rapidskins
    krakatoa
    waxpeer
    waxpeer_buy
    marketcsgo
    marketcsgo_buy
    rusttm
    itrade
    itrade_trade
    skindeck
    avanmarket
    pirateswap
    dupefi
    uuskins
    skinland
    moonmarket
    moonmarket_buy
    rustskins
    rustskins_buy
    gsol
    gsol_buy
    wowskins
    balticskins
    csgoempire
    csgoempire_store
    csgo500
    csgofast
    clashgg
    csgoroll
    csgoroll_store
    skinrave
    rollbit
    csgogem
    49skins
    skinvault
    skinplace
    gameboost
    test-market
  • currencystring

    Currency for prices

    Default
    USD
  • from_datestring

    Start date for history (YYYY-MM-DD). If not provided, defaults to 30 days ago. Maximum range is 180 days.

    Default
  • to_datestring

    End date for history (YYYY-MM-DD). If not provided, defaults to today. Maximum range is 180 days.

    Default
  • market_hash_namesstring

    Comma-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/v4/paid/items/images

Get all items with their images. You should use https://cs2-cdn.pricempire.com prefix.

Parameters

  • app_idnumber

    The app_id of the game

    Default
    730
    252490
    440
    570
    590830

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

get/v4/paid/inventory

Parameters

  • steam_idstringRequired

    The steam_id of the user (17 digits starting with 7656)

    Default
  • app_idnumberRequired

    The app_id of the game

    Default
    730
    570
    252490
    440
    590830
  • forceboolean

    Force reload the inventory (allowed only once per minute)

    Default
    true
    false

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/v4/paid/items

Get all items with their images, metas, containers and other data.

Parameters

  • languagestring

    The language of the response

    Default
    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

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/v4/paid/items/metas

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

get/v4/paid/comparison

Compare prices between different markets/providers to find arbitrage opportunities.

Parameters

  • from_providerstringRequired

    Source provider to compare from

    Default
    steam
  • to_providerstringRequired

    Target provider to compare to

    Default
    steam
  • app_idnumber

    The app_id of the game

    Default
    730
    252490
    440
    570
    590830
  • searchstring

    Comma-separated search terms to filter items

    Default
    []
  • blackliststring

    Comma-separated blacklist terms to exclude items

    Default
    []
  • rarityarray<string>Required
    Default
    []
  • price_agenumber

    Maximum age of prices in seconds (0-604800)

    Default
    10
  • volumenumber

    Minimum trade volume filter

    Default
    0
  • from_qtynumber

    Minimum quantity on source provider

    Default
    0
  • to_qtynumber

    Minimum quantity on target provider

    Default
    0
  • liquiditynumber

    Minimum liquidity percentage (0-100)

    Default
    0
  • min_roinumber

    Minimum ROI percentage (-1000 to 1000)

    Default
    -1000
  • max_roinumber

    Maximum ROI percentage (-1000 to 1000)

    Default
    1000
  • min_pricenumber

    Minimum price filter

    Default
    0
  • max_pricenumber

    Maximum price filter

    Default
    10000000
  • feenumber

    Custom fee percentage to apply (-20 to 100)

    Default
    0
  • sortstring

    Sort order for results

    Default
    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
  • pagenumber

    Page number (1-100)

    Default
    1
  • providersstring

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

get/v4/paid/items/prices/feed

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

  • sourcesstringRequired

    Comma-separated list of provider keys

    Default
  • sincenumber

    Unix 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/v4/paid/items/marketplace-ids

Get all items with their marketplace IDs (buff163_id, buffmarket_id, youpin_id)

Parameters

  • app_idnumber

    The app_id of the game

    Default
    730
    252490
    440
    570
    590830

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.

Contact us