Buying/selling items

add-to-sale

Put an item for sale

Request parameters:
  • [id] — Steam item ID, it can be found in the item description in your inventory on Steam.
  • [price] — amount, integer (1 RUB = 100, 1 USD = 1000, 1 EUR = 1000)
  • [currency] — the currency (RUB, USD, EUR) an additional check, if specified is not equal to the current set the purchase will be cancelled. It is done to protect you from losing money if you change the currency in your account and forget about the API.
Sample answer:
{
    "success":true,
    "item_id":136285662
}
                
An example of a response in case of an error:
{
    "success":false,
    "error":"bad_request"
}
                
Possible errors:
  • bad_input - incorrect parameters
  • inventory_not_loaded - need to update inventory
  • item_not_recieved - need to update inventory
  • no_description_found - Steam did not return the item description; try again later
  • item_not_inserted - failed to put up for sale
  • item_not_in_inventory — The item is not found in the inventory, try to update it first using the method UpdateInventory and wait 10-20 seconds before trying again.
  • bad_request — Invalid price or not specified at all
set-price

Set a new price on the item, or remove from sale.

Request parameters:
  • [item_id] — ID của mặt hàng trong hệ thống của chúng tôi, nó có thể được lấy từ kết quả của yêu cầu add-to-sale
  • [price] — amount, integer (1 RUB = 100, 1 USD = 1000, 1 EUR = 1000), if you specify 0, the item will be removed from sale
  • [currency] — the currency (RUB, USD, EUR) an additional check, if specified is not equal to the current set the purchase will be cancelled.
Sample answer:
{
    "success": true
}
                
An example of a response in case of an error:
{
    "success":false,
    "error":"bad_item"
}
                
Possible errors:
  • bad_item - item with this ID is not found
remove-all-from-sale

Removing all items at once from the sale.

