Min Prices API

This documentation explains how to use the aggregatedMinPrices GraphQL query to fetch the minimum prices for items across multiple marketplaces.

Authentication

All API requests require authentication using a JWT token. Include the following header in your requests:

Header	Value	Description
`api-token`	`<generated_jwt>`	Your JWT authentication token

For information on how to generate your JWT token, please refer to the Authentication Guide.

GraphQLREST

graphql

# Query
query MinPrices($markets: [String!]!) {
  aggregatedMinPrices(markets: $markets) {
    market_hash_name
    prices {
      market_name
      offers
      price
      price_locked
    }
  }
}

# Variables
{
  "markets": [
    "buff163",
    "skinport",
    "csmoney",
    "steamcommunity"
  ]
}

http

# Endpoint
POST https://api.csmarketcap.com/api/v2/rest/get-aggregated-min-prices

# Request Body
{
  "game_id": 730, // required: The game ID (e.g., 730 for CS2)
  "markets": ["buff163", "skinport", "csmoney", "steamcommunity"] // required: Array of marketplace names
}

# Response Format: AggregatedMinPricesCsmarketCapFormat[]
[
  {
    "market_hash_name": "Sticker | Vitality | Paris 2023",
    "prices": [
      {
        "market_name": "marketcsgo",
        "offers": 2209,
        "price": 5,
        "price_locked": null
      },
      {
        "market_name": "csmoney",
        "offers": 408,
        "price": 20,
        "price_locked": null
      },
      {
        "market_name": "steamcommunity",
        "offers": 5399718,
        "price": 30,
        "price_locked": null
      }
    ]
  }
]

Parameters

Parameter	Type	Description	Required
`markets`	[String]	Array of marketplace names to include in the comparison	Yes

Supported Markets

The following marketplaces are supported:

Market Name	Description
`aim-market`	Aim.market
`avanmarket`	Avan.Market
`bitskins`	Bitskins
`buff163`	BUFF163
`c5`	C5 Game
`cs-trade`	CS.TRADE
`csdeals`	CSDeals
`csfloat`	CSFloat
`marketcsgo`	MarketCSGO
`csmoney`	CS.MONEY
`dmarket`	DMarket
`ecosteam`	ECOSteam
`gameboost`	GameBoost
`gamerpay`	GamerPay
`haloskins`	Haloskins
`itrade`	iTrade.gg
`lis-skins`	Lis Skins
`lootfarm`	LOOTFarm
`mannco`	Mannco
`pirateswap`	PirateSwap
`rapidskins`	Rapidskins
`shadowpay`	ShadowPay
`skinflow`	Skinflow
`skinland`	Skin.Land
`skinout`	Skinout
`skinplace`	SKINPLACE
`skinport`	Skinport
`skins-monkey`	SkinsMonkey
`skinswap`	SkinSwap
`skinvault`	Skinvault
`steamcommunity`	SteamCommunity
`tradeit`	Tradeit
`uuskins`	UUSKINS
`waxpeer`	Waxpeer
`white-market`	WhiteMarket
`youpin`	Youpin

Response Fields

Root Object

Field	Type	Description
`market_hash_name`	String	The unique identifier of the item
`prices`	[MarketPrice]	Array of price information for each marketplace

MarketPrice Object

Field	Type	Description
`market_name`	String	Name of the marketplace
`offers`	Integer	Number of available offers/listings
`price`	Integer	Minimum price on the marketplace (divide by 1000 to get the real value)
`price_locked`	Integer	Minimum price for locked/trade-restricted items (divide by 1000 to get the real value)

Code Examples

const axios = require('axios');

async function getMinPrices(markets) {
  const query = `
    query MinPrices($markets: [String!]!) {
      aggregatedMinPrices(markets: $markets) {
        market_hash_name
        prices {
          market_name
          offers
          price
          price_locked
        }
      }
    }
  `;

  try {
    const response = await axios({
      url: 'https://api.csmarketcap.com/api/v2/graphql',
      method: 'post',
      headers: {
        'Content-Type': 'application/json',
        'api-token': 'YOUR_JWT_TOKEN_HERE'
      },
      data: {
        query: query,
        variables: {
          markets: markets
        }
      }
    });

    console.log('Min prices:', response.data.data.aggregatedMinPrices);
    return response.data.data.aggregatedMinPrices;
  } catch (error) {
    console.error('Error fetching min prices:', error);
  }
}

// Compare prices across popular marketplaces
getMinPrices(['buff163', 'skinport', 'csmoney', 'steamcommunity']);

const axios = require('axios');

