{"openapi":"3.1.0","info":{"title":"CS2Sell public API","description":"Read access to the catalog, listings, your orders and your wallet. Authenticate with an API key from Account → Security as `Authorization: Bearer sk_…`. Each key gets a per-minute budget per scope (free 60, pro 600, business 3000).","license":{"name":"UNLICENSED","identifier":"UNLICENSED"},"version":"1.0.0"},"servers":[{"url":"https://api.cs2sell.com","description":"Production"}],"paths":{"/v1/public/catalog":{"get":{"tags":["catalog"],"summary":"Browse the item catalog.","operationId":"catalog","parameters":[{"name":"q","in":"query","description":"Name contains (case-insensitive).","required":false,"schema":{"type":"string"}},{"name":"kind","in":"query","description":"Item kind.","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Paged_PublicItem"}}}},"403":{"description":"Key lacks `catalog:read`"}},"security":[{"api_key":["catalog:read"]}]}},"/v1/public/items/{id}":{"get":{"tags":["catalog"],"summary":"One catalog item.","operationId":"item_by_id","parameters":[{"name":"id","in":"path","description":"Item id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicItem"}}}},"404":{"description":"No such item"}},"security":[{"api_key":["catalog:read"]}]}},"/v1/public/listings":{"get":{"tags":["listings"],"summary":"Active listings.","operationId":"listings_search","parameters":[{"name":"item_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"variant_id","in":"query","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"min_price","in":"query","description":"Minimum price, USD.","required":false,"schema":{"type":"string"}},{"name":"max_price","in":"query","description":"Maximum price, USD.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"`newest` (default), `price_asc` or `price_desc`.","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Paged_PublicListing"}}}},"403":{"description":"Key lacks `listings:read`"}},"security":[{"api_key":["listings:read"]}]}},"/v1/public/marketplaces":{"get":{"tags":["catalog"],"summary":"Marketplaces we compare prices against.","operationId":"marketplaces","responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PublicMarketplace"}}}}}},"security":[{"api_key":["catalog:read"]}]}},"/v1/public/me":{"get":{"tags":["account"],"summary":"The key you're calling with.","operationId":"me","responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicMe"}}}},"401":{"description":"Missing, unknown or revoked key"}},"security":[{"api_key":[]}]}},"/v1/public/orders":{"get":{"tags":["orders"],"summary":"Your purchases, newest first.","operationId":"orders","parameters":[{"name":"page","in":"query","description":"1-based page number.","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"page_size","in":"query","description":"Items per page, 1–100.","required":false,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Paged_PublicOrder"}}}},"403":{"description":"Key lacks `orders:read`"}},"security":[{"api_key":["orders:read"]}]}},"/v1/public/prices/{variant_id}":{"get":{"tags":["catalog"],"summary":"Cross-marketplace prices for a variant (item + wear + StatTrak).","operationId":"prices_for_variant","parameters":[{"name":"variant_id","in":"path","description":"Variant id","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VariantPrices"}}}},"404":{"description":"No prices for this variant"}},"security":[{"api_key":["catalog:read"]}]}},"/v1/public/wallet/balance":{"get":{"tags":["wallet"],"summary":"Your wallet balance.","operationId":"wallet_balance","responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBalance"}}}},"403":{"description":"Key lacks `wallet:read`"}},"security":[{"api_key":["wallet:read"]}]}}},"components":{"schemas":{"Paged_PublicItem":{"type":"object","required":["items","page","page_size","total"],"properties":{"items":{"type":"array","items":{"type":"object","required":["id","kind"],"properties":{"id":{"type":"string"},"image":{"type":["string","null"]},"kind":{"type":"string","description":"`skin`, `sticker`, `case`, `agent`, …"},"name":{"type":["string","null"]},"slug":{"type":["string","null"]}}}},"page":{"type":"integer","format":"int64"},"page_size":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64"}}},"Paged_PublicListing":{"type":"object","required":["items","page","page_size","total"],"properties":{"items":{"type":"array","items":{"type":"object","required":["id","id8","price_usd","kind","is_auction","created_at"],"properties":{"created_at":{"type":"string","format":"date-time"},"id":{"type":"string","format":"uuid"},"id8":{"type":"string","description":"Short id used in `/l/{id8}` links."},"is_auction":{"type":"boolean"},"item_id":{"type":["string","null"]},"kind":{"type":"string","description":"`bot` (instant delivery) or `p2p` (escrow)."},"market_hash_name":{"type":["string","null"]},"price_usd":{"type":"string"},"variant_id":{"type":["string","null"],"format":"uuid"}}}},"page":{"type":"integer","format":"int64"},"page_size":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64"}}},"Paged_PublicOrder":{"type":"object","required":["items","page","page_size","total"],"properties":{"items":{"type":"array","items":{"type":"object","required":["id","status","source","total_usd","created_at","items"],"properties":{"created_at":{"type":"string","format":"date-time"},"delivered_at":{"type":["string","null"],"format":"date-time"},"id":{"type":"string","format":"uuid"},"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicOrderLine"}},"source":{"type":"string","description":"`checkout`, `auction`, `offer`, `buy_order` or `trade`."},"status":{"type":"string","description":"`awaiting_delivery`, `delivered`, `refunded`, …"},"total_usd":{"type":"string"}}}},"page":{"type":"integer","format":"int64"},"page_size":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64"}}},"PublicBalance":{"type":"object","required":["available_usd","store_usd","trade_usd","withdrawable_usd","held_usd","escrow_usd"],"properties":{"available_usd":{"type":"string","description":"Spendable on CS2Sell: store plus trade balance."},"escrow_usd":{"type":"string","description":"P2P sale payouts in escrow that Steam hasn't confirmed yet."},"held_usd":{"type":"string","description":"Set aside for your leading bids and open offers."},"store_usd":{"type":"string","description":"Spendable and withdrawable."},"trade_usd":{"type":"string","description":"Sales and trades still inside Steam's trade protection or P2P escrow:\nspendable here and spent first, withdrawable once it turns into store\nbalance."},"withdrawable_usd":{"type":"string","description":"What a withdrawal can take right now."}}},"PublicItem":{"type":"object","required":["id","kind"],"properties":{"id":{"type":"string"},"image":{"type":["string","null"]},"kind":{"type":"string","description":"`skin`, `sticker`, `case`, `agent`, …"},"name":{"type":["string","null"]},"slug":{"type":["string","null"]}}},"PublicListing":{"type":"object","required":["id","id8","price_usd","kind","is_auction","created_at"],"properties":{"created_at":{"type":"string","format":"date-time"},"id":{"type":"string","format":"uuid"},"id8":{"type":"string","description":"Short id used in `/l/{id8}` links."},"is_auction":{"type":"boolean"},"item_id":{"type":["string","null"]},"kind":{"type":"string","description":"`bot` (instant delivery) or `p2p` (escrow)."},"market_hash_name":{"type":["string","null"]},"price_usd":{"type":"string"},"variant_id":{"type":["string","null"],"format":"uuid"}}},"PublicMarketplace":{"type":"object","required":["key","name","link","kind","enabled"],"properties":{"enabled":{"type":"boolean"},"key":{"type":"string"},"kind":{"type":"string"},"link":{"type":"string"},"name":{"type":"string"}}},"PublicMe":{"type":"object","required":["api_key_id","user_id","tier","scopes","rate_limit_per_minute"],"properties":{"api_key_id":{"type":"string","format":"uuid"},"rate_limit_per_minute":{"type":"integer","format":"int32","description":"Requests per minute per scope.","minimum":0},"scopes":{"type":"array","items":{"type":"string"}},"tier":{"type":"string","description":"`free`, `pro` or `business`."},"user_id":{"type":"string","format":"uuid"}}},"PublicOrder":{"type":"object","required":["id","status","source","total_usd","created_at","items"],"properties":{"created_at":{"type":"string","format":"date-time"},"delivered_at":{"type":["string","null"],"format":"date-time"},"id":{"type":"string","format":"uuid"},"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicOrderLine"}},"source":{"type":"string","description":"`checkout`, `auction`, `offer`, `buy_order` or `trade`."},"status":{"type":"string","description":"`awaiting_delivery`, `delivered`, `refunded`, …"},"total_usd":{"type":"string"}}},"PublicOrderLine":{"type":"object","required":["listing_id","price_usd"],"properties":{"item_id":{"type":["string","null"]},"listing_id":{"type":"string","format":"uuid"},"price_usd":{"type":"string"}}},"VariantPrices":{"type":"object","required":["variant_id","sample_size","source_keys"],"properties":{"lowest_usd":{"type":["string","null"]},"mean_usd":{"type":["string","null"]},"median_usd":{"type":["string","null"]},"recommended_list_usd":{"type":["string","null"]},"sample_size":{"type":"integer","format":"int32"},"source_keys":{"type":"array","items":{"type":"string"},"description":"Marketplaces the figures come from."},"variant_id":{"type":"string","format":"uuid"}}}},"securitySchemes":{"api_key":{"type":"http","scheme":"bearer","bearerFormat":"sk_…"}}},"tags":[{"name":"account","description":"The calling key"},{"name":"catalog","description":"Items, prices and marketplaces (`catalog:read`)"},{"name":"listings","description":"Active listings (`listings:read`)"},{"name":"orders","description":"Your purchases (`orders:read`)"},{"name":"wallet","description":"Your balance (`wallet:read`)"}]}