! IMPORTANT! If you send more than 5 requests per second to our server, your key will be deleted. (List of API requests for the last 20 minutes can be viewed here
Sample answer:
{
    "count":4,
    "success":true
}
                
Details of the answer:
  • count — The number of items that were removed from sale, 0 if there are no items for sale
my-inventory

Getting Steam inventory, only those items that you have not yet put up for sale.

Sample answer:
{
    "success": true,
    "items": [
        {
            "id": "14933635912",
            "classid": "310776767",
            "instanceid": "0",
            "market_hash_name": "SCAR-20 | Carbon Fiber (Factory New)",
            "market_price": 10.34,
            "tradable": 1
        }
    ]
}
                
Details of the answer:
  • id — ID (assetid) for sale (see method add-to-sale)
  • market_price — recommended sale price
items

List of items:

Sample answer:
{
    "success": true,
    "items": [
        {
            "item_id": "286316844",
            "assetid": "15092687536",
            "classid": "637317999",
            "instanceid": "630912635",
            "real_instance": "1629337655",
            "market_hash_name": "Horns of Monstrous Reprisal",
            "position": 0,
            "price": 4,
            "currency": "USD",
            "status": "1",
            "live_time": 920,
            "left": null,
            "botid": "0"
        }
    ]
}
                
Possible statuses:
  • status = 1 — Item is set for sale.
  • status = 2 — You sold the item and must give it to the bot.
  • status = 3 — Waiting for the transfer of the item you bought from the seller to the bot.
  • status = 4 — You can pick up the purchased item.
Details of the answer:
  • item_id — Item ID in our system
  • status — item status (see above)
  • price — your price
  • position — position in the sales queue (sorting by price from lowest), the cheapest item is selected at the time of purchase.
  • botid — ID of the bot which has the item in status 4.
  • assetid — Item ID in the bot inventory.
  • left — Time left to trade the item, after this operation will be cancelled and the money will be returned to the buyer. Penalty points will be given
pingdeprecated

Enable sales, you need to send every 3 minutes.

Sample answer:
{
    "success": true,
    "ping": "pong",
    "online": true,
	"p2p": true,
	"steamApiKey": true
}
                
An example of a response in case of an error:
{
	"success": false,
	"message": "too early for pong"
}
                
ping-new

Enable sales, you need to send every 3 minutes.

Request parameters: (JSON)
{
    "access_token": "eyAidHlwIjogIkpXVCIsICJhb.....",
    "proxy": "http://proxy_login:proxy_pass@proxy_ip:proxy_port"
}
                

The «proxy» parameter is optional. If it is passed, then requests with your «access_token» will be performed through the proxy.

The value of the access_token parameter can be obtained in several ways:
  1. The https://steamcommunity.com/pointssummary/ajaxgetasyncconfig method allows you to request an access token with the "web:community" scope. This scope allows you to use methods such as GetTradeOffer, GetTradeOffers and GetTradeHistory, and this token also allows you to cancel exchange offers.
  2. Mobile token obtained using libraries (for example, DoctorMcKay/node-steam-session) have the same level of access, but have a “web, mobile” scope

For https://*/pointssummary/ajaxgetasyncconfig requests the following format is used:

{
                    "success": 1,
                    "data": {
                        "webapi_token": "ACCESS_TOKEN"
                    }
                }

This request necessarily requires the use of the "steamLoginSecure" cookie in the request headers, below is an example of a header:

Cookie: steamLoginSecure=COOKIE_PAYLOAD;
! IMPORTANT! To use in services at the moment, you must use the access token from points 1 or 2.

The access_token is valid for 24 hours. You need to update it yourself and send it every time you call this method.

If you receive an «invalid_access_token» error and are absolutely sure that the token is valid, repeat the request.
Sample answer:
{
    "success": true,
    "ping": "pong",
    "online": true,
	"p2p": true,
	"steamApiKey": true
}
                
An example of a response in case of an error:
{
	"success": false,
	"message": "invalid_access_token"
}
                
trade-request-take

Create a request for the transfer of purchased items that are at our bots.

Request parameters:
  • botid — The ID of our bot from which you want to pick up items is optional.
Sample answer:
{
    "success": true,
    "trade": "1704976549",
    "nick": "NIPFribergEZIO",
    "botid": "354589802",
    "profile": "https://steamcommunity.com/profiles/76561198314855530/",
    "secret": "1J10",
    "items": [
        "1812819920_188530170",
        "2082539396_188530139",
        "2048839018_902658099"
    ]
}
                
Possible errors:
  • 3001 — nothing to transfer.
trade-request-give

Create a request to transfer purchased items to our bot

Sample answer:
{
    "success": true,
    "trade": "1704976549",
    "nick": "NIPFribergEZIO",
    "botid": "354589802",
    "profile": "https://steamcommunity.com/profiles/76561198314855530/",
    "secret": "1J10",
    "items": [
        15060788266
    ]
}
                
trade-request-give-p2p

Request data to transfer the item to the buyer

Sample answer:
{
    "success": true,
    "hash" : "234234234/wefsdgsd",
    "offer" : {
        "partner" : 12345,
        "token" : "fffffff",
        "tradeoffermessage" : "sdfsdf . . . 234234234/wefsdgsd",
        "items" : [
            {
                "appid" : 730,
                "contextid" : 2,
                "assetid" : 23452345,
                "amount" : 1
            }
        ]
    }
}
                
trade-request-give-p2p-all

Returns data for creating all trades

Sample answer:
{
    "success": true,
    "offers": [
        {
            "partner": 12345,
            "token": "fffffff",
            "tradeoffermessage": "sdfsdf . . . 234234234/wefsdgsd",
            "hash": "234234234/wefsdgsd",
            "items": [
                {
                    "appid": 730,
                    "contextid": 2,
                    "assetid": 23452345,
                    "amount": 1
                }
            ]
        },
        {
            "partner": 123456,
            "token": "fffffff",
            "hash": "234234234/wefsdas",
            "tradeoffermessage": "sdfsdf . . . 234234234/wefsdas",
            "items": [
                {
                    "appid": 730,
                    "contextid": 2,
                    "assetid": 23452346,
                    "amount": 1
                }
            ]
        }
    ]
}
                
trade-ready

Register with us a trade offer that you created on Steam

Sample answer:
{
    "success": false,
    "tradeofferid": 1133557799,
    "error": "not active offers"
}
                
trades

Get a list of trade offers that are currently sent to your account by the Market and are awaiting confirmation on Steam.

Request parameters:
  • extended — Extended information
Sample answer:
{
    "success": true,
    "trades": [
        {
            "dir": "out",
            "trade_id": "3759667687",
            "bot_id": "1022850783",
            "timestamp": 1572021797,
            "secret": "3R5U",
            "nik": "teresiacais",
            "list_item_id": {
                "361847026": {
                    "id": "361847026",
                    "assetid": "17737368051",
                    "classid": "284952881",
                    "instanceid": "1625510296"
                },
                "361851594": {
                    "id": "361851594",
                    "assetid": "17737368059",
                    "classid": "284952881",
                    "instanceid": "1625510296"
                }
            }
        },
        {
            "dir": "in",
            "trade_id": "3759668212",
            "bot_id": "1022850783",
            "timestamp": 1572021825,
            "secret": "EC58",
            "nik": "teresiacais",
            "list_item_id": {
                "381304045": {
                    "id": "381304045",
                    "assetid": "8028182393",
                    "classid": "996701649",
                    "instanceid": "0"
                }
            }
        }
    ]
}
                
Details of the answer:
  • dir — The direction of the trade: in - transfer of the item that was sold; out - the withdrawal of the item that was purchased.
  • trade_id - Trade offer SteamID
  • bot_id - SteamID of our bot that sent it
buy

Item purchase. In our system, it is possible to purchase only one item per request.

Request parameters:
  • [market_hash_name] — market_hash_name item identifiers.
  • [id] — Item ID
  • [price] — the price in kopecks (1 RUB = 100, 1 USD = 1000, 1 EUR = 1000) is an integer number of some lot already put up for sale, or you can specify any amount greater than the price of the cheapest lot, in the second case the item with the lowest price will be purchased.
  • [custom_id] - your unique ID (string [50]), it will be possible to track your buy operation (optional parameter!)
Sample answer:
{
    "success":true,
    "id":"136256960"
}
                
An example of a response in case of an error:
{
    "success":false,
    "error":"this custom_id exist"
}
                
Details of the answer:
  • id - Item ID
buy-for

Item purchase and it`s transfer to another user.

Request parameters:
  • [market_hash_name] — market_hash_name item identifiers.
  • [id] — Item ID
  • [price] — the price in kopecks (1 RUB = 100, 1 USD = 1000, 1 EUR = 1000) is an integer number of some lot already put up for sale, or you can specify any amount greater than the price of the cheapest lot, in the second case the item with the lowest price will be purchased.
  • [chance] — Integer number from 0 to 100. Filter items when buying by seller with chance to transfer not lower than the specified number.
  • partner=[partner]&token=[token] - parameters of the trade link of the account that will receive the item.
  • [custom_id] - your unique ID (string [50]), it will be possible to track your buy operation (optional parameter!)
Sample answer:
{
    "success":true,
    "id":"136256960"
}
                
An example of a response in case of an error:
{
    "success":false,
    "error":"this custom_id exist"
}
                
Details of the answer:
  • id - Item ID
get-buy-info-by-custom-id

Returns purchase status information

Request parameters:
  • [custom_id] — custom_id is your unique ID set in the method (buy, buy-for)
Sample answer:
{
    "success": true,
    "data": {
        "item_id": "534415936",
        "market_hash_name": "Spectrum 2 Case",
        "classid": "2521767801",
        "instance": "0",
        "time": "1548081954",
        "send_until" : null,
        "stage": "2",
        "paid": 0.5,
        "causer": null,
        "currency": "USD",
        "for": "1234567",
        "trade_id": null
    }
}
                
Details of the answer:
  • trade_id - active trade_offer id
  • for - steamid(32) to whom the item was given (if the purchase was through the buy-for method)
  • time - Unix Timestamp when the item was purchased
  • paid - how much was the item purchased
  • stage
    • TRADE_STAGE_NEW = 1
    • TRADE_STAGE_ITEM_GIVEN = 2
    • TRADE_STAGE_TIMED_OUT = 5
get-list-buy-info-by-custom-id

Returns purchase status information

Request parameters:
  • custom_id[] — custom_id is your unique ID set in the method (buy, buy-for)
Sample answer:
{
    "success": true,
    "data": {
        "custom_id": {
            "item_id": "534415936",
            "market_hash_name": "Spectrum 2 Case",
            "classid": "2521767801",
            "instance": "0",
            "time": "1548081954",
            "send_until" : null,
            "stage": "2",
            "paid": 0.5,
            "currency": "USD",
            "for": "1234567",
            "trade_id": null
        }
    }
}
                
Details of the answer:
  • trade_id - active trade_offer id
  • for - steamid(32) to whom the item was given (if the purchase was through the buy-for method)
  • paid - how much was the item purchased
  • time - Unix Timestamp when the item was purchased
  • stage
    • TRADE_STAGE_NEW = 1
    • TRADE_STAGE_ITEM_GIVEN = 2
    • TRADE_STAGE_TIMED_OUT = 5
history

History history of purchases and sales

Request parameters:
  • [date] - the date in the DD-MM-YYYY format, for example (10-08-1986). или UNIX_TIMESTAMP
  • [date_end] - UNIX_TIMESTAMP
Sample answer:
{
    "success": true,
    "data": [
        {
            "item_id": "286316842",
            "market_hash_name": "Maraxiform's Ire",
            "class": "2274724615",
            "instance": "57949762",
            "time": "1546229560",
            "event": "buy",
            "app": 570,
            "stage": "2",
            "for": null,
            "custom_id": null,
            "paid": "72",
            "currency": "USD"
        }
    ]
}
                
Details of the answer:
  • app — on which site the item was purchased
  • for — ID of the user to whom it was transferred (if the purchase was made using the buy-for method)
  • stage
    • TRADE_STAGE_NEW = 1
    • TRADE_STAGE_ITEM_GIVEN = 2
    • TRADE_STAGE_TIMED_OUT = 5
operation-history

History of purchases, sales, deposit operations, withdrawals on all platforms

Request parameters:
  • [date] - UNIX_TIMESTAMP
  • [date_end] - UNIX_TIMESTAMP
Sample answer:
{
    "success": true,
    "data": [
        {
            "time": "1592564265",
            "event": "sell",
            "item_id": "520336165",
            "market_hash_name": "Glock-18 | Ironwork (Factory New)",
            "class": "3706631132",
            "instance": "188530139",
            "price": "500",
            "received": "468",
            "currency": "USD",
            "stage": "5",
            "for": null,
            "custom_id": null,
            "app": 730
        },
        {
            "time": "1591817364",
            "event": "buy",
            "item_id": "286316972",
            "market_hash_name": null,
            "class": null,
            "instance": null,
            "paid": "193",
            "currency": "USD",
            "stage": "5",
            "for": null,
            "custom_id": null,
            "app": 570
        },
        {
            "time": "1588586061",
            "event": "checkout",
            "id": "542713332",
            "amount": "1001",
            "currency": "USD",
            "status": "105"
        }
    ]
}
                
Details of the answer:
  • app — on which site the item was purchased
  • for — ID of the user to whom it was transferred (if the purchase was made using the buy-for method)
  • Event Checkout: status
    • 0 - The order has been created
    • 10 - The order is approved
    • 20 - The order has been sent for execution
    • 30 - The order is executed
    • 100 - The order is rejected
    • 105 - The order is canceled
    • 110 - Error
  • Event Byu/Sell: stage
    • TRADE_STAGE_NEW = 1
    • TRADE_STAGE_ITEM_GIVEN = 2
    • TRADE_STAGE_TIMED_OUT = 5
get-list-items-info

Option to request a single item

Request parameters:
  • [market_hash_name] - Item name, it can be taken from the Steam inventory.
Sample answer:
{
    "success": true,
    "currency": "USD",
    "data": {
        "USP-S | Lead Conduit (Well-Worn)": {
            "max": 3.8,
            "min": 1.24,
            "average": 50,
            "history": [
                [1695397484, 2.1],
                [1692708282, 1.5]
            ]
        }
    }
}
                
Details of the answer:
  • max — max price
  • min — min price
  • history — sales history
bid-ask

Request the stock by hash

Request parameters:
  • [market_hash_name] - Item name, it can be taken from the Steam inventory.
  • [phase] - item phase. options: phase1, phase2, phase3, phase4, sapphire, ruby, blackpearl
Sample answer:
{
	"bid": [
		{
			"price": "414.0600",
			"total": "1"
		},
		{
			"price": "406.4600",
			"total": "3"
		}
    ],
    "ask": [
		{
			"price": "441.5900",
			"total": "1"
		},
		{
			"price": "441.7800",
			"total": "1"
		}
    ],
    "currency": "USD"
}
                
Details of the answer:
  • bid — buy orders
  • ask — items on sale (offers)
  • currency — current currency
test

Check all possible obstacles to the successful items selling.

Sample answer:
{
    "success": true,
    "status": {
        "user_token": true,
        "trade_check": true,
        "site_online": false,
        "site_notmpban": false,
        "steam_web_api_key" : false
    }
}
                
Details of the answer:
  • user_token — Is there a trade link set
  • trade_check — Has trade availability check been completed?
  • site_online — Are you online on the site ping
  • site_notmpban — Indicator of absence of ban for not transferring sold items (for 24 hours)
  • steam_web_api_key — Steam API key installed (needed for selling via p2p)