Difference between revisions of "WebAPI/GetAssetPrices"

From Team Fortress Wiki
Jump to: navigation, search
(Careful about how you use "integer" in type dependent documentation, also moved other notes to ref list)
m (consistency edits)
Line 1: Line 1:
 
== URL ==
 
== URL ==
<nowiki>http://api.steampowered.com/ISteamEconomy/GetAssetPrices/v0001/</nowiki>
+
<nowiki>GET http://api.steampowered.com/ISteamEconomy/GetAssetPrices/v0001/</nowiki>
 
 
See the [[WebAPI#appids|ID list]] for a valid ID.
 
  
 
== Method-specific Parameters ==
 
== Method-specific Parameters ==
; appid
+
; appid (uint32)
 
:The [[WebAPI#appids|ID]] of the game to query assets from.
 
:The [[WebAPI#appids|ID]] of the game to query assets from.
  
; language
+
; {{API optional|language}} (string)
 
:The [[Wikipedia:List of ISO 639-1 codes|ISO639-1 language code]] for the language all localized strings should be returned in. Not all strings have been translated to every language. If a language does not have a string, the English string will be returned instead.  If this parameter is omitted the string token will be returned for the strings.
 
:The [[Wikipedia:List of ISO 639-1 codes|ISO639-1 language code]] for the language all localized strings should be returned in. Not all strings have been translated to every language. If a language does not have a string, the English string will be returned instead.  If this parameter is omitted the string token will be returned for the strings.
 
+
;{{API optional|currency}} (string): The [[Wikipedia:ISO 4217|ISO 4217 code]] for currency specific filtering.
Supported languages:
 
* Danish (da, da_DK)
 
* Dutch (nl, nl_NL)
 
* English (en, en_US)
 
* Finnish (fi, fi_FI)
 
* French (fr, fr_FR)
 
* German (de, de_DE)
 
* Hungarian (hu, hu_HU)
 
* Italian (it, it_IT)
 
* Japanese (ja, ja_JP)
 
* Korean (ko, ko_KR)
 
* Norwegian (no, no_NO)
 
* Polish (pl, pl_PL)
 
* Portuguese (pt, pt_PT)
 
* Brazillian Portuguese (pt_BR)
 
* Romanian (ro, ro_RO)
 
* Russian (ru, ru_RU)
 
* Simplified Chinese (zh, zh_CN)
 
* Spanish (es, es_ES)
 
* Swedish (sv, sv_SE)
 
* Traditional Chinese (zh2, zh_TW)
 
* Turkish (tr, tr_TR)
 
 
 
;currency: The [[Wikipedia:ISO 4217|ISO 4217 code]] for currency specific filtering.
 
 
 
Supported codes:
 
* US dollars (usd)
 
* UK pound (gbp)
 
* Euro (eur)
 
* RU Ruble (rub)
 
  
 
== Result Data ==
 
== Result Data ==

Revision as of 20:27, 5 February 2013

URL

GET http://api.steampowered.com/ISteamEconomy/GetAssetPrices/v0001/

Method-specific Parameters

appid (uint32)
The ID of the game to query assets from.
language (Optional) (string)
The ISO639-1 language code for the language all localized strings should be returned in. Not all strings have been translated to every language. If a language does not have a string, the English string will be returned instead. If this parameter is omitted the string token will be returned for the strings.
currency (Optional) (string)
The ISO 4217 code for currency specific filtering.

Result Data

result
success
true if the query was successful, false otherwise.
assets
A list of items with slot tags and prices in the chosen or all currency.
prices
An array containing the currency code and respective price, if a currency is specified only that currency value will be present. [1]
original_prices (Optional)
An array equivalent to prices in layout. Present when the item is on sale.
class
A list of properties attached to the item [2]
name
The name of the property.
value
The value of the property.
name
The "name" of the asset. This has no set content besides that it is an identifier that can be used in URLs such as those for Valve's store frontend.
classid
The class ID of the item.
tags
An array containing information related to the item's slot or special attributes. See tags
tags
An array containing friendly names for the tags attached to items.

Notes

  1. All prices are given as integers due to issues regarding precision. A double value can be obtained by dividing the price by 100.
  2. Note that for first party (Valve) games there may be a def_index property present, its value is a string that can be converted to an integer for use in schema item lookups.