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.
These are the different states for a trade offer:
|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|
- assetid - either assetid or currencyid will be set
- currencyid - either assetid or currencyid will be set
- classid - together with instanceid, uniquely identifies the display of the item
- instanceid - together with classid, uniquely identifies the display of the item
- amount - the amount offered in the trade, for stackable items and currency
- missing - a boolean that indicates the item is no longer present in the user's inventory
Both GetTradeOffers and GetTradeOffer return this structure:
- tradeofferid - a unique identifier for the trade offer
- accountid_other - your partner in the trade offer
- message - a message included by the creator of the trade offer
- expiration_time - unix time when the offer will expire (or expired, if it is in the past)
- trade_offer_state - see ETradeOfferState above
- items_to_give - array of CEcon_Asset, items you will give up in the trade (regardless of who created the offer)
- items_to_receive - array of CEcon_Asset, items you will receive in the trade (regardless of who created the offer)
- is_our_offer - boolean to indicate this is an offer you created.
- time_created - unix timestamp of the time the offer was sent
- time_updated - unix timestamp of the time the trade_offer_state last changed.
This API gets a list of trade offers for the account associated with the WebAPI key. You cannot call this API for accounts other than your own.
Either get_sent_offers or get_received_offers (or both) must be set. active_only and historical_only are optional, if neither is passed it is equivalent to both being set.
- get_sent_offers - return the list of offers you've sent to other people.
- get_received_offers - return the list of offers you've received from other people.
- get_descriptions - return item display information for any items included in the returned offers.
- language - needed if get_descriptions is set, the language to use for item descriptions.
- active_only - 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 time_historical_cutoff.
- historical_only - return trade offers that are not in an active state.
- time_historical_cutoff - a unix time value. when active_only 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.
- trade_offers_sent - if get_sent_offers was set, this will be an array of CEcon_TradeOffer values that you have sent.
- trade_offers_recieved - if get_received_offers was set, this will be an array of CEcon_TradeOffer values that have been sent to you.
- descriptions - if get_descriptions was set, this will be a list of item display information. This is associated with the data in the items_to_receive and items_to_give lists via the classid / instanceid identifier pair.