- CSGOEmpire API Documentation
- Contents
- Getting started
- API Keys
- Libraries & Links
- Rate Limits
- Trade Status Enums
- Metadata
- Get Active Trades
- Get Active Auctions
- Settings
- Transaction History
- Blocking Users
- Deposits
- Withdraw
- Websocket
All requests are included in bash form. You can use a program like Postman to import the request (example) and generate (example) code for most major languages.
Any code provided is as an example, you should write your own if you wish to do more than the most basic tasks.
Any input marked '(required)' is required for the request to work, anything without that is optional.
API keys can be created, viewed and revoked here: https://csgoempire.com/trading/apikey
Setting up an API key requires 2FA to be activated, 2FA codes are not required for requests authenticated via API key.
Currently we don't offer any official library for the API, but below you can find links to unofficial libraries and resources to help you with creating your first bot.
Please note as these are unofficial libraries, they may not be maintained or updated regularly, you should also verify the source code yourself.
If you have something you think should be added here, please open an issue with a link to the library or resource and a description of what it is/does.
- Antal's Deposit Bot by @antal-k - Automated deposit bot for CSGOEmpire
- Pricempire - Price comparison website for most CSGO marketplaces
Rate limits limit the number of requests you can make per second from one IP. Currently there is a global request limit (to any endpoint) of 120 requests per 10 seconds. If you exceed a ratelimit you'll be unable to access any endpoints for 60 seconds. This will return a response with a status code of 429.
Below are a list of trade statuses. Trade endpoints will return status enums.
- Error = -1;
- Pending = 0;
- Received = 1;
- Processing = 2;
- Sending = 3;
- Confirming = 4;
- Sent = 5;
- Completed = 6;
- Declined = 7;
- Canceled = 8;
- TimedOut = 9;
- Credited = 10;
URL: https://csgoempire.com/api/v2/metadata/socket
Method: GET
Returns the user object, which is used to identify via websocket, as well as socket token (authorizationToken) & socket signature (signature) which are used to authenticate on websocket.
Example Request:
curl --location --request GET 'https://csgoempire.com/api/v2/metadata/socket' \
--header 'Authorization: Bearer {API-KEY-HERE}'
Example Response:
{
"user": {
"id": 303119,
"steam_id": "76561198106192114",
"steam_id_v3": "145926386",
"steam_name": "Artemis",
"avatar": "https://steamcdn-a.akamaihd.net/steamcommunity/public/images/avatars/4f/4f619bc788f0d41261d2a5ced0e96a281af88479_full.jpg",
"profile_url": "https://steamcommunity.com/id/G0FastMen/",
"registration_timestamp": "2016-07-27 23:20:03",
"registration_ip": "0.0.0.0",
"last_login": "2021-11-29 13:02:54",
"balance": 0,
"total_profit": 0,
"total_bet": 0,
"betback_total": 0,
"bet_threshold": 0,
"total_trades": 0,
"total_deposit": 0,
"total_withdraw": 0,
"withdraw_limit": 0,
"csgo_playtime": 0,
"last_csgo_playtime_cache": "2016-07-27 23:20:03",
"trade_url": "https://steamcommunity.com/tradeoffer/new/?partner=145926386&token=ABCDEF",
"trade_offer_token": "ABCDEF",
"ref_id": 0,
"total_referral_bet": 0,
"total_referral_commission": 0,
"ref_permission": 0,
"ref_earnings": 0,
"total_ref_earnings": 0,
"total_ref_count": 0,
"total_credit": 0,
"referral_code": "Artemis",
"referral_amount": 50,
"muted_until": 1632354690,
"mute_reason": "Other",
"admin": 0,
"super_mod": 0,
"mod": 0,
"utm_campaign": "",
"country": "",
"is_vac_banned": 2,
"steam_level": 343,
"last_steam_level_cache": "2021-11-30 07:41:07",
"whitelisted": 1,
"total_tips_received": 0,
"total_tips_sent": 0,
"withdrawal_fee_owed": "0.0000",
"flags": 0,
"ban": null,
"balances": [],
"level": 0,
"xp": 0,
"socket_token": "",
"user_hash": "",
"hashed_server_seed": "",
"intercom_hash": "",
"roles": [],
"eligible_for_free_case": false,
"extra_security_type": "2fa",
"total_bet_skincrash": 0,
"total_bet_matchbetting": 0,
"total_bet_roulette": 0,
"total_bet_coinflip": 0,
"total_bet_supershootout": 0,
"p2p_telegram_notifications_allowed": true,
"p2p_telegram_notifications_enabled": true,
"verified": false,
"hide_verified_icon": false,
"unread_notifications": [],
"last_session": {},
"email": "",
"email_verified": false,
"eth_deposit_address": "",
"btc_deposit_address": "",
"ltc_deposit_address": "",
"bch_deposit_address": "",
"steam_inventory_url": "https://steamcommunity.com/profiles/76561198106192114/inventory/#730",
"steam_api_key": "",
"has_crypto_deposit": true,
"chat_tag": {},
"linked_accounts": [],
"api_token": "nice try"
},
"socket_token": "",
"socket_signature": ""
}
Ratelimit
No specific ratelimit, global ratelimit of 120 requests per 10 seconds applies.
URL: https://csgoempire.com/api/v2/trading/user/trades
Method: GET
Returns an array of all items currently being deposited or withdrawn by this account. This does not include bids placed on active items until the auction ends.
Example Request:
curl --location --request GET 'https://csgoempire.com/api/v2/trading/user/trades' \
--header 'Authorization: Bearer {API-KEY-HERE}'
Example Response:
{
"success": true,
"data": {
"deposits": [
{
"id": 11203,
"service_name": "csgoempire",
"service_invoice_id": 920,
"user_id": 303119,
"item_id": 50755,
"items": [
{
"asset_id": 26876810352,
"created_at": "2022-10-14 13:54:35",
"custom_price_percentage": 0,
"full_position": 83,
"icon_url": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpovbSsLQJf3qr3czxb49KzgL-DjsjwN6vQglRd4cJ5nqeQ89mk2VHg_UpkYjj0JdLGdAFvNAvS81G6kLjq1pHtv5SdnHdhuCYq-z-DyHWIya-0",
"id": 50755,
"is_commodity": false,
"market_name": "★ M9 Bayonet | Forest DDPAT (Factory New)",
"market_value": 488.82,
"name_color": "8650AC",
"position": null,
"preview_id": null,
"price_is_unreliable": 1,
"tradable": true,
"tradelock": false,
"updated_at": "2022-10-18 08:46:45",
"wear": null
}
],
"total_value": 48882,
"security_code": "",
"tradeoffer_id": 0,
"trade_id": 2,
"status": 2,
"status_message": "",
"metadata": {
"auction_highest_bid": null,
"auction_highest_bidder": null,
"auction_number_of_bids": 0,
"auction_ends_at": 1666083002,
"auction_auto_withdraw_failed": null,
"price_updated_at": null,
"trade_url": null,
"partner": null,
"total_fee": null,
"fee": null,
"old_total_value": null,
"item_position_in_inventory": null,
"item_inspected": true,
"expires_at": null,
"delivery_time": null,
"phishingScamDetected": null,
"item_validation": null,
"penalty": null
},
"item_hash": "7d1cacdc3016c134e284ae253543cc3b0fd63942",
"created_at": "2022-10-18 08:47:02",
"updated_at": "2022-10-18 08:47:02"
}
],
"withdrawals": [
]
}
}Ratelimit
3 requests per 10 seconds, block for 1 minute.URL: https://csgoempire.com/api/v2/trading/user/auctions
Method: GET
Returns an array of all auctions currently being bid on by this account.
Example Request:
curl --location --request GET 'https://csgoempire.com/api/v2/trading/user/auctions' \
--header 'Authorization: Bearer {API-KEY-HERE}'
Example Response:
{
"success": true,
"active_auctions": [
{
"auction_ends_at": 1666083221,
"auction_highest_bid": 227,
"auction_highest_bidder": 303119,
"auction_number_of_bids": 1,
"custom_price_percentage": 0,
"icon_url": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXX7gNTPcUmqBwTTR7SQb37g5vWCwlxdFEC5uyncgZi0vGQJWwQudm0xtTexaD2ZOmClyVB5sL8h7mCHA",
"is_commodity": true,
"market_name": "Name Tag",
"market_value": 227,
"name_color": "D2D2D2",
"preview_id": null,
"price_is_unreliable": true,
"stickers": [
],
"wear": null,
"published_at": "2022-10-18T08:51:02.803761Z",
"id": 11204,
"depositor_stats": {
"delivery_rate_recent": 0.6,
"delivery_rate_long": 0.7567567567567568,
"delivery_time_minutes_recent": 7,
"delivery_time_minutes_long": 7,
"steam_level_min_range": 5,
"steam_level_max_range": 10,
"user_has_trade_notifications_enabled": false,
"user_is_online": null
},
"above_recommended_price": -5
}
]
}Ratelimit
No specific ratelimit, global ratelimit of 120 requests per 10 seconds applies.
URL: https://csgoempire.com/api/v2/trading/user/settings
Method: POST
Used to update your tradelink and/or Steam API key
Inputs:
- trade_url (required): string, your steam trade url
- steam_api_key : string, your steam api key
Example Request:
curl --location --request POST 'https://csgoempire.com/api/v2/trading/user/settings' \
--header 'Authorization: Bearer {API-KEY-HERE}' \
--header 'Content-Type: application/json' \
--data-raw '{"trade_url":"https://steamcommunity.com/tradeoffer/new/?partner=145926386&token=zYMYgbXB"}'Example Response:
{
"success": true,
"escrow_seconds": 0
}Ratelimit
No specific ratelimit, global ratelimit of 120 requests per 10 seconds applies.
URL: https://csgoempire.com/api/v2/user/transactions?page={page_number}
Method: GET
Used to get your transaction history.
Inputs:
- page_number : int, the page you wish to get
Example Request:
curl --location --request GET 'https://csgoempire.com/api/v2/user/transactions?page=1' \
--header 'Authorization: Bearer {API-KEY-HERE}'Example Response:
{
"current_page": 1,
"data": [
{
"id": 54773614,
"key": "withdrawal_invoices",
"type": "Steam Auction Bid Withdrawal",
"balance": 17543153,
"delta": -227,
"balance_after": 17542926,
"timestamp": 1666083061.355,
"timestamp_raw": 1666083061355,
"date": "2022-10-18 08:51:01",
"invoice_id": null,
"data": {
"id": 69,
"processor_name": "Steam",
"status": 200,
"status_name": "Created",
"metadata": {
"deposit_id": 11204,
"payment_method": "auction_bid",
"id": 11204,
"auction_highest_bid": 227,
"auction_highest_bidder": 303119,
"auction_number_of_bids": 1,
"auction_ends_at": 1666083221
}
}
}
],
"first_page_url": "user/transactions?page=1",
"from": 1,
"last_page": 2499,
"last_page_url": "user/transactions?page=2499",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "user/transactions?page=1",
"label": "1",
"active": true
},
{
"url": "user/transactions?page=2",
"label": "2",
"active": false
},
{
"url": "user/transactions?page=3",
"label": "3",
"active": false
},
{
"url": "user/transactions?page=4",
"label": "4",
"active": false
},
{
"url": "user/transactions?page=5",
"label": "5",
"active": false
},
{
"url": "user/transactions?page=6",
"label": "6",
"active": false
},
{
"url": "user/transactions?page=7",
"label": "7",
"active": false
},
{
"url": "user/transactions?page=8",
"label": "8",
"active": false
},
{
"url": "user/transactions?page=9",
"label": "9",
"active": false
},
{
"url": "user/transactions?page=10",
"label": "10",
"active": false
},
{
"url": null,
"label": "...",
"active": false
},
{
"url": "user/transactions?page=2498",
"label": "2498",
"active": false
},
{
"url": "user/transactions?page=2499",
"label": "2499",
"active": false
},
{
"url": "user/transactions?page=2",
"label": "Next »",
"active": false
}
],
"next_page_url": "user/transactions?page=2",
"path": "user/transactions",
"per_page": 1,
"prev_page_url": null,
"to": 1,
"total": 2499
}Ratelimit
No specific ratelimit, global ratelimit of 120 requests per 10 seconds applies.
URL: https://csgoempire.com/api/v2/trading/block-list/{steam_id}
Method: POST
Used to block a user, preventing them from trading with you, and you with them.
Inputs:
- steam_id : string, the users steam ID
Example Request:
curl --location --request POST 'https://csgoempire.com/api/v2/trading/block-list/76561197960287930' \
--header 'Authorization: Bearer {API-KEY-HERE}'Example Response:
{
"success": true,
}Ratelimit
No specific ratelimit, global ratelimit of 120 requests per 10 seconds applies.
URL: https://csgoempire.com/api/v2/trading/block-list/{steam_id}
Method: DELETE
Used to unblock a user, allowing them to trade with you, and you with them.
Inputs:
- steam_id : string, the users steam ID
Example Request:
curl --location --request DELETE 'https://csgoempire.com/api/v2/trading/block-list/76561197960287930' \
--header 'Authorization: Bearer {API-KEY-HERE}'Example Response:
{
"success": true,
}Ratelimit
No specific ratelimit, global ratelimit of 120 requests per 10 seconds applies.
URL: https://csgoempire.com/api/v2/trading/block-list
Method: GET
Used to get a list of all currently blocked users.
Example Request:
curl --location --request GET 'https://csgoempire.com/api/v2/trading/block-list' \
--header 'Authorization: Bearer {API-KEY-HERE}'Example Response:
[
{
"id": 1,
"blocker_user_id": 76561198106192114,
"blocked_user_id": 76561197960287930,
"created_at": "2022-02-15 11:57:08",
"updated_at": "2022-02-15 11:57:08"
}
]Ratelimit
No specific ratelimit, global ratelimit of 120 requests per 10 seconds applies.
URL: https://csgoempire.com/api/v2/trading/user/inventory
Method: GET
Fetch your inventory from steam and caches it to the database for 1 hour.
Inputs:
- invalid : yes|no - Filters invalid items, defaults to no filtering
Example Request:
curl --location --request GET 'https://csgoempire.com/api/v2/trading/user/inventory' \
--header 'Authorization: Bearer {API-KEY-HERE}'Example Response:
{
"success": true,
"updatedAt": 1666082810,
"allowUpdate": true,
"data": [
{
"asset_id": 26876810352,
"created_at": "2022-10-14 13:54:35",
"custom_price_percentage": null,
"full_position": 83,
"icon_url": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpovbSsLQJf3qr3czxb49KzgL-DjsjwN6vQglRd4cJ5nqeQ89mk2VHg_UpkYjj0JdLGdAFvNAvS81G6kLjq1pHtv5SdnHdhuCYq-z-DyHWIya-0",
"id": 50755,
"invalid": "This item is currently in an active deposit.",
"is_commodity": false,
"market_name": "★ M9 Bayonet | Forest DDPAT (Factory New)",
"market_value": 48882,
"name_color": "8650AC",
"position": null,
"preview_id": "43246cdca7fe",
"price_is_unreliable": 1,
"stickers": [],
"tradable": true,
"tradelock": false,
"updated_at": "2022-10-18 08:46:45",
"wear": 0.064
},
{
"asset_id": 27299195480,
"created_at": "2022-10-14 13:54:34",
"custom_price_percentage": null,
"full_position": 27,
"icon_url": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpou7uifDhnwMzFcDoV09ajh5SClPLLP7LWnn8f7sZ1ib6S9I6i3w21qUNlYDymI9KcclI3YAvRr1Ltwujm18TvtMnPzGwj5Hdb1VS4mQ",
"id": 50696,
"is_commodity": false,
"market_name": "StatTrak™ MAG-7 | Justice (Factory New)",
"market_value": 3267,
"name_color": "CF6A32",
"position": 2,
"preview_id": null,
"price_is_unreliable": 0,
"stickers": [
{
"sticker_id": 3453,
"wear": null,
"name": "Legendary Eagle Master (Holo)",
"image": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXQ9QVcJY8gulROR0XcS-O_2NrDbF51NRdCur_qJwJt7PvHfTJ94N2kk4XFw_OhZbmAxWhT7Zcp3u2TpIqmilDl8hZsMjylJoHEIAA9ZQ2B-1W-xfCv28G5r0_B7Q"
}
],
"tradable": true,
"tradelock": false,
"updated_at": "2022-10-18 08:46:45",
"wear": 0.068
}
]
}Ratelimit
No specific ratelimit, global ratelimit of 120 requests per 10 seconds applies.
URL: https://csgoempire.com/api/v2/trading/user/inventory/unique-info
Method: GET
Get inspected unique info for items in user inventory. Examples include float/sticker data
Example Request:
curl --location --request GET 'https://csgoempire.com/api/v2/trading/user/inventory/unique-info' \
--header 'Authorization: Bearer {API-KEY-HERE}'Example Response:
{
"success": true,
"data": [
{
"id": 50696,
"asset_id": 27299195480,
"wear": 0.068,
"stickers": [
{
"slot": 0,
"sticker_id": 3453,
"wear": null,
"scale": null,
"rotation": null,
"tint_id": null,
"name": "Legendary Eagle Master (Holo)",
"image": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXQ9QVcJY8gulROR0XcS-O_2NrDbF51NRdCur_qJwJt7PvHfTJ94N2kk4XFw_OhZbmAxWhT7Zcp3u2TpIqmilDl8hZsMjylJoHEIAA9ZQ2B-1W-xfCv28G5r0_B7Q"
}
]
},
{
"id": 50697,
"asset_id": 27297587028,
"wear": 0.392,
"stickers": [
]
}
}Ratelimit
No specific ratelimit, global ratelimit of 120 requests per 10 seconds applies.
URL: https://csgoempire.com/api/v2/trading/deposit
Method: POST
List an item(s) for sale.
Inputs:
- Items: (required) array with array elements: [id: itemId, coin_value: int] (Max 20 per request)
Notes:
- coin_value is in coin cents, so 100.01 coins is represented as 10001
- coin_value should be the price you want to list at. If you want to list at 100.01 coins, you should set coin_value to 10001. See below for how to calculate the coin value.
- the frontend works differently, use how these docs suggest, the requests are smaller and therefore faster than the frontend.
- you should be chunking these requests into groups of 20, but it's not required. If you don't chunk, you'll list slower and hit ratelimits more often.
- Individual deposit state's will be announced to the websocket, so monitor that to see when your items are listed. Errors will use the key
deposit_failedand will contain the item id and error message.
Pricing example:
percent = 5
market_price = 10001
price = round(market_price * (percent/100+1))
item = {
"id": 3731677705,
"coin_value": price
}Example Input:
{
"items": [
{
"id": 3731677704,
"coin_value": 576811
},
{
"id": 3731677705,
"coin_value": 52811
}
]
}Example Request:
y> curl --location --request POST 'https://csgoempire.com/api/v2/trading/deposit' \
--header 'Authorization: Bearer {API-KEY-HERE}' \
--header 'Content-Type: application/json' \
--data-raw '{"items":[{"id":50755,"coin_value":48882}]}'Example Response:
{
"success": true
}Ratelimit
20 requests per 10 seconds, block for 1 minute.
URL: https://csgoempire.com/api/v2/trading/deposit/{DEPOSIT-ID}/cancel
Method: POST
Cancels processing deposit without any bids. Once a bid has been placed items are no longer eligible to be cancelled.
Example Request:
curl --location --request POST 'https://csgoempire.com/api/v2/trading/deposit/28391470/cancel' \
--header 'Authorization: Bearer {API-KEY-HERE}'Example Response:
{
"success": true
}Ratelimit
Success: Global ratelimit Error: 20 requests per 10 seconds, block for 1 minute.
URL: https://csgoempire.com/api/v2/trading/deposit/cancel
Method: POST
Cancels processing multiple deposit without any bids. Once a bid has been placed items are no longer eligible to be cancelled.
Inputs:
- Array of deposits ids (required) : integer
Example Request:
curl --location --request POST 'https://csgoempire.com/api/v2/trading/deposit/cancel' \
--header 'Authorization: Bearer {API-KEY-HERE}' \
--data-raw '{"ids":[10001, 10002, 10003, 10004, 10005]}'Example Response:
{
"success": true,
"data": {
"10001": {"success":false,"message":"You don't have a cancellable deposit."},
"10002": {"success":true},
"10003": {"success":true},
"10004": {"success":true},
"10005": {"success":false,"message":"You don't have a cancellable deposit."}
}
}
Ratelimit
Success: Global ratelimit Error: 20 requests per 10 seconds, block for 1 minute.
URL: https://csgoempire.com/api/v2//trading/deposit/{deposit_id}/sell
Method: POST
Sell an item immediately.
Inputs:
- deposit_id (required) : integer - Required in the URL
Example Request:
curl --location --request POST 'https://csgoempire.com/api/v2/trading/deposit/28393316/sell' \
--header 'Authorization: Bearer {API-KEY-HERE}'Example Response:
{
"success": true,
"auction_data": {
"id": 28393316,
"app_id": 730,
"auction_highest_bid": 54,
"auction_highest_bidder": 2700170,
"auction_number_of_bids": 2,
"auction_ends_at": 1638273900
}
}Ratelimit
No specific ratelimit, global ratelimit of 120 requests per 10 seconds applies.
URL: https://csgoempire.com/api/v2/trading/items
Method: GET
Get a list of all items listed on the withdrawals page
Inputs:
- per_page - (required), number. How many items to fetch. Min is 1 and max is 200 for guests and 2500 for logged in user
- page - (required), number. Page to fetch.
- search - string. Item market name to search. 2 char min length.
- order - string. Field to use for ordering supported fields: market_value
- sort - string. Sorting asc or desc. Default asc
- auction - string. Auction only, yes/no, defaults to no.
- price_min - number. Minimum item current price.
- price_max - number. Maximum item current price.
- price_max_above - number. Maximum item percentage to show.
- wear_min - number (0-1). Minimum float wear value.
- wear_max - number (0-1). Maximum float wear value.
- delivery_time_long_min - number. Minimum delivery time average from the last 100 items.
- delivery_time_long_max - number. Maximum delivery time average from the last 100 items.
- has_stickers - yes/no. Filters for items that have stickers.
- is_commodity - yes/no. Filters for items that are commodities. Cannot have wear/sticker based filters.
Example Request:
curl --location --request GET 'https://csgoempire.com/api/v2/trading/items?per_page=10&page=1&price_max_above=15&sort=desc&order=market_value' \
--header 'Authorization: Bearer {API-KEY-HERE}'Example Response:
{
"current_page": 1,
"data": [
{
"auction_ends_at": 1665762091,
"auction_highest_bid": null,
"auction_highest_bidder": null,
"auction_number_of_bids": 0,
"custom_price_percentage": 0,
"icon_url": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpou-6kejhnwMzFJQJE4NOhkZKYqPrxN7LEmyVQ7JMkieiTp92sjAzs_hc4Nm_7LdCcdQdrNVrU_gK6xOnt0MO4tZvP1zI97XHPMlL3",
"is_commodity": false,
"market_name": "StatTrak™ M4A4 | Spider Lily (Well-Worn)",
"market_value": 240,
"name_color": "CF6A32",
"preview_id": "3d33db497b7b",
"price_is_unreliable": false,
"stickers": [],
"wear": 0.431,
"published_at": "2022-10-14T15:38:33.947439Z",
"id": 11196,
"depositor_stats": {
"delivery_rate_recent": 1,
"delivery_rate_long": 0.9565217391304348,
"delivery_time_minutes_recent": 2,
"delivery_time_minutes_long": 3,
"steam_level_min_range": 5,
"steam_level_max_range": 10,
"user_has_trade_notifications_enabled": false,
"user_is_online": null
},
"above_recommended_price": -6
}
],
"first_page_url": "http://csgoempire.com/api/trading/items?per_page=10&price_max_above=15&sort=desc&order=market_value&page=1",
"from": 1,
"last_page": 1,
"last_page_url": "http://csgoempire.com/api/trading/items?per_page=10&price_max_above=15&sort=desc&order=market_value&page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "http://csgoempire.com/api/trading/items?per_page=10&price_max_above=15&sort=desc&order=market_value&page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "http://csgoempire.com/api/trading/items",
"per_page": "10",
"prev_page_url": null,
"to": 1,
"total": 1
}Ratelimit
20 requests per 10 seconds if not searching, 3 requests per 10 seconds if searching
URL: https://csgoempire.com/api/v2/trading/deposit/{DEPOSIT_ID}/stats
Method: GET
Get the depositing users stats from a unique deposit ID
Inputs:
- deposit_id (required) : integer - Required in the URL
Example Request:
curl --location --request GET 'https://csgoempire.com/api/v2/trading/deposit/28079776/stats' \
--header 'Authorization: Bearer {API-KEY-HERE}'Example Response:
{
"delivery_rate_recent": 1,
"delivery_rate_long": 1,
"delivery_time_minutes_recent": null,
"delivery_time_minutes_long": null,
"steam_level_min_range": 100,
"steam_level_max_range": 5000,
"user_has_trade_notifications_enabled": false,
"user_is_online": null
}Ratelimit
No specific ratelimit, global ratelimit of 120 requests per 10 seconds applies.
URL: https://csgoempire.com/api/v2/trading/deposit/{DEPOSIT_ID}/withdraw
Method: POST
Withdraw item directly if the auction has expired without being won.
Inputs:
- deposit_id (required) : integer - Required in the URL
- coin_value (required) : integer - The item price.
Example Request:
curl --location --request POST 'https://csgoempire.com/api/v2/trading/deposit/28396506/withdraw' \
--header 'Authorization: Bearer {API-KEY-HERE}' \
--header 'Content-Type: application/json' \
--data-raw '{"coin_value":64}'Example Response:
{
"success": true,
"data": {
"id": 13745535,
"user_id": 303119,
"item_id": null,
"items": [
{
"app_id": 730,
"created_at": 1638267229,
"custom_price_percentage": null,
"icon_url": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXQ9QVcJY8gulROWEPTTOz_h52CHFp7ITtRubOpZVZh1vGbJW0Xuoq3zdiKxfKsNunVxj1TsMEk3LmS9930jQPnqEI6NW3tZNjC2hpzSfU",
"id": 28387732,
"img": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXQ9QVcJY8gulROWEPTTOz_h52CHFp7ITtRubOpZVZh1vGbJW0Xuoq3zdiKxfKsNunVxj1TsMEk3LmS9930jQPnqEI6NW3tZNjC2hpzSfU",
"is_commodity": true,
"market_name": "Sticker | GODSENT (Foil) | Stockholm 2021",
"market_value": 0.41,
"name": "Sticker | GODSENT (Foil) | Stockholm 2021",
"name_color": "D2D2D2",
"paint_index": null,
"preview_id": null,
"price_is_unreliable": false,
"tradable": true,
"tradelock": false,
"type": "Exotic Sticker",
"updated_at": "2021-11-30 13:41:36",
"wear": null
}
],
"total_value": 41,
"security_code": "",
"tradeoffer_id": 28387732,
"trade_id": 2,
"status": 4,
"status_message": "Confirming",
"metadata": {
"auction_highest_bid": null,
"auction_highest_bidder": null,
"auction_number_of_bids": 0,
"auction_ends_at": 1638267409,
"auction_auto_withdraw_failed": null,
"price_updated_at": null,
"trade_url": null,
"partner": null,
"total_fee": null,
"fee": null,
"old_total_value": null,
"item_position_in_inventory": 2,
"item_inspected": false,
"steam_id": "76561198106192114",
"expires_at": null,
"delivery_time": null,
"phishingScamDetected": null,
"item_validation": null,
"possible_abuse_detected_at": null,
"penalty": null,
"service_name": "csgoempire",
"service_invoice_id": 3881481
},
"created_at": "2021-11-30 13:46:29",
"updated_at": "2021-11-30 13:46:29"
},
"invoice": {
"user_id": 303119,
"status": 201,
"processor_id": 1,
"currency_id": 1,
"amount_coins": 41,
"metadata": {
"deposit_id": 28387732
},
"ip": "0.0.0.0",
"updated_at": "2021-11-30 13:46:29",
"created_at": "2021-11-30 13:46:27",
"id": 5191251,
"processor_txid": "13745535",
"user": {
"id": 303119,
"steam_id": "76561198106192114",
"steam_id_v3": "145926386",
"steam_name": "Artemis",
"avatar": "https://steamcdn-a.akamaihd.net/steamcommunity/public/images/avatars/4f/4f619bc788f0d41261d2a5ced0e96a281af88479_full.jpg",
"profile_url": "https://steamcommunity.com/id/G0FastMen/",
"registration_timestamp": "2016-07-27 23:20:03",
"registration_ip": "0.0.0.0",
"last_login": "2021-11-29 13:02:54",
"balance": 0,
"total_profit": 0,
"total_bet": 0,
"betback_total": 0,
"bet_threshold": 0,
"total_trades": 0,
"total_deposit": 0,
"total_withdraw": 0,
"withdraw_limit": 0,
"csgo_playtime": 0,
"last_csgo_playtime_cache": "2016-07-27 23:20:03",
"trade_url": "https://steamcommunity.com/tradeoffer/new/?partner=145926386&token=ABCDEF",
"trade_offer_token": "ABCDEF",
"ref_id": 0,
"total_referral_bet": 1,
"total_referral_commission": 1,
"ref_permission": 1,
"ref_earnings": 0,
"total_ref_earnings": 1,
"total_ref_count": 0,
"total_credit": 1,
"referral_code": null,
"referral_amount": 50,
"muted_until": 1632354690,
"mute_reason": "Other",
"admin": 0,
"super_mod": 0,
"mod": 0,
"utm_campaign": "",
"country": "",
"is_vac_banned": 2,
"steam_level": 343,
"last_steam_level_cache": "2021-11-30T13:46:29.814674Z",
"whitelisted": 1,
"total_tips_received": 0,
"total_tips_sent": 0,
"withdrawal_fee_owed": "0.0000",
"flags": 704,
"encrypted_fields": [],
"balances": [],
"kyc": [],
"steam_data": {
"user_id": 303119,
"timecreated": 1378522915
}
},
"status_name": "Processing",
"processor_name": "Steam P2P"
}
}Ratelimit
Success: 8 requests per 10 seconds, block for 1 minute Failure: 2 per 10 seconds, block for 1 minute
URL: https://csgoempire.com/api/v2/trading/deposit/{DEPOSIT_ID}/bid
Method: POST
Place a bid on an auction.
Inputs:
- bid_value (required) : integer, the amount of coins to bid.
Example Request:
curl --location --request POST 'https://csgoempire.com/api/v2/trading/deposit/28396506/bid' \
--header 'Authorization: Bearer {API-KEY-HERE}' \
--header 'Content-Type: application/json' \
--data-raw '{"bid_value":64}'Example Response:
{
"success": true,
"auction_data": {
"id": 28396506,
"app_id": 730,
"auction_highest_bid": 64,
"auction_highest_bidder": 303119,
"auction_number_of_bids": 11,
"auction_ends_at": 1638279554
},
"invoice": {
"user_id": 303119,
"status": 200,
"processor_id": 1,
"currency_id": 1,
"amount_coins": 64,
"metadata": {
"deposit_id": 28396506
},
"ip": "0.0.0.0",
"updated_at": 1638279494,
"created_at": 1638279490,
"id": 5190329,
"processor_ref": "15064711",
"status_name": "CREATED",
"processor_name": "Steam P2P",
"currency_code": "CSGOEMPIRE_COIN",
"complete_at": null,
"refunded_at": null
}
}Ratelimit
Success: 20 requests per 10 seconds, block for 1 minute Failure: 20 per 10 seconds, block for 1 minute
URL: https://csgoempire.com/api/trading/user/withdrawals/{WITHDRAWAL_ID}
Method: DELETE
Cancel a withdrawal if unsent and past the 30 minute mark.
Example Request:
curl --location --request DELETE 'https://csgoempire.com/api/trading/user/withdrawals/12345' \
--header 'Authorization: Bearer {API-KEY-HERE}' \
--header 'Content-Type: application/json'Example Response:
{
"success": true
}Ratelimit
No specific ratelimit, global ratelimit of 120 requests per 10 seconds applies.
URL: wss://trade.csgoempire.com/s/?EIO=3&transport=websocket
Example code for connecting to the websocket can be found here
Note: Connecting to the socket requires Socket.IO v2.x Client
The socket can be used as unauthenticated but if you want to receive trade updates you need to auth. To authenticate you need to emit identify event with the data:
Example Frame:
{
"uid": <userid>,
"model": { ...user_model },
"authorizationToken": <token>,
"signature": <token_signature>,
"uuid": <optional_device_identifier>
}See metadata on how to get the required socket auth data.
This returns the following:
Example Response:
[
"init",
{
"authenticated":true,
"serverTime":"2021-11-30T08:30:09.443Z",
"server":"trade:slave-server:GpOfWK",
"id":303119,
"steam_name":"Artemis",
"steam_id":"76561198106192114",
"verified":false,
"hide_verified_icon":false,
"avatar":"https://steamcdn-a.akamaihd.net/steamcommunity/public/images/avatars/4f/4f619bc788f0d41261d2a5ced0e96a281af88479_full.jpg",
"profile_url":"https://steamcommunity.com/id/G0FastMen/",
"balance":1533471521,
"bet_threshold":0,
"total_bet":2147483647,
"total_deposit":2182538,
"withdraw_limit":234118685,
"ref_id":0,
"referral_code":"Artemis",
"muted_until":0,
"mute_reason":"",
"utm_campaign":"",
"is_vac_banned":2,
"whitelisted":false,
"registration_ip":"0.0.0.0",
"steam_level":343,
"registration_timestamp":"2016-07-27 23:20:03",
"total_profit":-689280648,
"roles":[
"super-mod",
"tester",
"support-manager",
"root",
"matchbetting-beta",
"shark",
"admin",
"manager",
"mod"
],
"chat_tag":null,
"uid":303119,
"helper_mod":false,
"mod":true,
"super_mod":true,
"admin":true,
"qa":false,
"deposited":true,
"lvl":119,
"badge_text":null,
"badge_text_localized":null,
"badge_color":null,
"hide_rank":null,
"name":"Artemis"
}
]After you're identified you'll want to submit the default filters to subscribe to item updates. Without this being emitted, item updates will not be sent to you.
To do this, emit the following:
Filters:
{
"price_max": 9999999
}In most languages, this will look something like emit('filters', {'price_max': 9999999});.
All websocket events can be either a single item OR an array containing multiple items.
Syncing server timestamp. It is not emitted unless the client asks it by sending timesync event.
Event sample:
["timesync",1619682261540]Emitted when a new item is available.
Event sample:
[
"new_item",
[
{
"auction_ends_at": 1682284226,
"auction_highest_bid": null,
"auction_highest_bidder": null,
"auction_number_of_bids": 0,
"custom_price_percentage": 197,
"icon_url": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgposr-kLAtl7PLFTj9Q49Kskb-Yh_bmOLfUqWdY781lxL2T8Y-kjAa2qhZlNmz7ItCSd1I4ZVrVrFi6kO_mgJa9uJXAyHdguXI8pSGKoKTrgPA",
"is_commodity": false,
"market_name": "Desert Eagle | Bronze Deco (Factory New)",
"market_value": 353,
"name_color": "D2D2D2",
"preview_id": null,
"price_is_unreliable": false,
"stickers": [
{
"sticker_id": 377,
"wear": null,
"name": "Kawaii Killer Terrorist",
"image": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXQ9QVcJY8gulReQ0HdUuqkw9aDARJ_JBNWv7OuIgts1uH3ZQJO7c6xkc6PkaOkYe2Ik2hVsJIgibqV9t2hjAy28kJpNWjzIYGXd1JoNA6G_lHv366x0hEUSJjM"
},
{
"sticker_id": 965,
"wear": null,
"name": "Merietta",
"image": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXQ9QVcJY8gulRNRULFV_eS1M7DQEh4IEtas6isLhN00szEcC9F6ZLux9ONzvP3Y-yJwTtX6pQj3-uWp9qs2A3n-kRkMjvxLNWcegNqYQ7Z5BHgliqAJ7zD"
}
],
"wear": 0.053,
"published_at": "2023-04-23T21:07:36.874150Z",
"id": 148843931,
"depositor_stats": {
"delivery_rate_recent": 1,
"delivery_rate_long": 0.99,
"delivery_time_minutes_recent": 0,
"delivery_time_minutes_long": 17,
"steam_level_min_range": 5,
"steam_level_max_range": 10,
"user_has_trade_notifications_enabled": true,
"user_is_online": null
},
"above_recommended_price": 191,
"purchase_price": 353
},
{
"auction_ends_at": 1682284227,
"auction_highest_bid": null,
"auction_highest_bidder": null,
"auction_number_of_bids": 0,
"custom_price_percentage": 14,
"icon_url": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpot7HxfDhjxszJemkV09G3h5SOhe7LPr7Vn35cpsEl0-2Xrdii3APt-RI4ZG71IdOXelJoZVDX_li7kOu-1MW6uZ_JyHV9-n51hRUaMfs",
"is_commodity": false,
"market_name": "AK-47 | Elite Build (Field-Tested)",
"market_value": 266,
"name_color": "D2D2D2",
"preview_id": null,
"price_is_unreliable": false,
"stickers": [
{
"sticker_id": 5132,
"wear": null,
"name": "Perfecto | Stockholm 2021",
"image": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXQ9QVcJY8gulROWEPTTOz_h52CHE59IjtHs6ijLgR03MzEcC9F6ZLmwdPTlqGjau7XxWoGvJRz272Uotqh3FLmrkBvMTvzJNWUdw8_NQqD5BHgljRT2dJr"
},
{
"sticker_id": 4777,
"wear": null,
"name": "Liquid | 2020 RMR",
"image": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXQ9QVcJY8gulRPQV6CF7b9mMPaQmJ4JBZQs_Skf1Q41afJdTsX796zlYPclaWtMr3Vwm1XuJcpj-uRrdml3ADkqkNrfSmtc1IIUOC7"
},
{
"sticker_id": 4536,
"wear": 0.7532175183296204,
"name": "Extermination",
"image": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXQ9QVcJY8gulRVTUDfCOG1w8rBXlR6JBBeubSaJwZy1PaGcmUTvI_hzNnSwPb2ZbmEkm4EuJUj276Xo4-mjgew-0BpZG-gcNTDIBh-Pw_rXqC9BQ"
},
{
"sticker_id": 923,
"wear": 0.6144185066223145,
"name": "Flipsid3 Tactics | Cluj-Napoca 2015",
"image": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXQ9QVcJY8gulReQFnaFbT8goDVX1RkGghWpL2gZVVm16DOdT5G7t3kxobawPakN-uIwzgDv5Ap0rmVrNyk3FG1-EA-MmjtZNjCmcnHFc4"
}
],
"wear": 0.346,
"published_at": "2023-04-23T21:07:37.029237Z",
"id": 148843957,
"depositor_stats": {
"delivery_rate_recent": 1,
"delivery_rate_long": 0.99,
"delivery_time_minutes_recent": 0,
"delivery_time_minutes_long": 17,
"steam_level_min_range": 5,
"steam_level_max_range": 10,
"user_has_trade_notifications_enabled": true,
"user_is_online": null
},
"above_recommended_price": 8,
"purchase_price": 266
},
{
"auction_ends_at": 1682284229,
"auction_highest_bid": null,
"auction_highest_bidder": null,
"auction_number_of_bids": 0,
"custom_price_percentage": 11,
"icon_url": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpovbSsLQJf3qr3czxb49KzgL-Khsj2P67UklRc7cF4n-SP9tXw3gLl-BZvamGhIIDAIwQ8NAyB_1C8wO-61pfvup_By3Yw63Uj7GGdwUKpIv7t7w",
"is_commodity": false,
"market_name": "★ M9 Bayonet | Blue Steel (Field-Tested)",
"market_value": 106933,
"name_color": "8650AC",
"preview_id": "13bbfe513e9c",
"price_is_unreliable": false,
"stickers": [],
"wear": 0.18,
"published_at": "2023-04-23T21:07:37.118648Z",
"id": 148844032,
"depositor_stats": {
"delivery_rate_recent": 1,
"delivery_rate_long": 1,
"delivery_time_minutes_recent": 1,
"delivery_time_minutes_long": 2,
"steam_level_min_range": 100,
"steam_level_max_range": 5000,
"user_has_trade_notifications_enabled": false,
"user_is_online": null
},
"above_recommended_price": 5,
"purchase_price": 106933
}
]
]Emitted when an existing item has been updated. For example, if status changes.
Event sample:
["updated_item", {
"app_id": 730,
"auction_auto_withdraw_failed": null,
"auction_ends_at": 1631921311,
"auction_highest_bid": null,
"auction_highest_bidder": null,
"auction_number_of_bids": 0,
"custom_name": null,
"description_type": "Souvenir Mil-Spec Grade SMG",
"icon_url": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpou6r8FAZu7OHNdQJO5du-gM7bwqb2MeuClTsCv8Ek2LiZ9t2giwa28hVlZGD0doSUIANqYV_U_gC2366x0j0WoURS",
"img": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpou6r8FAZu7OHNdQJO5du-gM7bwqb2MeuClTsCv8Ek2LiZ9t2giwa28hVlZGD0doSUIANqYV_U_gC2366x0j0WoURS",
"is_commodity": false,
"market_name": "Souvenir MP9 | Hot Rod (Factory New)",
"market_value": 3394,
"name": "Souvenir MP9 | Hot Rod (Factory New)",
"name_color": "FFD700",
"paint_index": null,
"paint_seed": null,
"preview_id": null,
"price_is_unreliable": 0,
"stickers": [],
"tradable": true,
"tradelock": false,
"updated_at": "2021-09-17 23:15:33",
"wear": null,
"published_at": "2021-09-17T23:25:31.111700Z",
"id": 10003,
}]
Emitted when someone places a bid for an auction item.
Event sample:
[
{
"id": 148844336,
"above_recommended_price": 10,
"auction_highest_bid": 79,
"auction_highest_bidder": 3894061,
"auction_number_of_bids": 11,
"auction_ends_at": 1682284308
},
{
"id": 148844305,
"above_recommended_price": 18,
"auction_highest_bid": 35,
"auction_highest_bidder": 2678443,
"auction_number_of_bids": 7,
"auction_ends_at": 1682284301
},
{
"id": 148844241,
"above_recommended_price": 14,
"auction_highest_bid": 203,
"auction_highest_bidder": 7905183,
"auction_number_of_bids": 17,
"auction_ends_at": 1682284289
}
]
Emitted when the item is not anymore available for withdrawing. Eg. the auction ends and the winner withdraws it. Contains an array of ids.
Event sample:
[
"deleted_item",
[
91997374,
92044606,
92019018,
92044607,
91997376,
92044608,
91997377
]
]Emitted when the trade status gets updated.
Event sample:
[
"trade_status",
[
{
"type": "withdrawal",
"data": {
"status": 6,
"status_message": "Completed",
"id": 19179038,
"item_id": 148842604,
"tradeoffer_id": 148842604,
"item": {
"market_name": "Sticker | Tyloo | Stockholm 2021",
"market_value": 0.31
},
"total_value": 35
}
}
]
]
Emitted when a deposit fails
Event sample:
[
"deposit_failed",
[
{
"response": {
"data": {
"success": false,
"message": "\"Sticker | device (Gold) | Boston 2018\" (ID 3517043328) already exists in another deposit by you. Please select a different item.",
"error_key": "item_already_deposited",
"item_id": 30013
},
"status": 400,
"statusText": "Bad Request"
}
}
]