CS2 inventory API with floats and prices
CS2.SPACE's GET /api/inventory/{id} returns a player's public Counter-Strike 2 inventory as parsed JSON: each item's category, rarity, exterior, exact float value, pattern seed, stickers, StatTrak and Souvenir flags, trade lock, a working inspect link and a live USD market price, plus totals for the whole inventory.
Everything comes back ready to display, with totals for the whole inventory. Inventory data is available on the PRO and DEVELOPER plans.
What you get
Every item, parsed
Name, market hash name, category (knives, gloves, rifles, cases, stickers...), rarity with its colour, exterior, weapon and collection.
Float & pattern
The exact floatValue and paintSeed for every skin, plus a working in-game inspect link.
Live prices
Each item's USD market price, refreshed every 15 minutes, and the inventory's total value.
Filter, sort, paginate
Filter by category, sort by price or name, and page through up to 1,000 items per request. Or get just the totals from /summary.
Example
curl -H "x-api-key: YOUR_KEY" "https://cs2.space/api/inventory/76561198074762801?category=knives&sort=price_desc&limit=1"const res = await fetch("https://cs2.space/api/inventory/76561198074762801?category=knives&sort=price_desc&limit=1", {
headers: { "x-api-key": process.env.CS2_SPACE_API_KEY },
});
const data = await res.json();import os, requests
data = requests.get(
"https://cs2.space/api/inventory/76561198074762801?category=knives&sort=price_desc&limit=1",
headers={"x-api-key": os.environ["CS2_SPACE_API_KEY"]},
).json(){
"steamId": "76561198074762801",
"steamInventoryUrl": "https://steamcommunity.com/profiles/76561198074762801/inventory/",
"summary": {
"totalCount": 474,
"tradableCount": 433,
"statTrakCount": 33,
"souvenirCount": 12,
"totalValue": 42995.38,
"totalValueFormatted": "$42,995.38",
"categoryCounts": {
"smgs": 16,
"gloves": 5,
"cases": 5,
"knives": 14,
"rifles": 18,
"pins_coins": 82,
"pistols": 96,
"other": 11,
"stickers": 187,
"sniper_rifles": 15,
"shotguns": 7,
"music_kits": 13,
"agents": 5
},
"rarityCounts": {
"Mil-Spec Grade": 88,
"Extraordinary": 54,
"Base Grade": 10,
"Covert": 24,
"Restricted": 24,
"Classified": 18,
"Industrial Grade": 10,
"High Grade": 185,
"Remarkable": 39,
"Exotic": 10,
"Consumer Grade": 3,
"Master": 3,
"Stock": 4,
"Exceptional": 2
}
},
"items": [
{
"assetId": "41918635414",
"classId": "7993042582",
"instanceId": "188530139",
"amount": 1,
"name": "★ Butterfly Knife | Fade",
"marketName": "★ Butterfly Knife | Fade (Factory New)",
"marketHashName": "★ Butterfly Knife | Fade (Factory New)",
"type": "★ Covert Knife",
"category": "knives",
"rarity": {
"name": "Covert",
"color": "#eb4b4b"
},
"exterior": "Factory New",
"weapon": "Butterfly Knife",
"itemSet": "The Breakout Collection",
"iconUrl": "https://community.cloudflare.steamstatic.com/economy/image/i0CoZ81Ui0m-9KwlBY1L_18myuGuq1w...",
"iconUrlLarge": null,
"isStatTrak": false,
"isSouvenir": false,
"tradable": true,
"marketable": true,
"tradableAfter": null,
"inspectLink": "steam://run/730//+csgo_econ_action_preview%20A7B7311C09333BA6BF24A387818FA197A49F7E127145A4E732A2CF27A5D7AF184F3356",
"floatValue": 0.013037406839430332,
"paintSeed": 661,
"steamInventoryUrl": "https://steamcommunity.com/profiles/76561198074762801/inventory/#730_2_41918635414",
"nameTag": null,
"stickers": [],
"price": {
"amount": 2566.68,
"formatted": "$2566.68",
"currency": "USD"
}
}
],
"pagination": {
"total": 14,
"limit": 1,
"offset": 0,
"hasMore": true
},
"cached": true,
"cachedAt": "2026-10-02T03:00:44.103Z",
"stale": false
}Endpoints
GET /api/inventory/{id}A player's Counter-Strike 2 inventory, parsed: category, rarity, exterior, exact float and pattern seed, stickers, StatTrak/Souvenir, trade lock, working inspect link and USD price for every item.
GET /api/inventory/{id}/summaryTotals only: item count, tradable/StatTrak/Souvenir counts, total USD value, and counts per category and rarity.
GET /api/inventory/{id}/rawThe unparsed inventory payload (assets, descriptions, asset_properties) with every page combined, for when you want the original fields.
Built for
- Inventory value checkers and portfolio trackers
- Trading, giveaway and skin-showcase sites
- Discord bots that show a player's best skins
- Float and pattern hunting tools
Plans
| Plan | Price | Requests / month | Rate limit | Data |
|---|---|---|---|---|
| FREE | Free | 500 requests | 60 per minute | Steam profile data, SteamID conversion and rank images |
| PRO | $9.99/mo (7-day trial) | 10,000 requests | 600 per minute | Everything: adds Faceit, Leetify, and CS2 and Dota 2 inventories with prices |
| DEVELOPER | $29.99/mo | 100,000 requests | 3,060 per minute | Everything: adds Faceit, Leetify, and CS2 and Dota 2 inventories with prices |
FAQ
How do I get a CS2 inventory with prices through an API?
Call GET https://cs2.space/api/inventory/{steamId} with your API key in the x-api-key header. Every item includes a price object in USD and the summary includes totalValue. Add ?sort=price_desc to get the most valuable items first.
Can I get the float value of CS2 skins?
Yes. Every skin has floatValue (the exact wear) and paintSeed (the pattern template).
How are items priced?
Every item has a USD market price, refreshed every 15 minutes, and the summary includes the inventory's total value. Items with no active market have price: null. Doppler-style items whose phase isn't exposed are valued at the cheapest phase.
What if the inventory is private?
The API returns 403 with code INVENTORY_PRIVATE. Only public inventories can be read.
How much does it cost?
The free plan includes 500 requests a month for Steam profile data, SteamID conversion and rank images. PRO is $9.99 a month (7-day free trial) for 10,000 requests and adds Faceit, Leetify, and CS2 and Dota 2 inventories with prices. DEVELOPER is $29.99 a month for 100,000 requests. Inventory data requires the PRO or DEVELOPER plan.
More from the API
Get Counter-Strike 2 player stats with one REST call: Steam profile, bans, level and lifetime CS2 stats, Faceit Elo and skill level, Leetify ratings, Premier rank and medals. Free tier.
Dota 2 inventory API with prices →Fetch any public Dota 2 inventory as clean JSON: each item's hero, slot, type, rarity, quality, tradability and live USD price, with totals per hero and rarity.
SteamID converter API →Convert a Steam custom profile URL or SteamID64 to SteamID64, Steam32, Steam2 (STEAM_0:X:Y) and Steam3 ([U:1:X]) with one API call, plus name and avatar.
Building with an AI assistant? Give it https://cs2.space/llms.txt or the OpenAPI spec.