Buy items using item_id and send to specific tradelink

Notes about trades and frequently asked questions

The duration of the trade in different situations:

If seller's info is invalid then it can be cancelled immediately and status 6 is set;

If seller's details are valid, but no trade is created, then it will auto-cancel after 6 minutes;

if created or waiting for mobile confirmation then it will auto-cancel after 11 to 15 min (depends on when created);

if trade is waiting for mobile confirmation and connection with the seller was lost then it will auto-cancel after 6 hours.

We recommend adding project_id to purchase so that you can track a trade in case of a timeout or break of purchase request using the /check-many-project-id GET method one minute after the request.

An array of possible messages with purchase errors and other information, such as status, can be seen by opening the response scheme, where:

System busy - trade is cancelled due to tradelink check timeout or heavy load;

buy_csgo - CS:GO purchases are deactivated on the market;

buy_rust - RUST purchases are deactivated on the market.

A trade-locked listing can be bought only by exact item_id and only with allow_trade_locked. The opt-in confirms that you saw unlock_at and accept delayed delivery. Without it the purchase is refused: "trade-locked listing: pass allow_trade_locked=1 to confirm delayed delivery". You are charged in full at purchase time. There is no endpoint to cancel a reservation. A successful hold purchase adds purchase_status "reserved", unlock_at, and send_until (RFC 3339 UTC). Regular purchases omit those fields. GET /v1/buy-one-p2p-name never sells hold items.

Trade link errors

Before buying we validate the buyer's trade link with Steam. These errors are on the buyer's side: no purchase is created and nothing is charged. Once the buyer fixes the problem, the next purchase goes through.

Most of these come as msg: "Your tradelink is incorect, please update it", with the reason from Steam in error_msg:

If error_msg equals msg, Steam returned no details: the trade link is missing or malformed, or the reason is in msg itself (Please set your steam inventory public, Trade banned, User has VACBAN or Game Ban, You're banned for not accepting trades).

double purchase

double purchase: the same item_id (with the same project_id) was already received in the last 5 seconds. The duplicate is rejected and nothing is charged for it; the first request is processed normally. Usually caused by a client-side retry. To find the result of the first request, use /v1/check-many-project-id.