TradeOffer

TradeOffer is a class which represents an individual trade offer sent or received by your account. It cannot be instantiated directly, it must be created using TradeOfferManager#createOffer, TradeOfferManager#getOffer, or TradeOfferManager#getOffers.

Properties

Each TradeOffer object has a number of read-only properties. To change an offer, you must use a method.

• manager - The TradeOfferManager which owns this TradeOffer. If you want to get the SteamID of the bot account which sent/received this trade offer, use offer.manager.steamID.
• id - The trade offer's unique numeric ID, represented as a string
• partner - The other party in this offer, as a SteamID object
• message - A message, possibly empty, included with the trade offer by its sender
• state - A value from the ETradeOfferState enum
• itemsToGive - An array of items to be given from your account should this offer be accepted
• itemsToReceive - An array of items to be given from the other account and received by yours should this offer be accepted
• isOurOffer - true if this offer was sent by you, false if you received it
• created - A Date object representing when the trade offer was sent
• updated - A Date object representing when the trade offer was last updated (equal to created if never updated)
• expires - A Date object representing when the trade offer will expire if not acted on
• tradeID - A numeric trade ID, represented as a string, if the offer was accepted. null otherwise. This value won't be very useful to you.
• fromRealTimeTrade - true if this trade offer was created automatically from a real-time trade that was committed, false if it was explicitly sent as a trade offer
• confirmationMethod - If this offer needs to be confirmed by you, this is a value from EConfirmationMethod
• escrowEnds - If this offer is in state InEscrow (11), this is a Date object representing when the offer should exit escrow
• rawJson - The stringified raw JSON from the WebAPI from which this TradeOffer object was constructed

Methods

There are a number of methods available to each TradeOffer object, although not all are available for all states.

isGlitched()

v1.22.0 or later is required to use this method

Checks if the offer is "glitched". Returns true (glitched) or false (not glitched). An offer is considered "glitched" if it has been sent and either contains no items (itemsToGive and itemsToReceive are both empty) or any item has an empty or undefined name. Neither of these conditions can be met under normal, non-buggy Steam conditions.

data(key[, value])

• key - A string containing the data key you wish to get/set.
• value - Any arbitrary data type that can be stringified using JSON.stringify. Using undefined will unset the value.

v1.9.0 or later is required to use this method.

Gets or sets any arbitrary data you wish to associate with a trade offer. This can be useful to give offers context. This data is stored in poll data, so you will need to save and restore that if you want your offer data to persist across app sessions.

Omit value to get the data, specify it to set. For example:

var offer = manager.createOffer('[U:1:46143802]');
console.log(offer.data('foo')); // undefined
offer.data('foo', 'bar');
console.log(offer.data('foo')); // bar

This offer data is permanently tied to the trade offer, so it can be accessed and updated anywhere the offer's object is available (e.g. when creating an object, in an update event, or in getOffer). You can use this method before you send an offer, but any data you set will be discarded if the offer is not sent and assigned an offer ID.

Some data keys are special, and are used to modify the properties or options of a specific trade offer. These are:

cancelTime

Used to change the time after which the trade offer will be automatically canceled if not acted on by the other party. This can only be set for an offer which we created, and only if the offer is either unsent or Active.

Set to 0 to disable automatic cancellation, undefined to use the TradeOfferManager's cancelTime (default if not set), or any other numeric value to automatically cancel the offer after that many milliseconds have passed after it was sent.

Usage of this option is governed by the same rules as cancelTime in the TradeOfferManager's constructor (e.g. this is only effective if timed polling is enabled).

getPartnerInventoryContents(appid, contextid, callback)

• appid - The ID of the app for which you wish to load the inventory
• contextid - The ID of the context within the app for which you wish to load the inventory
• callback - A callback to be invoked when complete.
  • err - An Error object on failure, null on success
  • inventory - An array of the user's inventory items, as EconItem objects
  • currencies - An array of the user's currency items, as EconItem objects

v2.5.0 or later is required to use this method

Gets the contents of your trading partner's inventory for a particular app and context. Same difference from loadPartnerInventory as there is between TradeOfferManager#getInventoryContents and TradeOfferManager#loadInventory. See that documentation for more information.

