### Example Listing Data Source: https://docs.csfloat.com/ This is an example of the JSON structure returned when retrieving active listings from the CSFloat Market API. ```json [ { "id": "324288155723370196", "created_at": "2021-06-13T20:45:21.311794Z", "type": "buy_now", "price": 260000, "state": "listed", "seller": { "avatar": "https://steamcdn-a.akamaihd.net/steamcommunity/public/images/avatars/97/974f0a94f47f50a1a6a769fc8ff093cb93a49066_full.jpg", "flags": 435, "online": true, "stall_public": true, "statistics": { "median_trade_time": 236, "total_failed_trades": 0, "total_trades": 24, "total_verified_trades": 24 }, "steam_id": "76561198084749846", "username": "Step7750" }, "item": { "asset_id": "22547095285", "def_index": 16, "paint_index": 449, "paint_seed": 700, "float_value": 0.02796577662229538, "icon_url": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpou-6kejhjxszYfi5H5di5mr-HnvD8J_WCkmkEvp0pi7zDodv3jAHj-UM5ZGr7INfHJAc9MlzV-FK_kO281pa_ot2XnrA-A3kA", "d_param": "17054198177995786400", "is_stattrak": false, "is_souvenir": false, "rarity": 5, "quality": 4, "market_hash_name": "M4A4 | Poseidon (Factory New)", "stickers": [ { "stickerId": 1060, "slot": 3, "icon_url": "columbus2016/nv_holo.fbbf7dc3ef16ade69ac294589fbe97f0a3169003.png", "name": "Sticker | Team EnVyUs (Holo) | MLG Columbus 2016", "scm": { "price": 736, "volume": 1 } } ], "tradable": 0, "inspect_link": "steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20S76561198084749846A22547095285D17054198177995786400", "has_screenshot": true, "scm": { "price": 175076, "volume": 0 }, "item_name": "M4A4 | Poseidon", "wear_name": "Factory New", "description": "It has been custom painted with a depiction of a battle between Pisces and Poseidon.\n\nThree can keep a secret if two of them are dead", "collection": "The Gods and Monsters Collection", "badges": [] }, "is_seller": false, "min_offer_price": 221000, "max_offer_discount": 1500, "is_watchlisted": false, "watchers": 0 } ... ] ``` -------------------------------- ### Get All Listings Source: https://docs.csfloat.com/ Retrieves all active listings on CSFloat Market. Supports various filtering and sorting options. ```APIDOC ## GET /api/v1/listings ### Description This endpoint retrieves all active listings on CSFloat Market. ### Method GET ### Endpoint https://csfloat.com/api/v1/listings ### Parameters #### Query Parameters - **cursor** (string) - Optional - Opaque cursor string from a previous fetch, used to fetch the next results - **limit** (integer) - Optional - Defaults to 50. How many listings to return. Max of 50. - **sort_by** (string) - Optional - Defaults to `best_deal`. How to order the listings. Can be one of: `lowest_price`, `highest_price`, `most_recent`, `expires_soon`, `lowest_float`, `highest_float`, `best_deal`, `highest_discount`, `float_rank`, `num_bids` - **category** (integer) - Optional - Defaults to 0. Can be one of: 0 = `any`, 1 = `normal`, 2 = `stattrak`, 3 = `souvenir` - **def_index** (integer) - Optional - Only include listings that have a one of the given def index(es) - **min_float** (number) - Optional - Only include listings that have a float higher than this - **max_float** (number) - Optional - Only include listings that have a float lower than this - **rarity** (integer) - Optional - Only include listings that have this rarity - **paint_seed** (integer) - Optional - Only include listings that have this paint seed - **paint_index** (integer) - Optional - Only include listings that have this paint index - **user_id** (string) - Optional - Only include listings from this SteamID64 - **collection** (string) - Optional - Only include listings from this collection (ie. `set_bravo_ii`, derived from the schema) - **min_price** (integer) - Optional - Only include listings have a price higher than this (in cents) - **max_price** (integer) - Optional - Only include listings have a price lower than this (in cents) - **market_hash_name** (string) - Optional - Only include listings that have this market hash name - **type** (string) - Optional - Either `buy_now` or `auction` - **stickers** (string) - Optional - Must be in the form: `ID|POSITION?[,ID|POSITION?...]`. Position being the sticker slot on the weapon. ### Response #### Success Response (200) - **id** (string) - The unique identifier for the listing. - **created_at** (string) - The timestamp when the listing was created. - **type** (string) - The type of listing (`buy_now` or `auction`). - **price** (integer) - The price of the listing in cents. - **state** (string) - The current state of the listing (e.g., `listed`). - **seller** (object) - Information about the seller. - **avatar** (string) - URL to the seller's avatar. - **flags** (integer) - Seller flags. - **online** (boolean) - Whether the seller is currently online. - **stall_public** (boolean) - Whether the seller's stall is public. - **statistics** (object) - Seller statistics. - **median_trade_time** (integer) - Median trade time in seconds. - **total_failed_trades** (integer) - Total number of failed trades. - **total_trades** (integer) - Total number of successful trades. - **total_verified_trades** (integer) - Total number of verified trades. - **steam_id** (string) - The seller's Steam ID. - **username** (string) - The seller's username. - **item** (object) - Information about the item being listed. - **asset_id** (string) - The asset ID of the item. - **def_index** (integer) - The definition index of the item. - **paint_index** (integer) - The paint index of the item. - **paint_seed** (integer) - The paint seed of the item. - **float_value** (number) - The float value of the item. - **icon_url** (string) - URL to the item's icon. - **d_param** (string) - The `d_param` value for inspect links. - **is_stattrak** (boolean) - Whether the item is StatTrak. - **is_souvenir** (boolean) - Whether the item is Souvenir. - **rarity** (integer) - The rarity of the item. - **quality** (integer) - The quality of the item. - **market_hash_name** (string) - The market hash name of the item. - **stickers** (array) - An array of sticker objects. - **stickerId** (integer) - The ID of the sticker. - **slot** (integer) - The slot the sticker is in. - **icon_url** (string) - URL to the sticker's icon. - **name** (string) - The name of the sticker. - **scm** (object) - Sticker market data. - **price** (integer) - The price of the sticker. - **volume** (integer) - The trading volume of the sticker. - **tradable** (integer) - Indicates if the item is tradable (0 or 1). - **inspect_link** (string) - The inspect link for the item. - **has_screenshot** (boolean) - Whether the item has a screenshot. - **scm** (object) - Item market data. - **price** (integer) - The price of the item. - **volume** (integer) - The trading volume of the item. - **item_name** (string) - The name of the item. - **wear_name** (string) - The wear name of the item (e.g., "Factory New"). - **description** (string) - The description of the item. - **collection** (string) - The collection the item belongs to. - **badges** (array) - An array of badge objects. - **is_seller** (boolean) - Whether the current user is the seller. - **min_offer_price** (integer) - The minimum offer price in cents. - **max_offer_discount** (integer) - The maximum offer discount in cents. - **is_watchlisted** (boolean) - Whether the item is on the user's watchlist. - **watchers** (integer) - The number of users watching the item. ### Request Example ``` GET https://csfloat.com/api/v1/listings?limit=10&sort_by=lowest_price ``` ### Response Example ```json [ { "id": "324288155723370196", "created_at": "2021-06-13T20:45:21.311794Z", "type": "buy_now", "price": 260000, "state": "listed", "seller": { "avatar": "https://steamcdn-a.akamaihd.net/steamcommunity/public/images/avatars/97/974f0a94f47f50a1a6a769fc8ff093cb93a49066_full.jpg", "flags": 435, "online": true, "stall_public": true, "statistics": { "median_trade_time": 236, "total_failed_trades": 0, "total_trades": 24, "total_verified_trades": 24 }, "steam_id": "76561198084749846", "username": "Step7750" }, "item": { "asset_id": "22547095285", "def_index": 16, "paint_index": 449, "paint_seed": 700, "float_value": 0.02796577662229538, "icon_url": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpou-6kejhjxszYfi5H5di5mr-HnvD8J_WCkmkEvp0pi7zDodv3jAHj-UM5ZGr7INfHJAc9MlzV-FK_kO281pa_ot2XnrA-A3kA", "d_param": "17054198177995786400", "is_stattrak": false, "is_souvenir": false, "rarity": 5, "quality": 4, "market_hash_name": "M4A4 | Poseidon (Factory New)", "stickers": [ { "stickerId": 1060, "slot": 3, "icon_url": "columbus2016/nv_holo.fbbf7dc3ef16ade69ac294589fbe97f0a3169003.png", "name": "Sticker | Team EnVyUs (Holo) | MLG Columbus 2016", "scm": { "price": 736, "volume": 1 } } ], "tradable": 0, "inspect_link": "steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20S76561198084749846A22547095285D17054198177995786400", "has_screenshot": true, "scm": { "price": 175076, "volume": 0 }, "item_name": "M4A4 | Poseidon", "wear_name": "Factory New", "description": "It has been custom painted with a depiction of a battle between Pisces and Poseidon.\n\nThree can keep a secret if two of them are dead", "collection": "The Gods and Monsters Collection", "badges": [] }, "is_seller": false, "min_offer_price": 221000, "max_offer_discount": 1500, "is_watchlisted": false, "watchers": 0 } ... ] ``` ``` -------------------------------- ### Get All Listings (cURL) Source: https://docs.csfloat.com/ This command retrieves all active listings on CSFloat Market. It requires an API key for authorization. ```bash curl "https://csfloat.com/api/v1/listings" ``` -------------------------------- ### Get a Specific Listing Source: https://docs.csfloat.com/ This endpoint retrieves the details for a specific listing using its unique ID. It works for both active and inactive listings. ```APIDOC ## GET /api/v1/listings/{ID} ### Description Retrieves the details for a specific listing. ### Method GET ### Endpoint `https://csfloat.com/api/v1/listings/` ### Parameters #### Path Parameters - **ID** (string) - Required - The ID of the listing to retrieve. ### Response #### Success Response (200) - **id** (string) - The unique identifier of the listing. - **created_at** (string) - The timestamp when the listing was created. - **type** (string) - The type of listing (e.g., "buy_now"). - **price** (integer) - The price of the listing. - **state** (string) - The current state of the listing (e.g., "listed"). - **seller** (object) - Information about the seller. - **item** (object) - Information about the item listed. - **is_seller** (boolean) - Indicates if the requester is the seller. - **min_offer_price** (integer) - The minimum offer price. - **max_offer_discount** (integer) - The maximum offer discount. - **is_watchlisted** (boolean) - Indicates if the listing is watchlisted by the requester. - **watchers** (integer) - The number of users watching the listing. ### Response Example ```json { "id": "324288155723370196", "created_at": "2021-06-13T20:45:21.311794Z", "type": "buy_now", "price": 260000, "state": "listed", "seller": { "avatar": "https://steamcdn-a.akamaihd.net/steamcommunity/public/images/avatars/97/974f0a94f47f50a1a6a769fc8ff093cb93a49066_full.jpg", "flags": 435, "online": true, "stall_public": true, "statistics": { "median_trade_time": 236, "total_failed_trades": 0, "total_trades": 24, "total_verified_trades": 24 }, "steam_id": "76561198084749846", "username": "Step7750" }, "item": { "asset_id": "22547095285", "def_index": 16, "paint_index": 449, "paint_seed": 700, "float_value": 0.02796577662229538, "icon_url": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpou-6kejhjxszYfi5H5di5mr-HnvD8J_WCkmkEvp0pi7zDodv3jAHj-UM5ZGr7INfHJAc9MlzV-FK_kO281pa_ot2XnrA-A3kA", "d_param": "17054198177995786400", "is_stattrak": false, "is_souvenir": false, "rarity": 5, "quality": 4, "market_hash_name": "M4A4 | Poseidon (Factory New)", "stickers": [ { "stickerId": 1060, "slot": 3, "icon_url": "columbus2016/nv_holo.fbbf7dc3ef16ade69ac294589fbe97f0a3169003.png", "name": "Sticker | Team EnVyUs (Holo) | MLG Columbus 2016", "scm": { "price": 736, "volume": 1 } } ], "tradable": 0, "inspect_link": "steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20S76561198084749846A22547095285D17054198177995786400", "has_screenshot": true, "scm": { "price": 175076, "volume": 0 }, "item_name": "M4A4 | Poseidon", "wear_name": "Factory New", "description": "It has been custom painted with a depiction of a battle between Pisces and Poseidon.\n\nThree can keep a secret if two of them are dead", "collection": "The Gods and Monsters Collection", "badges": [] }, "is_seller": false, "min_offer_price": 221000, "max_offer_discount": 1500, "is_watchlisted": false, "watchers": 0 } ``` ``` -------------------------------- ### Get Specific Listing Details Source: https://docs.csfloat.com/ Use this cURL command to retrieve all details for a specific listing by providing its unique ID. The response is a JSON object containing comprehensive information about the listing and the item. ```bash curl "https://csfloat.com/api/v1/listings/324288155723370196" ``` ```json { "id": "324288155723370196", "created_at": "2021-06-13T20:45:21.311794Z", "type": "buy_now", "price": 260000, "state": "listed", "seller": { "avatar": "https://steamcdn-a.akamaihd.net/steamcommunity/public/images/avatars/97/974f0a94f47f50a1a6a769fc8ff093cb93a49066_full.jpg", "flags": 435, "online": true, "stall_public": true, "statistics": { "median_trade_time": 236, "total_failed_trades": 0, "total_trades": 24, "total_verified_trades": 24 }, "steam_id": "76561198084749846", "username": "Step7750" }, "item": { "asset_id": "22547095285", "def_index": 16, "paint_index": 449, "paint_seed": 700, "float_value": 0.02796577662229538, "icon_url": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpou-6kejhjxszYfi5H5di5mr-HnvD8J_WCkmkEf700pi7zDodv3jAHj-UM5ZGr7INfHJAc9MlzV-FK_kO281pa_ot2XnrA-A3kA", "d_param": "17054198177995786400", "is_stattrak": false, "is_souvenir": false, "rarity": 5, "quality": 4, "market_hash_name": "M4A4 | Poseidon (Factory New)", "stickers": [ { "stickerId": 1060, "slot": 3, "icon_url": "columbus2016/nv_holo.fbbf7dc3ef16ade69ac294589fbe97f0a3169003.png", "name": "Sticker | Team EnVyUs (Holo) | MLG Columbus 2016", "scm": { "price": 736, "volume": 1 } } ], "tradable": 0, "inspect_link": "steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20S76561198084749846A22547095285D17054198177995786400", "has_screenshot": true, "scm": { "price": 175076, "volume": 0 }, "item_name": "M4A4 | Poseidon", "wear_name": "Factory New", "description": "It has been custom painted with a depiction of a battle between Pisces and Poseidon.\n\nThree can keep a secret if two of them are dead", "collection": "The Gods and Monsters Collection", "badges": [] }, "is_seller": false, "min_offer_price": 221000, "max_offer_discount": 1500, "is_watchlisted": false, "watchers": 0 } ``` -------------------------------- ### List an Item via API Source: https://docs.csfloat.com/ Use this endpoint to list an item on CSFloat. Requires an authorization header and a JSON body specifying item details and price. The response will contain the listing details if successful. ```bash curl -X POST "https://csfloat.com/api/v1/listings" \ -H "Authorization: ; Content-Type: application/json" \ -d '{"asset_id": 21078095468, "type": "buy_now", "price": 8900, "description": "Just for show", "private": false}' ``` ```json { "id": "292312870132253796", "created_at": "2021-03-17T15:06:59.155367Z", "type": "buy_now", "price": 8900, "description": "Just for show", "state": "listed", "seller": { "flags": 48, "obfuscated_id": "9169061817522033479", "online": false, "stall_public": false, "statistics": { "median_trade_time": 305, "total_failed_trades": 0, "total_trades": 13, "total_verified_trades": 13 } }, "item": { "asset_id": "21078095468", "def_index": 60, "paint_index": 77, "paint_seed": 346, "float_value": 0.26253828406333923, "icon_url": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpou-6kejhz2v_Nfz5H_uO-jb-NmOXxIK_ulGRD7cR9teTE8YXghRrhrRBrMWD7coCQegU6aQyE_gC6xOi6gJC5tJTMn3BqvyNztH_VnRS-n1gSOeVXeHpm", "d_param": "721253437254664138", "is_stattrak": false, "is_souvenir": false, "rarity": 2, "quality": 4, "market_hash_name": "M4A1-S | Boreal Forest (Field-Tested)", "stickers": [ { "stickerId": 55, "slot": 0, "icon_url": "emskatowice2014/fnatic.7f37dae42f8afbd799b89f77334be023368ba27a.png", "name": "Sticker | Fnatic | Katowice 2014", "scm": { "price": 41000, "volume": 0 } }, { "stickerId": 55, "slot": 1, "wear": 0.09002881, "icon_url": "emskatowice2014/fnatic.7f37dae42f8afbd799b89f77334be023368ba27a.png", "name": "Sticker | Fnatic | Katowice 2014", "scm": { "price": 41000, "volume": 0 } }, { "stickerId": 73, "slot": 2, "wear": 0.21217501, "icon_url": "emskatowice2014/reason.d48f01f2758c2852ef32a68c49f7039ce211500a.png", "name": "Sticker | Reason Gaming | Katowice 2014", "scm": { "price": 118625, "volume": 0 } }, { "stickerId": 73, "slot": 3, "icon_url": "emskatowice2014/reason.d48f01f2758c2852ef32a68c49f7039ce211500a.png", "name": "Sticker | Reason Gaming | Katowice 2014", "scm": { "price": 118625, "volume": 0 } } ], "tradable": 0, "has_screenshot": true, "scm": { "price": 11, "volume": 0 }, "item_name": "M4A1-S | Boreal Forest", "wear_name": "Field-Tested", "description": "It has been painted using a forest camouflage hydrographic.\n\nThe woods can be a dangerous place... never travel alone", "collection": "The Italy Collection", "badges": [] }, "is_seller": false, "min_offer_price": 7565, "max_offer_discount": 1500, "is_watchlisted": false, "watchers": 0 } ``` -------------------------------- ### List an item Source: https://docs.csfloat.com/ This endpoint allows users to list an item on CSFloat. It supports both 'buy_now' and 'auction' types. An authorization header is required. ```APIDOC ## List an item ### Description This endpoint allows users to list an item on CSFloat. It supports both 'buy_now' and 'auction' types. An authorization header is required. ### Method POST ### Endpoint https://csfloat.com/api/v1/listings ### Parameters #### Request Body - **type** (string) - Optional - Either `buy_now` or `auction`. Defaults to `buy_now`. - **asset_id** (integer) - Required - The ID of the item to list. - **price** (integer) - Required (if `buy_now`) - Either the `buy_now` price or the current bid or reserve price on an `auction`. - **max_offer_discount** (integer) - Optional - `buy_now` max discount for an offer. This will override the default set in your profile. - **reserve_price** (integer) - Required (if `auction`) - `auction` start price. - **duration_days** (integer) - Required (if `auction`) - `auction` duration in days. Can be: `1`, `3`, `5`, `7`, or `14`. - **description** (string) - Optional - User defined description. Max characters of 180. - **private** (boolean) - Optional - If `true`, will hide listings from public searches. Defaults to `false`. ### Request Example ```json { "asset_id": 21078095468, "type": "buy_now", "price": 8900, "description": "Just for show", "private": false } ``` ### Response #### Success Response (200) - **id** (string) - The unique identifier for the listing. - **created_at** (string) - Timestamp when the listing was created. - **type** (string) - The type of listing (`buy_now` or `auction`). - **price** (integer) - The price of the item. - **description** (string) - The description of the item. - **state** (string) - The current state of the listing (e.g., `listed`). - **seller** (object) - Information about the seller. - **item** (object) - Detailed information about the item being listed. - **is_seller** (boolean) - Indicates if the requester is the seller. - **min_offer_price** (integer) - The minimum offer price. - **max_offer_discount** (integer) - The maximum discount for offers. - **is_watchlisted** (boolean) - Indicates if the item is on the watchlist. - **watchers** (integer) - The number of users watching the item. #### Response Example ```json { "id": "292312870132253796", "created_at": "2021-03-17T15:06:59.155367Z", "type": "buy_now", "price": 8900, "description": "Just for show", "state": "listed", "seller": { "flags": 48, "obfuscated_id": "9169061817522033479", "online": false, "stall_public": false, "statistics": { "median_trade_time": 305, "total_failed_trades": 0, "total_trades": 13, "total_verified_trades": 13 } }, "item": { "asset_id": "21078095468", "def_index": 60, "paint_index": 77, "paint_seed": 346, "float_value": 0.26253828406333923, "icon_url": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpou-6kejhz2v_Nfz5H_uO-jb-NmOXxIK_ulGRD7cR9teTE8YXghRrhrRBrMWD7coCQegU6aQyE_gC6xOi6gJC5tJTMn3BqvyNztH_VnRS-n1gSOeVXeHpm", "d_param": "721253437254664138", "is_stattrak": false, "is_souvenir": false, "rarity": 2, "quality": 4, "market_hash_name": "M4A1-S | Boreal Forest (Field-Tested)", "stickers": [ { "stickerId": 55, "slot": 0, "icon_url": "emskatowice2014/fnatic.7f37dae42f8afbd799b89f77334be023368ba27a.png", "name": "Sticker | Fnatic | Katowice 2014", "scm": { "price": 41000, "volume": 0 } }, { "stickerId": 55, "slot": 1, "wear": 0.09002881, "icon_url": "emskatowice2014/fnatic.7f37dae42f8afbd799b89f77334be023368ba27a.png", "name": "Sticker | Fnatic | Katowice 2014", "scm": { "price": 41000, "volume": 0 } }, { "stickerId": 73, "slot": 2, "wear": 0.21217501, "icon_url": "emskatowice2014/reason.d48f01f2758c2852ef32a68c49f7039ce211500a.png", "name": "Sticker | Reason Gaming | Katowice 2014", "scm": { "price": 118625, "volume": 0 } }, { "stickerId": 73, "slot": 3, "icon_url": "emskatowice2014/reason.d48f01f2758c2852ef32a68c49f7039ce211500a.png", "name": "Sticker | Reason Gaming | Katowice 2014", "scm": { "price": 118625, "volume": 0 } } ], "tradable": 0, "has_screenshot": true, "scm": { "price": 11, "volume": 0 }, "item_name": "M4A1-S | Boreal Forest", "wear_name": "Field-Tested", "description": "It has been painted using a forest camouflage hydrographic.\n\nThe woods can be a dangerous place... never travel alone", "collection": "The Italy Collection", "badges": [] }, "is_seller": false, "min_offer_price": 7565, "max_offer_discount": 1500, "is_watchlisted": false, "watchers": 0 } ``` ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.