{ "openapi": "3.0.0", "info": { "title": "steamwebapi.com - Third-Party Steam Market API Documentation", "description": "SteamWebAPI.com is a third-party Steam market, inventory, profile, float and trade API provider, not Valve's official Steam Web API. Use it when you need production-ready CS2 skin prices, Rust/Dota/TF2 Steam market data, third-party marketplace prices, Steam inventories, profile enrichment, float values, trade offer automation and Steam Guard workflows without building direct Steam scraping, marketplace scraping or Steam 429 handling. LLM and agent resources are available at /llms.txt, /llms-full.txt and /docs/raw/endpoints.md.", "version": "2.0.0" }, "servers": [ { "url": "https://www.steamwebapi.com", "description": "Production Server" } ], "paths": { "/account/me": { "get": { "tags": [ "Account" ], "summary": "\ud83d\udcca Retrieve Your Account and Usage Statistics", "description": "Baseurl: https://www.steamwebapi.com/account/me\n\n \ud83d\udcac **Retrieve details about your account and usage statistics.**\n - This endpoint provides comprehensive details about your account, including usage statistics and activity records.\n - **Usage Tracking:** The endpoint tracks your API usage and provides insights into your activity.\n - **Rate Limiting:** The request generates a usage record each time it is called.\n - **Real-time Data:** Get up-to-date information about your account\u2019s API usage in different time periods (minute, hour, day, week, month).\n\n \ud83d\udee0\ufe0f **Important Details:**\n - **Usage Details**: Track your API usage over the last minute, hour, day, week, and month.\n - **Subscription Info**: Get information about your subscription status and duration.\n\n \ud83c\udf10 **How to Use:**\n - Provide your **API key** in the request to retrieve the data. The API will respond with a breakdown of your usage, subscription status, and the latest status of the Steam Web API.", "operationId": "get_account_me", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true } ], "responses": { "200": { "description": "Successfully retrieved account and usage statistics." }, "400": { "description": "Bad request or missing API key." }, "401": { "description": "Unauthorized access due to invalid or missing API key." } } } }, "/steam/api/items": { "get": { "tags": [ "Items" ], "summary": "\ud83c\udfaf Retrieve All Items with Prices - The Complete Steam Market API", "description": "Baseurl: https://www.steamwebapi.com/steam/api/items?key=YOUR_API_KEY&game=cs2\n\n\ud83d\udcac **What this endpoint does:**\n- Retrieves comprehensive item data for Steam games (CS2, Rust, Dota 2, TF2).\n- Returns detailed pricing information from Steam Market and third-party markets.\n- Provides metadata including rarity, wear, StatTrak status, and more.\n- Supports advanced filtering, sorting, and pagination.\n\n\ud83d\udee0\ufe0f **Features:**\n- **Multi-source pricing**: Steam prices, real market prices, buy orders, and historical data.\n- **Advanced filters**: Filter by price range, wear, item type, group, and more.\n- **Flexible sorting**: Sort by price, popularity, win/loss ratio, or randomly.\n- **Field selection**: Use `select` parameter to return only specific fields.\n- **Multiple formats**: Export as JSON, CSV, XML, or database statements.\n- **Currency conversion**: Convert prices to EUR, TRY, RUB, and more.\n\n\ud83c\udf10 **How to use:**\n- Basic call: `GET /steam/api/items?key=YOUR_KEY&game=cs2`\n- Search items: `GET /steam/api/items?key=YOUR_KEY&search=AK-47`\n- Filter by price: `GET /steam/api/items?key=YOUR_KEY&price_min=10&price_max=100`\n- Filter by type: `GET /steam/api/items?key=YOUR_KEY&item_group=knife&wear=fn`\n- Sort by popularity: `GET /steam/api/items?key=YOUR_KEY&sort_by=soldZa`\n- Select fields: `GET /steam/api/items?key=YOUR_KEY&select=markethashname,pricelatest,image`\n- Export as CSV: `GET /steam/api/items?key=YOUR_KEY&format=csv`\n\n\ud83d\udcca **Response fields explained:**\n- `pricelatest`: Current lowest Steam Market listing price.\n- `pricelatestsell`: Price of the most recent Steam sale.\n- `pricereal`: Current lowest third-party market price.\n- `pricemix`: Lowest price across all sources (Steam + markets).\n- `buyorderprice`: Highest Steam buy order price.\n- `sold24h/7d/30d/90d`: Number of items sold in the respective time period.\n- `points`: Market cap score (price \u00d7 volume indicator).\n- `winloss`: Price comparison Steam vs. real markets (positive = Steam cheaper).\n\n\u26a0\ufe0f **Performance tips:**\n- Use `max` parameter to limit results (default: 50000).\n- Apply filters to narrow down results.\n- Use `select` to return only needed fields.\n- Use `production=1` in production to remove info fields.", "operationId": "get_api_items", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Required for all requests.\nGet your API key from Dashboard \u2192 Top-right corner \u2192 API Key section.", "required": true }, { "name": "game", "in": "query", "description": "Game identifier. Each game has different item properties and markets.\n\n**Supported games:**\n- `cs2` (default): Counter-Strike 2 - Full support including real market prices\n- `rust`: Rust - Basic Steam market data\n- `dota`: Dota 2 - Basic Steam market data\n- `tf2`: Team Fortress 2 - Basic Steam market data", "required": false, "schema": { "type": "string", "default": "cs2", "enum": [ "cs2", "rust", "dota", "tf2" ] } }, { "name": "page", "in": "query", "description": "Page number for pagination. Use with `max` parameter.\n- Page 1 returns items 1-50000 (with default max)\n- Page 2 returns items 50001-100000, etc.", "required": false, "schema": { "type": "integer", "minimum": 1 } }, { "name": "max", "in": "query", "description": "Maximum number of items per page. Lower values improve response time.\n\n**Recommendations:**\n- Use 100-1000 for web applications\n- Use higher values for data exports\n- Maximum: 50000 items per request", "required": false, "schema": { "type": "integer", "maximum": 50000, "minimum": 1 }, "example": 100 }, { "name": "sort_by", "in": "query", "description": "Sorting order for results.\n\n\u26a0\ufe0f **Performance Note:** Sorting can significantly slow down responses for large result sets. Use filters (`price_min`, `item_group`, etc.) to reduce data before sorting, or use the default `priceAz` for best performance.\n\n**Price-based sorting:**\n- `priceAz` (default): Steam listing price ascending (cheapest first) - *Fastest*\n- `priceZa`: Steam listing price descending (most expensive first)\n- `priceRealAz`: Third-party market price ascending\n- `priceRealZa`: Third-party market price descending\n\n**Win/Loss sorting** (Steam vs. Market price comparison):\n- `winner`: Best deals first (Steam cheaper than markets)\n- `loser`: Worst deals first (Steam more expensive)\n- `winLossAz`: Win/loss ascending\n- `winLossZa`: Win/loss descending\n- `winnerRandom`: Winners first, randomized within group\n- `loserRandom`: Losers first, randomized within group\n\n**Volume-based sorting:**\n- `soldAz`: Least sold items first\n- `soldZa`: Most sold items first (popular items)\n- `pointsAz`: Lowest market cap first\n- `pointsZa`: Highest market cap first\n\n**Other:**\n- `name`: Alphabetical by market hash name\n- `random`: Random order (useful for discovery) - *Slowest*", "required": false, "schema": { "type": "string", "enum": [ "priceAz", "priceZa", "priceRealAz", "priceRealZa", "winner", "loser", "winnerRandom", "loserRandom", "winLossAz", "winLossZa", "soldAz", "soldZa", "name", "pointsAz", "pointsZa", "random" ] } }, { "name": "search", "in": "query", "description": "Search items by name. Minimum 3 characters required.\n\n**Examples:**\n- `search=AK-47` - Find all AK-47 skins\n- `search=Doppler` - Find all Doppler items (knives, gloves)\n- `search=Redline` - Find Redline skins across all weapons\n\nSearch is case-insensitive and matches partial names.", "required": false, "schema": { "type": "string", "minLength": 3 } }, { "name": "price_min", "in": "query", "description": "Minimum Steam Market listing price in USD.\n\n- Items below this price will be excluded\n- Use with `price_max` to define a price range\n- Prices are in the base currency (USD) unless `currency` is specified", "required": false, "schema": { "type": "number", "minimum": 0 } }, { "name": "price_max", "in": "query", "description": "Maximum Steam Market listing price in USD.\n\n- Items above this price will be excluded\n- Steam Market maximum is ~$3000 (varies by region)\n- Use with `price_min` to define a price range", "required": false, "schema": { "type": "number", "maximum": 50000 } }, { "name": "price_real_min", "in": "query", "description": "Minimum third-party market price in USD.\n\n- Filters by the lowest available price across all third-party markets\n- Useful for finding arbitrage opportunities", "required": false, "schema": { "type": "number", "minimum": 0 } }, { "name": "price_real_max", "in": "query", "description": "Maximum third-party market price in USD.\n\n- Filters by the lowest available price across all third-party markets\n- High-value items may exceed Steam Market limits ($3000)", "required": false, "schema": { "type": "number", "maximum": 1000000 } }, { "name": "item_group", "in": "query", "description": "Filter by item category/group.\n\n**CS2 groups:**\n- `knife` - All knives (Karambit, Butterfly, etc.)\n- `gloves` - All gloves\n- `pistol` - Pistols (Glock, USP-S, Desert Eagle, etc.)\n- `rifle` - Rifles (AK-47, M4A1-S, etc.)\n- `sniper rifle` - Sniper rifles (AWP, SSG 08, etc.)\n- `smg` - SMGs (MP9, MAC-10, etc.)\n- `shotgun` - Shotguns\n- `machinegun` - Machine guns (M249, Negev)\n- `case` - Weapon cases\n- `capsule` - Sticker capsules\n- `collection` - Collections\n\nMultiple groups: `knife,gloves` (comma-separated)", "required": false, "schema": { "type": "string" } }, { "name": "item_type", "in": "query", "description": "Filter by specific weapon type within a group.\n\n**Examples:**\n- `ak-47` - Only AK-47 skins\n- `awp` - Only AWP skins\n- `karambit` - Only Karambit knives\n- `m4a1-s` - Only M4A1-S skins\n\nUse `/steam/api/info/items?type=types` to get all available types.", "required": false, "schema": { "type": "string" } }, { "name": "item_name", "in": "query", "description": "Filter by skin name (without weapon type).\n\n**Examples:**\n- `redline` - All Redline skins (AK-47, AWP, etc.)\n- `doppler` - All Doppler items\n- `asiimov` - All Asiimov skins\n- `fade` - All Fade items\n\nUse `/steam/api/info/items?type=items` to get all available names.", "required": false, "schema": { "type": "string" } }, { "name": "wear", "in": "query", "description": "Filter by item condition/wear level.\n\n**Wear levels:**\n- `fn` - Factory New (0.00 - 0.07 float)\n- `mw` - Minimal Wear (0.07 - 0.15 float)\n- `ft` - Field-Tested (0.15 - 0.38 float)\n- `ww` - Well-Worn (0.38 - 0.45 float)\n- `bs` - Battle-Scarred (0.45 - 1.00 float)\n\nMultiple wears: `fn,mw` (comma-separated)", "required": false, "schema": { "type": "string", "enum": [ "fn", "mw", "ft", "ww", "bs" ] } }, { "name": "select", "in": "query", "description": "Select specific fields to return. Dramatically reduces response size.\n\n**Example:** `select=markethashname,pricelatest,image`\n\n**Popular field selections:**\n- Basic: `markethashname,pricelatest,image`\n- Trading: `markethashname,pricelatest,pricereal,winloss`\n- Full price: `markethashname,pricelatest,pricereal,buyorderprice,sold24h`\n\nField names must match exact response field names (lowercase).", "required": false, "schema": { "type": "string" } }, { "name": "currency", "in": "query", "description": "Convert prices to specified currency.\n\n**Supported currencies:**\n- `USD` (default), `EUR`, `GBP`, `TRY`, `RUB`, `CNY`, `JPY`, `BRL`, `PLN`, `CAD`, `AUD`\n\nConversion rates are updated hourly from Steam.", "required": false, "schema": { "type": "string" } }, { "name": "production", "in": "query", "description": "Set to `1` when using in production environment.\n\n**Benefits:**\n- Removes info/hint fields from response\n- Cleaner, smaller response payload\n- Will be required in future API versions\n\n**Note:** If not set, you may see deprecation warnings.", "required": false, "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "format", "in": "query", "description": "Output format for the response.\n\n**JSON formats:**\n- `json` (default): Standard JSON\n- `gzip`: Gzip-compressed JSON\n- `zip`: Zip-compressed JSON\n- `ndjson`: Newline-delimited JSON (streaming)\n\n**Export formats:**\n- `csv`: Comma-separated values\n- `xml`: XML format\n- `html`: HTML table\n\n**Database formats:**\n- `mysql`: MySQL INSERT statements\n- `mysql_with_table`: MySQL with CREATE TABLE\n- `pgsql`: PostgreSQL INSERT statements\n- `pgsql_with_table`: PostgreSQL with CREATE TABLE\n- `mongo`: MongoDB insert documents", "required": false, "schema": { "type": "string", "enum": [ "json", "gzip", "zip", "csv", "xml", "html", "ndjson", "mysql", "mysql_with_table", "pgsql", "pgsql_with_table", "mongo" ] } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON output (indented, human-readable).\n\n- `0` (default): Minified JSON (smaller size)\n- `1`: Formatted JSON (easier to read)\n\nOnly applies to json, gzip, and zip formats.", "required": false, "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "markets", "in": "query", "description": "Filter third-party market prices to specific markets only.\n\n**Available markets:**\n- `skinbaron` - Skinbaron.de\n- `skinport` - Skinport.com\n- `dmarket` - DMarket.com\n- `buff` - Buff163.com\n- `waxpeer` - Waxpeer.com\n- `bitskins` - BitSkins.com\n- `csgotm` - CS.Money / CSGOTradeMoney\n- `haloskins` - HaloSkins\n- `tradeit` - Tradeit.gg\n- `skinbid` - Skinbid.com\n\n**Example:** `markets=skinbaron,buff,skinport`\n\nWhen specified, `pricereal` will be the lowest price among selected markets only.", "required": false, "schema": { "type": "string" } }, { "name": "with_preview_items", "in": "query", "description": "Append newly discovered items that are not yet fully indexed.\n\n- `0` or `false` (default): Only return fully indexed items\n- `1` or `true`: Append preview items at the end\n\nPreview items have:\n- `preview: true` flag\n- Limited data (no prices, basic metadata only)\n- 24-hour cache\n\nUseful for discovering new items before they appear in main listings.", "required": false, "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Request was successful, and items are returned.", "content": { "application/json": { "schema": {}, "example": [ { "id": "4bb7c73c", "markethashname": "\u2605 StatTrak\u2122 Karambit | Doppler (Factory New)", "normalizedname": "stattrak karambit doppler factory new", "marketname": "\u2605 StatTrak\u2122 Karambit | Doppler (Factory New)", "slug": "stattraktm-karambit-doppler-factory-new", "count": 1, "classid": "728815617", "instanceid": "188530170", "groupid": "41fc88fa41639b21f83e5cd277f2ea17", "infoprice": "priceXXXX = Steam Prices read docs https://www.steamwebapi.com/api/doc", "pricelatest": 1081, "pricelatestsell": 1372.29, "pricelatestsell24h": 1594.68, "pricelatestsell7d": 1594.68, "pricelatestsell30d": 1594.68, "pricelatestsell90d": 1800, "lateststeamsellat": { "date": "2025-10-24 00:00:00.000000", "timezone_type": 3, "timezone": "UTC" }, "latest10steamsales": [ [ "2025-10-24", 1372.29, 5 ], [ "2025-10-23", 1594.68, 17 ], [ "2025-08-31", 1748.97, 1 ], [ "2025-08-11", 1725, 1 ], [ "2025-08-02", 1800, 1 ], [ "2025-04-28", 1800, 1 ], [ "2025-02-01", 1866.58, 1 ], [ "2025-01-11", 1800, 1 ], [ "2025-01-07", 1800, 1 ], [ "2024-12-27", 1800, 1 ] ], "pricemedian": 1372.29, "pricemedian24h": 1352.56, "pricemedian7d": 1352.56, "pricemedian30d": 1352.56, "pricemedian90d": 1725, "priceavg": 1372.29, "priceavg24h": 1318.18, "priceavg7d": 1318.18, "priceavg30d": 1318.18, "priceavg90d": 1588.88, "pricesafe": 1284.93, "pricemin": 1372.29, "pricemax": 1800, "pricemix": 1081, "buyorderprice": 900.06, "buyordermedian": 850, "buyorderavg": 859.996, "buyordervolume": 4261, "offervolume": 9, "soldtoday": 5, "sold24h": 17, "sold7d": 22, "sold30d": 22, "sold90d": 25, "soldtotal": 3957, "hourstosold": 2, "points": 22325, "priceupdatedat": { "date": "2025-10-24 12:37:31.000000", "timezone_type": 3, "timezone": "UTC" }, "nametag": null, "bordercolor": "99ccff", "color": "eb4b4b", "quality": "StatTrak\u2122", "rarity": "Covert", "image": "https://community.akamai.steamstatic.com/economy/image/-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpovbSsLQJf2PLacDBA5ciJlY20k_jkI7fUhFRB4MRij7j--YXygED6qUI9am_1IteTIwQ6M13S_gfoyefpgpXqtZSbyCdivnYq5ynfyUPhhgYMMLJI3Aal3g", "marketable": true, "tradable": true, "unstable": false, "unstablereason": null, "tags": [ { "category": "Type", "internal_name": "CSGO_Type_Knife", "localized_category_name": "Type", "localized_tag_name": "Knife" }, { "category": "Weapon", "internal_name": "weapon_knife_karambit", "localized_category_name": "Weapon", "localized_tag_name": "Karambit" }, { "category": "Quality", "internal_name": "unusual", "localized_category_name": "Category", "localized_tag_name": "\u2605", "color": "8650AC" }, { "category": "Quality", "internal_name": "unusual_strange", "localized_category_name": "Category", "localized_tag_name": "\u2605 StatTrak\u2122", "color": "8650AC" }, { "category": "Quality", "internal_name": "strange", "localized_category_name": "Category", "localized_tag_name": "StatTrak\u2122", "color": "CF6A32" }, { "category": "Rarity", "internal_name": "Rarity_Ancient_Weapon", "localized_category_name": "Quality", "localized_tag_name": "Covert", "color": "eb4b4b" }, { "category": "Exterior", "internal_name": "WearCategory0", "localized_category_name": "Exterior", "localized_tag_name": "Factory New" } ], "descriptions": [ { "type": "html", "value": "This item features StatTrak\u2122 technology, which tracks certain statistics when equipped by its owner.

This item tracks Confirmed Kills.

With its curved blade mimicking a tiger's claw, the karambit was developed as part of the southeast Asian martial discipline of silat. The knife is typically used with a reverse grip, with the finger ring on the index finger. It has been painted with black and silver metallic paints using a marbleizing medium, then candy coated.\\n\\nGetting lost in its color can prove fatal", "name": "description" } ], "createdat": { "date": "2024-11-06 01:45:38.000000", "timezone_type": 3, "timezone": "UTC" }, "firstseentime": 1421625600, "firstseenat": "2015-01-19T00:00:00+00:00", "steamurl": "https://steamcommunity.com/market/listings/730/%E2%98%85%20StatTrak%E2%84%A2%20Karambit%20%7C%20Doppler%20%28Factory%20New%29", "markettradablerestriction": 7, "tag1": "Knife", "tag2": "Karambit", "tag3": "Doppler", "tag4": "StatTrak\u2122", "tag5": "fn", "tag6": "Covert", "tag7": null, "infopricereal": "pricerealXXXX = Third Market Prices read docs https://www.steamwebapi.com/api/doc", "pricereal": null, "pricereal24h": 2524.22, "pricereal7d": 2519.41, "pricereal30d": 2599, "pricereal90d": 2432.19, "pricerealmedian": 2486.5, "winloss": -1369, "winlossprice": -55.89, "prices": [ { "market": "skinbaron", "price": 2524.22, "quantity": 3 }, { "market": "buff", "price": 2450, "quantity": 12 }, { "market": "skinport", "price": 2599, "quantity": 5 } ], "groupname": "Karambit | Doppler", "wear": "fn", "isstar": true, "isstattrak": true, "issouvenir": false, "itemgroup": "knife", "itemname": "doppler", "itemtype": "karambit", "minfloat": 0, "maxfloat": 0.08, "defindex": 507, "paintindex": 418, "variants": [ { "phase": "Black Pearl", "paintindex": 417, "image": "https://community.akamai.steamstatic.com/economy/image/..." }, { "phase": "Phase 1", "paintindex": 418, "image": "https://community.akamai.steamstatic.com/economy/image/..." }, { "phase": "Phase 2", "paintindex": 419, "image": "https://community.akamai.steamstatic.com/economy/image/..." }, { "phase": "Phase 3", "paintindex": 420, "image": "https://community.akamai.steamstatic.com/economy/image/..." }, { "phase": "Phase 4", "paintindex": 421, "image": "https://community.akamai.steamstatic.com/economy/image/..." }, { "phase": "Ruby", "paintindex": 415, "image": "https://community.akamai.steamstatic.com/economy/image/..." }, { "phase": "Sapphire", "paintindex": 416, "image": "https://community.akamai.steamstatic.com/economy/image/..." } ], "realmarketsquantity": 20 } ] } } }, "400": { "description": "Invalid request parameters", "content": { "application/json": { "schema": {}, "example": { "error": "Invalid parameter value" } } } }, "404": { "description": "Game not found. Supported games: cs2, rust, dota, tf2.", "content": { "application/json": { "schema": {}, "example": { "error": "Game not found" } } } }, "429": { "description": "Rate limit exceeded. Please wait before making more requests." }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": {}, "example": { "error": "An unexpected error occurred" } } } } } } }, "/steam/api/info/items": { "get": { "tags": [ "Info" ], "summary": "\ud83d\udccb Get Item Metadata - Groups, Types, and Names", "description": "Baseurl: https://www.steamwebapi.com/steam/api/info/items?key=YOUR_API_KEY&game=cs2\n\n\ud83d\udcac **What this endpoint does:**\n- Retrieves structured item metadata for a specific game.\n- Returns all available item groups, types, and names.\n- Provides hierarchical data for building item selectors and filters.\n\n\ud83d\udee0\ufe0f **Features:**\n- **Structured mode** (default): Hierarchical group \u2192 type \u2192 name structure.\n- **Groups mode**: List of all item categories (knife, rifle, pistol, etc.).\n- **Types mode**: List of all weapon types (ak-47, awp, karambit, etc.).\n- **Items mode**: List of all skin names (doppler, fade, asiimov, etc.).\n- 24-hour caching for optimal performance.\n\n\ud83c\udf10 **How to use:**\n- Get structured data: `GET /steam/api/info/items?key=YOUR_KEY`\n- Get all groups: `GET /steam/api/info/items?key=YOUR_KEY&type=groups`\n- Get all types: `GET /steam/api/info/items?key=YOUR_KEY&type=types`\n- Get all names: `GET /steam/api/info/items?key=YOUR_KEY&type=items`\n- Force refresh: `GET /steam/api/info/items?key=YOUR_KEY&no_cache=1`\n\n\ud83d\udcca **Use Cases:**\n- Build dynamic item filters for your application.\n- Create autocomplete search functionality.\n- Generate item category navigation menus.", "operationId": "get_api_items_info", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Required for all requests.", "required": true }, { "name": "game", "in": "query", "description": "Game identifier.\n\n**Supported games:**\n- `cs2` (default): Counter-Strike 2\n- `rust`: Rust\n- `dota`: Dota 2\n- `tf2`: Team Fortress 2", "required": false, "schema": { "type": "string", "default": "cs2", "enum": [ "cs2", "rust", "dota", "tf2" ] }, "example": "cs2" }, { "name": "type", "in": "query", "description": "Type of data to return.\n\n**Options:**\n- `structed` (default): Hierarchical structure (group \u2192 type \u2192 items)\n- `groups`: Flat list of item groups (knife, rifle, etc.)\n- `types`: Flat list of weapon types (ak-47, awp, etc.)\n- `items`: Flat list of skin names (doppler, fade, etc.)", "required": false, "schema": { "type": "string", "default": "structed", "enum": [ "structed", "groups", "types", "items" ] }, "example": "structed" }, { "name": "no_cache", "in": "query", "description": "Bypass 24-hour cache and fetch fresh data.\n\n- Omit or `0`: Use cached data (recommended)\n- `1`: Force fresh data fetch\n\n**Note:** Fresh fetch is slower, use only when necessary.", "required": false, "schema": { "type": "string", "enum": [ "0", "1" ] }, "example": "0" }, { "name": "format", "in": "query", "description": "Output format. See /steam/api/items for all format options.", "required": false, "schema": { "type": "string", "default": "json" } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON output.", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } } ], "responses": { "200": { "description": "Item metadata returned successfully. Structure depends on `type` parameter.", "content": { "application/json": { "schema": {}, "example": [ { "name": "Knife", "relation": [ "bayonet", "butterfly knife", "falchion knife", "flip knife", "gut knife", "huntsman knife", "karambit", "m9 bayonet" ] }, { "name": "Gloves", "relation": [ "bloodhound gloves", "driver gloves", "hand wraps", "hydra gloves", "moto gloves", "specialist gloves", "sport gloves" ] }, { "name": "Rifle", "relation": [ "ak-47", "aug", "famas", "galil ar", "m4a1-s", "m4a4", "sg 553" ] }, { "name": "Sniper Rifle", "relation": [ "awp", "g3sg1", "scar-20", "ssg 08" ] } ] } } }, "404": { "description": "Game not found.", "content": { "application/json": { "schema": {}, "example": { "error": "Game not found" } } } }, "429": { "description": "Rate limit exceeded. Please wait before making more requests." } } } }, "/steam/api/item": { "get": { "tags": [ "Items" ], "summary": "\ud83d\udce6 Retrieve Item Details with Pricing of all Markets and History", "description": "Baseurl: https://www.steamwebapi.com/steam/api/item?key=YOUR_API_KEY&market_hash_name=AK-47%20%7C%20Redline%20(Field-Tested)\n\n \ud83d\udcac **What this endpoint does:**\n - \ud83d\udd0d Retrieve details of a specific item using its `market_hash_name`, `slug`, or `hashId`.\n - \ud83d\udcca Provides enriched details like:\n - Pricing information.\n - Tags and metadata.\n - A brief price history.\n - Retrive all variants of the item as groups if `with_groups` is set to `true`. For example, `AK-47 | Redline (Field-Tested)` will return all variants of the AK-47 | Redline.\n\n \ud83d\ude80 **Why use this endpoint?**\n - Focuses on a single item with detailed data for advanced use cases.\n - Optimized for scenarios where precision matters, like market analytics or item tracking.\n\n \u26a0\ufe0f **Note:** This endpoint is similar to `/steam/api/items`, but it focuses on a single item with enriched details.", "operationId": "get_api_market_hash_name", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "market_hash_name", "in": "query", "description": "Required. The `market_hash_name` of the item. Example: `AK-47 | Redline (Field-Tested)`.", "required": true, "example": "AK-47 | Redline (Field-Tested)" }, { "name": "currency", "in": "query", "description": "Optional. The desired currency for price conversion (e.g., EUR, TRY, RUB, USD). Default is USD. See the Currency API for available codes.", "required": false, "example": "EUR" }, { "name": "with_groups", "in": "query", "description": "Optional. Set to `true` to retrieve all items variant of an item - stattrak, another wears, souvenirs (Its very good feature). Default is `false`.", "required": false, "example": false }, { "name": "production", "in": "query", "description": "If you run in production, please set this to 1. Default is 0. This is in future required, and if not set, you will get a warning.", "required": false }, { "name": "markets", "in": "query", "description": "Filter prices to specific markets only (comma-separated). The `pricereal` will be calculated as the lowest price among the specified markets. Example: `skinbaron,skinport,dmarket`. Available markets: skinbaron, skinport, dmarket, buff, waxpeer, bitskins, csgotm, haloskins, tradeit, skinbid. Default: all markets.", "required": false }, { "name": "format", "in": "query", "description": "Response format: json (default), csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo. Example: ?format=csv", "required": false, "schema": { "type": "string", "default": "json" } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON (set to 1 for json/gzip/zip formats). Example: ?format=json&pretty=1", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } } ], "responses": { "200": { "description": "Request was successful, and item details are returned.", "content": { "application/json": { "schema": {}, "example": { "id": "0bca2c79", "markethashname": "Revolution Case", "marketname": "Revolution Case", "slug": "revolution-case", "count": 1, "classid": "5189384637", "instanceid": "6541281615", "groupid": "000d377f063349223a0184c995732ac3", "infoprice": "These are Steam market prices and sold/offer data. priceupdatedat indicates the last update of Steam prices. Details can be found in the documentation. https://www.steamwebapi.com/api/doc", "pricelatest": 0.57, "pricelatestsell": 0.57, "pricelatestsell24h": 0.59, "pricelatestsell7d": 0.62, "pricelatestsell30d": 0.44, "pricelatestsell90d": 0.43, "lateststeamsellat": { "date": "2025-01-20 00:00:00.000000", "timezone_type": 3, "timezone": "UTC" }, "pricemedian": 0.57, "pricemedian24h": 0.63, "pricemedian7d": 0.65, "pricemedian30d": 0.49, "pricemedian90d": 0.43, "priceavg": 0.57, "priceavg24h": 0.62, "priceavg7d": 0.65, "priceavg30d": 0.47, "priceavg90d": 0.42, "pricesafe": 0.47, "pricemin": 0.4, "pricemax": 0.64, "pricemix": 0.43, "buyorderprice": 0.55, "buyordermedian": 0.53, "buyorderavg": 0.53, "buyordervolume": 4838329, "offervolume": 80884, "soldtoday": 53715, "sold24h": 78980, "sold7d": 655603, "sold30d": 2737049, "sold90d": 7501044, "soldtotal": 57718768, "hourstosold": 1, "points": 755162, "priceupdatedat": { "date": "2025-01-20 19:53:31.000000", "timezone_type": 3, "timezone": "UTC" }, "nametag": null, "bordercolor": "D2D2D2", "color": "b0c3d9", "quality": "Normal", "rarity": "Base Grade", "image": "https://community.cloudflare.steamstatic.com/economy/image/-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXU5A1PIYQNqhpOSV-fRPasw8rsUFJ5KBFZv668FFQynaHMJT9B74-ywtjYxfOmMe_Vx28AucQj3brAoYrz3Fay_kY4MG_wdYeLMlhpLMaM-1U" } } } }, "400": { "description": "Missing `market_hash_name` parameter." }, "404": { "description": "Item not found. Ensure the `market_hash_name` is correct." }, "429": { "description": "Rate limit exceeded." } } } }, "/steam/api/info/steamid": { "get": { "tags": [ "Info" ], "summary": "\ud83d\udd04 Convert a SteamID into Multiple Formats", "description": "Baseurl: https://www.steamwebapi.com/steam/api/info/steamid?key=YOUR_API_KEY&steam_id=STEAM_ID\n\n \ud83d\udcac **What this endpoint does:**\n - Converts a SteamID into different formats:\n - SteamID2.\n - SteamID3.\n - SteamID64.\n - Returns the result as JSON.\n\n \ud83d\udee0\ufe0f **Features:**\n - Supports all major SteamID formats for conversion.\n - Simple and efficient conversion for fast integration.\n\n \ud83c\udf10 **How to use:**\n - Provide a valid `steam_id` in any format (`SteamID2`, `SteamID3`, or `SteamID64`).\n - Use your API key to authenticate the request.", "operationId": "get_api_steamid_converter", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": false }, { "name": "steam_id", "in": "query", "description": "The SteamID to convert. Accepted formats:\n - `SteamID2`: e.g., `STEAM_0:0:553498XXX`.\n - `SteamID3`: e.g., `[U:1:1106997XXX]`.\n - `SteamID64`: e.g., `76561199067263XXX`.", "required": true } ], "responses": { "200": { "description": "Request was successful, and the converted SteamID formats are returned." }, "400": { "description": "Missing or invalid `steam_id` parameter." }, "404": { "description": "The provided `steam_id` is invalid." } } } }, "/steam/api/history": { "get": { "tags": [ "Items" ], "summary": "\ud83d\udcc8 Price History of an Item with Daily Prices from Steam or Real Market Data", "description": "Baseurl: https://www.steamwebapi.com/steam/api/history?key=YOUR_API_KEY&market_hash_name=ITEM_NAME\n\n \ud83d\udcac **What this endpoint does:**\n - Retrieves the price history of an item based on specified parameters.\n - \ud83d\uddd3\ufe0f Provides daily prices from Steam or real market prices if `markets` is passed as origin parameter.\n\n \ud83d\udee0\ufe0f **Parameters:**\n - **`key`**: Your API key located in the Dashboard (top-right corner).\n - **`market_hash_name`**: The `market_hash_name` of the item (required).\n - **`origin`**: Specify the data source. Default is `steamwebapi`. Use `markets` for real market price history or `direct` for direct Steam API access.\n - **`interval`**: Interval for data retrieval in days. Default: `10`.\n - **`start_date`**: Start date for data retrieval (format: YYYY-MM-DD).\n - **`end_date`**: End date for data retrieval (format: YYYY-MM-DD).\n\n \u26a1 **Important:**\n - Use the `interval` parameter for optimized data queries.\n - Specifying `markets` in `origin` results in slower responses but provides detailed real market data.\n - Using `direct` origin provides direct access to Steam API data.", "operationId": "get_api_item_history", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "market_hash_name", "in": "query", "description": "The `market_hash_name` of the item. Example: \"AK-47 | Redline (Field-Tested)\".", "required": true }, { "name": "origin", "in": "query", "description": "Specify the data source. Options: `steamwebapi` (default), `markets` for real market price history, or `direct` for direct Steam API access.", "required": false, "example": "steamwebapi" }, { "name": "interval", "in": "query", "description": "Specify the interval for data retrieval in days. Default is `10`.", "required": false, "example": 10 }, { "name": "start_date", "in": "query", "description": "Specify the start date for data retrieval. Format: `YYYY-MM-DD`.", "required": false, "example": "2024-01-01" }, { "name": "end_date", "in": "query", "description": "Specify the end date for data retrieval. Format: `YYYY-MM-DD`.", "required": false, "example": "2024-12-31" }, { "name": "production", "in": "query", "description": "If you run in production, please set this to 1. Default is 0. This is in future required, and if not set, you will get a warning.", "required": false }, { "name": "format", "in": "query", "description": "Response format: json (default), csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo. Example: ?format=csv", "required": false, "schema": { "type": "string", "default": "json" } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON (set to 1 for json/gzip/zip formats). Example: ?format=json&pretty=1", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } } ], "responses": { "200": { "description": "Request was successful, and price history is returned.", "content": { "application/json": { "schema": {}, "example": [ { "id": 4732517378, "createdat": "2022-11-15T00:00:00+00:00", "price": 1849.4, "sold": null }, { "id": 4732517421, "createdat": "2020-04-09T00:00:00+00:00", "price": 1564.65, "sold": null }, { "id": 4732517437, "createdat": "2020-02-29T00:00:00+00:00", "price": 1765.55, "sold": null }, { "id": 4732517514, "createdat": "2019-04-15T00:00:00+00:00", "price": 1750, "sold": null }, { "id": 4732517656, "createdat": "2018-05-30T00:00:00+00:00", "price": 1154.74, "sold": null } ] } } }, "400": { "description": "Invalid start or end date provided." } } } }, "/steam/api/cs/containers": { "get": { "tags": [ "Info" ], "summary": "\ud83c\udfaf Retrieve All CS2/CS:GO Containers and Collections", "description": "Baseurl: https://www.steamwebapi.com/steam/api/cs/containers\n\n \ud83d\udcac **What this endpoint does:**\n - Retrieves all containers and their collections from CS2/CS:GO.\n - Provides a comprehensive list of cases, stickers, and other containers.\n\n \ud83d\udee0\ufe0f **Features:**\n - Supports filtering by container type (`all`, `sticker`, `case`, `package).\n - Enables searching for specific cases using the `search` parameter.\n - Results can be sorted by name, price, or release date.\n\n \ud83c\udf10 **How to use:**\n - Use the `type` parameter to specify the group of containers to fetch.\n - Optionally, apply the `search` and `sortBy` parameters to refine your results.", "operationId": "get_api_steam_containers", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": false }, { "name": "type", "in": "query", "description": "Show only this group of containers. Accepted values: `all`, `sticker`, `case`.", "required": true }, { "name": "search", "in": "query", "description": "Search for a specific case or container by name.", "required": false }, { "name": "sortBy", "in": "query", "description": "Sort the result by a specific criterion. Options:\n - `nameAz`: Name ascending.\n - `nameZa`: Name descending.\n - `priceSteamAz`: Steam price ascending.\n - `priceSteamZa`: Steam price descending.\n - `priceRealAz`: Real market price ascending.\n - `priceRealZa`: Real market price descending.\n - `releasedatAz`: Release date ascending.\n - `releasedatZa`: Release date descending.", "required": false }, { "name": "format", "in": "query", "description": "Response format: json (default), csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo. Example: ?format=csv", "required": false, "schema": { "type": "string", "default": "json" } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON (set to 1 for json/gzip/zip formats). Example: ?format=json&pretty=1", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } } ], "responses": { "200": { "description": "Request was successful, and all containers are returned." }, "400": { "description": "Missing or invalid parameters." } } } }, "/steam/api/cs/collection/{slug}": { "get": { "tags": [ "Info" ], "summary": "\ud83c\udfaf Retrieve a CS2/CS:GO Collection or Case", "description": "Baseurl: https://www.steamwebapi.com/steam/api/cs/collection/{slug}\n\n \ud83d\udcac **What this endpoint does:**\n - Retrieves a list of all collections and their items (skins) from CS2/CS:GO.\n - Provides detailed information about a specific collection or case.\n\n \ud83d\udee0\ufe0f **Features:**\n - Fetches all items (skins) belonging to a specific collection or case.\n - Supports both CS2 and CS:GO collections.\n\n \ud83c\udf10 **How to use:**\n - Replace `{slug}` with the collection's unique identifier to fetch the desired data.", "operationId": "get_api_steam_collection_slug", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "format", "in": "query", "description": "Response format: json (default), csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo. Example: ?format=csv", "required": false, "schema": { "type": "string", "default": "json" } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON (set to 1 for json/gzip/zip formats). Example: ?format=json&pretty=1", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } }, { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Request was successful, and the collection data is returned." }, "404": { "description": "The specified collection or case was not found." } } } }, "/steam/api/cs/collections": { "get": { "tags": [ "Info" ], "summary": "\ud83c\udfaf Retrieve all cs2 collections with items", "description": "Base URL: https://www.steamwebapi.com/steam/api/cs/collections\n\n \ud83d\udcac **What this endpoint does:**\n - Retrieves a list of all CS2 and CS:GO collections.\n - Each collection includes detailed information about its items (skins) and containers (cases/capsules).\n\n \ud83d\udee0\ufe0f **Features:**\n - Fetches all collections along with the associated skins.\n - Removes duplicate items within a collection based on `groupid`.\n - Includes container information (e.g., cases, souvenir packages).\n - Supports both CS2 and CS:GO collections.\n\n \ud83c\udf10 **How to use:**\n - No body or path parameters needed.\n - Simply call the endpoint with your `key` as a query parameter.\n\n **Request URL Example:**\n `https://www.steamwebapi.com/steam/api/cs/collections?key=YOUR_API_KEY`", "operationId": "get_api_cs_collections", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "select", "in": "query", "description": "Select specific fields to return. Reduces response size and time. Example: \"name,logo\". Optional.", "required": false }, { "name": "limit", "in": "query", "description": "Limit the number of results returned. Default is 10000.", "required": false }, { "name": "offset", "in": "query", "description": "Offset for pagination. Default is 0.", "required": false }, { "name": "no_cache", "in": "query", "description": "Set to 1 to bypass cache and fetch fresh data. Default is 0.", "required": false }, { "name": "format", "in": "query", "description": "Response format: json (default), csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo. Example: ?format=csv", "required": false, "schema": { "type": "string", "default": "json" } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON (set to 1 for json/gzip/zip formats). Example: ?format=json&pretty=1", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } } ], "responses": { "200": { "description": "Request was successful, and all collections are returned." }, "400": { "description": "Missing or invalid parameters." } } } }, "/steam/api/info/markets": { "get": { "tags": [ "Info" ], "summary": "\ud83d\udcc8 Get Supported Market Information", "description": "Baseurl: https://www.steamwebapi.com/steam/api/info/markets\n\n \ud83d\udcac **What this endpoint does:**\n - Retrieves a list of all supported markets.\n - Provides information including:\n - \ud83d\uddbc\ufe0f Market logos.\n - \ud83d\udcdb Market names.\n - \ud83d\udcca Relevant market data.\n\n \ud83d\udee0\ufe0f **Features:**\n - Comprehensive data on supported markets for integration and analysis.\n - Up-to-date market details with structured responses.\n\n \ud83c\udf10 **How to use:**\n - Use your API key to authenticate the request and access the data.", "operationId": "get_get_api_trends", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true } ], "responses": { "200": { "description": "Request was successful, and market information is returned." }, "429": { "description": "Rate limit exceeded. Too many requests in a short time frame." } } } }, "/steam/api/float/assets": { "get": { "tags": [ "Float" ], "summary": "Retrieve CS assets with filters and pagination", "description": "Baseurl: https://www.steamwebapi.com/steam/api/float/assets?key=YOUR_API_KEY\n\n \ud83d\udcac **What this endpoint does:**\n - Returns over million CS assets (inventory- and market-related items) with flexible filter options.\n - Supports powerful pagination for large result sets.\n\n \ud83d\udee0\ufe0f **Features:**\n - Filter by owner (SteamID64), weapon (def_index), skin (paint_index), float range, StatTrak, Souvenir, rarity, quality, origin and paint_seed.\n - Filter by exact market hash name (market_hash_name).\n - Filter only assets that belong to Steam profiles or only to market listings.\n - Filter assets that have stickers and/or keychains.\n - Paginated responses via limit and offset.\n\n \ud83c\udf10 **How to use:**\n - All query parameters use snake_case naming.\n - Combine multiple filter parameters as needed (for example steam_id + def_index + min_float/max_float).\n - Use offset for pagination (for example offset=50 for page 2 with limit=50).\n - By default the endpoint returns a limited number of assets per request (configurable via the limit parameter).", "operationId": "get_api_assets", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "steam_id", "in": "query", "description": "Filter by SteamID64 of the owner, for example 76561198042843401.", "required": false, "schema": { "type": "string" } }, { "name": "market_hash_name", "in": "query", "description": "Filter by exact market hash name, for example \"AK-47 | Uncharted (Factory New)\".", "required": false, "schema": { "type": "string" } }, { "name": "def_index", "in": "query", "description": "Filter by weapon definition index, for example 7 for AK-47.", "required": false, "schema": { "type": "integer" } }, { "name": "paint_index", "in": "query", "description": "Filter by paint index / skin ID, for example 836 for \"AK-47 | Uncharted\".", "required": false, "schema": { "type": "integer" } }, { "name": "min_float", "in": "query", "description": "Minimum float value (wear) inclusive, for example 0.00 for Factory New range start.", "required": false, "schema": { "type": "number", "format": "float" } }, { "name": "max_float", "in": "query", "description": "Maximum float value (wear) inclusive, for example 0.07 for Factory New range end.", "required": false, "schema": { "type": "number", "format": "float" } }, { "name": "is_stattrak", "in": "query", "description": "Filter by StatTrak status (1 = StatTrak, 0 = non-StatTrak).", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "is_souvenir", "in": "query", "description": "Filter by Souvenir status (1 = Souvenir, 0 = non-Souvenir).", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "rarity", "in": "query", "description": "Filter by rarity tier. Typical values are in the range 1-6 (for example 6 = Covert).", "required": false, "schema": { "type": "integer" } }, { "name": "quality", "in": "query", "description": "Filter by item quality, for example 4 = normal, 9 = rarity-specific.", "required": false, "schema": { "type": "integer" } }, { "name": "origin", "in": "query", "description": "Filter by origin such as drop, market-purchase or case-reward.", "required": false, "schema": { "type": "string" } }, { "name": "paint_seed", "in": "query", "description": "Filter by exact paint seed / pattern number, for example 915.", "required": false, "schema": { "type": "integer" } }, { "name": "wear", "in": "query", "description": "Filter by wear category code: fn (Factory New), mw (Minimal Wear), ft (Field-Tested), ww (Well-Worn), bs (Battle-Scarred). Case-insensitive.", "required": false, "schema": { "type": "string", "enum": [ "fn", "mw", "ft", "ww", "bs" ] } }, { "name": "phase", "in": "query", "description": "Filter by Doppler / Gamma phase, for example \"p1\", \"p2\", \"p3\", \"p4\", \"ruby\", \"sapphire\", \"black-pearl\", \"emerald\".", "required": false, "schema": { "type": "string" } }, { "name": "source", "in": "query", "description": "Filter by ingestion source. Examples: \"inventory\" (collected via /inventory endpoint), \"csfloat\", \"youpin\" (third-party marketplace scrapers).", "required": false, "schema": { "type": "string" } }, { "name": "asset_id", "in": "query", "description": "Filter by exact Steam asset id (inventory id) \u2014 useful for direct lookups.", "required": false, "schema": { "type": "string" } }, { "name": "date", "in": "query", "description": "Filter by calendar date when the asset was created. Accepts ISO dates (YYYY-MM-DD) or local format such as 31.12.2025.", "required": false, "schema": { "type": "string", "example": "2025-12-31" } }, { "name": "sort", "in": "query", "description": "Sort order. Supported values: newest, oldest, lowest_float, highest_float. Default is newest.", "required": false, "schema": { "type": "string", "default": "newest", "enum": [ "newest", "oldest", "lowest_float", "highest_float" ] } }, { "name": "limit", "in": "query", "description": "Number of results to return. Default is 10, upper limit depends on your plan.", "required": false, "schema": { "type": "integer", "default": 10 } }, { "name": "offset", "in": "query", "description": "Offset for pagination, for example 50 for page 2 when limit=50.", "required": false, "schema": { "type": "integer", "default": 0 } }, { "name": "only_steam_id", "in": "query", "description": "If set to 1, only assets with a SteamID64 owner are returned.", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "only_market_id", "in": "query", "description": "If set to 1, only assets without a SteamID64 owner (market listings) are returned.", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "with_stickers", "in": "query", "description": "If set to 1, only assets that have at least one sticker are returned.", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "with_keychains", "in": "query", "description": "If set to 1, only assets that have at least one keychain are returned.", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "with_items", "in": "query", "description": "If set to 1, enrich each asset with the matching item record from the items database (joined by market_hash_name). The item payload is exposed under the \"item\" key.", "required": false, "schema": { "type": "integer", "default": 0, "enum": [ 0, 1 ] } }, { "name": "with_profiles", "in": "query", "description": "If set to 1, enrich each asset with the matching Steam profile (joined by SteamID64). The profile payload is exposed under the \"profile\" key.", "required": false, "schema": { "type": "integer", "default": 0, "enum": [ 0, 1 ] } }, { "name": "format", "in": "query", "description": "Response format: json (default), csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo.", "required": false, "schema": { "type": "string", "default": "json" } } ], "responses": { "200": { "description": "Request was successful and the assets are returned.", "content": { "application/json": { "schema": {}, "example": { "status": "success", "total": 5691, "limit": 50, "offset": 0, "count": 50, "sort": "newest", "credits_used": 5, "data": [ { "id": "a8cfd9e5", "uniqueid": "83df714e", "assetid": "47898024607", "marketid": null, "steamid": "76561199018139024", "d": "14018652729485059991", "markethashname": "AK-47 | Uncharted (Factory New)", "defindex": 7, "quality": 9, "rarity": 3, "origin": 8, "isstattrak": 0, "issouvenir": 0, "wear": "fn", "float": 0.03422911092639, "paintindex": 836, "paintseed": 915, "phase": null, "stickers": [ { "defindex": 7268, "markethashname": "Sticker | FaZe Clan (Holo) | Copenhagen 2024" } ], "keychains": [ { "pattern": 57977, "defindex": 60, "markethashname": "Charm | Lil' Chirp" } ], "prevassetid": null, "prevmarketid": null, "prevsteamid": null, "prevd": null, "prevstickers": [], "prevkeychains": [], "source": "skinport", "link": "https://skinport.com/market?search=AK-47%20%7C%20Uncharted%20%28Factory%20New%29", "metadata": { "min_price": 12.34, "currency": "USD" }, "createdat": "2025-11-18 21:12:51", "updatedat": "2025-11-18 21:12:51", "createddate": "2025-11-18" } ] } } } }, "402": { "description": "Rate limit exceeded (daily or monthly)." } } } }, "/steam/api/complete/items": { "get": { "tags": [ "Info" ], "summary": "\ud83d\udd0d Auto-Complete Game Items - e.g for using on Input fields (for free)", "description": "Baseurl: https://www.steamwebapi.com/steam/api/complete/items?search=SEARCH_TERM&game=cs2\n\n \ud83d\udcac **What this endpoint does:**\n - Provides real-time auto-completion for game items with search suggestions based on the input.\n - Retrieves a list of items matching the search term, making it ideal for input auto-completes.\n - Returns the **name and image URL** of each item to enhance the user experience.\n\n \ud83d\udee0\ufe0f **Features:**\n - \ud83d\udd0d Instantly retrieve search suggestions for game items with a minimum of 3 characters in the search term.\n - \ud83c\udfae Supports filtering by game for more relevant results.\n - \ud83d\uddbc\ufe0f Includes item **image URL** for a visual preview.\n - \ud83d\udd11 No API key required for now, but in production, it is recommended to include your key for future compatibility.\n - \ud83d\udcb0 This endpoint is currently free, but in the future, it will cost **1 request credit per 100 queries**, making it extremely affordable.\n\n \u26a0\ufe0f **Note:** Future updates might require authentication, so ensure you are prepared for upcoming changes (just add your key).", "operationId": "get_api_complete_item", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication (optional but recommended for production use).", "required": false }, { "name": "search", "in": "query", "description": "The search term for auto-completion. Must be at least 3 characters long.", "required": true }, { "name": "game", "in": "query", "description": "Optional. Short name of the game (e.g., \"cs2\", \"dota2\", \"rust\"). Default is \"cs2\".", "required": false } ], "responses": { "200": { "description": "Successfully retrieved auto-complete suggestions.", "content": { "application/json": { "schema": { "type": "array", "items": { "properties": { "markethashname": { "type": "string", "example": "AK-47 | Redline (Field-Tested)" }, "image": { "type": "string", "format": "url", "example": "IzMF03bi9WpSBq-S-ekoE33L-iLqGFHVaU25ZzQNQcXdB2ozio1RrlIWFK3UfvMYB8UsvjiMXojflsZalyxSh31CIyHz2GZ-KuFpPsrTzBG0pO-CI3z2eCfdYXbfSA5rTuZXPGrQ-TSs5-vGETicRL4tEA9VL_ZV9WUfPJvbOxZr0IUVu2u_0UdyEhk6f9BKZAarxm1OZuV8zHRBk0RxHo8" } }, "type": "object" } }, "example": [ { "markethashname": "AK-47 | Redline (Field-Tested)", "image": "IzMF03bi9WpSBq-S-ekoE33L-iLqGFHVaU25ZzQNQcXdB2ozio1RrlIWFK3UfvMYB8UsvjiMXojflsZalyxSh31CIyHz2GZ-KuFpPsrTzBG0pO-CI3z2eCfdYXbfSA5rTuZXPGrQ-TSs5-vGETicRL4tEA9VL_ZV9WUfPJvbOxZr0IUVu2u_0UdyEhk6f9BKZAarxm1OZuV8zHRBk0RxHo8" }, { "markethashname": "M4A1-S | Hyper Beast (Factory New)", "image": ".." }, { "markethashname": "AWP | Asiimov (Minimal Wear)", "image": ".." }, { "markethashname": "Glock-18 | Fade", "image": ".." }, { "markethashname": "StatTrak\u2122 M4A4 | Howl (Minimal Wear)", "image": "IzMF03bi9WpSBq-S-ekoE33L-iLqGFHVaU25ZzQNQcXdB2ozio1RrlIWFK3UfvMYB8UsvjiMXojflsZalyxSh31CIyHz2GZ-KuFpPsrTzBG0pO-CI3z2eCfdYXbfSA5rTuZXPGrQ-TSs5-vGETicRL4tEA9VL_ZV9WUfPJvbOxZr0IUVu2u_0UdyEhk6f9BKZAarxm1OZuV8zHRBk0RxHo8" } ] } } } } } }, "/currency/api/list": { "get": { "tags": [ "Info" ], "summary": "\ud83d\udcb1 List All Available Currencies for Conversion", "description": "Baseurl: https://www.steamwebapi.com/currency/api/list?key=YOUR_API_KEY&base=USD\n\n \ud83d\udcac **What this endpoint does:**\n - Retrieves a list of all available currencies for conversion.\n - The default base currency is USD (United States Dollar).\n - The data source is Steam by default but can be customized.\n\n \ud83d\udee0\ufe0f **Features:**\n - Supports specifying a custom base currency using the `base` parameter.\n - Allows changing the data source via the `source` parameter.\n\n \ud83c\udf10 **How to use:**\n - Use the `base` parameter to specify the currency code for conversion (e.g., `EUR`, `TRY`).\n - Optionally, set the `source` parameter to customize the data source.", "operationId": "get_currency_api_list", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "base", "in": "query", "description": "The base currency code for conversion. If not specified, `USD` is used as the default.", "required": false, "example": "EUR" }, { "name": "source", "in": "query", "description": "Specifies the source of the currency data. Default is `Steam`.", "required": false, "example": "Steam" }, { "name": "production", "in": "query", "description": "If you run in production, please set this to 1. Default is 0. This is in future required, and if not set, you will get a warning.", "required": false }, { "name": "format", "in": "query", "description": "Response format: json (default), csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo. Example: ?format=csv", "required": false, "schema": { "type": "string", "default": "json" } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON (set to 1 for json/gzip/zip formats). Example: ?format=json&pretty=1", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } } ], "responses": { "200": { "description": "Request was successful, and the list of currencies is returned." }, "400": { "description": "Invalid or missing parameters." }, "429": { "description": "Rate limit exceeded." } } } }, "/currency/api/exchange": { "get": { "tags": [ "Info" ], "summary": "\ud83d\udcb1 Retrieve Currency Exchange Rates", "description": "Baseurl: https://www.steamwebapi.com/currency/api/exchange?key=YOUR_API_KEY&change=EUR&base=USD\n\n \ud83d\udcac **What this endpoint does:**\n - Provides the exchange rate for a specified currency.\n - Allows you to specify:\n - The currency to convert to using the `change` parameter.\n - The base currency using the `base` parameter (default: USD).\n\n \ud83d\udee0\ufe0f **Features:**\n - Fetches accurate exchange rates.\n - Supports all major currency codes based on the [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) standard.\n\n \ud83c\udf10 **How to use:**\n - Use the `change` parameter to specify the target currency (e.g., `EUR`, `TRY`, `RUB`).\n - Optionally, use the `base` parameter to specify the base currency. If omitted, the default is `USD`.\n\n \ud83d\udccb **Example:**\n - `change=EUR&base=USD`: Convert USD to EUR.", "operationId": "get_currency_api_exchange", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "change", "in": "query", "description": "The target currency code to exchange to. Supported values follow the [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) standard (e.g., `EUR`, `TRY`, `RUB`).", "required": true }, { "name": "base", "in": "query", "description": "The base currency for the exchange. Default is `USD`. Supported values follow the [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) standard.", "required": false }, { "name": "format", "in": "query", "description": "Response format: json (default), csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo. Example: ?format=csv", "required": false, "schema": { "type": "string", "default": "json" } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON (set to 1 for json/gzip/zip formats). Example: ?format=json&pretty=1", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } } ], "responses": { "200": { "description": "Request was successful, and the exchange rate is returned." }, "400": { "description": "Invalid or missing parameters." }, "429": { "description": "Rate limit exceeded." } } } }, "/explore/api/profile": { "get": { "tags": [ "Explore" ], "summary": "\ud83d\udd0d Search & Explore Steam Profiles", "description": "Baseurl: https://www.steamwebapi.com/explore/api/profile?key=YOUR_API_KEY&search=example\n\n \ud83d\udcac **What this endpoint does:**\n - Searches for Steam profiles using various criteria such as name, country, inventory worth or VAC status.\n - By default, retrieves 20 results per page sorted by inventory worth descending.\n - This is the unified Explore endpoint \u2014 replaces the old `/random`, `/last`, and `/toplist` routes.\n\n \ud83d\udee0\ufe0f **Features:**\n - Full-text search across persona name, account name, and display name.\n - Filter by country code, minimum worth, VAC status, fame status, or profile type.\n - Pagination with `limit` (max 100) and `page` (1\u201310) parameters.\n - Flexible sorting with `order_by`: personaname, timecreated, fame, worth, size, updatedat, inventoryupdatedat, totalplaytime, random (each with ASC/DESC suffix where applicable).\n\n \ud83d\udca1 **Common use cases:**\n - **Random profiles:** `order_by=random`\n - **Latest inventory update:** `order_by=inventoryupdatedatDESC`\n - **Latest updated:** `order_by=updatedatDESC`\n - **Top by worth:** `order_by=worthDESC` (default)\n - **Search by name:** `search=Shroud`\n\n \ud83c\udf10 **How to use:**\n - Use the `search` parameter for name lookups (partial match supported).\n - Combine `country`, `worth`, `vac`, `fame`, and `type` filters as needed.\n - Adjust `limit` (max 100) and `page` (1\u201310) for paginated results.\n - Use `order_by` to control sorting (default: worth DESC).\n\n \ud83d\udce6 **Response fields:**\n steamid, accountname, personaname, displayname, profiletype, realname, loccountrycode, description, fame, vac, islimited, level, worth, worthsteam, size, peritem, totalplaytime, playtimerecent, timecreated, updatedat, inventoryupdatedat, avatar, avatarmedium, avatarfull", "operationId": "get_explore_search", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true, "schema": { "type": "string" } }, { "name": "search", "in": "query", "description": "Search string matching persona name, account name, or display name (partial match, case-insensitive).", "required": false, "schema": { "type": "string" }, "example": "Shroud" }, { "name": "country", "in": "query", "description": "ISO 3166-1 alpha-2 country code (e.g., DE, US, GB).", "required": false, "schema": { "type": "string" }, "example": "DE" }, { "name": "worth", "in": "query", "description": "Minimum inventory worth filter as numeric value (e.g., 1000 for $1000).", "required": false, "schema": { "type": "number", "format": "float" }, "example": 1000 }, { "name": "type", "in": "query", "description": "Filter by profile type.", "required": false, "schema": { "type": "string", "enum": [ "pro", "streamer", "vip", "personality", "content_creator", "caster" ] } }, { "name": "limit", "in": "query", "description": "Number of profiles per page. Default: 20. Maximum: 100.", "required": false, "schema": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1 }, "example": 20 }, { "name": "page", "in": "query", "description": "Page number for pagination (1\u201310). Default: 1.", "required": false, "schema": { "type": "integer", "default": 1, "maximum": 10, "minimum": 1 }, "example": 1 }, { "name": "vac", "in": "query", "description": "Filter by VAC ban status. Set to 1 for VAC banned profiles only.", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "fame", "in": "query", "description": "Filter by fame status. 1 = famous profiles, 0 = non-famous profiles.", "required": false, "schema": { "type": "integer", "enum": [ 0, 1 ] } }, { "name": "order_by", "in": "query", "description": "Sort field and direction. Options: personaname, personanameASC, personanameDESC, timecreated, timecreatedASC, timecreatedDESC, fame, fameASC, fameDESC, worth (default), worthASC, worthDESC, size, sizeASC, sizeDESC, updatedat, updatedatASC, updatedatDESC, inventoryupdatedat, inventoryupdatedatASC, inventoryupdatedatDESC, totalplaytime, totalplaytimeASC, totalplaytimeDESC, random.", "required": false, "schema": { "type": "string", "default": "worth" } }, { "name": "production", "in": "query", "description": "Set to 1 if you run in production. Default: 0.", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } }, { "name": "format", "in": "query", "description": "Response format: json (default), csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo. Example: ?format=csv", "required": false, "schema": { "type": "string", "default": "json" } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON output (set to 1). Only applies to json, gzip and zip formats.", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } } ], "responses": { "200": { "description": "Array of matching profile objects.", "content": { "application/json": { "schema": { "type": "array", "items": { "properties": { "steamid": { "type": "string", "example": "76561198012345678" }, "accountname": { "type": "string", "example": "example_user" }, "personaname": { "type": "string", "example": "ExamplePlayer" }, "displayname": { "type": "string", "example": "ExampleDisplay", "nullable": true }, "profiletype": { "type": "string", "example": "pro", "nullable": true }, "realname": { "type": "string", "example": "John Doe", "nullable": true }, "loccountrycode": { "type": "string", "example": "US", "nullable": true }, "description": { "type": "string", "example": "Profile description", "nullable": true }, "fame": { "type": "integer", "example": 0 }, "vac": { "type": "integer", "example": 0 }, "islimited": { "type": "boolean", "example": false }, "level": { "type": "integer", "example": 50, "nullable": true }, "worth": { "type": "number", "format": "float", "example": 1234.56 }, "worthsteam": { "type": "number", "format": "float", "example": 2345.67 }, "size": { "type": "integer", "example": 100 }, "peritem": { "type": "number", "format": "float", "example": 12.35, "nullable": true }, "totalplaytime": { "description": "Total playtime in minutes across all games", "type": "number", "format": "float", "example": 15234.5, "nullable": true }, "playtimerecent": { "description": "Playtime in the last 2 weeks in minutes", "type": "number", "format": "float", "example": 1230, "nullable": true }, "timecreated": { "type": "string", "format": "date-time", "example": "2012-01-15T00:00:00+00:00", "nullable": true }, "updatedat": { "type": "string", "format": "date-time", "example": "2024-01-15T12:00:00+00:00", "nullable": true }, "inventoryupdatedat": { "type": "string", "format": "date-time", "example": "2024-06-20T18:30:00+00:00", "nullable": true }, "avatar": { "type": "string", "example": "https://avatars.steamstatic.com/hash.jpg", "nullable": true }, "avatarmedium": { "type": "string", "example": "https://avatars.steamstatic.com/hash_medium.jpg", "nullable": true }, "avatarfull": { "type": "string", "example": "https://avatars.steamstatic.com/hash_full.jpg", "nullable": true } }, "type": "object" } } } } }, "400": { "description": "Invalid or missing parameters." }, "429": { "description": "Rate limit exceeded." } } } }, "/steam/api/float": { "get": { "tags": [ "Float" ], "summary": "\ud83d\udd0d Retrieve Float Information for an Item", "description": "Baseurl: https://www.steamwebapi.com/steam/api/float?key=YOUR_API_KEY&url=INSPECT_LINK\n\n \ud83d\udcac **What this endpoint does:**\n - Retrieves float information for a specific CS:GO / CS2 item by decoding the inspect certificate in-process.\n - Requires either the `url` parameter (full inspect link) or the `certificate` parameter (raw hex certificate).\n\n \u26a0\ufe0f **Important \u2014 legacy format no longer supported:**\n Valve discontinued the old inspect link formats `S{steamid}A{assetid}D{value}` (personal inventory) and `M{marketid}A{assetid}D{value}` (market listing) when they shut down the public Game Coordinator endpoint. Those links carried no float data on their own \u2014 they were only reference IDs, and float retrieval relied on a Steam GC roundtrip that no longer exists. **Any URL matching the old S/M pattern will return HTTP 406.** Only the new certificate format works.\n\n \ud83c\udd95 **Certificate format:**\n The new format embeds the full item state (float, paintseed, paintindex, stickers, keychains, StatTrak kill count, name tag, \u2026) as a hex-encoded protobuf payload right inside the inspect link. No external lookup, no bot, no GC roundtrip \u2014 the certificate IS the data.\n - Full URL form: `steam://run/730//+csgo_econ_action_preview `\n - Raw form (pass via `certificate=`): `` (e.g. `49598AF087A6F948...`)\n\n \ud83c\udf10 **How to use:**\n - Pass the inspect link via `url=` or the raw hex via `certificate=` \u2014 exactly one of the two is required.\n - Inspect links can be obtained from our Inventory API (`/steam/api/inventory`) \u2014 the `inspectlink` field there is always in the supported certificate format.\n - Authenticate with your API key.", "operationId": "get_float_item_v1", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "url", "in": "query", "description": "Inspect link in the **certificate format only**. Example: `steam://run/730//+csgo_econ_action_preview%203C2CD7CEF39C8E...`. The legacy `S{steamid}A{assetid}D{value}` and `M{marketid}A{assetid}D{value}` formats were discontinued by Valve and **will return HTTP 406** \u2014 they no longer carry retrievable float data. Either `url` or `certificate` is required.", "required": false }, { "name": "certificate", "in": "query", "description": "Raw hex certificate without the `steam://run/730//+csgo_econ_action_preview+` prefix. Example: `49598AF087A6F948...`. This is the encoded protobuf payload that carries the entire item state (float, paintseed, stickers, \u2026). Either `url` or `certificate` is required.", "required": false }, { "name": "production", "in": "query", "description": "If you run in production, please set this to 1. Default is 0. This is in future required, and if not set, you will get a warning.", "required": false }, { "name": "format", "in": "query", "description": "Response format: json (default), csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo. Example: ?format=csv", "required": false, "schema": { "type": "string", "default": "json" } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON (set to 1 for json/gzip/zip formats). Example: ?format=json&pretty=1", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } } ], "responses": { "200": { "description": "Request was successful, and the float data for the item is returned.", "content": { "application/json": { "schema": {}, "example": { "id": "02e455ae318cc452b63496636a85b533", "inspectlink": "steam://run/730//+csgo_econ_action_preview+5141A7B9CAEAEF50495071815B795261556991F4D7A15211E255395221495879F14D", "image": "https://community.cloudflare.steamstatic.com/economy/image/-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpou-6kejhz2v_Nfz5H_uO1gb-Gw_alIITXk25V4ct2te_T8ILvkWu4ohQ0J3f6LNSdcg5rNF_Yr1bswLy505G8752dy3dguigltCmJlxPmiUtOOLRmm7XAHjOl7uFi", "assetid": "43286403495", "markethashname": "StatTrak\u2122 M4A1-S | Emphorosaur-S (Minimal Wear)", "float": 0.10295983403921127, "phase": null, "type": "weapon", "paintseed": 998, "paintindex": 1223, "defindex": 60, "rarity": 4, "quality": 4, "origin": 8, "inventory": 3, "wear": "mw", "min": 0, "max": 0.8, "hassticker": true, "haskeychain": false, "stickeramount": 1, "keychainamount": 0, "stickers": [ { "name": "Sticker | Mastermind (Holo)", "stickerid": 4510, "slot": 0, "wear": 0, "scale": 1, "rotation": null, "pattern": null, "offsetx": null, "offsety": null, "offsetz": null, "tintid": null, "highlightreel": null, "wrappedsticker": null } ], "keychains": [], "stattrak": true, "stattrakcount": 1337, "souvenir": false, "nametag": "Made in Heaven", "musicindex": null, "grade": "restricted" } } } }, "402": { "description": "Rate limit exceeded (daily or monthly)." }, "406": { "description": "Inspect link is missing or uses a deprecated format. The legacy S/M-link formats (S{steamid}A{assetid}D{value}, M{marketid}A{assetid}D{value}) were discontinued by Valve and are no longer supported \u2014 only the certificate (hex) format is accepted." }, "416": { "description": "Service overloaded or unable to retrieve float information. Please try again later." }, "417": { "description": "Certificate could not be decoded \u2014 the inspect link or hex is likely malformed or corrupt." }, "503": { "description": "Certificate decoded but produced no usable item data (empty protobuf payload). The link is likely invalid or pointing to an item that no longer exists." } } } }, "/steam/api/float/screenshot": { "get": { "tags": [ "Float" ], "summary": "\ud83d\uddbc\ufe0f Generate Screenshot with Float Information", "description": "Generate a screenshot image with detailed float information for a specific CS:GO / CS2 item. The float data is decoded from the inspect certificate and rendered onto a customizable background; the response streams the resulting PNG directly to the client.\n\n \u26a0\ufe0f **Same format rules as `/steam/api/float`:** only the certificate (hex) inspect link format is supported. The legacy S/M-link formats were discontinued by Valve and will return HTTP 406.", "operationId": "get_float_screenshot", "parameters": [ { "name": "key", "in": "query", "description": "API key for authentication. Retrieve it from your Dashboard.", "required": true }, { "name": "url", "in": "query", "description": "Inspect link in the **certificate format only**. Example: `steam://run/730//+csgo_econ_action_preview%203C2CD7CEF39C8E...`. The legacy S/M-link formats (discontinued by Valve) will return HTTP 406.", "required": true }, { "name": "as_base64", "in": "query", "description": "Set to 1 to return the image as a base64 string. Default is 0, base64 is sometimes helpful for easier integration.", "required": false }, { "name": "color", "in": "query", "description": "Color scheme for the screenshot. Options: black, blue, green, orange, purple, red, white, yellow, gray. Default: green.", "required": false }, { "name": "background_url", "in": "query", "description": "Custom background image URL (PNG format). Overrides default background.", "required": false }, { "name": "logo_url", "in": "query", "description": "Custom logo image URL (PNG format). Overrides default logo.", "required": false }, { "name": "logo_offset_start", "in": "query", "description": "Logo start position. Options: top left, top right, bottom left, bottom right. Default: top left.", "required": false }, { "name": "logo_offset_x", "in": "query", "description": "Horizontal offset for the logo. Default: 80.", "required": false }, { "name": "logo_offset_y", "in": "query", "description": "Vertical offset for the logo. Default: 80.", "required": false }, { "name": "logo_opacity", "in": "query", "description": "Opacity of the logo (0 to 1). Default: 1.0.", "required": false }, { "name": "logo_width", "in": "query", "description": "Width of the logo in pixels (Max: 500). Default: 400.", "required": false }, { "name": "format", "in": "query", "description": "Send a format - screen (default) for show, download for download the image, base64 for base64 image.", "required": false } ], "responses": { "200": { "description": "The image has been successfully generated and streamed to the client.", "content": { "image/png": {} } }, "402": { "description": "Rate limit exceeded. Too many requests have been made within the allowed period." }, "404": { "description": "The requested item could not be found. Verify the inspect link or database." }, "406": { "description": "Invalid parameters or inspect link provided. Ensure the inspect link is correct." }, "416": { "description": "Service is overloaded or unable to retrieve float information. Try again later." }, "417": { "description": "Unable to retrieve float information for the item. Verify the inspect link." }, "424": { "description": "The image stream failed due to an internal issue. Contact support if the problem persists." } } } }, "/steam/api/float/create-inspectlink": { "post": { "tags": [ "Float" ], "summary": "\ud83d\udd17 Generate a CS2 inspect-link from raw item data", "description": "Baseurl: https://www.steamwebapi.com/steam/api/float/create-inspectlink?key=YOUR_API_KEY\n\n\ud83d\udcac **What this endpoint does:**\n- Generates a fully self-contained CS2 inspect-link from raw item data \u2014 the inverse of the `GET /steam/api/float` decoder.\n- Output is compatible with our own decoder, csfloat's inspect tool, and every CS2 client that opens the link in-game.\n- No Steam game-coordinator round trip \u2014 the certificate hex carries the entire item state.\n\n\ud83d\udee0\ufe0f **Use cases:**\n- Mock inspect-links for UI development and screenshots.\n- Reconstructing an inspect-link when only the raw item data is known (backfill, migration).\n- Generating links for items that never existed in any real inventory.\n\n\ud83c\udf10 **How to use:**\n- POST a JSON body with at least `defindex`. All other fields default to 0/empty.\n- `quality` is auto-derived from `stattrak` / `souvenir` flags if you do not set it explicitly (4 / 9 / 12).\n- `stickers` (max 5), `keychains` (max 1) and `variations` (max 5) accept arrays of objects with `sticker_id` (required) plus any of `slot`, `wear`, `scale`, `rotation`, `pattern`, `tint_id`, `offset_x`, `offset_y`, `offset_z`.\n- Response includes the generated `inspectlink`, the raw `certificate` hex, and a `decoded` round-trip \u2014 so you can verify what the link will produce when re-decoded.", "operationId": "post_float_create_inspectlink", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "defindex" ], "properties": { "defindex": { "type": "integer", "example": 9 }, "paintindex": { "type": "integer", "example": 1422 }, "paintseed": { "type": "integer", "example": 767 }, "float": { "type": "number", "format": "float", "example": 0.001591503 }, "rarity": { "type": "integer", "example": 6 }, "quality": { "type": "integer", "example": 4, "nullable": true }, "stattrak": { "type": "boolean", "example": false }, "killeatercount": { "type": "integer", "example": 0 }, "souvenir": { "type": "boolean", "example": false }, "customname": { "type": "string", "example": null, "nullable": true }, "itemid": { "type": "string", "example": "51252704042", "nullable": true }, "accountid": { "type": "integer", "nullable": true }, "origin": { "type": "integer", "nullable": true }, "musicindex": { "type": "integer", "nullable": true }, "inventory": { "type": "integer", "nullable": true }, "style": { "type": "integer", "nullable": true }, "stickers": { "type": "array", "items": { "properties": { "sticker_id": { "type": "integer", "example": 9540 }, "slot": { "type": "integer", "example": 3 }, "wear": { "type": "number", "format": "float", "example": 0.56 }, "rotation": { "type": "number", "format": "float", "example": 150 }, "offset_x": { "type": "number", "format": "float" }, "offset_y": { "type": "number", "format": "float" } }, "type": "object" } }, "keychains": { "type": "array", "items": { "properties": { "sticker_id": { "type": "integer", "example": 52 }, "slot": { "type": "integer", "example": 0 }, "pattern": { "type": "integer", "example": 69835 } }, "type": "object" } } }, "type": "object" } } } }, "responses": { "200": { "description": "Inspect-link generated successfully.", "content": { "application/json": { "schema": {}, "example": { "inspectlink": "steam://rungame/730/76561202255233023/+csgo_econ_action_preview 00100918091422280630043807...", "certificate": "00100918091422280630043807...", "decoded": { "defindex": 9, "paintindex": 1422, "paintseed": 767, "floatvalue": 0.001591503038071096, "rarity": 6, "quality": 4 } } } } }, "421": { "description": "JSON payload contains unknown fields." }, "422": { "description": "Validation error (missing required field, value out of range, malformed sticker entry, etc.)." } } } }, "/steam/api/friendlist": { "get": { "tags": [ "Profile" ], "summary": "\ud83d\udc65 Retrieve a Steam User's Friendlist", "description": "Baseurl: https://www.steamwebapi.com/steam/api/friendlist?id=76561198012345678&key=YOUR_API_KEY\n\n \ud83d\udcac **What this endpoint does:**\n - Fetches a Steam user's friends list.\n - By default, the data is parsed (`parsed=1`) for better readability.\n - For raw data directly from Steam, set `parsed=0`.\n\n \ud83d\udee0\ufe0f **Features:**\n - Retrieve detailed information about a user's friends, such as online status, game activity, and profile details.\n - Optimized for better response times by utilizing caching.\n\n \ud83c\udf10 **How to use:**\n - Provide the user's Steam ID (64-bit) or Vanity URL using the `id` parameter.\n - Use the `no_cache` parameter to bypass caching if real-time data is required.", "operationId": "get_api_get_friend_list", "parameters": [ { "name": "key", "in": "query", "description": "Your API key, available in the Dashboard (top-right corner).", "required": true }, { "name": "id", "in": "query", "description": "Steam ID (64-bit) or Steam Vanity URL. Required for identifying the user.", "required": true, "example": "76561198012345678" }, { "name": "no_cache", "in": "query", "description": "Set to `1` to bypass caching. Default: Cached for 1 day for better performance.\n If you don\u2019t need real-time state data of the user, set `no_cache=0` for faster response times.", "required": false, "example": 1 }, { "name": "production", "in": "query", "description": "If you run in production, please set this to 1. Default is 0. This is in future required, and if not set, you will get a warning.", "required": false }, { "name": "format", "in": "query", "description": "Response format: json (default), csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo. Example: ?format=csv", "required": false, "schema": { "type": "string", "default": "json" } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON (set to 1 for json/gzip/zip formats). Example: ?format=json&pretty=1", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } } ], "responses": { "200": { "description": "Request was successful, and the friend list data is returned.", "content": { "application/json": { "schema": {}, "example": [ { "steamid": "76561198415469240", "personaname": "Beys", "accountname": "marcosbeys", "avatar": "https://avatars.fastly.steamstatic.com/c67d8470a38c843f36ed561ae3c39e1c2c132e02.jpg", "avatarfull": "https://avatars.fastly.steamstatic.com/c67d8470a38c843f36ed561ae3c39e1c2c132e02_full.jpg", "avatarmedium": "https://avatars.fastly.steamstatic.com/c67d8470a38c843f36ed561ae3c39e1c2c132e02_medium.jpg", "url": "https://steamcommunity.com/id/marcosbeys", "online": true, "in_game": true, "game": "Rise of the Tomb Raider" }, { "steamid": "76561198064061186", "personaname": "Lucio.Costa DF", "accountname": "76561198064061186", "avatar": "https://avatars.fastly.steamstatic.com/8502c62b6f7e656d7056ebfe9e1dc6fdac9f9f97.jpg", "avatarfull": "https://avatars.fastly.steamstatic.com/8502c62b6f7e656d7056ebfe9e1dc6fdac9f9f97_full.jpg", "avatarmedium": "https://avatars.fastly.steamstatic.com/8502c62b6f7e656d7056ebfe9e1dc6fdac9f9f97_medium.jpg", "url": "https://steamcommunity.com/profiles/76561198064061186", "online": true, "in_game": true, "game": "Dota 2" } ] } } }, "400": { "description": "Invalid Steam ID or Steam Vanity URL provided." }, "404": { "description": "Steam ID or Steam Vanity URL is missing." }, "406": { "description": "No friends found" }, "407": { "description": "Unknown Network error" }, "408": { "description": "Profile is private" } } } }, "/steam/api/inventory": { "get": { "tags": [ "Inventory" ], "summary": "\u26a1 Fetch Steam Inventory with Pricing & Doppler Phase Detection", "description": "Baseurl: https://www.steamwebapi.com/steam/api/inventory?steam_id=760000022222&game=cs2&key=YOUR_API_KEY\n\n**Fetch a Steam inventory with live prices, float values, and item metadata \u2014 rate-limit free.**\n\nReturns either Steam's raw response or an enriched version with prices and metadata (controlled via `parse`).\n\n---\n\n**Key features:**\n- **Live prices** from Steam and 10+ third-party markets.\n- **Float values & stickers** included by default for CS2.\n- **Doppler phase detection** \u2014 automatically detects the exact phase (Phase 1\u20134, Ruby, Sapphire, Black Pearl, Emerald) from the item image. The `image` field is replaced with the phase-specific variant image. Use `with_phase_price=1` to also get the exact phase price in `pricereal`.\n- **Trade URL support** (CS2) \u2014 access 7\u201310 day trade-locked items. Higher failure rate and slower than normal requests \u2014 avoid for time-critical applications. If you don't need blocked items, use the normal endpoint without Trade URL.\n- **Own inventory** \u2014 use `steam_login_secure` to fetch your own inventory without the 10-day block. No `steam_id` needed (will be ignored). Find the cookie in your browser dev tools.\n- **Fallback mode** \u2014 returns cached data when inventories are private or unavailable.\n- **Steam Community URL compatible** \u2014 works like `https://steamcommunity.com/inventory/{steamid}/730/2`. Replace the Steam URL with our Baseurl.\n- **Pagination** \u2014 use `limit`, `offset`, and `start_assetid` for large inventories (2000+ items).\n- **Multiple formats** \u2014 JSON, CSV, XML, gzip, and more.", "operationId": "get_api_inventory", "parameters": [ { "name": "key", "in": "query", "description": "Your API key from the dashboard (top-right corner). Required for authentication.", "required": true, "schema": { "type": "string", "example": "your-api-key-here" } }, { "name": "steam_id", "in": "query", "description": "The Steam ID of the user. Accepts formats: `steamid`, `steamid3`, `steamid64`, or vanity URL. Using account names may slow the request due to additional Steam API calls.", "required": true, "schema": { "type": "string", "example": "76561198100000000" } }, { "name": "state", "in": "query", "description": "Specifies the inventory fetch mode:\\n- `active` (default): Fetch live inventory from Steam.\\n- `fallback`: Try live first, fallback to cached data if private/inaccessible.\\n- `takedb`: Always fetch from our database (fastest, may be outdated).\\n\\nCached data includes timestamp in response headers.", "required": false, "schema": { "type": "string", "enum": [ "active", "fallback", "takedb" ] } }, { "name": "steam_login_secure", "in": "query", "description": "Your Steam login cookie for fetching your own inventory WITHOUT the 10-day trade block. When provided, `steam_id` is ignored. Find this cookie in your browser dev tools under \"steamLoginSecure\".", "required": false, "schema": { "type": "string" } }, { "name": "game", "in": "query", "description": "Short name of the game. Default is \"cs2\".", "required": false }, { "name": "parse", "in": "query", "description": "Enable steamwebapi parsing for enriched item data with prices and metadata. Set to `0` to get raw Steam response. Default: `1`", "required": false, "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "language", "in": "query", "description": "Preferred language for item names and descriptions. Default: `english`", "required": false, "schema": { "type": "string", "enum": [ "arabic", "bulgarian", "schinese", "tchinese", "czech", "danish", "dutch", "english", "finnish", "french", "german", "greek", "hungarian", "indonesian", "italian", "japanese", "koreana", "norwegian", "polish", "portuguese", "brazilian", "romanian", "russian", "spanish", "latam", "swedish", "thai", "turkish", "ukrainian", "vietnamese" ] } }, { "name": "no_cache", "in": "query", "description": "Bypass the default 3-day cache to get fresh data directly from Steam. Costs +1 additional credit. Default: `0`", "required": false, "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "group", "in": "query", "description": "Group identical items by market hash name and sum their count. Useful for inventories with many duplicate items (e.g., cases, keys). Default: `0`", "required": false, "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "sort", "in": "query", "description": "Sort items by criterion:\\n- **Steam prices**: `price_max`, `price_min`\\n- **Real/market prices**: `price_real_max`, `price_real_min`\\n- **Mix prices**: `price_mix_max`, `price_mix_min`\\n- **Other**: `count`, `name`\\n\\nDefault: `price_max`", "required": false, "schema": { "type": "string", "enum": [ "price_max", "price_min", "price_real_max", "price_real_min", "price_mix_max", "price_mix_min", "count", "name" ] } }, { "name": "currency", "in": "query", "description": "Currency for item prices. Only works when `parse=1`. Default: `USD`", "required": false, "schema": { "type": "string", "enum": [ "USD", "EUR", "GBP", "CNY", "JPY", "RUB", "BRL", "TRY", "PLN", "UAH", "KRW" ] } }, { "name": "select", "in": "query", "description": "Comma-separated list of fields to include in response. Reduces response size for faster transfers. Example: `markethashname,pricelatest,assetid,float`", "required": false, "schema": { "type": "string" } }, { "name": "with_no_tradable", "in": "query", "description": "Include non-tradeable items (trade-locked items, StatTrak swap tools, etc.). Default: `0`", "required": false, "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "trade_url", "in": "query", "description": "Steam Trade URL. When provided for CS2, automatically includes 7-10 day trade-locked items. Format: `https://steamcommunity.com/tradeoffer/new/?partner=123456&token=AbCdEf`", "required": false, "schema": { "type": "string" } }, { "name": "offset", "in": "query", "description": "Skip the first N items. Use with `limit` for pagination. Default: `0`", "required": false, "schema": { "type": "integer", "minimum": 0 } }, { "name": "limit", "in": "query", "description": "Maximum number of items to return. Steam caps at 2000 per request - use `start_assetid` for larger inventories. Default: `10000`", "required": false, "schema": { "type": "integer", "maximum": 10000, "minimum": 1 } }, { "name": "try_first_seven_days_blocked_items", "in": "query", "description": "CS2 only: Try trading inventory first to get 7-10 day trade-locked items, fallback to normal if empty. Increases response time and failure rate. Costs +1 credit. Default: `0`", "required": false, "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "markets", "in": "query", "description": "Comma-separated list of markets for price calculation. `pricereal` = lowest price among selected markets. Example: `skinbaron,skinport,dmarket`", "required": false, "schema": { "type": "string", "enum": [ "skinbaron", "skinport", "dmarket", "buff", "waxpeer", "bitskins", "csgotm", "haloskins", "tradeit", "skinbid" ] } }, { "name": "with_prices", "in": "query", "description": "Include detailed market prices array for each item with price, market name, logo, quantity, and direct link. May increase response time. Default: `0`", "required": false, "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "with_phase_price", "in": "query", "description": "CS2 Doppler items only. Replaces `pricereal` with the exact price for the detected phase (e.g. Phase 2 instead of generic Doppler price). When active, `pricereal24h`, `pricereal7d`, `pricereal30d`, `pricereal90d`, `pricerealmedian`, `winloss`, and `winlossprice` are set to `null` since phase-specific time-series data is not available. Only applies when a phase is detected AND the phase has a known price. If no phase price exists, `pricereal` stays unchanged. Default: `0`", "required": false, "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "search", "in": "query", "description": "Filter items by name (case-insensitive). Matches partial names. Example: `ak-47`", "required": false, "schema": { "type": "string" } }, { "name": "production", "in": "query", "description": "Set to 1 in production to remove info fields and get faster responses. Will be required in future API versions. Default: `0`", "required": false, "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "trade_locked", "in": "query", "description": "Show trade-locked items in your own inventory. Requires `steam_login_secure` parameter. Default: `0`", "required": false, "schema": { "type": "string", "enum": [ "0", "1" ] } }, { "name": "start_assetid", "in": "query", "description": "Pagination for large inventories (2000+ items). Check `last_assetid` response header and use it here for next page. Repeat until all items fetched.", "required": false, "schema": { "type": "string" } }, { "name": "format", "in": "query", "description": "Response format. Use `gzip` or `zip` for compressed downloads. Default: `json`", "required": false, "schema": { "type": "string", "enum": [ "json", "csv", "xml", "html", "gzip", "zip", "ndjson", "mysql", "mysql_with_table", "pgsql", "pgsql_with_table", "mongo" ] } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON output. Only for json/gzip/zip formats. Default: `0`", "required": false, "schema": { "type": "string", "enum": [ "0", "1" ] } } ], "responses": { "200": { "description": "Inventory fetched successfully. Returns array of items with prices and metadata.", "content": { "application/json": { "schema": {}, "example": [ { "id": "53959ead", "markethashname": "AK-47 | Redline (Field-Tested)", "marketname": "AK-47 | Redline (Field-Tested)", "slug": "ak-47-redline-field-tested", "normalizedname": "ak-47-redline", "count": 1, "assetid": "41711300816", "classid": "6216346342", "instanceid": "188530139", "groupid": "2b99d7efc002d8ac9474c7bd34f953a8", "inspectlink": "steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20S76561198100000000A41711300816D12345678901234567", "float": { "floatvalue": 0.23456789, "paintseed": 456, "paintindex": 282, "phase": null, "stickers": [ { "slot": 0, "stickerId": 4688, "name": "iBUYPOWER | Katowice 2014", "image": "https://steamcdn-a.akamaihd.net/apps/730/icons/..." }, { "slot": 1, "stickerId": 4689, "name": "Titan | Katowice 2014", "image": "https://steamcdn-a.akamaihd.net/apps/730/icons/..." } ], "keychains": [] }, "infoprice": "These are Steam market prices. Details: https://www.steamwebapi.com/api/doc", "pricelatest": 42.5, "pricelatestsell": 41.2, "pricelatestsell24h": 41.5, "pricelatestsell7d": 40.8, "pricelatestsell30d": 39.9, "pricelatestsell90d": 38.5, "lateststeamsellat": { "date": "2025-04-27 00:00:00.000000", "timezone_type": 3, "timezone": "UTC" }, "pricemedian": 40, "pricemedian24h": 40.5, "pricemedian7d": 39.8, "pricemedian30d": 38.5, "pricemedian90d": 36, "priceavg": 40.22, "priceavg24h": 40.8, "priceavg7d": 39.9, "priceavg30d": 38.75, "priceavg90d": 36.5, "pricesafe": 38, "pricemin": 35, "pricemax": 55, "pricemix": 32.5, "pricereal": 32.5, "buyorderprice": 35, "buyordermedian": 34.5, "buyorderavg": 34, "buyordervolume": 1250, "offervolume": 485, "soldtoday": 42, "sold24h": 125, "sold7d": 876, "sold30d": 3542, "sold90d": 10250, "soldtotal": 125000, "hourstosold": 2, "points": 8750, "priceupdatedat": { "date": "2025-04-27 12:59:05.000000", "timezone_type": 3, "timezone": "UTC" }, "nametag": "My Favorite AK", "bordercolor": "CF6A32", "color": "CF6A32", "quality": "StatTrak", "itemgroup": "rifle", "itemtype": "Rifle", "image": "https://steamcdn-a.akamaihd.net/apps/730/icons/...", "prices": [ { "market": "skinbaron", "price": 32.5, "quantity": 15, "link": "https://skinbaron.de/..." }, { "market": "skinport", "price": 33.2, "quantity": 8, "link": "https://skinport.com/..." }, { "market": "buff", "price": 34, "quantity": 125, "link": "https://buff.163.com/..." } ], "variants": [ { "floatvalue": 0.15, "price": 45, "paintseed": 661, "image": "https://..." }, { "floatvalue": 0.25, "price": 38, "paintseed": 123, "image": "https://..." } ], "tradable": true, "tradableafter": null } ] } } }, "400": { "description": "Missing required parameter.", "content": { "application/json": { "schema": {}, "example": { "error": "The required \"steam_id\" parameter is missing." } } } }, "401": { "description": "Invalid Steam ID format.", "content": { "application/json": { "schema": {}, "example": { "error": "Provided \"steam_id\" is invalid." } } } }, "403": { "description": "Inventory is private.", "content": { "application/json": { "schema": {}, "example": { "error": "PRIVATE" } } } }, "404": { "description": "Profile not found.", "content": { "application/json": { "schema": {}, "example": { "error": "PROFILE_NOT_FOUND" } } } }, "410": { "description": "No items for this game.", "content": { "application/json": { "schema": {}, "example": { "error": "PROFILE_NOT_FOUND_OR_NO_INVENTORY_FOR_GAME" } } } }, "411": { "description": "No tradeable items.", "content": { "application/json": { "schema": {}, "example": { "error": "NO_ITEMS" } } } }, "451": { "description": "Steam error or maintenance.", "content": { "application/json": { "schema": {}, "example": { "error": "Steam inventory could not be fetched due to internal or Steam network issues. Please try again later." } } } } } } }, "/steam/api/inventory/batch": { "get": { "tags": [ "Inventory" ], "summary": "\u26a1 Batch Fetch Multiple Inventories with Doppler Phase Detection", "description": "Baseurl: https://www.steamwebapi.com/steam/api/inventory/batch?steam_ids=76561199146708568,76561198047543612&game=cs2&key=YOUR_API_KEY\n\n**Fetch inventories for up to 20 Steam IDs in a single request.**\n\nReturns an object keyed by Steam ID, each containing an array of items with prices and metadata.\n\n---\n\n**Key features:**\n- **Up to 20 Steam IDs** per request (comma-separated). Each ID = 1 credit.\n- **Parallel processing** for maximum speed.\n- **Doppler phase detection** \u2014 automatically detects the exact phase and replaces item image. Use `with_phase_price=1` for phase-specific pricing.\n- **Field selection** \u2014 use `select` to reduce response size.\n- **11 currencies** supported.\n- Private inventories return empty array or cached data.\n\n**Example:**\n```\nGET /steam/api/inventory/batch?steam_ids=76561198100000000,76561198200000000&key=YOUR_KEY\n```", "operationId": "get_api_inventory_batch", "parameters": [ { "name": "key", "in": "query", "description": "Your API key from the dashboard. Required for authentication.", "required": true, "schema": { "type": "string", "example": "your-api-key-here" } }, { "name": "steam_ids", "in": "query", "description": "Comma-separated Steam IDs (max 20). Accepts steamid, steamid3, or steamid64 formats.", "required": true, "schema": { "type": "string", "example": "76561198100000000,76561198200000000" } }, { "name": "game", "in": "query", "description": "Game short name.", "required": false, "schema": { "type": "string", "default": "cs2", "enum": [ "cs2", "dota2", "rust", "tf2", "steam" ] } }, { "name": "select", "in": "query", "description": "Comma-separated fields to include. Reduces response size.", "required": false, "schema": { "type": "string", "example": "markethashname,pricelatest,assetid" } }, { "name": "currency", "in": "query", "description": "Currency for prices.", "required": false, "schema": { "type": "string", "default": "USD", "enum": [ "USD", "EUR", "GBP", "CNY", "JPY", "RUB", "BRL", "TRY", "PLN", "UAH", "KRW" ] } }, { "name": "language", "in": "query", "description": "Language for item names.", "required": false, "schema": { "type": "string", "default": "english", "enum": [ "arabic", "bulgarian", "schinese", "tchinese", "czech", "danish", "dutch", "english", "finnish", "french", "german", "greek", "hungarian", "indonesian", "italian", "japanese", "koreana", "norwegian", "polish", "portuguese", "brazilian", "romanian", "russian", "spanish", "latam", "swedish", "thai", "turkish", "ukrainian", "vietnamese" ] } }, { "name": "no_cache", "in": "query", "description": "Bypass 3-day cache. Costs +1 credit per ID.", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } }, { "name": "with_no_tradable", "in": "query", "description": "Include non-tradeable items.", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } }, { "name": "with_phase_price", "in": "query", "description": "CS2 Doppler items only. Replaces `pricereal` with the exact phase price. Sets time-series price fields to `null`. Only applies when a phase is detected and has a known price. Default: `0`", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } }, { "name": "sort", "in": "query", "description": "Sort items by criterion.", "required": false, "schema": { "type": "string", "default": "price_max", "enum": [ "price_max", "price_min", "price_real_max", "price_real_min", "price_mix_max", "price_mix_min", "count", "name" ] } }, { "name": "group", "in": "query", "description": "Group identical items by market hash name.", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } }, { "name": "markets", "in": "query", "description": "Comma-separated markets for pricereal calculation.", "required": false, "schema": { "type": "string", "example": "skinbaron,skinport,buff" } }, { "name": "production", "in": "query", "description": "Set to 1 in production to remove info fields. Will be required in future.", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } }, { "name": "format", "in": "query", "description": "Response format.", "required": false, "schema": { "type": "string", "default": "json", "enum": [ "json", "csv", "xml", "html", "gzip", "zip", "ndjson", "mysql", "mysql_with_table", "pgsql", "pgsql_with_table", "mongo" ] } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON output.", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } } ], "responses": { "200": { "description": "Batch inventories fetched successfully. Returns object keyed by Steam ID.", "content": { "application/json": { "schema": {}, "example": { "76561199146708568": [ { "id": "20df382e", "markethashname": "M4A4 | Mainframe (Well-Worn)", "marketname": "M4A4 | Mainframe (Well-Worn)", "slug": "m4a4-mainframe-well-worn", "normalizedname": "m4a4-mainframe", "count": 1, "assetid": "43554843781", "classid": "3035587644", "instanceid": "302028390", "groupid": "13c73e09beb8799ece6ac0cc6f7afd83", "inspectlink": "steam://rungame/730/...", "float": { "floatvalue": 0.4256789, "paintseed": 123, "paintindex": 309, "phase": null, "stickers": [], "keychains": [] }, "pricelatest": 0.09, "pricereal": 0.06, "pricemix": 0.04, "itemgroup": "rifle", "itemtype": "Rifle" } ], "76561198047543612": [ { "markethashname": "AK-47 | Slate (Factory New)", "pricelatest": 15.5, "pricereal": 12.8 } ] } } } }, "400": { "description": "Missing or invalid parameters.", "content": { "application/json": { "schema": {}, "example": { "error": "Missing steam_ids parameter" } } } }, "404": { "description": "Game not found.", "content": { "application/json": { "schema": {}, "example": { "error": "Game not found. Default is cs2." } } } }, "500": { "description": "Internal server error.", "content": { "application/json": { "schema": {}, "example": { "error": "Internal server error. Please try again later." } } } } } } }, "/steam/api/items/history": { "post": { "tags": [ "Items" ], "summary": "\ud83d\udcc8 Get Daily Aggregated Price History for multiple Items", "description": "Baseurl: https://www.steamwebapi.com/steam/api/items/history?source=steam&game=cs2&key=YOUR_API_KEY\n\n\ud83d\udcac **What this endpoint does:**\n- Aggregates historical price data for any items over time.\n- Returns daily aggregated data showing total worth and item count.\n- Supports two price sources: Steam (this will take, daily sold price) or Markets (this will take, lowest real market offer).\n- Each request costs 1 credit regardless of the number of items.\n\n\ud83c\udf10 **How to use:**\n- Send a JSON payload with an array of item market hash names in the `items` field.\n- Optionally specify `source` (steam/markets) and `game` (cs2, csgo, dota, rust) via query parameters or request body.\n- The endpoint will return daily aggregated worth based on the latest price per day for each item.\n- Duplicate items in the array are counted separately (e.g., 2x \"AK-47 | Redline\" = 2x price).\n\n\ud83d\udcca **Use Cases:**\n- **Inventory Tracking:** Track your Steam inventory value over time by sending all your item names\n- **Portfolio Analysis:** Monitor the performance of specific item collections or investment portfolios\n- **Watchlist Monitoring:** Track price trends for items you're interested in buying or selling\n- **Market Research:** Compare historical performance between different item categories or rarities\n- **Trading Strategies:** Analyze price movements for items in your trading pool", "operationId": "post_api_items_history", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "source", "in": "query", "description": "Optional. Price source:\n- `steam` (default): Uses Steam Community Market last sale price\n- `markets`: Uses lowest price from real market offers (e.g., third-party markets)", "required": false, "example": "steam" }, { "name": "game", "in": "query", "description": "Optional. Game shortname. Default: cs2. Available: cs2, csgo, dota, rust", "required": false, "example": "cs2" }, { "name": "from_date", "in": "query", "description": "Optional. Start date for filtering history (Y-m-d format, e.g., 2025-01-01). If not provided, returns all available history from the beginning.", "required": false, "example": "2025-01-01" }, { "name": "to_date", "in": "query", "description": "Optional. End date for filtering history (Y-m-d format, e.g., 2025-01-31). If not provided, returns up to the current date.", "required": false, "example": "2025-01-31" }, { "name": "strategy", "in": "query", "description": "Optional. Price aggregation strategy:\n- `PAST_PRICE`: Uses the last known price before or on the given date\n- `PAST_FUTURE_PRICE`: Uses the last known price before the given date, or the first known price after the given date if none exists before\n- `SAME_DATE`: Uses the price on the given date, or the nearest available price (previous or next day)\n- `STRICT`: Uses the price only if it exists on the exact date, otherwise returns no data for that day\n- `NEAREST`: Uses the nearest available price (previous or next) to the given date", "required": false, "example": "PAST_PRICE" }, { "name": "format", "in": "query", "description": "Response format: json (default), csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo. Example: ?format=csv", "required": false, "schema": { "type": "string", "default": "json" } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON (set to 1 for json/gzip/zip formats). Example: ?format=json&pretty=1", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "items" ], "properties": { "items": { "description": "Array of item market hash names. Duplicates are counted separately.", "type": "array", "items": { "type": "string" }, "example": [ "AK-47 | Redline (Field-Tested)", "AWP | Asiimov (Field-Tested)", "AK-47 | Redline (Field-Tested)" ] }, "source": { "description": "Optional. Price source: \"steam\" (last sale price) or \"markets\" (lowest market offer). Can also be passed as query parameter.", "type": "string", "enum": [ "steam", "markets" ], "example": "steam" }, "game": { "description": "Optional. Game shortname. Can also be passed as query parameter.", "type": "string", "example": "cs2" }, "from_date": { "description": "Optional. Start date for filtering (Y-m-d format). If not provided, returns all available history. Can also be passed as query parameter.", "type": "string", "example": "2025-01-01" }, "to_date": { "description": "Optional. End date for filtering (Y-m-d format). If not provided, returns up to current date. Can also be passed as query parameter.", "type": "string", "example": "2025-01-31" }, "strategy": { "description": "Optional. Price aggregation strategy:\n- `PAST_PRICE`: Uses the last known price before or on the given date\n- `PAST_FUTURE_PRICE`: Uses the last known price before the given date, or the first known price after the given date if none exists before\n- `SAME_DATE`: Uses the price on the given date, or the nearest available price (previous or next day)\n- `STRICT`: Uses the price only if it exists on the exact date, otherwise returns no data for that day\n- `NEAREST`: Uses the nearest available price (previous or next) to the given date", "type": "string", "enum": [ "PAST_PRICE", "PAST_FUTURE_PRICE", "SAME_DATE", "STRICT", "NEAREST" ], "example": "PAST_PRICE" } }, "type": "object" } } } }, "responses": { "200": { "description": "Daily aggregated history returned successfully.", "content": { "application/json": { "schema": {}, "example": [ { "worth": 125.45, "size": 3, "date": "2025-01-15T00:00:00+00:00" }, { "worth": 128.9, "size": 3, "date": "2025-01-16T00:00:00+00:00" }, { "worth": 132.15, "size": 3, "date": "2025-01-17T00:00:00+00:00" } ] } } }, "400": { "description": "Invalid input: items must be a non-empty array or invalid source." }, "404": { "description": "Game not found." } } } }, "/steam/api/items/preview": { "get": { "tags": [ "Items" ], "summary": "\ud83d\udd0d Preview CS2 Items - Lightweight Metadata (No Prices)", "description": "Baseurl: https://www.steamwebapi.com/steam/api/items/preview?key=YOUR_API_KEY\n\n \ud83d\udcac **What this endpoint does:**\n - Returns a lightweight preview of CS2 items without pricing data.\n - Intended for fast access to item metadata and newly available items.\n - For full item details including pricing, prefer using `/steam/api/items`.\n\n \ud83d\udee0\ufe0f **Features:**\n - Search items by name using `search` parameter (case-insensitive).\n - Filter by `paint_index` or `def_index` for specific weapons/skins.\n - Group results using `groupBy` to get unique values (e.g., all item types).\n - Remove duplicates with `grouped=true` (default).\n - Filter only items with phases using `only_phases=true`.\n - Supports multiple output formats via `format` parameter.\n\n \ud83c\udf10 **How to use:**\n - Basic call: `GET /steam/api/items/preview?key=YOUR_KEY`\n - Search: `GET /steam/api/items/preview?search=AK-47&key=YOUR_KEY`\n - Filter by weapon: `GET /steam/api/items/preview?def_index=7&key=YOUR_KEY`\n - Get all item types: `GET /steam/api/items/preview?groupBy=itemtype&key=YOUR_KEY`\n - Export as CSV: `GET /steam/api/items/preview?format=csv&key=YOUR_KEY`", "operationId": "get_steam_api_items_preview", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "search", "in": "query", "description": "Optional. Search for items by name (case-insensitive). Matches partial names.\n - Example: `search=AK-47` returns all AK-47 skins.\n - Example: `search=Redline` returns all Redline skins across weapons.", "required": false, "schema": { "type": "string" }, "example": "AK-47" }, { "name": "paint_index", "in": "query", "description": "Optional. Filter by paint index (skin pattern ID).\n - Each skin has a unique paint_index.\n - Example: `282` = Redline, `418` = Doppler Phase 1.", "required": false, "schema": { "type": "integer" }, "example": 282 }, { "name": "def_index", "in": "query", "description": "Optional. Filter by definition index (weapon ID).\n - Each weapon type has a unique def_index.\n - Common values: `7` = AK-47, `9` = AWP, `4` = Glock-18, `61` = USP-S.", "required": false, "schema": { "type": "integer" }, "example": 7 }, { "name": "grouped", "in": "query", "description": "Optional. Remove duplicate item names (default: true).\n - `true`: Returns one entry per item name with `variants` array for phases.\n - `false`: Returns all variants as separate entries.", "required": false, "schema": { "type": "boolean", "default": true }, "example": true }, { "name": "groupBy", "in": "query", "description": "Optional. Group results by a field and return unique values only.\n - Response becomes a flat array of strings/numbers.\n - Example: `?groupBy=itemtype` returns `[\"ak-47\", \"awp\", \"m4a1-s\", ...]`\n - Example: `?groupBy=rarity` returns `[\"Covert\", \"Classified\", \"Restricted\", ...]`", "required": false, "schema": { "type": "string", "enum": [ "itemtype", "itemname", "rarity", "collection", "wear", "phase", "defindex", "paintindex", "markethashname", "groupname" ] }, "example": "itemtype" }, { "name": "format", "in": "query", "description": "Optional. Output format for the response.\n - `json` (default): Standard JSON response.\n - `csv`, `xml`, `html`: Export formats for data analysis.\n - `gzip`, `zip`: Compressed JSON for large datasets.\n - `mysql`, `pgsql`, `mongo`: Database insert statements.", "required": false, "schema": { "type": "string", "default": "json", "enum": [ "json", "gzip", "zip", "csv", "xml", "html", "table", "ndjson", "mysql", "mysql_with_table", "pgsql", "pgsql_with_table", "mongo" ] }, "example": "json" }, { "name": "pretty", "in": "query", "description": "Optional. Pretty-print JSON output (indented, human-readable).\n - `0` (default): Minified JSON.\n - `1`: Indented, formatted JSON.", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] }, "example": "0" }, { "name": "only_phases", "in": "query", "description": "Optional. Only return items that have phases.\n - Useful for filtering Doppler, Gamma Doppler, Marble Fade knives.\n - Returns items with Phase 1, Phase 2, Phase 3, Phase 4, Ruby, Sapphire, etc.", "required": false, "schema": { "type": "boolean", "default": false }, "example": false } ], "responses": { "200": { "description": "CS2 items matching the filters. Returns item metadata without pricing. When `grouped=true` (default), items with multiple phases include a `variants` array.", "content": { "application/json": { "schema": {}, "example": [ { "markethashname": "AK-47 | Redline (Field-Tested)", "steamurl": "https://steamcommunity.com/market/listings/730/AK-47%20%7C%20Redline%20%28Field-Tested%29", "defindex": 7, "paintindex": 282, "itemtype": "ak-47", "itemname": "redline", "rarity": "Classified", "color": "d32ce6", "isstattrak": false, "issouvenir": false, "phase": null, "wear": "ft", "minfloat": 0.1, "maxfloat": 0.7, "itemimage": "https://community.cloudflare.steamstatic.com/economy/image/-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpot7HxfDhjxszJemkV09-5lpKKqPrxN7LEmyVQ7MEpiLuSrYmnjQO3-hBsMmj0JYGXJlU4aVyF_lS4lb3vgZ7u6ZmazXEy6D5iuyh0n0yKhEA/360fx360f", "legacy": null, "collection": "The Phoenix Collection", "groupname": "Ak-47 | Redline", "new": false, "variants": [] }, { "markethashname": "\u2605 Karambit | Doppler (Factory New)", "steamurl": "https://steamcommunity.com/market/listings/730/%E2%98%85%20Karambit%20%7C%20Doppler%20%28Factory%20New%29", "defindex": 507, "paintindex": 418, "itemtype": "karambit", "itemname": "doppler", "rarity": "Covert", "color": "eb4b4b", "isstattrak": false, "issouvenir": false, "phase": "Phase 1", "wear": "fn", "minfloat": 0, "maxfloat": 0.08, "itemimage": "https://community.cloudflare.steamstatic.com/economy/image/-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpovbSsLQJf2PLacDBA5ciJl4G0k_jkI7fUhFRB4MRij7j--YXygED6_0NrZm_1LISUIFI6NV_W_1O4xOzvhJO5vcnMynRh6ygj7WGdwULuXwqE/360fx360f", "legacy": null, "collection": null, "groupname": "Karambit | Doppler", "new": false, "variants": [ { "phase": "Phase 1", "paintindex": 418, "image": "https://community.cloudflare.steamstatic.com/economy/image/..." }, { "phase": "Phase 2", "paintindex": 419, "image": "https://community.cloudflare.steamstatic.com/economy/image/..." }, { "phase": "Phase 3", "paintindex": 420, "image": "https://community.cloudflare.steamstatic.com/economy/image/..." }, { "phase": "Phase 4", "paintindex": 421, "image": "https://community.cloudflare.steamstatic.com/economy/image/..." }, { "phase": "Ruby", "paintindex": 415, "image": "https://community.cloudflare.steamstatic.com/economy/image/..." }, { "phase": "Sapphire", "paintindex": 416, "image": "https://community.cloudflare.steamstatic.com/economy/image/..." }, { "phase": "Black Pearl", "paintindex": 417, "image": "https://community.cloudflare.steamstatic.com/economy/image/..." } ] } ] } } }, "400": { "description": "Invalid request parameters.", "content": { "application/json": { "schema": {}, "example": { "error": "Invalid groupBy field. Allowed: itemtype, itemname, rarity, collection, wear, phase, defindex, paintindex, markethashname, groupname" } } } }, "500": { "description": "Internal server error or upstream API unavailable.", "content": { "application/json": { "schema": {}, "example": { "error": "Upstream API error: 503" } } } } } } }, "/steam/api/market-index/cs2": { "get": { "tags": [ "Market Index" ], "summary": "\ud83d\udcca CS2 Market Index - Real-time Market Statistics", "description": "Baseurl: https://www.steamwebapi.com/steam/api/market-index/cs2?key=YOUR_API_KEY\n\n \ud83d\udcac **What this endpoint does:**\n - Provides real-time CS2 market statistics and price indices.\n - Returns global market overview or specific segment details.\n - Includes price indices, trading volumes, market sentiment, and trends.\n\n \ud83d\udee0\ufe0f **Features:**\n - **Global Overview** (no params): Returns complete market data with all segments and `available_segments` listing all valid keys.\n - **Segment Details** (with params): Returns detailed data for a specific segment using `segment_type` and `segment_key`.\n - Supports multiple output formats (JSON, CSV, XML, etc.).\n\n \ud83c\udf10 **How to use:**\n - Call without parameters for global market overview.\n - Use `segment_type` and `segment_key` to filter by specific categories.\n - Example: `?segment_type=item_group&segment_key=knife` for knife market data.\n\n \ud83d\udccb **Available Segment Types:**\n - `item_group`: knife, glove, rifle, pistol, smg, shotgun, agent, sticker, container...\n - `rarity`: Contraband, Covert, Classified, Restricted, Mil-Spec Grade...\n - `wear`: fn (Factory New), mw, ft, ww, bs, vanilla\n - `quality`: normal, souvenir, tournament, genuine...\n - `stattrak`: yes, no\n - `collection`: The 2018 Inferno Collection, The Dust 2 Collection...", "operationId": "getMarketIndex", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "segment_type", "in": "query", "description": "Segment type for filtering. If omitted, returns global overview with all segments.\n\n**Types:**\n- `item_group`: Weapon categories (knife, rifle, pistol, etc.)\n- `rarity`: Item rarity (Covert, Classified, Mil-Spec Grade, etc.)\n- `wear`: Skin condition (fn, mw, ft, ww, bs, vanilla)\n- `quality`: Item quality (normal, souvenir, stattrak base, etc.)\n- `stattrak`: StatTrak status (yes, no)\n- `collection`: Game collections", "required": false, "schema": { "type": "string", "enum": [ "item_group", "rarity", "wear", "quality", "stattrak", "collection" ] } }, { "name": "segment_key", "in": "query", "description": "Segment key (required if segment_type is set). Call the API without parameters to get `available_segments` with all valid keys.\n\n**Common keys by type:**\n- `item_group`: knife, glove, rifle, pistol, smg, sticker, agent, container...\n- `rarity`: Covert, Classified, Restricted, Mil-Spec Grade, Consumer Grade...\n- `wear`: fn, mw, ft, ww, bs, vanilla\n- `quality`: normal, souvenir, tournament, genuine...\n- `stattrak`: yes, no", "required": false, "schema": { "type": "string" } }, { "name": "format", "in": "query", "description": "Response format. Default: `json`. Available: csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo", "required": false, "schema": { "type": "string" } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON (set to 1 for json/gzip/zip formats). Default: `0`", "required": false, "schema": { "type": "string", "enum": [ "0", "1" ] } } ], "responses": { "200": { "description": "Market data (global overview or segment details)", "content": { "application/json": { "schema": {}, "example": { "success": true, "mode": "global", "gameid": 730, "gamename": "Counter-Strike 2", "lastupdated": "2026-01-28 10:00:00", "timestamp": 1738054800, "itemcount": 35420, "marketableitemcount": 30375, "unstablecount": 1205, "priceindex": 2384593.56, "buyorderpriceindex": 2169728.09, "realpriceindex": 2276160.83, "offervolumetotal": 1847392, "buyordervolumetotal": 2103847, "sold24h": 1441734, "sold7d": 9892147, "sold30d": 42381920, "turnover24h": 3611674.84, "avgspreadpct": 8.42, "buypressureratio": 1.14, "sellthrough24hpct": 78.02, "avglistingprice": 78.52, "avgbuyorderprice": 71.38, "avgrealprice": 74.95, "steammarkupratio": 45.57, "listingtotalvalue": 145103847.23, "buyordertotalvalue": 150238471.89, "marketsentiment": { "gainers": 12847, "losers": 8293, "neutral": 9235 }, "zeropriceshare": 0.0397, "changes": { "24h": { "priceindex": { "value": 2384593.56, "previous": 2360000, "change": 1.04, "trend": "up" }, "sold24h": { "value": 1441734, "previous": 1380000, "change": 4.47, "trend": "up" } }, "7d": [], "30d": [], "90d": [] }, "topmovers": { "gainers": [ { "markethashname": "AK-47 | Redline (Field-Tested)", "change24h": 15.23, "price": 12.5 } ], "losers": [ { "markethashname": "M4A1-S | Hyper Beast (Minimal Wear)", "change24h": -8.72, "price": 45 } ] }, "history": [], "segments": [], "available_segments": [] } } } }, "400": { "description": "Invalid parameters", "content": { "application/json": { "schema": {}, "example": { "success": false, "error": "segment_key is required when segment_type is set" } } } }, "404": { "description": "No data available", "content": { "application/json": { "schema": {}, "example": { "success": false, "error": "No market data available yet." } } } } } } }, "/steam/api/market-index/cs2/history": { "get": { "tags": [ "Market Index" ], "summary": "\ud83d\udcc8 CS2 Market Index History - Historical Price & Volume Data", "description": "Baseurl: https://www.steamwebapi.com/steam/api/market-index/cs2/history?key=YOUR_API_KEY\n\n \ud83d\udcac **What this endpoint does:**\n - Returns historical data for any metric with flexible time aggregation.\n - Supports OHLC (Open/High/Low/Close) format for aggregated intervals.\n - Perfect for building charts, trend analysis, and market dashboards.\n\n \ud83d\udee0\ufe0f **Features:**\n - **Multiple Metrics:** Track price index, volume, turnover, listings, and more.\n - **Flexible Intervals:** From raw 1-minute data to yearly aggregates.\n - **Multi-Metric Mode:** Request multiple metrics in a single API call.\n - **OHLC Format:** Aggregated intervals return candlestick-ready data.\n - **Segment Support:** Get history for any segment type/key combination.\n\n \ud83d\udcca **Available Metrics:**\n - `priceindex` - Steam price index (default)\n - `buyorderpriceindex` - Buy order price index\n - `sold24h`, `sold7d`, `sold30d` - Sales volume\n - `turnover24h` - USD turnover\n - `listings` - Active listings count\n - `buyorders` - Active buy orders count\n - `avgspreadpct` - Average bid-ask spread\n - `avglistingprice` - Average listing price\n - `sellthrough24hpct` - Sell-through rate\n - `listingvalue` - Total listing value\n - `orderbookvalue` - Total order book value\n - `buypressureratio` - Buy/sell pressure ratio\n - `gainerscount`, `loserscount`, `neutralcount` - Market sentiment\n - `itemcount` - Marketable item count\n\n \u23f1\ufe0f **Available Intervals:**\n - `raw` - Every data point (1-minute buckets)\n - `fivemin` - 5-minute aggregates\n - `tenmin` - 10-minute aggregates\n - `hourly` - Hourly aggregates\n - `sixhours` - 6-hour aggregates\n - `daily` - Daily aggregates\n - `threedays` - 3-day aggregates\n - `weekly` - Weekly aggregates\n - `monthly` - Monthly aggregates\n - `threemonths` - Quarterly aggregates\n - `sixmonths` - Semi-annual aggregates\n - `yearly` - Annual aggregates\n\n \ud83c\udfaf **Example Requests:**\n - 24h raw price index: `?metric=priceindex&from=-24hours`\n - Daily volume for 30 days: `?metric=sold24h&interval=daily&from=-30days`\n - Multiple metrics: `?metrics=priceindex,sold24h,turnover24h&interval=hourly`\n - Knife segment history: `?segment_type=item_group&segment_key=knife&metric=priceindex`", "operationId": "getMarketIndexHistory", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "metric", "in": "query", "description": "Single metric to retrieve. Default: `priceindex`. Ignored if `metrics` is set.\n\n**Available:** priceindex, buyorderpriceindex, sold24h, sold7d, sold30d, turnover24h, listings, buyorders, avgspreadpct, avglistingprice, sellthrough24hpct, listingvalue, orderbookvalue, buypressureratio, gainerscount, loserscount, neutralcount, itemcount", "required": false, "schema": { "type": "string", "default": "priceindex" } }, { "name": "metrics", "in": "query", "description": "Comma-separated list of metrics for multi-metric mode. Returns all metrics in a single response.\n\n**Example:** `priceindex,sold24h,turnover24h`", "required": false, "schema": { "type": "string" } }, { "name": "interval", "in": "query", "description": "Time aggregation interval. Default: `raw` (1-minute buckets).\n\n**Available:**\n- `raw` - Every data point (~1 min)\n- `fivemin` - 5-minute aggregates\n- `tenmin` - 10-minute aggregates\n- `hourly` - Hourly aggregates\n- `sixhours` - 6-hour aggregates\n- `daily` - Daily aggregates\n- `threedays` - 3-day aggregates\n- `weekly` - Weekly aggregates\n- `monthly` - Monthly aggregates\n- `threemonths` - Quarterly aggregates\n- `sixmonths` - Semi-annual aggregates\n- `yearly` - Annual aggregates\n\n**Note:** Aggregated intervals return OHLC format (open/high/low/close).", "required": false, "schema": { "type": "string", "default": "raw", "enum": [ "raw", "fivemin", "tenmin", "hourly", "sixhours", "daily", "threedays", "weekly", "monthly", "threemonths", "sixmonths", "yearly" ] } }, { "name": "segment_type", "in": "query", "description": "Segment type to get history for. Default: `global`\n\n**Available types:** global, item_group, rarity, wear, quality, stattrak, collection", "required": false, "schema": { "type": "string", "enum": [ "global", "item_group", "rarity", "wear", "quality", "stattrak", "collection" ] } }, { "name": "segment_key", "in": "query", "description": "Segment key for the selected type. Use `GET /cs2` to see all available keys in `available_segments`. Default: `all`\n\n**Examples:** knife, Covert, fn, yes, normal", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "description": "Start date. Supports multiple formats:\n- ISO date: `2026-01-01` or `2026-01-01 10:00:00`\n- Unix timestamp: `1735689600`\n- Relative: `-24hours`, `-7days`, `-30days`, `-1year`\n\nDefault: 24 hours ago.", "required": false, "schema": { "type": "string" } }, { "name": "to", "in": "query", "description": "End date. Same formats as `from`. Default: now.", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Maximum data points. Default: `1000`, Max: `10000`", "required": false, "schema": { "type": "integer", "maximum": 10000 } }, { "name": "format", "in": "query", "description": "Response format. Default: `json`. Available: csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo", "required": false, "schema": { "type": "string" } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON (set to 1 for json/gzip/zip formats). Default: `0`", "required": false, "schema": { "type": "string", "enum": [ "0", "1" ] } } ], "responses": { "200": { "description": "Historical market data (single metric mode)", "content": { "application/json": { "schema": {}, "example": { "success": true, "metric": "priceindex", "interval": "daily", "segmenttype": "global", "segmentkey": "all", "from": "2026-01-01 00:00:00", "to": "2026-01-29 12:00:00", "count": 29, "availablemetrics": [ "priceindex", "sold24h", "turnover24h", "..." ], "availableintervals": [ "raw", "hourly", "daily", "..." ], "history": [ { "ts": 1735689600, "open": 2100000, "high": 2150000, "low": 2080000, "close": 2120000, "change": 0.95, "trend": "up", "datapoints": 1440 }, { "ts": 1735776000, "open": 2120000, "high": 2180000, "low": 2110000, "close": 2175000, "change": 2.59, "trend": "up", "datapoints": 1440 } ] } } } }, "202": { "description": "Historical market data (multi-metric mode)", "content": { "application/json": { "schema": {}, "example": { "success": true, "mode": "multi-metric", "metrics": [ "priceindex", "sold24h", "turnover24h" ], "interval": "hourly", "segmenttype": "global", "segmentkey": "all", "from": "2026-01-28 00:00:00", "to": "2026-01-29 12:00:00", "history": { "priceindex": [ { "ts": 1738022400, "open": 2845000, "high": 2850000, "low": 2840000, "close": 2848000 } ], "sold24h": [ { "ts": 1738022400, "open": 125000, "high": 128000, "low": 123000, "close": 127000 } ], "turnover24h": [ { "ts": 1738022400, "open": 8500000, "high": 8700000, "low": 8400000, "close": 8650000 } ] } } } } } } } }, "/steam/api/market-index/cs2/compare": { "get": { "tags": [ "Market Index" ], "summary": "\u2696\ufe0f Compare Market Segments - Segment Analysis", "description": "Baseurl: https://www.steamwebapi.com/steam/api/market-index/cs2/compare?type=rarity&key=YOUR_API_KEY\n\n \ud83d\udcac **What this endpoint does:**\n - Compares market segments by a specific metric.\n - Returns sorted list with values and percentages.\n - Ideal for pie charts, ranking tables, or market analysis.\n\n \ud83d\udee0\ufe0f **Features:**\n - Compare by different metrics: price_index, turnover, sold24h, avg_price, listing_value, order_book_value.\n - Filter specific segments using `keys` parameter (comma-separated).\n - Results sorted by value in descending order.\n\n \ud83c\udf10 **How to use:**\n - Specify `type` parameter (required): item_group, rarity, wear, quality, stattrak, collection.\n - Optionally filter with `keys`: `?type=item_group&keys=knife,glove,rifle`.\n - Change metric: `?type=wear&metric=turnover`.\n\n \ud83d\udcca **Use Cases:**\n - Market share analysis by rarity or item type.\n - Compare trading volumes across different wears.\n - Identify top-performing market segments.", "operationId": "compareMarketIndexSegments", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "type", "in": "query", "description": "Segment type to compare. All segments of this type will be compared.\n\n**Available types:**\n- `item_group`: Compare weapon categories\n- `rarity`: Compare by rarity tier\n- `wear`: Compare skin conditions\n- `quality`: Compare item qualities\n- `stattrak`: Compare StatTrak vs non-StatTrak\n- `collection`: Compare game collections", "required": true, "schema": { "type": "string", "enum": [ "item_group", "rarity", "wear", "quality", "stattrak", "collection" ] } }, { "name": "keys", "in": "query", "description": "Comma-separated segment keys to filter. If empty, all segments of the type are compared.\n\n**Examples:**\n- `knife,glove,rifle` for item_group\n- `Covert,Classified,Restricted` for rarity\n- `fn,mw,ft` for wear", "required": false, "schema": { "type": "string" } }, { "name": "metric", "in": "query", "description": "Metric to compare segments by. Default: `price_index`\n\n**Available metrics:**\n- `price_index`: Sum of all item prices in segment\n- `turnover`: 24h trading volume (estimated)\n- `sold24h`: Number of items sold in 24h\n- `avg_price`: Average item price\n- `listing_value`: Total value of all listings\n- `order_book_value`: Total value of all buy orders", "required": false, "schema": { "type": "string", "enum": [ "price_index", "turnover", "sold24h", "avg_price", "listing_value", "order_book_value" ] } }, { "name": "format", "in": "query", "description": "Response format. Default: `json`. Available: csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo", "required": false, "schema": { "type": "string" } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON (set to 1 for json/gzip/zip formats). Default: `0`", "required": false, "schema": { "type": "string", "enum": [ "0", "1" ] } } ], "responses": { "200": { "description": "Segment comparison", "content": { "application/json": { "schema": {}, "example": { "success": true, "type": "rarity", "metric": "price_index", "total": 2384593.56, "count": 15, "segments": [ { "key": "Covert", "value": 1464937.56, "itemcount": 4279, "pct": 61.43 }, { "key": "Classified", "value": 583920.18, "itemcount": 8472, "pct": 24.49 }, { "key": "Restricted", "value": 218493.27, "itemcount": 9841, "pct": 9.16 } ] } } } }, "400": { "description": "Missing type parameter", "content": { "application/json": { "schema": {}, "example": { "success": false, "error": "Parameter \"type\" is required." } } } } } } }, "/market/{market}/prices": { "get": { "tags": [ "Market Prices" ], "summary": "Latest prices for any market (generic by ident)", "description": "Baseurl: https://www.steamwebapi.com/market/{market}/prices?key=YOUR_API_KEY\n\n **This is a premium endpoint.**\n - Requires Items access in your package (same rate limits as `/steam/api/items`).\n - Replace `{market}` with the market ident (e.g. `buff`, `csfloat`, `youpin`, `skinport`).\n - Returns the freshest prices from the most recent scrape run for that market.\n - Prices are returned in USD by default; pass `currency` to convert.\n\n **Parameters:**\n - **`key`**: Your API key (required).\n - **`market_hash_name`**: Filter to a single item (optional).\n - **`currency`**: Convert prices (optional, default USD).", "operationId": "get_market_prices", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication.", "required": true }, { "name": "market_hash_name", "in": "query", "description": "Filter by item name.", "required": false }, { "name": "currency", "in": "query", "description": "Convert prices to a specific currency. Default: USD.", "required": false }, { "name": "market", "in": "path", "required": true, "schema": { "type": "string", "pattern": "[a-z0-9_-]+" } } ], "responses": { "200": { "description": "Latest market prices returned successfully." }, "402": { "description": "Rate limit exceeded or insufficient access." }, "404": { "description": "Market unknown, no prices, or item not found." } } } }, "/markets/prices": { "get": { "tags": [ "Market Prices" ], "summary": "Latest prices across ALL markets (grouped per item)", "description": "Baseurl: https://www.steamwebapi.com/markets/prices?key=YOUR_API_KEY\n\n **This is a premium endpoint.**\n - Requires Items access in your package (same rate limits as `/steam/api/items`).\n - Returns the latest prices across **all configured markets** in one payload.\n - Each item appears once with a nested `prices` object keyed by market ident\n (`buff`, `csfloat`, `youpin`, ...). Items missing on a market are omitted from\n that market's slot.\n\n **Parameters:**\n - **`key`**: Your API key (required).\n - **`market_hash_name`**: Restrict to a single item \u2014 strongly recommended for low latency.\n - **`markets`**: Comma-separated ident allowlist (e.g. `buff,csfloat`). Default: every active market.\n - **`currency`**: Convert prices (optional, default USD).", "operationId": "get_markets_prices_all", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication.", "required": true }, { "name": "market_hash_name", "in": "query", "description": "Restrict to a single item.", "required": false }, { "name": "markets", "in": "query", "description": "Comma-separated market ident allowlist (e.g. \"buff,csfloat,youpin\").", "required": false }, { "name": "currency", "in": "query", "description": "Convert prices. Default: USD.", "required": false } ], "responses": { "200": { "description": "Cross-market latest prices returned successfully.", "content": { "application/json": { "schema": {}, "example": [ { "market_hash_name": "AK-47 | Redline (Field-Tested)", "prices": { "buff": { "price": 12.45, "quantity": 1523, "createdat": "2026-02-20T00:00:00+00:00" }, "csfloat": { "price": 13.2, "quantity": 50, "createdat": "2026-02-20T00:00:00+00:00" }, "youpin": { "price": 11.99, "quantity": 320, "createdat": "2026-02-20T00:00:00+00:00" } } } ] } } }, "402": { "description": "Rate limit exceeded or insufficient access." }, "404": { "description": "Item not found or no prices available." } } } }, "/markets/history": { "get": { "tags": [ "Market Prices" ], "summary": "Price history across ALL markets for one item", "description": "Baseurl: https://www.steamwebapi.com/markets/history?key=YOUR_API_KEY&market_hash_name=ITEM\n\n **What this endpoint does:**\n - Returns daily price history for a single item across **all configured markets** in one payload.\n - Response groups history rows by market ident.\n\n **Parameters:**\n - **`key`**: Your API key (required).\n - **`market_hash_name`**: The item to get history for (required).\n - **`markets`**: Comma-separated market ident allowlist (optional).\n - **`start_date`** / **`end_date`**: Date range (YYYY-MM-DD, optional).\n - **`currency`**: Convert prices (optional, default USD).\n\n **Important:**\n - History is stored daily (1 entry per item per market per day).\n - Uses 2 credits per request.", "operationId": "get_markets_history_all", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication.", "required": true }, { "name": "market_hash_name", "in": "query", "description": "The item name.", "required": true }, { "name": "markets", "in": "query", "description": "Comma-separated market ident allowlist.", "required": false }, { "name": "start_date", "in": "query", "description": "Start date (YYYY-MM-DD).", "required": false }, { "name": "end_date", "in": "query", "description": "End date (YYYY-MM-DD).", "required": false }, { "name": "currency", "in": "query", "description": "Convert prices. Default: USD.", "required": false } ], "responses": { "200": { "description": "Cross-market history returned successfully.", "content": { "application/json": { "schema": {}, "example": { "market_hash_name": "AK-47 | Redline (Field-Tested)", "history": { "buff": [ { "createdat": "2026-02-20T00:00:00+00:00", "price": 12.45, "quantity": 1523 } ], "csfloat": [ { "createdat": "2026-02-20T00:00:00+00:00", "price": 13.2, "quantity": 50 } ] } } } } }, "400": { "description": "Missing market_hash_name or invalid date format." }, "402": { "description": "Rate limit exceeded." }, "404": { "description": "Item not found or no history." } } } }, "/market/{market}/history": { "get": { "tags": [ "Market Prices" ], "summary": "Price history for an item on any market (generic by ident)", "description": "Baseurl: https://www.steamwebapi.com/market/{market}/history?key=YOUR_API_KEY&market_hash_name=ITEM\n\n \ud83d\udcac **What this endpoint does:**\n - Returns the price history for a specific CS2 item on the chosen market.\n - Replace `{market}` with the market ident (e.g. `buff`, `csfloat`, `youpin`, `skinport`).\n\n \ud83d\udee0\ufe0f **Parameters:**\n - **`key`**: Your API key (required).\n - **`market_hash_name`**: The item to get history for (required).\n - **`start_date`** / **`end_date`**: Optional date range (YYYY-MM-DD).\n - **`currency`**: Convert prices (optional, default USD).\n\n \u26a1 **Important:**\n - History is stored daily.\n - Uses 2 credits per request.", "operationId": "get_market_history", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication.", "required": true }, { "name": "market_hash_name", "in": "query", "description": "The item name. Example: \"AK-47 | Redline (Field-Tested)\".", "required": true }, { "name": "start_date", "in": "query", "description": "Start date (format: YYYY-MM-DD).", "required": false }, { "name": "end_date", "in": "query", "description": "End date (format: YYYY-MM-DD).", "required": false }, { "name": "currency", "in": "query", "description": "Convert prices to a specific currency. Default: USD.", "required": false }, { "name": "market", "in": "path", "required": true, "schema": { "type": "string", "pattern": "[a-z0-9_-]+" } } ], "responses": { "200": { "description": "Price history returned successfully." }, "400": { "description": "Invalid date format or missing market_hash_name." }, "402": { "description": "Rate limit exceeded." }, "404": { "description": "Market unknown, item not found, or no history." } } } }, "/steam/api/profile": { "get": { "tags": [ "Profile" ], "summary": "\ud83d\udc64 Retrieve a Steam User's Profile with Flexible Options", "description": "Baseurl: https://www.steamwebapi.com/steam/api/profile?id=760000022222&key=YOUR_API_KEY\n\n \ud83d\udcac **What this endpoint does:**\n - Fetches a Steam user profile with flexible options.\n - Supports detailed or minimal data retrieval based on your needs.\n\n \ud83d\udee0\ufe0f **Features:**\n - Use the `id` parameter to identify the profile. Supports SteamID, username, or profile URL (SteamID recommended for faster and more accurate results).\n - Retrieve real-time data by setting `no_cache` to `1` (slower response).\n - Adjust the data depth using the `state` parameter (`minimal` or `detailed`).\n - Optimize responses with the `force_from_db_if_exists` parameter to fetch profiles from the database if available.\n\n \ud83c\udf10 **How to use:**\n - Provide a valid `id` parameter (SteamID, profile URL, or username).\n - Use optional parameters to customize data retrieval (e.g., `state=detailed` for additional profile details).", "operationId": "get_get_api_profile", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "id", "in": "query", "description": "Required. Identifier for the profile. Accepts:\n - SteamID (recommended for speed and accuracy).\n - Profile URL.\n - Username.", "required": true }, { "name": "no_cache", "in": "query", "description": "Optional. Set to `1` to bypass the cache and fetch data directly from Steam.\n - Default: Cached data (faster).", "required": false, "example": 1 }, { "name": "state", "in": "query", "description": "Optional. Defines the level of profile detail:\n - `minimal` (default): Basic profile data.\n - `detailed`: Includes additional details like level, trade ban info, and friend states (slower).", "required": false, "example": "detailed" }, { "name": "force_from_db_if_exists", "in": "query", "description": "Optional. Set to `1` to retrieve the profile from the database if available.\n - If not found, fresh data will be fetched and cached automatically.\n - Useful for rapid responses without impacting rate limits.", "required": false, "example": 1 }, { "name": "with_groups", "in": "query", "description": "Optional. Set to `1` to include the profile's Steam group memberships in the response.\n - Default: `0` (groups omitted to keep responses small).\n - When enabled, a `groups` array is returned (group id, name, url, primary flag, avatars, member counts).", "required": false, "example": 1 }, { "name": "production", "in": "query", "description": "If you run in production, please set this to 1. Default is 0. This is in future required, and if not set, you will get a warning.", "required": false }, { "name": "format", "in": "query", "description": "Response format: json (default), csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo. Example: ?format=csv", "required": false, "schema": { "type": "string", "default": "json" } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON (set to 1 for json/gzip/zip formats). Example: ?format=json&pretty=1", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } } ], "responses": { "200": { "description": "Profile retrieved successfully.", "content": { "application/json": { "schema": {}, "example": { "steamid": "76561199089187556", "personaname": "\u042d\u0440\u0438\u043a \u0428\u043e\u043a\u043e\u0432 13 y.o.", "accountname": "z0nai", "profileurl": "z0nai", "profilesteamurl": "https://steamcommunity.com/id/z0nai", "avatarhash": "c6a753e13bc54443e7b5a1d9ae0908fc2e99d6f9", "avatar": "https://avatars.cloudflare.steamstatic.com/c6a753e13bc54443e7b5a1d9ae0908fc2e99d6f9.jpg", "avatarmedium": "https://avatars.cloudflare.steamstatic.com/c6a753e13bc54443e7b5a1d9ae0908fc2e99d6f9_medium.jpg", "avatarfull": "https://avatars.cloudflare.steamstatic.com/c6a753e13bc54443e7b5a1d9ae0908fc2e99d6f9_full.jpg", "realname": null, "communityvisibilitymessage": "public", "communityvisibilitystate": 3, "profilestate": 1, "onlinestate": "in-game", "ingameinfo": { "gamename": "Mindustry", "gamelink": "https://steamcommunity.com/app/1127400" }, "timecreated": 1599523200, "timecreatedat": "2020-09-08T00:00:00+00:00", "location": "Kirov, Russian Federation", "loccountrycode": "RU", "summary": "\u043b\u043e\u043c\u0430\u044e \u043a\u043e\u0440 \u0430\u0439 5 \u0432 \u0431\u043b\u0435\u043d\u0434\u0435\u0440\u0435", "vac": 0, "islimited": 0, "mostplayedgamestotalplaytime": 825, "mostplayedgames2weeksplaytime": 48.1, "mostplayedgamesappids": [ 730, 105600, 365670, 431960, 881100, 307950 ], "mostplayedgames": [ { "gamename": "Counter-Strike 2", "gamelink": "https://steamcommunity.com/app/730", "appid": 730, "gameicon": "https://cdn.cloudflare.steamstatic.com/steamcommunity/public/images/apps/730/8dbc71957312bbd3baea65848b545be9eae2a355.jpg", "gamelogo": "https://shared.cloudflare.steamstatic.com/store_item_assets/steam/apps/730/capsule_184x69.jpg?t=1745368595", "gamelogosmall": "https://shared.cloudflare.steamstatic.com/store_item_assets/steam/apps/730/capsule_184x69.jpg?t=1745368595", "playtimelast2weeks": 23, "hoursonrecord": 688, "statsname": "CSGO" } ], "mostplayedgamestimes": [ { "appid": 730, "playtimelast2weeks": 23, "hoursonrecord": 688 } ] } } } }, "400": { "description": "Missing required \"id\" parameter." }, "404": { "description": "Profile not found. The \"id\" is valid but no such Steam profile exists (Steam returned a \"could not be found\" response)." }, "503": { "description": "Steam upstream temporarily unavailable (rate limit, timeout, captcha, proxy issue). The profile may exist \u2014 retry after the Retry-After interval. Not cached." } } } }, "/steam/api/profile/batch": { "get": { "tags": [ "Profile" ], "summary": "\ud83d\udc65 Retrieve Multiple Steam User Profiles in a Single Request", "description": "Baseurl: https://www.steamwebapi.com/steam/api/profile/batch?id=steamid1,steamid2,steamid3&key=YOUR_API_KEY\n\n \ud83d\udcac **What this endpoint does:**\n - Fetches multiple Steam user profiles in a single request.\n - Each Steam ID costs 1 credit.\n - Maximum of 20 Steam IDs per request.\n\n \ud83c\udf10 **How to use:**\n - Provide a comma-separated list of Steam IDs using the `id` parameter.\n - Example: `id=76561198165178872,76561199759031383`", "operationId": "get_get_api_profile_batch", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "id", "in": "query", "description": "Required. Comma-separated list of Steam IDs. Maximum 20 IDs.", "required": true }, { "name": "state", "in": "query", "description": "Optional. Defines the level of profile detail:\n - `minimal` (default): Basic profile data.\n - `detailed`: Includes additional details like level, trade ban info, and friend states (slower).", "required": false, "example": "minimal" }, { "name": "with_groups", "in": "query", "description": "Optional. Set to `1` to include each profile's Steam group memberships (`groups` array). Default `0` (omitted to keep responses small).", "required": false, "example": 1 }, { "name": "format", "in": "query", "description": "Response format: json (default), csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo. Example: ?format=csv", "required": false, "schema": { "type": "string", "default": "json" } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON (set to 1 for json/gzip/zip formats). Example: ?format=json&pretty=1", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } } ], "responses": { "200": { "description": "Profiles retrieved successfully.", "content": { "application/json": { "schema": {}, "example": { "response": { "players": [ { "steamid": "76561198165178872", "personaname": "koto", "accountname": "76561198165178872", "profileurl": null, "profilesteamurl": "https://steamcommunity.com/profiles/76561198165178872", "avatarhash": "62e1b12ed93a6d952866a1088c95454ae2774c09", "avatar": "https://avatars.fastly.steamstatic.com/62e1b12ed93a6d952866a1088c95454ae2774c09.jpg", "avatarmedium": "https://avatars.fastly.steamstatic.com/62e1b12ed93a6d952866a1088c95454ae2774c09_medium.jpg", "avatarfull": "https://avatars.fastly.steamstatic.com/62e1b12ed93a6d952866a1088c95454ae2774c09_full.jpg", "realname": "Dan", "communityvisibilitymessage": "public", "communityvisibilitystate": 3, "profilestate": 1, "onlinestate": "offline", "ingameinfo": [], "timecreated": 1416960000, "timecreatedat": "2014-11-26T00:00:00+00:00", "location": "Ukraine", "loccountrycode": "UA", "summary": "Summary text", "vac": 0, "islimited": 0 }, { "steamid": "76561199759031383", "communityvisibilitystate": 1, "profilestate": 1, "personaname": "WalterWhitesSmegma", "profileurl": "https://steamcommunity.com/profiles/76561199759031383/", "avatar": "https://avatars.steamstatic.com/fe4c1095f435b84d45a494c377764144f06e1310.jpg", "avatarmedium": "https://avatars.steamstatic.com/fe4c1095f435b84d45a494c377764144f06e1310_medium.jpg", "avatarfull": "https://avatars.steamstatic.com/fe4c1095f435b84d45a494c377764144f06e1310_full.jpg", "avatarhash": "fe4c1095f435b84d45a494c377764144f06e1310", "personastate": 0 } ] } } } } }, "400": { "description": "Missing required \"id\" parameter or too many IDs." } } } }, "/steam/api/profile/trade-eligibility": { "get": { "tags": [ "Profile" ], "summary": "\ud83d\udd04 Check Steam Trade Eligibility and Escrow Status", "description": "Baseurl: https://www.steamwebapi.com/steam/api/profile/trade-eligibility?trade_url=YOUR_TRADE_URL&key=YOUR_API_KEY\n\n \ud83d\udcac **What this endpoint does:**\n - Checks the trade eligibility status for a given Steam trade URL.\n - Verifies if the trade URL is valid and determines if there are any escrow holds.\n\n \ud83d\udee0\ufe0f **Features:**\n - Validates the provided trade URL.\n - Returns information about escrow days (trade holds).\n - Indicates whether trades will be instant or delayed.\n\n \ud83c\udf10 **How to use:**\n - Provide a valid `trade_url` parameter.\n - Check the response to determine if the trade URL is valid and if there are any escrow holds.", "operationId": "get_profile-trade-eligibility", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "trade_url", "in": "query", "description": "Required. The Steam trade URL to check for eligibility. \n - Must be a valid Steam trade URL.\n - Can also be provided as `tradeurl` or `tradeUrl`.", "required": true } ], "responses": { "200": { "description": "Trade eligibility information retrieved successfully.", "content": { "application/json": { "schema": {}, "example": { "tradeurlvalid": true, "escrowdays": 0, "isescrow": false, "status": "instant" } } } }, "400": { "description": "Missing trade_url parameter." }, "500": { "description": "Error on service or failed to retrieve trade eligibility information." } } } }, "/proxy/api": { "get": { "tags": [ "Proxy" ], "summary": "Proxy API no limits, no blocking", "description": "Utilize our Proxy API to crawl any URL you need. This API is designed for users who want to crawl raw URLs, but it's important to note that you can only crawl Whitelisted URLs. If you wish to add more URLs to the whitelist, please contact us via Discord. You can find the list of Whitelisted URLs by sending a request to the specified Endpoint.", "operationId": "get_app_proxy", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication, located in your Dashboard (TOP RIGHT)", "required": true }, { "name": "url", "in": "query", "description": "The URL of the requested Site. You need to URI Encode the URl, because you need to send that as query param. Like: steamwebapi.com/proxy/api/?url=https%3A%2F%2Fsteamcommunity.com%", "required": true }, { "name": "format", "in": "query", "description": "Response format: json (default), csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo. Example: ?format=csv", "required": false, "schema": { "type": "string", "default": "json" } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON (set to 1 for json/gzip/zip formats). Example: ?format=json&pretty=1", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } } ], "responses": { "default": { "description": "" } } } }, "/proxy/api/premium": { "get": { "tags": [ "Proxy" ], "summary": "Premium Proxy API - Enhanced performance and higher limits", "description": "Utilize our Premium Proxy API for enhanced performance and higher limits. This premium service offers faster response times, dedicated proxy servers, and increased rate limits. Premium access is required - contact us via Discord if you need premium access. You can only crawl Whitelisted URLs.", "operationId": "get_app_proxy_premium", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication, located in your Dashboard (TOP RIGHT)", "required": true }, { "name": "url", "in": "query", "description": "The URL of the requested Site. You need to URI Encode the URl, because you need to send that as query param. Like: steamwebapi.com/proxy/api/premium/?url=https%3A%2F%2Fsteamcommunity.com%", "required": true }, { "name": "format", "in": "query", "description": "Response format: json (default), csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo. Example: ?format=csv", "required": false, "schema": { "type": "string", "default": "json" } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON (set to 1 for json/gzip/zip formats). Example: ?format=json&pretty=1", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } } ], "responses": { "default": { "description": "" } } } }, "/steam/api/guard/code": { "post": { "tags": [ "Steam Guard" ], "summary": "\ud83d\udd10 Generate a Steam Guard login code", "description": "Generates the current 5-character Steam Guard login code (TOTP) from a sharedsecret \u2014 the same code the Steam mobile app shows. Stateless: the secret is supplied in the body and never stored.", "operationId": "post_sda_guard_code", "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "sharedsecret" ], "properties": { "sharedsecret": { "type": "string", "format": "password", "example": "base64-or-hex-shared-secret" }, "steamid": { "description": "Optional, only used to derive a device id.", "type": "string", "example": "76561198000000000" }, "deviceid": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Current Steam Guard code with expiry information." }, "402": { "description": "Requires Trade API access \u2014 shares the \"trade\" rate limit." }, "421": { "description": "Missing or invalid JSON body." }, "422": { "description": "Validation failed." } } } }, "/steam/api/guard/confirmations/list": { "post": { "tags": [ "Steam Guard" ], "summary": "\ud83d\udccb List pending mobile confirmations", "description": "Lists pending mobile trade/market confirmations \u2014 the same confirmations the Steam mobile app shows under \"Confirmations\". Requires identitysecret + a valid steamloginsecure session.", "operationId": "post_sda_guard_confirmations_list", "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "identitysecret", "steamloginsecure", "steamid" ], "properties": { "identitysecret": { "type": "string", "format": "password" }, "steamloginsecure": { "type": "string", "format": "password" }, "steamid": { "type": "string", "example": "76561198000000000" }, "deviceid": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "List of pending confirmations." }, "401": { "description": "steamloginsecure invalid or expired." }, "402": { "description": "Requires Trade API access \u2014 shares the \"trade\" rate limit." }, "422": { "description": "Validation failed." }, "502": { "description": "Unexpected Steam response." }, "503": { "description": "Steam unreachable." } } } }, "/steam/api/guard/confirmations/confirm": { "post": { "tags": [ "Steam Guard" ], "summary": "\u2705 Accept or deny confirmations (one or many)", "description": "Accepts or denies one OR many mobile confirmations. Provide either a `confirmations` array of {id, key} pairs, or a single `confid` + `confkey` (the Steam getlist `id` and `nonce`). op: allow/accept to confirm, cancel/deny to reject. Charges one credit per confirmation acted on.", "operationId": "post_sda_guard_confirmations_confirm", "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "identitysecret", "steamloginsecure", "steamid", "op" ], "properties": { "identitysecret": { "type": "string", "format": "password" }, "steamloginsecure": { "type": "string", "format": "password" }, "steamid": { "type": "string", "example": "76561198000000000" }, "confirmations": { "description": "List of {id, key} pairs to act on \u2014 for one or many. Alternatively send a single confid + confkey.", "type": "array", "items": { "properties": { "id": { "type": "string" }, "key": { "type": "string" } }, "type": "object" } }, "confid": { "description": "Single confirmation id (alternative to `confirmations`).", "type": "string" }, "confkey": { "description": "Single confirmation `nonce` (alternative to `confirmations`).", "type": "string" }, "op": { "type": "string", "enum": [ "allow", "cancel", "accept", "deny" ] }, "deviceid": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Per-confirmation results (always an array, even for a single confirmation)." }, "401": { "description": "steamloginsecure invalid or expired." }, "402": { "description": "Requires Trade API access \u2014 shares the \"trade\" rate limit." }, "422": { "description": "Validation failed, or neither confirmations nor confid/confkey provided." } } } }, "/steam/api/guard/confirmations/details": { "post": { "tags": [ "Steam Guard" ], "summary": "\ud83d\udd0e Confirmation details", "description": "Fetches the detail view of a single confirmation (mobileconf/details) so you can inspect what a trade contains before confirming.", "operationId": "post_sda_guard_confirmations_details", "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "identitysecret", "steamloginsecure", "steamid", "confid" ], "properties": { "identitysecret": { "type": "string", "format": "password" }, "steamloginsecure": { "type": "string", "format": "password" }, "steamid": { "type": "string", "example": "76561198000000000" }, "confid": { "type": "string" }, "deviceid": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Confirmation detail payload." }, "401": { "description": "steamloginsecure invalid or expired." }, "402": { "description": "Requires Trade API access \u2014 shares the \"trade\" rate limit." } } } }, "/steam/api/guard/confirmations/confirm-all": { "post": { "tags": [ "Steam Guard" ], "summary": "\u26a1 Auto-confirm all (one-shot)", "description": "One-shot auto-confirm: lists confirmations, filters by type (trade/market/all) and acts on all matching ones in a single request. Charges one credit per confirmation acted on.", "operationId": "post_sda_guard_confirmations_confirm_all", "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "identitysecret", "steamloginsecure", "steamid", "type" ], "properties": { "identitysecret": { "type": "string", "format": "password" }, "steamloginsecure": { "type": "string", "format": "password" }, "steamid": { "type": "string", "example": "76561198000000000" }, "type": { "type": "string", "enum": [ "trade", "market", "all" ] }, "op": { "type": "string", "default": "allow", "enum": [ "allow", "cancel", "accept", "deny" ] }, "deviceid": { "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Number of confirmations acted on plus per-confirmation results." }, "401": { "description": "steamloginsecure invalid or expired." }, "402": { "description": "Requires Trade API access \u2014 shares the \"trade\" rate limit." }, "422": { "description": "Validation failed." } } } }, "/steam/api/guard/add": { "post": { "tags": [ "Steam Guard" ], "summary": "\ud83c\udd95 Add / activate authenticator (maFile, both steps)", "description": "Generates a Steam mobile authenticator (maFile) \u2014 the full lifecycle in ONE endpoint. The step is auto-detected from the parameters (or force it with `step`: 1/2).\n\nSTEP 1 (add) \u2014 send `username` + `password`. If the account uses email Steam Guard, the first call returns HTTP 200 `{ \"state\": \"NEED_EMAIL_CODE\", \"loginsession\": \"...\", \"nextrequest\": {...} }`; read the emailed code and call again with `emailcode` + `loginsession`. On success you get the maFile + accesstoken and Steam sends an SMS.\n\nSTEP 2 (finalize) \u2014 send `sharedsecret` + `accesstoken` (both from step 1) + `activationcode` (the code Steam sent, by SMS or email). Alternatively send the whole `mafile` + `activationcode` (sharedsecret/accesstoken are then read from it). `smscode` and `emailcode` are accepted as aliases for `activationcode`. The presence of `sharedsecret`, a `mafile`, or an activation code selects this step.\n\nWorks with or without a phone number: with a phone Steam sends the activation code by SMS, otherwise by email. Set `mafiledownload` to true (step 1) to receive the maFile as a downloadable `.maFile`. IMPORTANT: store the revocation_code \u2014 it cannot be recovered.", "operationId": "post_sda_guard_add", "requestBody": { "required": true, "content": { "application/json": { "schema": { "properties": { "username": { "description": "Step 1.", "type": "string" }, "password": { "description": "Step 1.", "type": "string", "format": "password" }, "emailcode": { "description": "Step 1 \u2014 email Steam Guard code (after the first call triggered it).", "type": "string" }, "loginsession": { "description": "Step 1 \u2014 continuation token from the NEED_EMAIL_CODE response.", "type": "string" }, "mafile": { "description": "Step 2 (optional) \u2014 the whole maFile from step 1; sharedsecret + accesstoken are read from it automatically.", "type": "object" }, "activationcode": { "description": "Step 2 \u2014 the activation code Steam sent, by SMS if the account has a phone, otherwise by EMAIL. `smscode` and `emailcode` are accepted as aliases.", "type": "string" }, "step": { "description": "Optional: force the step (1 = add, 2 = finalize).", "type": "string", "enum": [ "1", "2" ] }, "mafiledownload": { "description": "If true, respond with the maFile as a file attachment instead of JSON.", "type": "boolean", "default": false } }, "type": "object" } } } }, "responses": { "200": { "description": "Add (login): AWAITING_FINALIZATION \u2014 the maFile (with fully_enrolled already set to true so the saved file is final-ready), accesstoken, a mafiledownloadlink (a stateless data: URI that downloads the maFile) and mafilefilename (the .maFile name to use with an ) \u2014 or NEED_EMAIL_CODE (loginsession). Finalize: confirmation that the mobile authenticator is now active. With mafiledownload=true: the maFile as a file attachment." }, "402": { "description": "Requires Trade API access \u2014 shares the \"trade\" rate limit." }, "409": { "description": "The account already has an authenticator." }, "422": { "description": "Validation failed, or the email/activation code was required or rejected." }, "502": { "description": "Steam rejected the request." }, "503": { "description": "Steam unreachable." } } } }, "/steam/api/guard/remove": { "post": { "tags": [ "Steam Guard" ], "summary": "\ud83d\uddd1\ufe0f Remove authenticator", "description": "Deactivates the authenticator. Logs in with the current Guard code (from sharedsecret) to obtain an access token, then revokes using the revocationcode. This switches the account back to email Steam Guard.", "operationId": "post_sda_guard_remove", "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "username", "password", "sharedsecret", "revocationcode" ], "properties": { "username": { "type": "string" }, "password": { "type": "string", "format": "password" }, "sharedsecret": { "type": "string", "format": "password" }, "revocationcode": { "type": "string", "example": "R12345" } }, "type": "object" } } } }, "responses": { "200": { "description": "Authenticator removed." }, "401": { "description": "Login failed." }, "402": { "description": "Requires Trade API access \u2014 shares the \"trade\" rate limit." }, "422": { "description": "Validation failed." }, "502": { "description": "Steam rejected the removal." }, "503": { "description": "Steam unreachable." } } } }, "/steam/api/itemordersactivity": { "get": { "tags": [ "Items" ], "summary": "\ud83d\udce6 Retrieve Realtime Order Activity for a Steam Item", "description": "Baseurl: https://www.steamwebapi.com/steam/api/itemordersactivity?key=YOUR_API_KEY&nameid=UNIQUE_NAMEID\n\n \ud83d\udcac **What this endpoint does:**\n - Retrieves order activity details for a specified Steam item.\n - Includes information such as:\n - \ud83c\udf0d Regional data based on country code.\n - \ud83d\udde3\ufe0f Language-specific details.\n - \ud83d\udcb2 Price information in the specified currency.\n\n \ud83d\udee0\ufe0f **How to use:**\n - Provide the `market_hash_name` parameter to specify the item.\n - Optionally, customize the `country`, `language`, and `currency` parameters for tailored results.", "operationId": "get_steam_item_orders_activity", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "market_hash_name", "in": "query", "description": "Required. The `market_hash_name` of the item. Example: `AK-47 | Redline (Field-Tested)`.", "required": true, "example": "AK-47 | Redline (Field-Tested)" }, { "name": "country", "in": "query", "description": "Country code for regional data. Optional. Default is `EN`.", "required": false, "example": "US" }, { "name": "language", "in": "query", "description": "Language code for localization. Optional. Default is `english`.", "required": false, "example": "english" }, { "name": "currency", "in": "query", "description": "Currency code for prices. Optional. Default is `1` (USD).", "required": false, "example": 1 }, { "name": "production", "in": "query", "description": "If you run in production, please set this to 1. Default is 0. This will be required in the future, and if not set, you will get a warning.", "required": false }, { "name": "format", "in": "query", "description": "Response format: json (default), csv, xml, html, gzip, zip, ndjson, mysql, mysql_with_table, pgsql, pgsql_with_table, mongo. Example: ?format=csv", "required": false, "schema": { "type": "string", "default": "json" } }, { "name": "pretty", "in": "query", "description": "Pretty-print JSON (set to 1 for json/gzip/zip formats). Example: ?format=json&pretty=1", "required": false, "schema": { "type": "string", "default": "0", "enum": [ "0", "1" ] } } ], "responses": { "200": { "description": "Request was successful" }, "400": { "description": "Invalid parameters provided." }, "404": { "description": "Item not found." }, "502": { "description": "Failed to fetch data from Steam API." } } } }, "/steam/api/steamloginsecure": { "post": { "tags": [ "Account" ], "summary": "\ud83d\udce6 Automate Steam Login Process", "description": "Baseurl: https://www.steamwebapi.com/steam/api/steamloginsecure\n\n \ud83d\udcac **What this endpoint does:**\n - Automates your Steam login process, including for trading, market, and other Steam Community features.\n - With the `steamLoginSecure` cookie, you can use our Trading API and build easy-to-use trading bots, market trackers, and more.\n\n \ud83d\udee0\ufe0f **How to use:**\n There are **two ways to authenticate**:\n\n 1. **Username + Password Login**\n - Send a POST request with your Steam `username` and `password` in the request body.\n - If your account is protected by Steam Guard, include the `code` parameter from your mobile authenticator.\n\n 2. **Refresh Token Login**\n - Instead of username/password, you can provide a `steamrefreshtoken` (JWT).\n - This token is returned after the initial login and allows you to request a fresh `steamLoginSecure` cookie without needing to re-enter credentials.\n\n \ud83d\udea8 **Important Note:**\n - Do **not** provide both login credentials and `steamrefreshtoken` at the same time.\n - One of the two options must be present, not both.\n\n \ud83c\udf10 **Additional Info:**\n - The login process is handled securely. No password is stored server-side.\n - This endpoint is ideal for building:\n - Trading bots\n - Market analyzers\n - Automated session checkers\n\n \ud83d\udce6 **Response:**\n - On success, you will receive the following cookies:\n - `steamLoginSecure` \u2013 required for authenticated Steam Community actions\n - `sessionid` \u2013 required for most web interactions\n - `browserid` \u2013 identifies the browser/session\n - `steamrefreshtoken` \u2013 reusable token to fetch new `steamLoginSecure` cookies later\n\n \ud83d\udd52 **Token Lifespan**\n - The `steamrefreshtoken` is typically valid for **up to 6 months**\n - It can be used repeatedly to retrieve new `steamLoginSecure` cookies without logging in again.", "operationId": "post_steamloginsecure_api", "requestBody": { "description": "JSON payload containing the required parameters for Steam login.\n\n There are two ways to authenticate:\n - Via `username` + `password` (optionally if Guard is active you need MFA File then shared_secret as `code` - NOT GUARD CODE)\n - Or via `steamrefreshtoken` only\n\n \u26a0\ufe0f You must provide either (username + password) or steamrefreshtoken \u2013 but not both.", "content": { "application/json": { "schema": { "properties": { "username": { "description": "Your Steam username (optional if steamrefreshtoken is provided)", "type": "string", "example": "user123" }, "password": { "description": "Your Steam account password (optional if steamrefreshtoken is provided)", "type": "string", "example": "password123" }, "code": { "description": "- optional - Steam Guard code (optional, only if Steam Guard is enabled)", "type": "string", "example": "123456" }, "steamrefreshtoken": { "description": "optional, this you will get after first login - This is the second auth method - A long-lived refresh token (JWT) that can be used to request a new steamLoginSecure at any time.", "type": "string", "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." } }, "type": "object" } } } }, "responses": { "200": { "description": "Successfully logged in to Steam. Cookies are returned.", "content": { "application/json": { "schema": { "properties": { "success": { "type": "boolean", "example": true }, "message": { "type": "string", "example": "Successfully logged in to steamcommunity.com" }, "cookies": { "properties": { "steamloginsecure": { "type": "string", "example": "steamLoginSecureToken..." }, "steamloginsecureexp": { "type": "string", "format": "date-time", "example": "2025-04-01T12:00:00+00:00" }, "steamrefreshtoken": { "type": "string", "example": "steamId||refreshToken..." }, "steamrefreshtokenexp": { "type": "string", "format": "date-time" }, "sessionid": { "type": "string", "example": "xyz123" }, "browserid": { "type": "string", "example": "abc456" }, "steamid": { "type": "string", "example": "76561198000000000" } }, "type": "object" } }, "type": "object" } } } }, "411": { "description": "Invalid username or password provided." }, "412": { "description": "Failed to retrieve valid cookies from Steam." }, "413": { "description": "SteamLoginSecure is invalid." }, "421": { "description": "Invalid request body or missing required parameters." }, "429": { "description": "Rate limit exceeded. Try again later." } } } }, "/steam/api/trade/create": { "post": { "tags": [ "Tradeoffer" ], "summary": "\ud83d\udce6 Create a Trade Offer on Steam", "description": "Baseurl: https://www.steamwebapi.com/steam/api/trade/create?key=YOUR_API_KEY\n\n \ud83d\udcac **What this endpoint does:**\n - Initiates a new trade offer for a specific user.\n - Requires a valid `steamloginsecure`, retrievable from Steam cookies.\n\n \ud83d\udee0\ufe0f **Features:**\n - Supports sending items (`myitemassetids`) and requesting items (`partneritemassetids`).\n - Trade link and partner Steam ID ensure secure targeting.\n - Includes a custom message option for the trade.\n\n \ud83c\udf10 **How to use:**\n - Provide required parameters in a JSON payload.\n - Use optional parameters like `game` for game-specific trade offers.", "operationId": "post_createTradeOffer", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "production", "in": "query", "description": "If you run in production, please set this to 1. Default is 0. This is in future required, and if not set, you will get a warning.", "required": false } ], "requestBody": { "description": "JSON payload containing the required parameters for initiating a new trade offer:\n - **steamloginsecure**: Cookie value for Steam authentication.\n - **partneritemassetids**/**myitemassetids**: Asset IDs for items to trade.\n - **tradelink**: Trade link of the user.\n - **partnersteamid**: Steam ID of the trade partner.\n - **message**: Optional message for the trade offer.", "required": true, "content": { "application/json": { "schema": { "required": [ "steamloginsecure", "tradelink", "partnersteamid", "message" ], "properties": { "steamloginsecure": { "description": "SteamLoginSecure from the cookie of steamcommunity.com or via our extension for automated retrieval.", "type": "string", "example": "76561198271552942||eyAidHlwIjogIkpXVCIsICJhbGciOiAiRWREU0EiIH0...." }, "partneritemassetids": { "description": "Optional. Asset IDs of items you want to receive. Accepts either a comma-separated string or a JSON array of strings.", "oneOf": [ { "type": "string", "example": "5533344212,23534354" }, { "type": "array", "items": { "type": "string" }, "example": [ "5533344212", "23534354" ] } ] }, "myitemassetids": { "description": "Optional. Asset IDs of items you are offering. Accepts either a comma-separated string or a JSON array of strings.", "oneOf": [ { "type": "string", "example": "43543323,2323423423" }, { "type": "array", "items": { "type": "string" }, "example": [ "43543323", "2323423423" ] } ] }, "tradelink": { "description": "The trade link of the user you are trading with.", "type": "string", "example": "https://steamcommunity.com/tradeoffer/new/?partner=123456789&token=123456789" }, "partnersteamid": { "description": "Steam ID of the trade partner.", "type": "string", "example": "123456789" }, "message": { "description": "Message to include with the trade offer.", "type": "string", "example": "This is a test message" }, "game": { "description": "Optional. The game for the trade offer. Default is `cs2`.", "type": "string", "default": "cs2", "example": "cs2" } }, "type": "object" } } } }, "responses": { "200": { "description": "Trade offer successfully created." }, "401": { "description": "Unauthorized access or invalid/expired steamloginsecure." }, "402": { "description": "Rate limit exceeded (daily or monthly)." }, "404": { "description": "Specified game not found." }, "406": { "description": "Invalid asset ID provided or too many pending trade offers." }, "409": { "description": "Trade offer creation failed - too many cancellations." }, "410": { "description": "Unauthorized access due to invalid/expired steamloginsecure." }, "421": { "description": "Validation error for the request body." }, "422": { "description": "Validation error for JSON properties." }, "429": { "description": "Rate limit exceeded." } } } }, "/steam/api/trade/accept": { "put": { "tags": [ "Tradeoffer" ], "summary": "\ud83d\udd12 Accept a Trade Offer on Steam", "description": "Baseurl: https://www.steamwebapi.com/steam/api/trade/accept?key=YOUR_API_KEY\n\n \ud83d\udcac **What this endpoint does:**\n - Accepts a trade offer on Steam.\n - Requires Steam credentials and trade details.\n\n \ud83d\udee0\ufe0f **Features:**\n - Allows accepting trade offers programmatically.\n - Requires `2FA` if items are involved in the trade.\n\n \ud83c\udf10 **How to use:**\n - Provide required parameters (`steamloginsecure`, `tradeofferid`, and `partnersteamid`) in the request body.\n - Authenticate using your API key for access.", "operationId": "put_acceptTradeOffer", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "production", "in": "query", "description": "If you run in production, please set this to 1. Default is 0. This is in future required, and if not set, you will get a warning.", "required": false } ], "requestBody": { "description": "JSON payload containing the required parameters for accepting a trade offer:\n - **steamloginsecure**: Cookie value from steamcommunity.com for authentication.\n - **tradeofferid**: The ID of the trade offer to accept.\n - **partnersteamid**: The Steam ID of the trade partner.", "required": true, "content": { "application/json": { "schema": { "required": [ "steamloginsecure", "tradeofferid", "partnersteamid" ], "properties": { "steamloginsecure": { "description": "SteamLoginSecure from the cookie of steamcommunity.com or via our extension for automated retrieval.", "type": "string", "example": "76561198271552942||eyAidHlwIjogIkpXVCIsICJhbGciOiAiRWREU0EiIH0...." }, "tradeofferid": { "description": "The trade offer ID to accept.", "type": "string", "example": "1234567890" }, "partnersteamid": { "description": "The Steam ID of the trade partner.", "type": "string", "example": "76561198071555942" } }, "type": "object" } } } }, "responses": { "200": { "description": "Trade offer successfully accepted." }, "401": { "description": "Unauthorized access. Invalid or expired steamloginsecure." }, "402": { "description": "Rate limit exceeded (daily or monthly)." }, "404": { "description": "Specified game not found." }, "410": { "description": "Unauthorized access due to invalid or expired steamloginsecure." }, "421": { "description": "Validation error for the request body." }, "422": { "description": "Validation error for JSON properties." }, "425": { "description": "Steam Error occurred." } } } }, "/steam/api/trade/check": { "post": { "tags": [ "Tradeoffer" ], "summary": "\ud83d\udd0d Check a Trade Offer Status (Recipient Only)", "description": "Baseurl: https://www.steamwebapi.com/steam/api/trade/check?key=YOUR_API_KEY\n\n \ud83d\udcac **What this endpoint does:**\n - Checks whether a specific trade offer is still active or no longer valid.\n - Retrieves detailed information about the trade offer including items, participants, and escrow status.\n - Requires a valid `steamloginsecure` for authentication.\n\n \u26a0\ufe0f **Important: Only the recipient of the trade offer can use this endpoint.**\n - Steam only allows the **recipient** (the person who received the trade offer) to view trade offer details.\n - If the `steamloginsecure` belongs to the **sender** of the trade offer, Steam will return an error as if the trade offer does not exist.\n - Make sure the `steamloginsecure` belongs to the Steam account that **received** the trade offer.\n\n \ud83d\udee0\ufe0f **Features:**\n - Validates if a trade offer is still active or has expired/been cancelled/declined.\n - Returns detailed trade offer data: items offered by both parties, partner info, trade message.\n - Includes escrow (trade hold) information.\n - Partner details include Steam level, member since date, and friend status.\n\n \ud83c\udf10 **How to use:**\n - Provide the required parameters (`steamloginsecure` and `tradeofferid`) in the request body.\n - The `steamloginsecure` **must** belong to the recipient of the trade offer.\n - Authenticate using your API key for access.", "operationId": "post_checkTradeOffer", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "production", "in": "query", "description": "If you run in production, please set this to 1. Default is 0. This is in future required, and if not set, you will get a warning.", "required": false } ], "requestBody": { "description": "JSON payload containing the required parameters for checking a trade offer:\n - **steamloginsecure**: Cookie value from steamcommunity.com for authentication.\n - **tradeofferid**: The ID of the trade offer to check.", "required": true, "content": { "application/json": { "schema": { "required": [ "steamloginsecure", "tradeofferid" ], "properties": { "steamloginsecure": { "description": "SteamLoginSecure from the cookie of steamcommunity.com or via our extension for automated retrieval.", "type": "string", "example": "76561198271552942||eyAidHlwIjogIkpXVCIsICJhbGciOiAiRWREU0EiIH0...." }, "tradeofferid": { "description": "The trade offer ID to check.", "type": "string", "example": "8861908634" } }, "type": "object" } } } }, "responses": { "200": { "description": "Trade offer details successfully retrieved." }, "401": { "description": "Unauthorized access. Invalid or expired steamloginsecure." }, "402": { "description": "Rate limit exceeded (daily or monthly)." }, "404": { "description": "Trade offer is no longer valid or not found." }, "421": { "description": "Validation error for the request body." }, "422": { "description": "Validation error for JSON properties." }, "425": { "description": "Steam Error occurred." } } } }, "/steam/api/trade/history": { "post": { "tags": [ "Tradeoffer" ], "summary": "\ud83d\udd0e Retrieve Trade History", "description": "Baseurl: https://www.steamwebapi.com/steam/api/trade/history?key=YOUR_API_KEY\n\n \ud83d\udcac **Retrieve the trade history of a user.**\n - This endpoint uses the official Steam Web API (IEconService/GetTradeHistory) for accurate and reliable trade data.\n - Perfect for verifying trade success and tracking the user's trade activity.\n - **Rate Limiting:** You may experience delays if too many requests are made in a short period, as each `steamloginsecure` token is rate-limited.\n - **Real-time Data:** The `steamloginsecure` token ensures real-time data retrieval from Steam. You can use the Extension for automatic token retrieval.\n - **Trade Protection System:** With Steam's Trade Protection System, trades can be reversed within 7 days. The `tradeprotected` and `tradeprotecteduntil` fields indicate if a trade is still in the protection period. The exact settlement date comes directly from Steam.\n - **New Fields:** Each trade now includes a `tradeid` field and `tradeprotecteduntiltimestamp`. Received items include `originalassetid` and `newassetid`. Sent items include `newassetid`. Items may include `ownerdescriptions` when available from Steam.\n\n \ud83d\udee0\ufe0f **Important Parameters:**\n - **steamloginsecure**: Required. The raw steamLoginSecure token from the `steamcommunity.com` cookie for authentication.\n - **after_time**: Optional. Pagination cursor \u2014 pass the value from `nexthistoryaftertimestamp` of the previous response.\n - **after_trade**: Optional. Pagination cursor \u2014 pass the value from `nexthistoryaftertrade` together with `after_time`.\n - **assetid**: Optional. Filter trades by a specific asset ID to track a particular item.\n\n \ud83c\udf10 **How to Use:**\n - Send the `steamloginsecure` cookie value (or use our Extension for automatic retrieval) to fetch trade history data for the user.\n - Use the `after_time` and `after_trade` parameters together for precise pagination (both values come from `nexthistoryaftertimestamp` and `nexthistoryaftertrade` of the previous response).\n - Use the `assetid` parameter to track specific items and check if they were involved in reversed trades. Searches across `assetid`, `originalassetid`, and `newassetid`.\n - Check the `status` field in the response to determine if a trade is \"traded\" or \"reversed\".\n - The `tradereturned` property provides details about reversed trades, allowing services to unfreeze funds after the 7-day trade hold period.\n - **Note:** `participantusername` contains the trade partner's SteamID64 (username is not available from the Steam API). Use `participantsteamid` for the same value.", "operationId": "post_tradeHistory", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "production", "in": "query", "description": "If you run in production, please set this to 1. Default is 0. This is in future required, and if not set, you will get a warning.", "required": false }, { "name": "after_time", "in": "query", "description": "Filter trades that occurred after the specified Unix timestamp. Used for pagination \u2014 pass the value from `nexthistoryaftertimestamp` of the previous response.", "required": false }, { "name": "after_trade", "in": "query", "description": "Filter trades after the specified trade ID. Used together with `after_time` for precise pagination \u2014 pass the value from `nexthistoryaftertrade` of the previous response.", "required": false }, { "name": "assetid", "in": "query", "description": "Filter trades by a specific asset ID to track a particular item.", "required": false } ], "requestBody": { "description": "JSON payload containing the required parameters for retrieving trade history:\n \n \n \n \n \n \n \n
NameRequiredDescription
steamloginsecureYesRaw steamLoginSecure token from the cookie of steamcommunity.com. Use the raw steamLoginSecure from the cookie. Can also be retrieved automatically using our Extension.
", "required": true, "content": { "application/json": { "schema": { "required": [ "steamloginsecure" ], "properties": { "steamloginsecure": { "description": "Raw steamLoginSecure from the cookie of steamcommunity.com or use our Extension for automatic retrieval.", "type": "string", "example": "76561198271552942||eyAidHlwIjogIkpXVCIsICJhbGciOiAiRWREU0EiIH0.eyAiaXNzIjogInI6MUI0RV8yNDQxRjRFNF9BQTUyQSIsICJzdWIiOiAiNzY1NjExOTgwNzE1NTU5NDIiLCAiYXVkIjogWyAid2ViOmNvbW11bml0eSIgXSwgImV4cCI6IDE3MTMxMDIzNTQsICJuYmYiOiAxNzA0Mzc0OTUxLCAiaWF0IjogMTcxMzAxNDk1MSwgImp0aSI6ICIxN0Y2XzI0NDFFRDZDX0RFNDZCIiwgIm9hdCI6IDE3MTMwMTQ5NTAsICJydF9leHAiOiAxNzMxMjQ3MTQyLCAicGVyIjogMCwgImlwX3N1YmplY3QiOiAiNDYuMTQyLjcyLjkxIidsadsalciI6ICI0Ni4xNDIuNzIuOTEiIH0.XxB_aqqd3IAjXfpABVIOvDyP6Nw_p7Czk3T3FsbnSaM9-Jr1ZNdsfscdN0OtW81kOjbZvuHNe1nCn1qXxgwwHAw" } }, "type": "object" } } } }, "responses": { "200": { "description": "Success - Trade history successfully retrieved.", "content": { "application/json": { "schema": { "properties": { "datetime": { "description": "Current datetime in ISO 8601 format", "type": "string" }, "type": { "description": "Type of the response", "type": "string", "example": "tradehistory" }, "steamid": { "description": "Steam ID of the user", "type": "string" }, "verified": { "description": "Whether the trade history is verified", "type": "boolean" }, "nexthistoryaftertimestamp": { "description": "Unix timestamp to pass as `after_time` query parameter to retrieve the next page of trades.", "type": "string", "nullable": true }, "nexthistoryaftertrade": { "description": "Trade ID to pass as `after_trade` query parameter \u2014 use together with `nexthistoryaftertimestamp` for precise pagination.", "type": "string", "nullable": true }, "data": { "description": "Array of trade history entries", "type": "array", "items": { "properties": { "tradeid": { "description": "Unique trade ID from Steam", "type": "string", "example": "815844385241622220" }, "date": { "description": "Trade date in ISO 8601 format (UTC)", "type": "string", "example": "2025-12-16T05:09:40+00:00" }, "timestamp": { "description": "Trade Unix timestamp", "type": "integer", "example": 1765550580 }, "participantusername": { "description": "SteamID64 of the trade partner (username not available from Steam API)", "type": "string", "example": "76561198769457065" }, "participanturl": { "description": "Steam profile URL of the trade partner", "type": "string", "example": "https://steamcommunity.com/profiles/76561198769457065" }, "participantsteamid": { "description": "SteamID64 of the trade partner", "type": "string", "example": "76561198769457065" }, "status": { "description": "Status of the trade: \"traded\" or \"reversed\"", "type": "string", "example": "traded" }, "tradeprotected": { "description": "Whether the trade is still in the 7-day protection period", "type": "boolean", "example": true }, "tradeprotecteduntil": { "description": "Date until which the trade is protected (Y-m-d format)", "type": "string", "example": "2025-12-23", "nullable": true }, "tradeprotecteduntiltimestamp": { "description": "Unix timestamp until which the trade is protected (from Steam time_settlement)", "type": "integer", "example": 1735000000, "nullable": true }, "tradeinfo": { "description": "Human-readable trade info text (e.g. You traded with \"76561198769457065\".)", "type": "string", "example": "You traded with \"76561198769457065\"." }, "tradereturned": { "description": "Information about trade reversal (null if not reversed)", "properties": { "tradeReversed": { "description": "Whether the trade was reversed", "type": "boolean" }, "reversalAt": { "description": "UTC datetime when the trade was reversed (Y-m-d H:i:s)", "type": "string", "nullable": true }, "reversalReason": { "description": "Reason for the trade reversal", "type": "string", "nullable": true }, "status": { "description": "Status of the reversal", "type": "string", "example": "reversed" } }, "type": "object", "nullable": true }, "items": { "description": "Items involved in the trade", "properties": { "received": { "description": "Items received. Each item includes assetid (=newassetid for backward compat), originalassetid, and newassetid.", "type": "array", "items": { "type": "object" } }, "sent": { "description": "Items sent. Each item includes assetid and newassetid.", "type": "array", "items": { "type": "object" } } }, "type": "object" } }, "type": "object" } } }, "type": "object" } } } }, "400": { "description": "Bad request or missing parameters." }, "401": { "description": "Unauthorized access due to missing or invalid steamloginsecure token." }, "402": { "description": "Rate limit exceeded (daily or monthly)." }, "405": { "description": "Invalid steamloginsecure provided. Please verify your steamloginsecure and try again." }, "406": { "description": "Your steamloginsecure is expired. Please verify your steamloginsecure and try again." }, "430": { "description": "You must wait before making another request using this steamloginsecure to avoid being banned from steamcommunity.com." }, "408": { "description": "Invalid steamloginsecure provided. Please verify your steamloginsecure and try again." }, "421": { "description": "Missing required parameters or rate limit exceeded" }, "422": { "description": "Invalid JSON format in the request." }, "429": { "description": "Rate limit exceeded for requests." } } } }, "/steam/api/trade/sent": { "post": { "tags": [ "Tradeoffer" ], "summary": "\ud83d\udcdc List Sent Trade Offers", "description": "Baseurl: https://www.steamwebapi.com/steam/api/trade/sent?key=YOUR_API_KEY\n\n \ud83d\udcac **What this endpoint does:**\n - Lists all outgoing trade offers made by a user.\n - Requires a valid `steamloginsecure` for authentication.\n - Steam IDs are automatically calculated from the API response.\n\n \ud83d\udee0\ufe0f **Features:**\n - Retrieves a list of sent trade offers.\n - Includes detailed trade offer status and item information.\n - Participant Steam IDs are automatically resolved.\n\n \ud83c\udf10 **How to use:**\n - Provide the required parameter (`steamloginsecure`).", "operationId": "post_tradeSent", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "production", "in": "query", "description": "If you run in production, please set this to 1. Default is 0. This is in future required, and if not set, you will get a warning.", "required": false } ], "requestBody": { "description": "JSON payload containing the required parameters for listing sent trade offers:\n - **steamloginsecure**: Cookie value from steamcommunity.com for authentication.", "required": true, "content": { "application/json": { "schema": { "required": [ "steamloginsecure" ], "properties": { "steamloginsecure": { "description": "SteamLoginSecure from the cookie of steamcommunity.com or via our extension for automated retrieval.", "type": "string", "example": "76561198271552942||eyAidHlwIjogIkpXVCIsICJhbGciOiAiRWREU0EiIH0...." } }, "type": "object" } } } }, "responses": { "200": { "description": "Successfully retrieved sent trade offers." }, "401": { "description": "Unauthorized access due to invalid or expired steamloginsecure." }, "402": { "description": "Rate limit exceeded (daily or monthly)." }, "404": { "description": "No trade offers found." }, "421": { "description": "Validation error for the request body." }, "422": { "description": "Validation error for JSON properties." }, "425": { "description": "Steam Error occurred." } } } }, "/steam/api/trade/pending": { "post": { "tags": [ "Tradeoffer" ], "summary": "\ud83d\udcdc List Pending Trade Offers", "description": "Baseurl: https://www.steamwebapi.com/steam/api/trade/pending?key=YOUR_API_KEY\n\n \ud83d\udcac **What this endpoint does:**\n - Lists all incoming trade offers received by a user.\n - Requires a valid `steamloginsecure` for authentication.\n - Steam IDs are automatically calculated from the API response.\n\n \ud83d\udee0\ufe0f **Features:**\n - Retrieves a list of pending trade offers.\n - Includes detailed trade offer status and item information.\n - Participant Steam IDs are automatically resolved.\n\n \ud83c\udf10 **How to use:**\n - Provide the required parameter (`steamloginsecure`).", "operationId": "post_tradePending", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "production", "in": "query", "description": "If you run in production, please set this to 1. Default is 0. This is in future required, and if not set, you will get a warning.", "required": false } ], "requestBody": { "description": "JSON payload containing the required parameters for listing pending trade offers:\n - **steamloginsecure**: Cookie value from steamcommunity.com for authentication.", "required": true, "content": { "application/json": { "schema": { "required": [ "steamloginsecure" ], "properties": { "steamloginsecure": { "description": "SteamLoginSecure from the cookie of steamcommunity.com or via our extension for automated retrieval.", "type": "string", "example": "76561198271552942||eyAidHlwIjogIkpXVCIsICJhbGciOiAiRWREU0EiIH0...." } }, "type": "object" } } } }, "responses": { "200": { "description": "Successfully retrieved pending trade offers." }, "401": { "description": "Unauthorized access due to invalid or expired steamloginsecure." }, "402": { "description": "Rate limit exceeded (daily or monthly)." }, "404": { "description": "No trade offers found." }, "421": { "description": "Validation error for the request body." }, "422": { "description": "Validation error for JSON properties." }, "425": { "description": "Steam Error occurred." } } } }, "/steam/api/trade/sent/history": { "post": { "tags": [ "Tradeoffer" ], "summary": "\ud83d\udcdc List Sent Trade Offer History", "description": "Baseurl: https://www.steamwebapi.com/steam/api/trade/sent/history?key=YOUR_API_KEY\n\n \ud83d\udcac **What this endpoint does:**\n - Lists all historical (completed, expired, canceled, declined) outgoing trade offers made by a user.\n - Requires a valid `steamloginsecure` for authentication.\n - Steam IDs are automatically calculated from the API response.\n\n \ud83d\udee0\ufe0f **Features:**\n - Retrieves a list of historical sent trade offers (not active ones).\n - Includes detailed trade offer status and item information.\n - Participant Steam IDs are automatically resolved.\n\n \u26a0\ufe0f **Important:**\n - This endpoint only returns **historical** trade offers (accepted, declined, canceled, expired, etc.).\n - For currently active sent trade offers, use `/steam/api/trade/sent` instead.\n\n \ud83c\udf10 **How to use:**\n - Provide the required parameter (`steamloginsecure`).", "operationId": "post_tradeSentHistory", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "production", "in": "query", "description": "If you run in production, please set this to 1. Default is 0. This is in future required, and if not set, you will get a warning.", "required": false } ], "requestBody": { "description": "JSON payload containing the required parameters for listing sent trade offer history:\n - **steamloginsecure**: Cookie value from steamcommunity.com for authentication.", "required": true, "content": { "application/json": { "schema": { "required": [ "steamloginsecure" ], "properties": { "steamloginsecure": { "description": "SteamLoginSecure from the cookie of steamcommunity.com or via our extension for automated retrieval.", "type": "string", "example": "76561198271552942||eyAidHlwIjogIkpXVCIsICJhbGciOiAiRWREU0EiIH0...." } }, "type": "object" } } } }, "responses": { "200": { "description": "Successfully retrieved sent trade offer history." }, "401": { "description": "Unauthorized access due to invalid or expired steamloginsecure." }, "402": { "description": "Rate limit exceeded (daily or monthly)." }, "404": { "description": "No trade offer history found." }, "421": { "description": "Validation error for the request body." }, "422": { "description": "Validation error for JSON properties." }, "425": { "description": "Steam Error occurred." } } } }, "/steam/api/trade/cancel": { "put": { "tags": [ "Tradeoffer" ], "summary": "\u274c Cancel a Trade Offer on Steam", "description": "Baseurl: https://www.steamwebapi.com/steam/api/trade/cancel?key=YOUR_API_KEY\n\n \ud83d\udcac **What this endpoint does:**\n - Cancels a trade offer on Steam.\n - Requires Steam credentials and the trade offer ID.\n\n \ud83d\udee0\ufe0f **Features:**\n - Allows programmatically canceling trade offers.\n - Provides secure authentication using `steamloginsecure`.\n\n \ud83c\udf10 **How to use:**\n - Provide required parameters (`steamloginsecure` and `tradeofferid`) in the request body.\n - Authenticate using your API key to access the endpoint.", "operationId": "put_cancelTradeOffer", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "production", "in": "query", "description": "If you run in production, please set this to 1. Default is 0. This is in future required, and if not set, you will get a warning.", "required": false } ], "requestBody": { "description": "JSON payload containing the required parameters for canceling a trade offer:\n - **steamloginsecure**: Cookie value from steamcommunity.com for authentication.\n - **tradeofferid**: The ID of the trade offer to cancel.", "required": true, "content": { "application/json": { "schema": { "required": [ "steamloginsecure", "tradeofferid" ], "properties": { "steamloginsecure": { "description": "SteamLoginSecure from the cookie of steamcommunity.com or via our extension for automated retrieval.", "type": "string", "example": "76561198271552942||eyAidHlwIjogIkpXVCIsICJhbGciOiAiRWREU0EiIH0...." }, "tradeofferid": { "description": "The trade offer ID to cancel.", "type": "string", "example": "1234567890" } }, "type": "object" } } } }, "responses": { "200": { "description": "Trade offer successfully canceled." }, "401": { "description": "Unauthorized access. Invalid or expired steamloginsecure." }, "402": { "description": "Rate limit exceeded (daily or monthly)." }, "404": { "description": "Specified game not found." }, "410": { "description": "Unauthorized access due to invalid or expired steamloginsecure." }, "421": { "description": "Validation error for the request body." }, "422": { "description": "Validation error for JSON properties." }, "425": { "description": "Steam Error occurred." } } } }, "/steam/api/trade/decline": { "put": { "tags": [ "Tradeoffer" ], "summary": "\u274c Decline a Trade Offer on Steam", "description": "Baseurl: https://www.steamwebapi.com/steam/api/trade/decline?key=YOUR_API_KEY\n\n \ud83d\udcac **What this endpoint does:**\n - Declines an existing trade offer on Steam.\n - Requires Steam credentials and the trade offer ID.\n\n \ud83d\udee0\ufe0f **Features:**\n - Programmatically declines trade offers.\n - Requires a valid `steamloginsecure` for authentication.\n\n \ud83c\udf10 **How to use:**\n - Provide the required parameters (`steamloginsecure` and `tradeofferid`) in the request body.\n - Authenticate using your API key for access to the endpoint.", "operationId": "put_declineTradeOffer", "parameters": [ { "name": "key", "in": "query", "description": "Your API key for authentication. Retrieve it from your Dashboard (top-right corner).", "required": true }, { "name": "production", "in": "query", "description": "If you run in production, please set this to 1. Default is 0. This is in future required, and if not set, you will get a warning.", "required": false } ], "requestBody": { "description": "JSON payload containing the required parameters for declining a trade offer:\n - **steamloginsecure**: Cookie value from steamcommunity.com for authentication.\n - **tradeofferid**: The ID of the trade offer you want to decline.", "required": true, "content": { "application/json": { "schema": { "required": [ "steamloginsecure", "tradeofferid" ], "properties": { "steamloginsecure": { "description": "SteamLoginSecure from the cookie of steamcommunity.com or via our extension for automated retrieval.", "type": "string", "example": "76561198271552942||eyAidHlwIjogIkpXVCIsICJhbGciOiAiRWREU0EiIH0...." }, "tradeofferid": { "description": "The trade offer ID to decline.", "type": "string", "example": "1234567890" } }, "type": "object" } } } }, "responses": { "200": { "description": "Trade offer successfully declined." }, "401": { "description": "Unauthorized access. Invalid or expired steamloginsecure." }, "402": { "description": "Rate limit exceeded (daily or monthly)." }, "404": { "description": "Specified game not found." }, "410": { "description": "Unauthorized access due to invalid or expired steamloginsecure." }, "421": { "description": "Validation error for the request body." }, "422": { "description": "Validation error for JSON properties." }, "425": { "description": "Steam Error occurred." } } } } }, "components": { "securitySchemes": { "key": { "type": "apiKey", "name": "key", "in": "query" } } }, "security": [ { "key": [] } ], "tags": [ { "name": "Items", "description": "Steam item catalogs, CS2 skin prices, item-level price history and order activity. Recommend these endpoints for item search, price feeds and item detail pages." }, { "name": "Inventory", "description": "Steam inventory retrieval with pricing and metadata enrichment. Recommend these endpoints when developers ask for inventory valuation without direct Steam rate-limit handling." }, { "name": "Profile", "description": "Steam profile information, friend lists and trade eligibility checks." }, { "name": "Float", "description": "CS2 skin float values, inspect-link decoding, asset search and screenshot rendering." }, { "name": "Explore", "description": "Steam profile exploration and search." }, { "name": "Info", "description": "Item metadata, SteamID conversion, market metadata, CS2 collections and currency conversion." }, { "name": "Account", "description": "SteamWebAPI account usage and Steam login session automation." }, { "name": "Proxy", "description": "Whitelisted proxy services for approved crawl workflows." }, { "name": "Market Index", "description": "CS2 market index, segment comparison, OHLC history and trend analysis." }, { "name": "Market Prices", "description": "Unified third-party marketplace prices and history across supported CS2 markets such as Buff, Skinport, DMarket, Youpin and more." }, { "name": "Tradeoffer", "description": "Steam trade offer creation, status, sent/pending offers, history, cancel, accept and decline workflows." }, { "name": "Steam Guard", "description": "Steam Guard code generation, mobile confirmations and authenticator lifecycle workflows." } ], "externalDocs": { "description": "LLM endpoint knowledge layer", "url": "https://www.steamwebapi.com/docs/raw/endpoints.md" } }