# Table of Contents

- [API Documentation | Pricempire.com](#api-documentation-pricempire-com)

---

# API Documentation | Pricempire.com

$USD ($)

€EUR (€)

£GBP (£)

¥JPY (¥)

¥CNY (¥)

$CAD ($)

$AUD ($)

CHFCHF (CHF)

krSEK (kr)

$NZD ($)

AEDAED (AED)

؋AFN (؋)

ALLALL (ALL)

֏AMD (֏)

ANGANG (ANG)

KzAOA (Kz)

$ARS ($)

AWGAWG (AWG)

₼AZN (₼)

KMBAM (KM)

$BBD ($)

৳BDT (৳)

BGNBGN (BGN)

BHDBHD (BHD)

BIFBIF (BIF)

$BMD ($)

$BND ($)

BsBOB (Bs)

R$BRL (R$)

$BSD ($)

BTNBTN (BTN)

PBWP (P)

BYNBYN (BYN)

$BZD ($)

CDFCDF (CDF)

CLFCLF (CLF)

$CLP ($)

CNHCNH (CNH)

$COP ($)

₡CRC (₡)

$CUP ($)

CVECVE (CVE)

KčCZK (Kč)

DJFDJF (DJF)

krDKK (kr)

$DOP ($)

DZDDZD (DZD)

E£EGP (E£)

ERNERN (ERN)

ETBETB (ETB)

Load more (115 remaining)

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
    
    [Login](https://pricempire.com/auth/login)
    
2.  Subscribe to an API plan
    
    Choose a plan that fits your needs. Free tier available for testing.
    
    [View Plans](https://pricempire.com/subscribe)
    
3.  Get your API key
    
    [Get API Key](https://pricempire.com/settings/developer)
    

There are two ways to include your API key in your requests:

### Method 1: Using Authorization Header (Recommended)

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

### Method 2: Using Query Parameter

Add this parameter to your request URL:

    ?api_key=your_api_key

Example using curl:

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

### Important Notes

*   Replace `your_api_key` with your actual API key
*   Keep your API key secret and never share it publicly
*   If you're using the sandbox environment, use `sandbox-api.pricempire.com` instead
*   Need help? Join our [Discord community](https://discord.gg/pricempire)
    

Query Builder
-------------

### Select Endpoint

getItem Prices

/v4/paid/items/prices

getItem Prices History (Enterprise Only)

/v4/paid/items/prices/history

getItem Images

/v4/paid/items/images

getInventory

/v4/paid/inventory

getAll Items

/v4/paid/items

getItem Metadatas

/v4/paid/items/metas

getMarket Comparison

/v4/paid/comparison

getMarketplace IDs

/v4/paid/items/marketplace-ids

Item Prices
-----------

get

`https://api.pricempire.com/v4/paid/items/prices`

### Quick Start

#### Raw Requestget

    GET https://api.pricempire.com/v4/paid/items/prices?app_id=730&sources=buff163,buff163_buy&currency=USD&avg=false&median=false&inflation_threshold=-1&metas=
    Authorization: Bearer your_api_key

#### cURL

    curl -X get "https://api.pricempire.com/v4/paid/items/prices?app_id=730&sources=buff163,buff163_buy&currency=USD&avg=false&median=false&inflation_threshold=-1&metas=" -H "Authorization: Bearer your_api_key"

#### JavaScript

    const response = await fetch("GET https://api.pricempire.com/v4/paid/items/prices?app_id=730&sources=buff163,buff163_buy&currency=USD&avg=false&median=false&inflation_threshold=-1&metas=", {
        headers: {
            "Authorization": "Bearer your_api_key"
        }
    });
    const data = await response.json();

#### Python

    import requests
    
    response = requests.get(
        "GET https://api.pricempire.com/v4/paid/items/prices?app_id=730&sources=buff163,buff163_buy&currency=USD&avg=false&median=false&inflation_threshold=-1&metas=",
        headers={"Authorization": "Bearer your_api_key"}
    )
    data = response.json()

#### Node.js

    const fetch = require('node-fetch');
    
    async function fetchData() {
        const response = await fetch('GET https://api.pricempire.com/v4/paid/items/prices?app_id=730&sources=buff163,buff163_buy&currency=USD&avg=false&median=false&inflation_threshold=-1&metas=', {
            headers: {
                'Authorization': 'Bearer your_api_key'
            }
        });
        const data = await response.json();
        return data;
    }
    
    fetchData().then(data => {
        console.log(data);
    }).catch(error => {
        console.error('Error:', error);
    });

#### PHP

    <?php
    
    $url = 'GET https://api.pricempire.com/v4/paid/items/prices?app_id=730&sources=buff163,buff163_buy&currency=USD&avg=false&median=false&inflation_threshold=-1&metas=';
    $headers = [\
        'Authorization: Bearer your_api_key',\
    ];
    
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    
    $response = curl_exec($ch);
    curl_close($ch);
    
    $data = json_decode($response, true);
    
    print_r($data);

### Parameters

7 parameters

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `app_id` | number (enum) | No  | \-  | The app\_id of the game<br><br>4 accepted values<br><br>730252490440570 |
| `sources` | array | No  | buff163, buff163\_buy | Comma-separated list of sources to get prices from<br><br>46 accepted values<br><br>buff163buff163\_buylootfarmitradeskinbarontradeitbuffmarketbitskinsswapggcsfloatyoupinsteamcstradeskinthunderlisskinsskinbidmarketcsgogamerpayshadowpayskinsmonkeyskinportc5gamemannconerfskinswapkrakatoawaxpeercsmoneyskinflowskinouthaloskinsrapidskinssteam\_buydmarketcsmoneymwhitemarketdmarket\_buymarketcsgo\_buycsdealsyoupin\_buycsgoempirecsgorollcsgoempire\_storecsgoroll\_storecsgogem49skins |
| `currency` | string (enum) | No  | USD | The currency to get the prices in<br><br>162 accepted values<br><br>USDAEDAFNALLAMDANGAOAARSAUDAWGAZNBAMBBDBDTBGNBHDBIFBMDBNDBOBBRLBSDBTNBWPBYNBZDCADCDFCHFCLPCNYCOPCRCCUPCVECZKDJFDKKDOPDZDEGPERNETBEURFJDFKPFOKGBPGELGGPGHSGIPGMDGNFGTQGYDHKDHNLHRKHTGHUFIDRILSIMPINRIQDIRRISKJEPJMDJODJPYKESKGSKHRKIDKMFKRWKWDKYDKZTLAKLBPLKRLRDLSLLYDMADMDLMGAMKDMMKMNTMOPMRUMURMVRMWKMXNMYRMZNNADNGNNIONOKNPRNZDOMRPABPENPGKPHPPKRPLNPYGQARRONRSDRUBRWFSARSBDSCRSDGSEKSGDSHPSLESLLSOSSRDSSPSTNSYPSZLTHBTJSTMTTNDTOPTRYTTDTVDTWDTZSUAHUGXUYUUZSVESVNDVUVWSTXAFXCDXDRXOFXPFYERZARZMWZWL |
| `avg` | boolean | No  | false | Whether to get the average prices (7d, 30d, 60d, 90d) |
| `median` | boolean | No  | false | Whether to get the median prices (7d, 30d, 60d, 90d) |
| `inflation_threshold` | number | No  | \-1 | The inflation threshold to use (in percentage) |
| `metas` | array | No  | \[\] | Comma-separated list of metadata fields to include<br><br>11 accepted values<br><br>liquiditysteam\_last\_7dsteam\_last\_30dsteam\_last\_90dmarketcaptrades\_7dtrades\_30dtrades\_90dcountrankimage |

### Example Response

Status: 200Content-Type: application/json

\[\
  {\
    "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

`https://api.pricempire.com/v4/paid/items/prices/history`

### Quick Start

#### Raw Requestget

    GET https://api.pricempire.com/v4/paid/items/prices/history?app_id=730&provider_key=steam&currency=USD&from_date=value&to_date=value&market_hash_names=value
    Authorization: Bearer your_api_key

#### cURL

    curl -X get "https://api.pricempire.com/v4/paid/items/prices/history?app_id=730&provider_key=steam&currency=USD&from_date=value&to_date=value&market_hash_names=value" -H "Authorization: Bearer your_api_key"

#### JavaScript

    const response = await fetch("GET https://api.pricempire.com/v4/paid/items/prices/history?app_id=730&provider_key=steam&currency=USD&from_date=value&to_date=value&market_hash_names=value", {
        headers: {
            "Authorization": "Bearer your_api_key"
        }
    });
    const data = await response.json();

#### Python

    import requests
    
    response = requests.get(
        "GET https://api.pricempire.com/v4/paid/items/prices/history?app_id=730&provider_key=steam&currency=USD&from_date=value&to_date=value&market_hash_names=value",
        headers={"Authorization": "Bearer your_api_key"}
    )
    data = response.json()

#### Node.js

    const fetch = require('node-fetch');
    
    async function fetchData() {
        const response = await fetch('GET https://api.pricempire.com/v4/paid/items/prices/history?app_id=730&provider_key=steam&currency=USD&from_date=value&to_date=value&market_hash_names=value', {
            headers: {
                'Authorization': 'Bearer your_api_key'
            }
        });
        const data = await response.json();
        return data;
    }
    
    fetchData().then(data => {
        console.log(data);
    }).catch(error => {
        console.error('Error:', error);
    });

#### PHP

    <?php
    
    $url = 'GET https://api.pricempire.com/v4/paid/items/prices/history?app_id=730&provider_key=steam&currency=USD&from_date=value&to_date=value&market_hash_names=value';
    $headers = [\
        'Authorization: Bearer your_api_key',\
    ];
    
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    
    $response = curl_exec($ch);
    curl_close($ch);
    
    $data = json_decode($response, true);
    
    print_r($data);

### Parameters

6 parameters

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `app_id` | number (enum) | Yes | \-  | The app\_id of the game<br><br>4 accepted values<br><br>730570252490440 |
| `provider_key` | string (enum) | Yes | \-  | The provider key<br><br>63 accepted values<br><br>steamsteam\_buybuff163buff163\_buyskinportdmarketdmarket\_buylootfarmbitskinsskinbaroncsfloatcsmoneycsmoneymtradeitbuffmarketwhitemarketswapggskinbidc5gameyoupinyoupin\_buycstradegamerpayskinthunderlisskinsshadowpayexeskinsecosteamecosteam\_buyskinsmonkeycsdealsskinswapsnipeskinsmannconerfskinflowskinouthaloskinsrapidskinskrakatoawaxpeerwaxpeer\_buymarketcsgomarketcsgo\_buyrusttmitradeskindeckavanmarketcsgoempirecsgoempire\_storecsgo500csgofastclashggcsgorollcsgoroll\_storeskinraverollbitcsgogem49skinsskinvaultskinplacegameboosttest-market |
| `currency` | string | No  | USD | Currency for prices |
| `from_date` | string | No  | \-  | Start date for history (YYYY-MM-DD). If not provided, defaults to 30 days ago. Maximum range is 180 days. |
| `to_date` | string | No  | \-  | End date for history (YYYY-MM-DD). If not provided, defaults to today. Maximum range is 180 days. |
| `market_hash_names` | string | No  | \-  | Comma-separated list of market\_hash\_names to filter |

### Example Response

Status: 200Content-Type: application/json

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

`https://api.pricempire.com/v4/paid/items/images`

### Quick Start

#### Raw Requestget

    GET https://api.pricempire.com/v4/paid/items/images?app_id=730
    Authorization: Bearer your_api_key

#### cURL

    curl -X get "https://api.pricempire.com/v4/paid/items/images?app_id=730" -H "Authorization: Bearer your_api_key"

#### JavaScript

    const response = await fetch("GET https://api.pricempire.com/v4/paid/items/images?app_id=730", {
        headers: {
            "Authorization": "Bearer your_api_key"
        }
    });
    const data = await response.json();

#### Python

    import requests
    
    response = requests.get(
        "GET https://api.pricempire.com/v4/paid/items/images?app_id=730",
        headers={"Authorization": "Bearer your_api_key"}
    )
    data = response.json()

#### Node.js

    const fetch = require('node-fetch');
    
    async function fetchData() {
        const response = await fetch('GET https://api.pricempire.com/v4/paid/items/images?app_id=730', {
            headers: {
                'Authorization': 'Bearer your_api_key'
            }
        });
        const data = await response.json();
        return data;
    }
    
    fetchData().then(data => {
        console.log(data);
    }).catch(error => {
        console.error('Error:', error);
    });

#### PHP

    <?php
    
    $url = 'GET https://api.pricempire.com/v4/paid/items/images?app_id=730';
    $headers = [\
        'Authorization: Bearer your_api_key',\
    ];
    
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    
    $response = curl_exec($ch);
    curl_close($ch);
    
    $data = json_decode($response, true);
    
    print_r($data);

### Parameters

1 parameters

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `app_id` | number (enum) | No  | \-  | The app\_id of the game<br><br>4 accepted values<br><br>730252490440570 |

### Example Response

Status: 200Content-Type: application/json

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

Inventory
---------

get

`https://api.pricempire.com/v4/paid/inventory`

### Quick Start

#### Raw Requestget

    GET https://api.pricempire.com/v4/paid/inventory?steam_id=value&app_id=730&force=true
    Authorization: Bearer your_api_key

#### cURL

    curl -X get "https://api.pricempire.com/v4/paid/inventory?steam_id=value&app_id=730&force=true" -H "Authorization: Bearer your_api_key"

#### JavaScript

    const response = await fetch("GET https://api.pricempire.com/v4/paid/inventory?steam_id=value&app_id=730&force=true", {
        headers: {
            "Authorization": "Bearer your_api_key"
        }
    });
    const data = await response.json();

#### Python

    import requests
    
    response = requests.get(
        "GET https://api.pricempire.com/v4/paid/inventory?steam_id=value&app_id=730&force=true",
        headers={"Authorization": "Bearer your_api_key"}
    )
    data = response.json()

#### Node.js

    const fetch = require('node-fetch');
    
    async function fetchData() {
        const response = await fetch('GET https://api.pricempire.com/v4/paid/inventory?steam_id=value&app_id=730&force=true', {
            headers: {
                'Authorization': 'Bearer your_api_key'
            }
        });
        const data = await response.json();
        return data;
    }
    
    fetchData().then(data => {
        console.log(data);
    }).catch(error => {
        console.error('Error:', error);
    });

#### PHP

    <?php
    
    $url = 'GET https://api.pricempire.com/v4/paid/inventory?steam_id=value&app_id=730&force=true';
    $headers = [\
        'Authorization: Bearer your_api_key',\
    ];
    
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    
    $response = curl_exec($ch);
    curl_close($ch);
    
    $data = json_decode($response, true);
    
    print_r($data);

### Parameters

3 parameters

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `steam_id` | string | Yes | \-  | The steam\_id of the user (17 digits starting with 7656) |
| `app_id` | number (enum) | Yes | \-  | The app\_id of the game<br><br>4 accepted values<br><br>730570252490440 |
| `force` | boolean | No  | \-  | Force reload the inventory (allowed only once per minute) |

### Example Response

Status: 200Content-Type: application/json

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

`https://api.pricempire.com/v4/paid/items`

### Quick Start

#### Raw Requestget

    GET https://api.pricempire.com/v4/paid/items?language=bg
    Authorization: Bearer your_api_key

#### cURL

    curl -X get "https://api.pricempire.com/v4/paid/items?language=bg" -H "Authorization: Bearer your_api_key"

#### JavaScript

    const response = await fetch("GET https://api.pricempire.com/v4/paid/items?language=bg", {
        headers: {
            "Authorization": "Bearer your_api_key"
        }
    });
    const data = await response.json();

#### Python

    import requests
    
    response = requests.get(
        "GET https://api.pricempire.com/v4/paid/items?language=bg",
        headers={"Authorization": "Bearer your_api_key"}
    )
    data = response.json()

#### Node.js

    const fetch = require('node-fetch');
    
    async function fetchData() {
        const response = await fetch('GET https://api.pricempire.com/v4/paid/items?language=bg', {
            headers: {
                'Authorization': 'Bearer your_api_key'
            }
        });
        const data = await response.json();
        return data;
    }
    
    fetchData().then(data => {
        console.log(data);
    }).catch(error => {
        console.error('Error:', error);
    });

#### PHP

    <?php
    
    $url = 'GET https://api.pricempire.com/v4/paid/items?language=bg';
    $headers = [\
        'Authorization: Bearer your_api_key',\
    ];
    
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    
    $response = curl_exec($ch);
    curl_close($ch);
    
    $data = json_decode($response, true);
    
    print_r($data);

### Parameters

1 parameters

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `language` | string (enum) | No  | \-  | The language of the response<br><br>28 accepted values<br><br>bgcsdadeelenen-ESes-MXfifrhuitjakonlnoplpt-BRpt-PTrorusvthtrukvizh-CNzh-TW |

### Example Response

Status: 200Content-Type: application/json

\[\
  {\
    "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

`https://api.pricempire.com/v4/paid/items/metas`

### Quick Start

#### Raw Requestget

    GET https://api.pricempire.com/v4/paid/items/metas
    Authorization: Bearer your_api_key

#### cURL

    curl -X get "https://api.pricempire.com/v4/paid/items/metas" -H "Authorization: Bearer your_api_key"

#### JavaScript

    const response = await fetch("GET https://api.pricempire.com/v4/paid/items/metas", {
        headers: {
            "Authorization": "Bearer your_api_key"
        }
    });
    const data = await response.json();

#### Python

    import requests
    
    response = requests.get(
        "GET https://api.pricempire.com/v4/paid/items/metas",
        headers={"Authorization": "Bearer your_api_key"}
    )
    data = response.json()

#### Node.js

    const fetch = require('node-fetch');
    
    async function fetchData() {
        const response = await fetch('GET https://api.pricempire.com/v4/paid/items/metas', {
            headers: {
                'Authorization': 'Bearer your_api_key'
            }
        });
        const data = await response.json();
        return data;
    }
    
    fetchData().then(data => {
        console.log(data);
    }).catch(error => {
        console.error('Error:', error);
    });

#### PHP

    <?php
    
    $url = 'GET https://api.pricempire.com/v4/paid/items/metas';
    $headers = [\
        'Authorization: Bearer your_api_key',\
    ];
    
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    
    $response = curl_exec($ch);
    curl_close($ch);
    
    $data = json_decode($response, true);
    
    print_r($data);

### Example Response

Status: 200Content-Type: application/json

\[\
  {\
    "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

`https://api.pricempire.com/v4/paid/comparison`

### Quick Start

#### Raw Requestget

    GET https://api.pricempire.com/v4/paid/comparison?providers=value&page=123&sort=roi:asc&fee=123&max_price=123&min_price=123&max_roi=123&min_roi=123&liquidity=123&to_qty=123&from_qty=123&volume=123&price_age=123&blacklist=value&search=value&app_id=730&to_provider=undefined&from_provider=undefined
    Authorization: Bearer your_api_key

#### cURL

    curl -X get "https://api.pricempire.com/v4/paid/comparison?providers=value&page=123&sort=roi:asc&fee=123&max_price=123&min_price=123&max_roi=123&min_roi=123&liquidity=123&to_qty=123&from_qty=123&volume=123&price_age=123&blacklist=value&search=value&app_id=730&to_provider=undefined&from_provider=undefined" -H "Authorization: Bearer your_api_key"

#### JavaScript

    const response = await fetch("GET https://api.pricempire.com/v4/paid/comparison?providers=value&page=123&sort=roi:asc&fee=123&max_price=123&min_price=123&max_roi=123&min_roi=123&liquidity=123&to_qty=123&from_qty=123&volume=123&price_age=123&blacklist=value&search=value&app_id=730&to_provider=undefined&from_provider=undefined", {
        headers: {
            "Authorization": "Bearer your_api_key"
        }
    });
    const data = await response.json();

#### Python

    import requests
    
    response = requests.get(
        "GET https://api.pricempire.com/v4/paid/comparison?providers=value&page=123&sort=roi:asc&fee=123&max_price=123&min_price=123&max_roi=123&min_roi=123&liquidity=123&to_qty=123&from_qty=123&volume=123&price_age=123&blacklist=value&search=value&app_id=730&to_provider=undefined&from_provider=undefined",
        headers={"Authorization": "Bearer your_api_key"}
    )
    data = response.json()

#### Node.js

    const fetch = require('node-fetch');
    
    async function fetchData() {
        const response = await fetch('GET https://api.pricempire.com/v4/paid/comparison?providers=value&page=123&sort=roi:asc&fee=123&max_price=123&min_price=123&max_roi=123&min_roi=123&liquidity=123&to_qty=123&from_qty=123&volume=123&price_age=123&blacklist=value&search=value&app_id=730&to_provider=undefined&from_provider=undefined', {
            headers: {
                'Authorization': 'Bearer your_api_key'
            }
        });
        const data = await response.json();
        return data;
    }
    
    fetchData().then(data => {
        console.log(data);
    }).catch(error => {
        console.error('Error:', error);
    });

#### PHP

    <?php
    
    $url = 'GET https://api.pricempire.com/v4/paid/comparison?providers=value&page=123&sort=roi:asc&fee=123&max_price=123&min_price=123&max_roi=123&min_roi=123&liquidity=123&to_qty=123&from_qty=123&volume=123&price_age=123&blacklist=value&search=value&app_id=730&to_provider=undefined&from_provider=undefined';
    $headers = [\
        'Authorization: Bearer your_api_key',\
    ];
    
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    
    $response = curl_exec($ch);
    curl_close($ch);
    
    $data = json_decode($response, true);
    
    print_r($data);

### Parameters

18 parameters

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `providers` | string | No  | \-  | Comma-separated list of allowed providers |
| `page` | number | No  | \-  | Page number (1-100) |
| `sort` | string (enum) | No  | \-  | Sort order for results<br><br>12 accepted values<br><br>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:desc |
| `fee` | number | No  | \-  | Custom fee percentage to apply (-20 to 100) |
| `max_price` | number | No  | \-  | Maximum price filter |
| `min_price` | number | No  | \-  | Minimum price filter |
| `max_roi` | number | No  | \-  | Maximum ROI percentage (-1000 to 1000) |
| `min_roi` | number | No  | \-  | Minimum ROI percentage (-1000 to 1000) |
| `liquidity` | number | No  | \-  | Minimum liquidity percentage (0-100) |
| `to_qty` | number | No  | \-  | Minimum quantity on target provider |
| `from_qty` | number | No  | \-  | Minimum quantity on source provider |
| `volume` | number | No  | \-  | Minimum trade volume filter |
| `price_age` | number | No  | \-  | Maximum age of prices in seconds (0-604800) |
| `blacklist` | string | No  | \-  | Comma-separated blacklist terms to exclude items |
| `search` | string | No  | \-  | Comma-separated search terms to filter items |
| `app_id` | number (enum) | No  | \-  | The app\_id of the game<br><br>4 accepted values<br><br>730252490440570 |
| `to_provider` |     | Yes | \-  | Target provider to compare to |
| `from_provider` |     | Yes | \-  | Source provider to compare from |

### Example Response

Status: 200Content-Type: application/json

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

Marketplace IDs
---------------

get

`https://api.pricempire.com/v4/paid/items/marketplace-ids`

### Quick Start

#### Raw Requestget

    GET https://api.pricempire.com/v4/paid/items/marketplace-ids?app_id=730
    Authorization: Bearer your_api_key

#### cURL

    curl -X get "https://api.pricempire.com/v4/paid/items/marketplace-ids?app_id=730" -H "Authorization: Bearer your_api_key"

#### JavaScript

    const response = await fetch("GET https://api.pricempire.com/v4/paid/items/marketplace-ids?app_id=730", {
        headers: {
            "Authorization": "Bearer your_api_key"
        }
    });
    const data = await response.json();

#### Python

    import requests
    
    response = requests.get(
        "GET https://api.pricempire.com/v4/paid/items/marketplace-ids?app_id=730",
        headers={"Authorization": "Bearer your_api_key"}
    )
    data = response.json()

#### Node.js

    const fetch = require('node-fetch');
    
    async function fetchData() {
        const response = await fetch('GET https://api.pricempire.com/v4/paid/items/marketplace-ids?app_id=730', {
            headers: {
                'Authorization': 'Bearer your_api_key'
            }
        });
        const data = await response.json();
        return data;
    }
    
    fetchData().then(data => {
        console.log(data);
    }).catch(error => {
        console.error('Error:', error);
    });

#### PHP

    <?php
    
    $url = 'GET https://api.pricempire.com/v4/paid/items/marketplace-ids?app_id=730';
    $headers = [\
        'Authorization: Bearer your_api_key',\
    ];
    
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    
    $response = curl_exec($ch);
    curl_close($ch);
    
    $data = json_decode($response, true);
    
    print_r($data);

### Parameters

1 parameters

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `app_id` | number (enum) | No  | \-  | The app\_id of the game<br><br>4 accepted values<br><br>730252490440570 |

### Example Response

Status: 200Content-Type: application/json

\[\
  {\
    "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"\
  }\
\]

---