API Documentation

Base URL /api/v1. Authenticate with the x-api-key header (or ?key=). Every response is JSON: { "data": ... } on success, { "error": ... } on failure. Rate-limit headers are returned on every call.

cURL

curl "https://skinapi.skinvaults.online/api/v1/markets?name=AK-47%20|%20Redline%20(Field-Tested)&game=cs2" \
  -H "x-api-key: sk_live_xxx"

JavaScript

const r = await fetch(
  "https://skinapi.skinvaults.online/api/v1/markets?" +
  new URLSearchParams({ name, game: "cs2" }),
  { headers: { "x-api-key": KEY } }
);
const { data } = await r.json();

Python

import requests
r = requests.get(
  "https://skinapi.skinvaults.online/api/v1/markets",
  params={"name": name, "game": "cs2"},
  headers={"x-api-key": KEY})
data = r.json()["data"]

Run in Postman

All 17 endpoints organised into folders with pre-filled example values - just set your API key and hit Send.

No Postman app? Download the .jsonthen use Postman > Import.

Open in Postman

OpenAPI: /api/v1/openapi.json · Status: /status

GET/api/v1/marketsPrices

Unified price for an item across every tracked marketplace.

Param	Required	Example	Description
name	yes	AK-47 \| Redline (Field-Tested)	market_hash_name of the item
game	no	cs2	cs2 (default), dota2, rust, ...
currency	no	USD	ISO 4217 code (USD default, e.g. EUR, GBP)

POST/api/v1/markets/batchPrices

Price up to 20 items across all markets in one call.

{
  "names": [
    "AK-47 | Redline (Field-Tested)",
    "AWP | Asiimov (Field-Tested)",
    "Glock-18 | Water Elemental (Factory New)"
  ],
  "game": "cs2",
  "currency": "USD"
}

GET/api/v1/itemsPrices

Current price for an item (cached Steam Market, live fallback).

Param	Required	Example	Description
name	yes	AK-47 \| Redline (Field-Tested)	market_hash_name
game	no	cs2	game key
currency	no	USD	ISO 4217 code (USD default, e.g. EUR, GBP)

GET/api/v1/historyPrices

Daily price history (cross-source average + volume). Returns up to 365 days.

Param	Required	Example	Description
name	yes	AK-47 \| Redline (Field-Tested)	market_hash_name
game	no	cs2	cs2 (default), dota2, rust, ...
days	no	30	1-365 (default 30)
currency	no	EUR	ISO 4217 code for price conversion (default USD, e.g. EUR, GBP)

GET/api/v1/dealsPrices

Deal finder: items priced below Steam across markets.

Param	Required	Example	Description
game	no	cs2	game key (default cs2)
min_discount	no	0.15	0-0.95 (default 0.15)
currency	no	USD	ISO 4217 (default USD)

GET/api/v1/floatFloat

Exact float, paint seed, pattern (Doppler phase, blue-gem tier, Fire&Ice), stickers with images and sticker value (USD), and item name+image.

Param	Required	Example	Description
url	yes	steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20S76561198006518558A35678741806D7170682694397862	CS2 inspect link (steam:// or https://)

GET/api/v1/float/leaderboardFloat

Lowest (or highest) float leaderboard for a skin.

Param	Required	Example	Description
name	yes	AK-47 \| Redline (Field-Tested)	skin name
order	no	lowest	lowest (default) \| highest
limit	no	25	1-100 (default 25)

GET/api/v1/inventoryInventory

Public inventory priced per item with total value, plus a summary (rarity breakdown, tradable/marketable counts, top items). Supports any game.

Param	Required	Example	Description
steam_id	yes	76561197960435530	SteamID64 or vanity name
game	no	cs2	game key (default cs2)
prices	no	true	false to skip valuation (default true)
currency	no	USD	ISO 4217 code for prices/total (default USD)

POST/api/v1/inventory/batchInventory

Up to 10 inventories in a single request.

{
  "steam_ids": [
    "76561197960435530",
    "76561198006518558"
  ],
  "game": "cs2"
}

GET/api/v1/inventory/historyInventory

Daily value-over-time history for a tracked inventory.

Param	Required	Example	Description
steam_id	yes	76561197960435530	SteamID64 or vanity name
game	no	cs2	game key (default cs2)
days	no	90	1-365 (default 90)
currency	no	USD	ISO 4217 (default USD)

GET/api/v1/profileProfile

Steam profile with level, CS2 playtime (hours), VAC/trade/community ban status, avatar and country.

Param	Required	Example	Description
id	yes	76561197960435530	SteamID64 or vanity name

GET/api/v1/friendlistProfile

Friend list with friendship timestamps.

Param	Required	Example	Description
steam_id	yes	76561197960435530	SteamID64 or vanity name

GET/api/v1/catalogItems DB

Full paginated item catalog (up to 500/page). CS2 returns all ~15K wear-specific items from the asset DB with image, type and rarity. Other games return names seen in the prices collection. Add ?prices=true to include the lowest known price per item.

Param	Required	Example	Description
game	no	cs2	cs2 (default), dota2, rust, tf2, ...
limit	no	0	items per page, default 100. Pass 0 for the full dataset (no cap)
offset	no	0	pagination offset (default 0)
q	no	AK-47	search / filter by name (partial match)
type	no	Rifle	CS2 weapon type filter (Rifle, Pistol, Knife, …)
rarity	no	Classified	CS2 rarity filter (Covert, Classified, Restricted, …)
prices	no	true	true to include lowest known price per item
sort	no	price	name (default) or price (requires prices=true)
currency	no	USD	ISO 4217 code for prices (default USD)

GET/api/v1/items/searchItems DB

Search the CS2 item database by name (autocomplete).

Param	Required	Example	Description
q	no	AK-47 Redline	search query
limit	no	20	1-50 (default 20)

GET/api/v1/items/metaItems DB

Full metadata for an item (weapon, rarity, collection, crates, float range).

Param	Required	Example	Description
name	yes	AK-47 \| Redline (Field-Tested)	market_hash_name

POST/api/v1/tradeupUtility

Trade-up calculator: 10 items of the same rarity + collection -> possible outcomes, probabilities, EV.

{
  "items": [
    {
      "name": "AK-47 | Redline (Field-Tested)",
      "float": 0.2
    },
    {
      "name": "AK-47 | Redline (Field-Tested)",
      "float": 0.22
    },
    {
      "name": "AK-47 | Redline (Field-Tested)",
      "float": 0.24
    },
    {
      "name": "AK-47 | Redline (Field-Tested)",
      "float": 0.26
    },
    {
      "name": "AK-47 | Redline (Field-Tested)",
      "float": 0.28
    },
    {
      "name": "AK-47 | Redline (Field-Tested)",
      "float": 0.3
    },
    {
      "name": "AK-47 | Redline (Field-Tested)",
      "float": 0.32
    },
    {
      "name": "AK-47 | Redline (Field-Tested)",
      "float": 0.34
    },
    {
      "name": "AK-47 | Redline (Field-Tested)",
      "float": 0.36
    },
    {
      "name": "AK-47 | Redline (Field-Tested)",
      "float": 0.38
    }
  ]
}

GET/api/v1/statusUtility

Public component health: DB connectivity, price ingest freshness, Buff source status, market source reachability. No auth required.

Machine-readable spec: /api/v1/openapi.json