Send Trade Offer

POST /tradeoffer/new/send

Sends a new trade offer to a trade partner.

Rate limits

No known rate limit

Request

Authenticated: Yes

Method: POST

Host: steamcommunity.com

Path: /tradeoffer/new/send

Headers:

Name	Required	Description
Referer	Yes	Use https://steamcommunity.com/tradeoffer/new/ as value (mandatory)

Form Data:

Name	Type	Required	Description
sessionid	string	Yes	The value of the sessionid cookie
serverid	number	Yes	Always 1
partner	string	Yes	The 64-bit SteamID of the trade partner
json_tradeoffer	string	Yes	The trade offer contents as a serialized JSON object, holding newversion, version and the me and them objects (each with an assets array of appid/contextid/amount/assetid objects, a currency array and a ready flag)
tradeoffermessage	string	No	The message attached to the trade offer
captcha	string	No	The reCAPTCHA response; empty when no captcha is presented
trade_offer_create_params	string	No	The serialized JSON object holding the partner's trade URL token as trade_offer_access_token, sent when the partner's trade URL includes one
tradeofferid_countered	string	No	The ID of the trade offer being countered; sent only for counter offers

Response

200 OK

Name	Type	Description
tradeofferid	string	The ID of the created trade offer
needs_mobile_confirmation	boolean	Whether the trade offer must be confirmed in the Steam Mobile app
needs_email_confirmation	boolean	Whether the trade offer must be confirmed by email
email_domain	string	The domain of the email address the confirmation was sent to; present when needs_email_confirmation is true

400 Bad Request

The response body is null.

401 Unauthorized

The response body is null.

403 Forbidden

The response body is null.

500 Internal Server Error

Name	Type	Description
strError	string	The error message, which may contain HTML

Example

POST https://steamcommunity.com/tradeoffer/new/send { sessionid: "a0b1c2d3e4f5g6h7i8j9klmn", serverid: 1, partner: "76561198042965266", tradeoffermessage: "", json_tradeoffer: "{\"newversion\":true,\"version\":2,\"me\":{\"assets\":[],\"currency\":[],\"ready\":false},\"them\":{\"assets\":[{\"appid\":440,\"contextid\":\"2\",\"amount\":1,\"assetid\":\"17555045548\"}],\"currency\":[],\"ready\":false}}", captcha: "" }

TODO