loadPartnerInventory(appid, contextid, callback)

• appid - The ID of the app for which you wish to load the inventory
• contextid - The ID of the context within the app for which you wish to load the inventory
• callback - A callback to be invoked when complete.
  • err - An Error object on failure, null on success
  • inventory - An array of the user's inventory items, as EconItem objects
  • currencies - An array of the user's currency items, as EconItem objects

THIS METHOD IS DEPRECATED AS OF v2.5.0; USE getPartnerInventoryContents INSTEAD

Gets the contents of your trading partner's inventory for a particular app and context.

addMyItem(item)

• item - An item object

Adds a given item to a new trade offer. The item object should be in the same format as is returned by the Steam inventory. That is, it should have the following properties:

• assetid - The item's asset ID within its context (the property can also be named id)
• appid - The ID of the app to which the item belongs
• contextid - The ID of the context within the app to which the item belongs
• amount - Default 1, if the item is stackable, this is how much of the stack will be added

Returns true if the item wasn't already in the offer and so was added successfully, or false if it was already in the offer.

As trade offers are created locally, this method does not involve any networking and returns immediately with no callback.

addMyItems(items)

• items - An array of item objects

Convenience method which simply calls addMyItem for each item in the array. Returns the number of items that were successfully added.

removeMyItem(item)

• item - An item object

Removes an item from your side of the trade offer. Returns true if the item was found and removed successfully, or false if the item wasn't found in the offer.

As trade offers are created locally, this method does not involve any networking and returns immediately with no callback.

removeMyItems(items)

• items - An array of item objects

Convenience method which simply calls removeMyItem for each item in the array. Returns the number of items that were successfully removed.

addTheirItem(item)

• item - An item object

Same as addMyItem, but for the partner's side of the trade.

addTheirItems(items)

• items - An array of item objects

Convenience method which simply calls addTheirItem for each item in the array. Returns the number of items that were successfully added.

removeTheirItem(item)

• item - An item object

Removes an item from the other side of the trade offer. Returns true if the item was found and removed successfully, or false if the item wasn't found in the offer.

As trade offers are created locally, this method does not involve any networking and returns immediately with no callback.

removeTheirItems(items)

• items - An array of item objects

Convenience method which simply calls removeTheirItem for each item in the array. Returns the number of items that were successfully removed.

containsItem(item)

• item - An item object containing appid, contextid, and assetid/id properties

v1.22.0 or later is required to use this method

Returns true if the given item is in this offer, or false if not.

setMessage(message)

• message - The new message you want to send with this offer. Can be empty string.

v2.0.0 or later is required to use this method

Sets this unsent offer's message. Messages are limited by Steam to 128 characters.

setToken(token)

• token - The access token you want to use to send this offer

v2.0.0 or later is required to use this method

Sets this unsent offer's access token, which is needed to send trade offers to non-friends. This token will be used to send the offer, and then will be discarded.

getUserDetails(callback)

