{"openapi":"3.1.0","info":{"title":"CS2SkinSpy Agent API","version":"1.4.0","description":"Value a public CS2 Steam inventory through path-based operations. The path without a representation suffix defaults to Markdown-formatted text/plain; explicit /txt, /md and /json suffixes select the response type. Trade-locked and non-marketable items are excluded. Marketplace URLs may contain affiliate parameters."},"servers":[{"url":"https://cs2skinspy.com"}],"externalDocs":{"description":"Agent navigation and usage guidance","url":"https://cs2skinspy.com/llms.txt"},"paths":{"/api/v1/inventory/id/{steam_id}":{"get":{"operationId":"getCs2InventoryValueDefaultPlainText","summary":"Value a public CS2 Steam inventory as plain text by default","description":"Default representation for callers that do not append /txt, /md or /json. Returns Markdown-formatted text/plain with Steam and cheapest-marketplace totals and the five most expensive items.","parameters":[{"name":"steam_id","in":"path","required":true,"description":"SteamID64 or Steam vanity name as one URL path segment.","schema":{"type":"string","minLength":2,"maxLength":100}}],"responses":{"200":{"description":"Completed, partial or unavailable inventory valuation as Markdown-formatted plain text.","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Invalid request returned as Markdown-formatted plain text."},"503":{"description":"Steam rate limit or temporary valuation service failure returned as Markdown-formatted plain text."}}}},"/api/v1/inventory/id/{steam_id}/md":{"get":{"operationId":"getCs2InventoryValueMarkdown","summary":"Value a public CS2 Steam inventory as Markdown","description":"Returns the same valuation, item, marketplace, exclusion and notice information as the path-based JSON operation, formatted as agent-readable Markdown.","parameters":[{"name":"steam_id","in":"path","required":true,"description":"SteamID64 or Steam vanity name as one URL path segment.","schema":{"type":"string","minLength":2,"maxLength":100}}],"responses":{"200":{"description":"Completed, partial or unavailable inventory valuation as Markdown.","content":{"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Invalid request returned as Markdown.","content":{"text/markdown":{"schema":{"type":"string"}}}},"503":{"description":"Steam rate limit or temporary valuation service failure returned as Markdown.","headers":{"Retry-After":{"description":"Seconds to wait when Steam rate-limits the request.","schema":{"type":"integer"}}},"content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/api/v1/inventory/id/{steam_id}/txt":{"get":{"operationId":"getCs2InventoryValuePlainText","summary":"Value a public CS2 Steam inventory as Markdown-formatted plain text","description":"Returns the same Markdown content as the path-based Markdown operation with text/plain for readers that reject text/markdown.","parameters":[{"name":"steam_id","in":"path","required":true,"description":"SteamID64 or Steam vanity name as one URL path segment.","schema":{"type":"string","minLength":2,"maxLength":100}}],"responses":{"200":{"description":"Completed, partial or unavailable inventory valuation as Markdown-formatted plain text.","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Invalid request returned as Markdown-formatted plain text.","content":{"text/plain":{"schema":{"type":"string"}}}},"503":{"description":"Steam rate limit or temporary valuation service failure returned as Markdown-formatted plain text.","headers":{"Retry-After":{"description":"Seconds to wait when Steam rate-limits the request.","schema":{"type":"integer"}}},"content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/api/v1/inventory/id/{steam_id}/json":{"get":{"operationId":"getCs2InventoryValueJson","summary":"Value a public CS2 Steam inventory as structured JSON","description":"Returns Steam and cheapest-marketplace totals and the five most expensive items as JSON. Sticker value defaults to zero and the full item list is omitted.","parameters":[{"name":"steam_id","in":"path","required":true,"description":"SteamID64 or Steam vanity name as one URL path segment.","schema":{"type":"string","minLength":2,"maxLength":100}}],"responses":{"200":{"description":"A completed or partial valuation, or a structured private/unavailable inventory explanation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryResponse"}}}},"400":{"description":"Invalid request."},"503":{"description":"Steam rate limit or temporary valuation service failure."}}}}},"components":{"schemas":{"Money":{"type":"object","required":["cents","usd"],"properties":{"cents":{"type":"integer","description":"Integer USD cents."},"usd":{"type":"string","description":"Decimal USD amount."}}},"Offer":{"type":"object","required":["source_key","marketplace","price_cents","price_usd","url","affiliate"],"properties":{"source_key":{"type":"string"},"marketplace":{"type":"string"},"price_cents":{"type":"integer"},"price_usd":{"type":"string"},"url":{"type":"string","format":"uri"},"affiliate":{"type":"boolean"}}},"InventoryItem":{"type":"object","required":["name","image","offers","stickers","valuation","included_in_totals"],"properties":{"name":{"type":"string"},"image":{"type":"object","properties":{"url":{"type":["string","null"],"format":"uri"},"alt":{"type":"string","description":"Accessible alternative text containing the item name."}}},"dmarket_url":{"type":["string","null"],"format":"uri"},"dmarket_affiliate":{"type":"boolean"},"offers":{"type":"array","items":{"$ref":"#/components/schemas/Offer"}},"cheapest_offer":{"oneOf":[{"$ref":"#/components/schemas/Offer"},{"type":"null"}]},"steam_offer":{"oneOf":[{"$ref":"#/components/schemas/Offer"},{"type":"null"}]},"stickers":{"type":"array","items":{"type":"object"}},"valuation":{"type":"object","properties":{"steam_with_stickers":{"oneOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"cheapest_market_with_stickers":{"oneOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"estimated_with_special_pattern_and_stickers":{"oneOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]}}},"included_in_totals":{"type":"boolean"},"exclusion_reason":{"type":["string","null"]}}},"InventoryResponse":{"type":"object","required":["schema_version","service","status","steam_id","currency","price_unit","totals","top_items","notices"],"properties":{"schema_version":{"type":"string"},"service":{"const":"CS2SkinSpy"},"status":{"enum":["ok","partial","unavailable"]},"steam_id":{"type":"string"},"currency":{"const":"USD"},"price_unit":{"const":"cents"},"counts":{"type":"object"},"sticker_value_percentage":{"type":"number"},"totals":{"type":"object","properties":{"steam":{"oneOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"cheapest_marketplaces":{"oneOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"estimated_with_special_patterns":{"oneOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]}}},"top_items":{"type":"array","items":{"$ref":"#/components/schemas/InventoryItem"}},"items":{"type":"array","items":{"$ref":"#/components/schemas/InventoryItem"}},"error":{"type":"object"},"notices":{"type":"array","items":{"type":"string"}}}}}}}