async function getMinPrices(markets, gameId = 730) {
  try {
    const response = await axios({
      url: 'https://api.csmarketcap.com/api/v2/rest/get-aggregated-min-prices',
      method: 'post',
      headers: {
        'api-token': 'YOUR_JWT_TOKEN_HERE',
        'Content-Type': 'application/json'
      },
      data: {
        markets: markets,
        game_id: gameId
      }
    });

    console.log('Min prices:', response.data);
    return response.data;
  } catch (error) {
    console.error('Error fetching min prices:', error);
  }
}

// Compare prices across popular marketplaces
getMinPrices(['buff163', 'skinport', 'csmoney', 'steamcommunity']);

import { Csmc } from 'csmc-sdk';

const sdk = new Csmc('YOUR_API_KEY');

async function getMinPrices() {
  await sdk.initialize();
  
  const prices = await sdk.methods.aggregatedMinPrices({
    game_id: 730,
    markets: ["buff163", "skinport", "csmoney", "steamcommunity"]
  });
  
  console.log(prices);
  return prices;
}

getMinPrices();

bash

curl -X POST https://api.csmarketcap.com/api/v2/graphql \
  -H "Content-Type: application/json" \
  -H "api-token: YOUR_JWT_TOKEN_HERE" \
  -d '{
    "query": "query MinPrices($markets: [String!]!) { aggregatedMinPrices(markets: $markets) { market_hash_name prices { market_name offers price price_locked } } }",
    "variables": {
      "markets": ["buff163", "skinport", "csmoney", "steamcommunity"]
    }
  }'

bash

curl -X POST "https://api.csmarketcap.com/api/v2/rest/get-aggregated-min-prices" \
  -H "Content-Type: application/json" \
  -H "api-token: YOUR_JWT_TOKEN_HERE" \
  -d '{
    "markets": ["buff163", "skinport", "csmoney", "steamcommunity"],
    "game_id": 730
  }'

Example Response

json

{
  "data": {
    "aggregatedMinPrices": [
      {
        "market_hash_name": "Sticker | Vitality | Paris 2023",
        "prices": [
          {
            "market_name": "marketcsgo",
            "offers": 2209,
            "price": 5,
            "price_locked": null
          },
          {
            "market_name": "csmoney",
            "offers": 408,
            "price": 20,
            "price_locked": null
          },
          {
            "market_name": "steamcommunity",
            "offers": 5399718,
            "price": 30,
            "price_locked": null
          }
        ]
      },
      {
        "market_hash_name": "Sticker | IEM | Rio 2022",
        "prices": [
          {
            "market_name": "marketcsgo",
            "offers": 1045,
            "price": 5,
            "price_locked": null
          },
          {
            "market_name": "csmoney",
            "offers": 44,
            "price": 20,
            "price_locked": null
          },
          {
            "market_name": "steamcommunity",
            "offers": 1239210,
            "price": 30,
            "price_locked": null
          }
        ]
      },
      {
        "market_hash_name": "Sticker | Techno4K | Copenhagen 2024",
        "prices": [
          {
            "market_name": "marketcsgo",
            "offers": 749,
            "price": 5,
            "price_locked": null
          },
          {
            "market_name": "csmoney",
            "offers": 23,
            "price": 20,
            "price_locked": null
          },
          {
            "market_name": "steamcommunity",
            "offers": 226648,
            "price": 30,
            "price_locked": null
          }
        ]
      },
      {
        "market_hash_name": "Sticker | ZywOo (Champion) | Paris 2023",
        "prices": [
          {
            "market_name": "marketcsgo",
            "offers": 747,
            "price": 5,
            "price_locked": null
          },
          {
            "market_name": "csmoney",
            "offers": 46,
            "price": 20,
            "price_locked": null
          },
          {
            "market_name": "steamcommunity",
            "offers": 857116,
            "price": 30,
            "price_locked": null
          }
        ]
      },
    ]
  }
}

Usage Notes

The price field represents the minimum price for items that can be traded immediately
The price_locked field represents the minimum price for items that have trade restrictions (e.g., Steam's 7-day trade hold)
For some marketplaces, price and price_locked might be the same if the marketplace doesn't distinguish between locked and unlocked items
Price values are provided in cents (divide by 1000 to get dollar value)
For efficiency, it's recommended to request only the marketplaces you need rather than all supported ones

Min Prices API ​

Authentication ​

Parameters ​

Supported Markets ​

Response Fields ​

Root Object ​

MarketPrice Object ​

Code Examples ​

Example Response ​

Usage Notes ​