View source for Steam Web API/IEconService

The IEconService interface provides methods related to inventory and trading.  See the [[Steam Web API]] page for more information about Web APIs.

== Common Values ==
=== ETradeOfferState ===
These are the different states for a trade offer:

{| class=standard-table
| '''Name''' || '''Value''' || '''Comment'''
|-
| k_ETradeOfferStateInvalid  || 1 || Invalid
|-
| k_ETradeOfferStateActive || 2 || This trade offer has been sent, neither party has acted on it yet.
|-
| k_ETradeOfferStateAccepted || 3 || The trade offer was accepted by the recipient and items were exchanged.
|-
| k_ETradeOfferStateCountered || 4 || The recipient made a counter offer
|-
| k_ETradeOfferStateExpired || 5 || The trade offer was not accepted before the expiration date
|-
| k_ETradeOfferStateCanceled || 6 || The sender cancelled the offer
|-
| k_ETradeOfferStateDeclined   || 7 || The recipient declined the offer
|-
| k_ETradeOfferStateInvalidItems || 8 || Some of the items in the offer are no longer available (indicated by the '''missing''' flag in the output)
|-
| k_ETradeOfferStateCreatedNeedsConfirmation || 9 || The offer hasn't been sent yet and is awaiting email/mobile confirmation. The offer is only visible to the sender.
|-
| k_ETradeOfferStateCanceledBySecondFactor || 10 || '''Either party''' canceled the offer via email/mobile. The offer is visible to both parties, even if the sender canceled it before it was sent.
|-
| k_ETradeOfferStateInEscrow || 11 || The trade has been placed on hold. The items involved in the trade have all been removed from both parties' inventories and will be automatically delivered in the future.
|}

=== ETradeOfferConfirmationMethod ===
These are the different methods in which a trade offer can be confirmed.
{| class=standard-table
| '''Name''' || '''Value''' || '''Comment'''
|-
| k_ETradeOfferConfirmationMethod_Invalid || 0 || Invalid
|-
| k_ETradeOfferConfirmationMethod_Email || 1 || An email was sent with details on how to confirm the trade offer
|-
| k_ETradeOfferConfirmationMethod_MobileApp || 2 || The trade offer may be confirmed via the mobile app
|}

=== ETradeStatus ===
Tracks the status of a trade after a trade offer has been accepted.
{| class=standard-table
| '''Name''' || '''Value''' || '''Comment'''
|-
| k_ETradeStatus_Init || 0 || Trade has just been accepted/confirmed, but no work has been done yet
|-
| k_ETradeStatus_PreCommitted || 1 || Steam is about to start committing the trade
|-
| k_ETradeStatus_Committed || 2 || The items have been exchanged
|-
| k_ETradeStatus_Complete || 3 || All work is finished
|-
| k_ETradeStatus_Failed || 4 || Something went wrong after Init, but before Committed, and the trade has been rolled back
|-
| k_ETradeStatus_PartialSupportRollback || 5 || A support person rolled back the trade for one side
|-
| k_ETradeStatus_FullSupportRollback || 6 || A support person rolled back the trade for both sides
|-
| k_ETradeStatus_SupportRollback_Selective || 7 || A support person rolled back the trade for some set of items
|-
| k_ETradeStatus_RollbackFailed || 8 || We tried to roll back the trade when it failed, but haven't managed to do that for all items yet
|-
| k_ETradeStatus_RollbackAbandoned || 9 || We tried to roll back the trade, but some failure didn't go away and we gave up
|-
| k_ETradeStatus_InEscrow || 10 || Trade is in escrow
|-
| k_ETradeStatus_EscrowRollback || 11 || A trade in escrow was rolled back
|}

=== CEcon_Asset ===
*<code>appid</code>
*<code>contextid</code>
*<code>assetid</code> - either <code>assetid</code> or <code>currencyid</code> will be set
*<code>currencyid</code> - either <code>assetid</code> or <code>currencyid</code> will be set
*<code>classid</code> - together with <code>instanceid</code>, uniquely identifies the display of the item
*<code>instanceid</code> - together with <code>classid</code>, uniquely identifies the display of the item
*<code>amount</code> - the amount offered in the trade, for stackable items and currency
*<code>missing</code> - a boolean that indicates the item is no longer present in the user's inventory
*<code>est_usd</code> - a string that represent Steam's determination of the item's value, in whole USD pennies. How this is determined is unknown.

