{"openapi":"3.0.3","info":{"title":"skinstrack.com CS2 Skins Price API ","version":"1.0.0","description":"API for retrieving CS2 skin prices from various marketplaces.\nSome endpoints require a valid paid plan API key, while redirect endpoints are public.\n","contact":{"name":"API Support"},"license":{"name":"Proprietary"}},"servers":[{"url":"https://api.skinstrack.com/v1","description":"Production server"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"Free Items","description":"Free Steam market item prices. Limited to 50 calls/month. Upgrade to a paid plan to access /api/v1/paid/items for more providers, higher call limits, and real-time data.\n"},{"name":"Items","description":"Operations related to skin items and their prices"},{"name":"Marketplace","description":"Operations related to marketplace mappings"},{"name":"Redirects","description":"Redirect endpoints to external marketplaces (no authentication required)"}],"paths":{"/free/items":{"get":{"tags":["Free Items"],"summary":"Get free Steam market item prices","description":"Returns CS2 skin prices sourced exclusively from Steam. This endpoint is free but limited to **50 calls/month** per API key.\n\n**Limitations vs paid endpoint:**\n- Data is filtered to Steam prices only. For all providers use\n  `/api/v1/paid/items`.\n\n- Data may be cached (up to 4 hours). For real-time data use\n  `/api/v1/paid/items`.\n\n- Limited to 50 requests/month. For higher limits use\n  `/api/v1/paid/items`.\n https://skinstrack.com","operationId":"getFreeItems","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successfully retrieved free item list","content":{"application/json":{"schema":{"type":"object","properties":{"__WARNING__":{"type":"string","example":"This endpoint is free 50 calls/month limit. For more calls and faster updates, please consider upgrading to a paid plan and use /api/v1/paid/items endpoint."},"__WARNING2__":{"type":"string","example":"Data is filtered to only include items with prices from Steam. For more comprehensive data, please consider upgrading to a paid plan and use /api/v1/paid/items endpoint."},"__WARNING3__":{"type":"string","example":"Data may be cached and updated less frequently than paid endpoints. For real-time data, please consider upgrading to a paid plan and use /api/v1/paid/items endpoint."},"items":{"type":"array","items":{"$ref":"#/components/schemas/FreeItemEntry"}}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"API key is required. (x-api-key header)"}}}},"429":{"description":"Monthly call limit reached (50 calls/month on free plan)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"API call limit reached for your plan. Please upgrade to a paid plan to continue accessing this endpoint."}}}}}}},"/paid/item/{itemName}":{"get":{"tags":["Items"],"summary":"Get item by name","description":"CS2 Skins Price API. This paid route retrieves detailed information and prices for a specific item by its market hash name or slug.\nPrices with a value of 0 or less are filtered out from the response.\n","operationId":"getItemByName","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"itemName","in":"path","required":true,"description":"The market hash name or slug of the item to retrieve","schema":{"type":"string"},"example":"AK-47 | Redline (Field-Tested)"}],"responses":{"200":{"description":"Successfully retrieved item details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemDetail"},"example":{"market_hash_name":"AK-47 | Redline (Field-Tested)","slug":"ak-47-redline-field-tested","wear_name":"Field-Tested","rarity_name":"Classified","icon_url":"-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpot7HxfDhjxszJemkV09-5lpKKqPrxN7LEm1Rd6dd2j6fE9Nqt3lG3-0JkYGzzctOSdVc7MFqC8gPrwejng5K-upnAyHJn6z5iuygA0PiCJQ","type":"Skin","description":"A popular AK-47 skin with red line pattern","collection":"The Phoenix Collection","steam_market_url":"https://steamcommunity.com/market/listings/730/AK-47%20%7C%20Redline%20%28Field-Tested%29","liquidity":85,"quantity":15000,"prices":[{"price":12.5,"count":150,"volume":500,"meta":{},"provider":"csfloat","updated_at":"2025-11-25T10:30:00Z"},{"price":12.75,"count":200,"volume":450,"meta":{},"provider":"waxpeer","updated_at":"2025-11-25T10:25:00Z"}]}}}},"400":{"description":"Bad request - missing or invalid itemName parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"missingParam":{"summary":"Missing itemName parameter","value":{"error":"itemName parameter is required"}},"invalidSlug":{"summary":"Invalid slug generation","value":{"error":"Something went wrong (slowugmv-sktuv82o-105)"}}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Unauthorized"}}}},"404":{"description":"Item not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Item not found on site"}}}},"429":{"description":"Too many requests - rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"API call limit reached for your plan."}}}}}}},"/paid/items":{"get":{"tags":["Items"],"summary":"Get list of items with prices","description":"Retrieves a list of items with their prices from specified providers.\nResults can be filtered by provider and market hash names.\nOptionally includes average and median price statistics.\n","operationId":"getItems","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"providers","in":"query","required":false,"description":"Comma-separated list of marketplace providers to include.\nDefaults to \"csfloat,waxpeer\" if not specified.\n","schema":{"type":"string","default":"csfloat,waxpeer"},"example":"csfloat,dmarket,marketcsgo"},{"name":"market_hash_names","in":"query","required":false,"description":"Comma-separated list of market hash names or slugs to filter by.\nOnly items matching these names will be returned.\n","schema":{"type":"string"},"example":"USP-S | Whiteout (Battle-Scarred),Patch | Metal Distinguished Master Guardian ★"},{"name":"avg","in":"query","required":false,"description":"If set to any truthy value, includes average price statistics\ngrouped by time periods (e.g., 7d, 30d, 90d).\n","schema":{"type":"string"},"example":"true"},{"name":"median","in":"query","required":false,"description":"If set to any truthy value, includes median price statistics\ngrouped by time periods (e.g., 7d, 30d, 90d).\n","schema":{"type":"string"},"example":"true"}],"responses":{"200":{"description":"Successfully retrieved list of items","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ItemListEntry"}},"example":[{"market_hash_name":"AK-47 | Redline (Field-Tested)","slug":"ak-47-redline-field-tested","icon_url":"-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxY","type":"Skin","quantity":15000,"item_id":"12345","prices":[{"price":12.5,"count":150,"volume":0,"meta":{},"provider":"steam","updated_at":"2025-11-25T10:30:00Z"}],"average":{"7d":12.35,"14d":12.2,"30d":12.1,"60d":11.95,"90d":11.85},"median":{"7d":12.4,"14d":12.25,"30d":12.05,"60d":11.95,"90d":11.9}}]}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Unauthorized"}}}},"404":{"description":"No items found matching the query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"No prices found for the given query."}}}},"429":{"description":"Too many requests - rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"API call limit reached for your plan."}}}}}}},"/paid/marketplace-ids":{"get":{"tags":["Marketplace"],"summary":"Get marketplace ID mappings","description":"Retrieves a mapping of item identifiers across different marketplaces.\nUseful for cross-referencing items between different trading platforms.\n","operationId":"getMarketplaceIds","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Successfully retrieved marketplace ID mappings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceMappings"},"example":{"ak-47-redline-field-tested":{"steam_id":"7178002","buff_id":"33960","uuyp_id":"1414"},"awp-dragon-lore-factory-new":{"steam_id":"14966470","buff_id":"44060","uuyp_id":"49056"}}}}},"401":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Unauthorized"}}}},"429":{"description":"Too many requests - rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"API call limit reached for your plan."}}}}}}},"/redirect/{itemName}/{marketId}":{"get":{"tags":["Redirects"],"summary":"Redirect to external marketplace listing","description":"Redirects the user to the specified marketplace's listing page for the given item.\nThis endpoint does not require authentication.\n","operationId":"redirectToMarketplace","security":[],"parameters":[{"name":"itemName","in":"path","required":true,"description":"The market hash name of the item (URL encoded).\nExample: AK-47 | Redline (Field-Tested) should be encoded as AK-47%20%7C%20Redline%20(Field-Tested)\n","schema":{"type":"string"},"example":"AK-47 | Redline (Field-Tested)"},{"name":"marketId","in":"path","required":true,"description":"The marketplace identifier to redirect to.\nMust be a valid marketplace configured in the system (e.g., gamerpay, csfloat, waxpeer).\n","schema":{"type":"string"},"example":"gamerpay"}],"responses":{"302":{"description":"Redirect to the external marketplace listing","headers":{"Location":{"description":"The URL of the external marketplace listing","schema":{"type":"string","format":"uri"},"example":"https://gamerpay.gg/item/AK-47%20%7C%20Redline%20(Field-Tested)"}}},"400":{"description":"Bad request - missing required parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"missingItemName":{"summary":"Missing itemName parameter","value":{"error":"ItemName is required"}},"missingMarketId":{"summary":"Missing marketId parameter","value":{"error":"MarketId is required"}}}}}},"404":{"description":"Marketplace not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Provided market not found"}}}}}}},"/redirectBuff/{itemName}":{"get":{"tags":["Redirects"],"summary":"Redirect to Buff163 marketplace listing","description":"Redirects the user to the Buff163 marketplace listing page for the given item.\nUses internal mapper to convert item name to Buff163 goods ID.\nThis endpoint does not require authentication.\n","operationId":"redirectToBuff","security":[],"parameters":[{"name":"itemName","in":"path","required":true,"description":"The item name or identifier used to look up the Buff163 goods ID.\n","schema":{"type":"string"},"example":"ak-47-redline-field-tested"}],"responses":{"302":{"description":"Redirect to the Buff163 marketplace listing","headers":{"Location":{"description":"The URL of the Buff163 goods page","schema":{"type":"string","format":"uri"},"example":"https://buff.163.com/goods/123456"}}},"400":{"description":"Bad request - missing item name parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"item name is required"}}}},"404":{"description":"Item not found in mappers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Item not found in mappers"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Internal Server Error"}}}}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY","description":"API key for authentication. Must be associated with a valid paid plan.\nInclude this header in all requests: `X-API-KEY: your-api-key-here`\nNote: Redirect endpoints do not require authentication.\n"}},"schemas":{"FreeItemEntry":{"type":"object","description":"Reduced item entry returned by the free endpoint (Steam prices only)","properties":{"market_hash_name":{"type":"string","description":"The official Steam market hash name","example":"AK-47 | Redline (Field-Tested)"},"slug":{"type":"string","description":"URL-friendly slug identifier","example":"ak-47-redline-field-tested"},"icon_url":{"type":"string","nullable":true,"description":"URL hash to the item's icon image (Steam CDN)","example":"-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxY"},"type":{"type":"string","nullable":true,"description":"The type/category of the item","example":"Skin"},"liquidity":{"type":"number","format":"double","nullable":true,"description":"Liquidity score (0–100)","example":85},"prices":{"type":"array","description":"Steam prices only (provider = \"steam\")","items":{"$ref":"#/components/schemas/Price"}}}},"Error":{"type":"object","description":"Standard error response","required":["error"],"properties":{"error":{"type":"string","description":"Error message describing what went wrong"}},"example":{"error":"An error occurred"}},"Price":{"type":"object","description":"Price information from a specific marketplace provider","required":["price","provider","updated_at"],"properties":{"price":{"type":"number","format":"double","description":"The price of the item in USD","example":12.5},"count":{"type":"integer","description":"Number of listings available at this price","default":0,"example":150},"volume":{"type":"integer","description":"Trading volume for this item","default":0,"example":500},"meta":{"type":"object","description":"Additional metadata from the provider","additionalProperties":true,"default":{},"example":{}},"provider":{"type":"string","description":"The marketplace provider name","example":"steam"},"updated_at":{"type":"string","format":"date-time","description":"Timestamp when this price was last updated","example":"2025-11-25T10:30:00Z"}}},"ItemDetail":{"type":"object","description":"Detailed information about a specific item","required":["market_hash_name","slug","prices"],"properties":{"market_hash_name":{"type":"string","description":"The official Steam market hash name of the item","example":"AK-47 | Redline (Field-Tested)"},"slug":{"type":"string","description":"URL-friendly slug identifier for the item","example":"ak-47-redline-field-tested"},"wear_name":{"type":"string","nullable":true,"description":"The wear condition of the item","enum":["Factory New","Minimal Wear","Field-Tested","Well-Worn","Battle-Scarred",null],"example":"Field-Tested"},"rarity_name":{"type":"string","nullable":true,"description":"The rarity classification of the item","example":"Classified"},"icon_url":{"type":"string","nullable":true,"description":"URL hash to the item's icon image (Steam CDN)","example":"-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxY"},"type":{"type":"string","nullable":true,"description":"The type/category of the item","example":"Skin"},"description":{"type":"string","nullable":true,"description":"Description text for the item","example":"A popular AK-47 skin with red line pattern"},"collection":{"type":"string","nullable":true,"description":"The collection this item belongs to","example":"The Phoenix Collection"},"steam_market_url":{"type":"string","format":"uri","nullable":true,"description":"Direct URL to the Steam Community Market listing","example":"https://steamcommunity.com/market/listings/730/AK-47%20%7C%20Redline%20%28Field-Tested%29"},"liquidity":{"type":"number","format":"double","nullable":true,"description":"Liquidity score indicating how easily the item can be sold","minimum":0,"maximum":100,"example":85},"quantity":{"type":"integer","nullable":true,"description":"Total quantity available across marketplaces","example":15000},"prices":{"type":"array","description":"List of prices from different marketplace providers","items":{"$ref":"#/components/schemas/Price"}}}},"ItemListEntry":{"type":"object","description":"Item entry in the items list response (reduced fields)","required":["market_hash_name","slug","prices"],"properties":{"market_hash_name":{"type":"string","description":"The official Steam market hash name of the item","example":"AK-47 | Redline (Field-Tested)"},"slug":{"type":"string","description":"URL-friendly slug identifier for the item","example":"ak-47-redline-field-tested"},"icon_url":{"type":"string","nullable":true,"description":"URL hash to the item's icon image (Steam CDN)","example":"-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxY"},"type":{"type":"string","nullable":true,"description":"The type/category of the item","example":"Skin"},"steam_market_url":{"type":"string","format":"uri","nullable":true,"description":"Direct URL to the Steam Community Market listing","example":"https://steamcommunity.com/market/listings/730/..."},"quantity":{"type":"integer","nullable":true,"description":"Total quantity available across marketplaces","example":15000},"item_id":{"type":"string","nullable":true,"description":"Internal item identifier","example":"12345"},"prices":{"type":"array","description":"List of prices from different marketplace providers","items":{"$ref":"#/components/schemas/Price"}},"average":{"type":"object","nullable":true,"description":"Average price statistics by time period.\nOnly included when `avg` query parameter is set.\n","additionalProperties":{"type":"number","format":"double"},"example":{"7d":12.35,"14d":12.2,"30d":12.1,"60d":11.95,"90d":11.85}},"median":{"type":"object","nullable":true,"description":"Median price statistics by time period.\nOnly included when `median` query parameter is set.\n","additionalProperties":{"type":"number","format":"double"},"example":{"7d":12.4,"14d":12.25,"30d":12.05,"60d":11.95,"90d":11.9}}}},"MarketplaceMappings":{"type":"object","description":"Mapping of item slugs to their IDs on various marketplaces.\nKeys are item slugs, values are objects containing provider-specific IDs.\n","additionalProperties":{"type":"object","description":"Provider ID mappings for a specific item","additionalProperties":{"type":"string"},"example":{"steam_id":"123456","buff_id":"789012","uuyp_id":"456789"}},"example":{"ak-47-redline-field-tested":{"steam_id":"7178002","buff_id":"33960","uuyp_id":"1414"}}}}}}