This website requires JavaScript and Cloudflare Turnstile to function properly.
Skins.com
P2P on Skins.com is now live!
0% Fees Instant
Visit

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

  2. Subscribe to an API plan

    Choose a plan that fits your needs. Free tier available for testing.

  3. Get your API key

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

Query Builder

Select Endpoint

Item Prices

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

Quick Start 

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&type=container&metas=
Authorization: Bearer your_api_key
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&type=container&metas=" -H "Authorization: Bearer your_api_key"
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&type=container&metas=", {
    headers: {
        "Authorization": "Bearer your_api_key"
    }
});
const data = await response.json();
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&type=container&metas=",
    headers={"Authorization": "Bearer your_api_key"}
)
data = response.json()
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&type=container&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

$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&type=container&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

8 parameters
Name Type Required Default Description
app_idnumber (enum)No-The app_id of the game
sourcesarray Nobuff163, buff163_buyComma-separated list of sources to get prices from
currencystring (enum)NoUSDThe currency to get the prices in
avgboolean NofalseWhether to get the average prices (7d, 30d, 60d, 90d)
medianboolean NofalseWhether to get the median prices (7d, 30d, 60d, 90d)
inflation_thresholdnumber No-1The inflation threshold to use (in percentage)
typearray No-Comma-separated list of item types to filter by
metasarray No[]Comma-separated list of metadata fields to include

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 

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 -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"
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();
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()
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

$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_idnumber (enum)Yes-The app_id of the game
provider_keystring (enum)Yes-The provider key
currencystring NoUSDCurrency for prices
from_datestring No-Start date for history (YYYY-MM-DD). If not provided, defaults to 30 days ago. Maximum range is 180 days.
to_datestring No-End date for history (YYYY-MM-DD). If not provided, defaults to today. Maximum range is 180 days.
market_hash_namesstring 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 

GET https://api.pricempire.com/v4/paid/items/images?app_id=730
Authorization: Bearer your_api_key
curl -X get "https://api.pricempire.com/v4/paid/items/images?app_id=730" -H "Authorization: Bearer your_api_key"
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();
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()
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

$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_idnumber (enum)No-The app_id of the game

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 

GET https://api.pricempire.com/v4/paid/inventory?steam_id=value&app_id=730&force=true
Authorization: Bearer your_api_key
curl -X get "https://api.pricempire.com/v4/paid/inventory?steam_id=value&app_id=730&force=true" -H "Authorization: Bearer your_api_key"
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();
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()
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

$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_idstring Yes-The steam_id of the user (17 digits starting with 7656)
app_idnumber (enum)Yes-The app_id of the game
forceboolean 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 

GET https://api.pricempire.com/v4/paid/items?language=bg
Authorization: Bearer your_api_key
curl -X get "https://api.pricempire.com/v4/paid/items?language=bg" -H "Authorization: Bearer your_api_key"
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();
import requests

response = requests.get(
    "GET https://api.pricempire.com/v4/paid/items?language=bg",
    headers={"Authorization": "Bearer your_api_key"}
)
data = response.json()
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

$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
languagestring (enum)No-The language of the response

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 

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

response = requests.get(
    "GET https://api.pricempire.com/v4/paid/items/metas",
    headers={"Authorization": "Bearer your_api_key"}
)
data = response.json()
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

$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 

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 -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"
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();
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()
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

$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
providersstring No-Comma-separated list of allowed providers
pagenumber No-Page number (1-100)
sortstring (enum)No-Sort order for results
feenumber No-Custom fee percentage to apply (-20 to 100)
max_pricenumber No-Maximum price filter
min_pricenumber No-Minimum price filter
max_roinumber No-Maximum ROI percentage (-1000 to 1000)
min_roinumber No-Minimum ROI percentage (-1000 to 1000)
liquiditynumber No-Minimum liquidity percentage (0-100)
to_qtynumber No-Minimum quantity on target provider
from_qtynumber No-Minimum quantity on source provider
volumenumber No-Minimum trade volume filter
price_agenumber No-Maximum age of prices in seconds (0-604800)
blackliststring No-Comma-separated blacklist terms to exclude items
searchstring No-Comma-separated search terms to filter items
app_idnumber (enum)No-The app_id of the game
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
}

Price Feed Events (Enterprise Only)

get
https://api.pricempire.com/v4/paid/items/prices/feed

Quick Start 

GET https://api.pricempire.com/v4/paid/items/prices/feed?sources=value&since=123
Authorization: Bearer your_api_key
curl -X get "https://api.pricempire.com/v4/paid/items/prices/feed?sources=value&since=123" -H "Authorization: Bearer your_api_key"
const response = await fetch("GET https://api.pricempire.com/v4/paid/items/prices/feed?sources=value&since=123", {
    headers: {
        "Authorization": "Bearer your_api_key"
    }
});
const data = await response.json();
import requests

response = requests.get(
    "GET https://api.pricempire.com/v4/paid/items/prices/feed?sources=value&since=123",
    headers={"Authorization": "Bearer your_api_key"}
)
data = response.json()
const fetch = require('node-fetch');

async function fetchData() {
    const response = await fetch('GET https://api.pricempire.com/v4/paid/items/prices/feed?sources=value&since=123', {
        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

$url = 'GET https://api.pricempire.com/v4/paid/items/prices/feed?sources=value&since=123';
$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

2 parameters
Name Type Required Default Description
sourcesstring Yes-Comma-separated list of provider keys
sincenumber No-Unix timestamp in milliseconds — only return events after this time (max 5 minutes ago)

Example Response

Status: 200Content-Type: application/json
{
  "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
https://api.pricempire.com/v4/paid/items/marketplace-ids

Quick Start 

GET https://api.pricempire.com/v4/paid/items/marketplace-ids?app_id=730
Authorization: Bearer your_api_key
curl -X get "https://api.pricempire.com/v4/paid/items/marketplace-ids?app_id=730" -H "Authorization: Bearer your_api_key"
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();
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()
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

$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_idnumber (enum)No-The app_id of the game

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