=== CEcon_TradeOffer ===
Both GetTradeOffers and GetTradeOffer return this structure:
*<code>tradeofferid</code> - a unique identifier for the trade offer
*<code>accountid_other</code> - your partner in the trade offer
*<code>message</code> - a message included by the creator of the trade offer
*<code>expiration_time</code> - unix time when the offer will expire (or expired, if it is in the past)
*<code>trade_offer_state</code> - see ETradeOfferState above
*<code>items_to_give</code> - array of CEcon_Asset, items you will give up in the trade (regardless of who created the offer)
*<code>items_to_receive</code> - array of CEcon_Asset, items you will receive in the trade (regardless of who created the offer)
*<code>is_our_offer</code> - boolean to indicate this is an offer you created.
*<code>time_created</code> - unix timestamp of the time the offer was sent
*<code>time_updated</code> - unix timestamp of the time the trade_offer_state last changed.
*<code>from_real_time_trade</code> - boolean to indicate this is an offer automatically created from a real-time trade.
*<code>escrow_end_date</code> - unix timestamp of when the trade hold period is supposed to be over for this trade offer
*<code>confirmation_method</code> - the confirmation method that applies to the user asking about the offer. See ETradeOfferConfirmationMethod above.

=== CEcon_GetTradeHistory_Response_Trade_TradedAsset ===
A traded item returned by GetTradeHistory
*<code>appid</code>
*<code>contextid</code>
*<code>assetid</code>
*<code>amount</code>
*<code>classid</code> - together with <code>instanceid</code>, uniquely identifies the display of the item
*<code>instanceid</code> - together with <code>classid</code>, uniquely identifies the display of the item
*<code>new_assetid</code> - the asset ID given to the item after the trade completed
*<code>new_contextid</code> - the context ID the item was placed in
*<code>rollback_new_assetid</code> - if the trade has been rolled back, the new asset ID given in the rollback
*<code>rollback_new_contextid</code> - if the trade has been rolled back, the context ID the new asset was placed in

=== CEcon_GetTradeHistory_Response_Trade_TradedCurrency ===
A traded currency returned by GetTradeHistory
*<code>appid</code>
*<code>contextid</code>
*<code>currencyid</code>
*<code>amount</code>
*<code>classid</code>
*<code>new_currencyid</code> - the currency ID given after the trade completed
*<code>new_contextid</code> - the context ID the currency was placed in
*<code>rollback_new_currencyid</code> - if the trade has been rolled back, the new currency ID given in the rollback
*<code>rollback_new_contextid</code> - if the trade has been rolled back, the context ID the new asset was placed in

=== CEcon_GetTradeHistory_Response_Trade ===
A trade returned by GetTradeHistory
*<code>tradeid</code> - a unique identifier for the trade
*<code>steamid_other</code> - the SteamID of your trade partner
*<code>time_init</code> - unix timestamp of the time the trade started to commit
*<code>time_escrow_end</code> - unix timestamp of the time the trade will leave escrow
*<code>status</code> - see ETradeStatus above
*<code>assets_received</code> - array of CEcon_GetTradeHistory_Response_Trade_TradedAsset showing the items received in the trade
*<code>assets_given</code> - array of CEcon_GetTradeHistory_Response_Trade_TradedAsset showing the items given to the other party in the trade
*<code>currency_received</code> - array of CEcon_GetTradeHistory_Response_Trade_TradedCurrency showing the items received in the trade
*<code>currency_given</code> - array of CEcon_GetTradeHistory_Response_Trade_TradedCurrency showing the items given to the other party in the trade

== GetTradeOffers (v1) ==
This API gets a list of trade offers (up to a maximum of 500 sent or 1000 received regardless of time_historical_cutoff) for the account associated with the WebAPI key.  You cannot call this API for accounts other than your own. 
=== Input ===
Either <code>get_sent_offers</code> or <code>get_received_offers</code> (or both) must be set.  <code>active_only</code> and <code>historical_only</code> are optional, if neither is passed it is equivalent to both being set.