• callback - Called when the requested data is available
  • err - An Error object if there was an error, or null on success
  • me - An object containing your user data
    • personaName - Your current Steam display name
    • contexts - An object containing your inventory contexts
    • escrowDays - How many days the trade will be held if completed due to you (Steam uses the larger value between you and the other user)
    • avatarIcon - A URL to the icon-sized version of your avatar
    • avatarMedium - A URL to the medium-sized version of your avatar
    • avatarFull - A URL to the full-sized version of your avatar
  • them - An object containing the other user's user data
    • personaName - The other user's current Steam display name
    • `contexts - An object containing the other user's inventory contexts
    • escrowDays - How many days the trade will be held if completed due to the other user (Steam uses the larger value between you and the other user)
    • probation - true if the other user is on trade probation, false if not
    • avatarIcon - A URL to the icon-sized version of their avatar
    • avatarMedium - A URL to the medium-sized version of their avatar
    • avatarFull - A URL to the full-sized version of their avatar

v2.0.0 or later is required to use this method. v2.2.0 or later is required to use avatar URLs.

Gets data about both users in this trade. May be called for offers that meet one of these criteria:

• Created by you, unsent, and you're friends with the other user
• Created by you, unsent, and you supplied the other user's correct trade token (either in the constructor or with setToken)
• Created by them, sent, and Active

If there was an error and the offer was created by you and is unsent, then the error might describe a reason why you can't trade with the other user at all (e.g. they're trade banned, wrong trade token, they're on a trade cooldown, etc). The error might also be something else, like an HTTP error.

send([callback])

• callback - Optional. A callback to be invoked when complete.
  • err - An Error object on failure, null on success
  • status - pending if awaiting email/mobile confirmation, sent if offer was successfully sent to the other party

Sends a newly-created offer. Only works if this is an offer created with TradeOfferManager#createOffer which hasn't been sent yet. When the callback fires, if successful, the offer's id parameter will be defined. All other parameters will be defined with the module's best guess for their values. As of v1.1.0, on failure, the err object may contain an eresult property. As of v1.3.0, on failure, the err object may contain a cause property which will be one of TradeBan (if the partner is trade banned), NewDevice (if you've logged in from a new device and must wait), or TargetCannotTrade (if the partner cannot trade due to Steam Guard, password reset, etc.).

cancel([callback])

• callback - Optional. A callback to be invoked when complete.
  • err - An Error object on failure, null on success

If this trade offer was sent by us, cancels it. If it was sent to us, declines it. As of v1.1.0, on failure, the err object may contain an eresult property.

decline([callback])

• callback - Optional. A callback to be invoked when complete.
  • err - An Error object on failure, null on success

Alias of cancel

accept([skipStateUpdate][, callback])

• skipStateUpdate - Optional. Defaults to false. See below for details.
• callback - Optional. A callback to be invoked when complete.
  • err - An Error object on failure, null on success
  • status - pending if awaiting email confirmation to be committed, accepted if successfully accepted, escrow if it went into escrow

v2.4.0 or later is required to use skipStateUpdate

Accepts an offer that was sent to us. Once the callback fires, you can call getReceivedItems to get details about the items you received, including their new assetids. As of v1.1.0, on failure, the err object may contain an eresult property. As of v1.3.0, on failure, the err object may contain a cause property which will be one of TradeBan (if the partner is trade banned), NewDevice (if you've logged in from a new device and must wait), or TargetCannotTrade (if the partner cannot trade due to Steam Guard, password reset, etc.).

With the default value of false for skipStateUpdate, TradeOfferManager will query the trade offer's new status from the WebAPI before calling your callback. This allows it to check whether the trade went into escrow or not, and the exact time when escrow will end for this offer.

If this is not a concern for you, you may provide true for skipStateUpdate. This will bypass the extra request (which may error out in some cases when acceptance succeeded), but status will be accepted instead of escrow if the trade is placed on hold. The state property of the TradeOffer will also not be updated in this case.

duplicate()

v1.15.0 or later is required to use this method

Returns a new unsent TradeOffer object that contains the same items as this one. Same as TradeOffer#counter, except sending this offer won't mark the original as Countered.

counter()

v1.2.0 or later is required to use this method

Returns a new unsent TradeOffer object that contains the same items as this one. Sending the new trade offer will send a counter offer, and this offer will be marked as Countered.

update(callback)

• callback - Required. A callback to be invoked when complete.
  • err - An Error object on failure, null on success

v1.15.0 or later is required to use this method

Fetch the latest data for this offer from the WebAPI. When the callback is fired, if an error didn't occur then all of this offer's properties will be updated with the newest values.

getReceivedItems([getActions, ]callback)

• getActions - Optional. If true, then the descriptions of the received items will be loaded from the WebAPI in order to populate the items' actions. Default false.
• callback - Required. A callback to be invoked when complete.
  • err - An Error object on failure, null on success
  • items - An array of EconItem objects that you received.

v1.19.0 or later is required to use getActions.

Can be called on an accepted offer to retrieve item data about the items you received, including names, descriptions, and new assetids. Will not include any actions (e.g. the CS:GO inspect link) unless getActions is true.