*<code>get_sent_offers</code> - return the list of offers you've sent to other people.
*<code>get_received_offers</code> - return the list of offers you've received from other people.
*<code>get_descriptions</code> - return item display information for any items included in the returned offers.
*<code>language</code> - needed if <code>get_descriptions</code> is set, the language to use for item descriptions.
*<code>active_only</code> - return only trade offers in an active state (offers that haven't been accepted yet), or any offers that have had their state change since <code>time_historical_cutoff</code>.
*<code>historical_only</code> - return trade offers that are not in an active state.
*<code>time_historical_cutoff</code> - a unix time value.  when <code>active_only</code> is set, inactive offers will be returned if their state was updated since this time.  Useful to get delta updates on what has changed.  WARNING: If not passed, this will default to the time your account last viewed the trade offers page.  To avoid this behavior use a very low or very high date.
=== Output ===
*<code>trade_offers_sent</code> - if <code>get_sent_offers</code> was set, this will be an array of [[#CEcon_TradeOffer|CEcon_TradeOffer]] values that you have sent.
*<code>trade_offers_received</code> - if <code>get_received_offers</code> was set, this will be an array of [[#CEcon_TradeOffer|CEcon_TradeOffer]] values that have been sent to you.
* <code>descriptions</code> - if <code>get_descriptions</code> was set, this will be a list of item display information.  This is associated with the data in the <code>items_to_receive</code> and <code>items_to_give</code> lists via the <code>classid</code> / <code>instanceid</code> identifier pair.

== GetTradeOffer (v1) ==
This API gets details about a single trade offer.  The trade offer must have been sent to or from the account associated with the WebAPI key.  You cannot call this API for accounts other than your own.

=== Input ===
*<code>tradeofferid</code> - the trade offer identifier
*<code>language</code> - the language to use for item display information.

=== Output ===
*<code>offer</code> - A [[#CEcon_TradeOffer|CEcon_TradeOffer]] representing the offer
* <code>descriptions</code> - if <code>language</code> was set, this will be a list of item display information.  This is associated with the data in the <code>items_to_receive</code> and <code>items_to_give</code> lists via the <code>classid</code> / <code>instanceid</code> identifier pair.

== DeclineTradeOffer (v1) ==
Decline a trade offer that was sent to you.  The trade offer must have been sent to the account associated with the WebAPI key.  You cannot call this API for accounts other than your own.  This accepts only POST requests.
=== Input ===
*<code>tradeofferid</code> - the trade offer identifier
=== Output ===
(just the usual success/error fields)

== CancelTradeOffer (v1) ==
Cancel a trade offer that you sent.  The trade offer must have been sent by the account associated with the WebAPI key.  You cannot call this API for accounts other than your own.  This accepts only POST requests.
=== Input ===
*<code>tradeofferid</code> - the trade offer identifier
=== Output ===
(just the usual success/error fields)

== GetTradeHistory (v1) ==
Gets a history of trades that you have been involved in as identified by the account associated with the WebAPI key. You cannot call this API for accounts other than your own.
=== Input ===
*<code>10</code> - The number of trades to return information for, limit 500 if get_descriptions is false and 100 if get_descriptions is true
*<code>start_after_time</code> - The time of the last trade shown on the previous page of results, or the time of the first trade if navigating back
*<code>start_after_tradeid</code> - The tradeid shown on the previous page of results, or the ID of the first trade if navigating back
*<code>navigating_back</code> - Return the previous max_trades trades before the start time and ID
*<code>get_descriptions</code> - If set, the item display data for the items included in the returned trades will also be returned
*<code>language</code> - The language to use when loading item display data
*<code>include_failed</code> - If set, trades in status <code>k_ETradeStatus_Failed</code>, <code>k_ETradeStatus_RollbackFailed</code>, <code>k_ETradeStatus_RollbackAbandoned</code>, and <code>k_ETradeStatus_EscrowRollback</code> will be included
=== Output ===
*<code>total_trades</code> - total number of trades performed by the account
*<code>more</code> - whether or not more are available
*<code>trades</code> - array of CEcon_GetTradeHistory_Response_Trade
*<code>descriptions</code> - if <code>get_descriptions</code> was set, this will be a list of item display information.  This is associated with the data in the <code>assets/currency_received</code> and <code>assets/currency_given</code> lists via the <code>classid</code> / <code>instanceid</code> identifier pair.

== GetTradeHoldDurations(v1) ==
Returns the estimated hold duration and end date that a trade with a user would have. You cannot call this API for accounts other than your own.
=== Input ===
*<code>steamid_target</code> - the 64-bit steamid of the other user in a potential trade.
*<code>trade_offer_access_token</code> - the access token in the trade offer URL of the other user. If your account is friends with the target, this may be omitted or incorrect and you will still receive a valid response.

=== Output ===
All output fields are a document with a single member, <code>escrow_end_duration_seconds</code>.
*<code>my_escrow</code> - the duration of the escrow caused by your account.
*<code>their_escrow</code> - the duration of the escrow caused by the <code>steamid_target</code> account.
*<code>both_escrow</code> - the higher of the two above escrow durations.