API:2/commerce/prices
From Guild Wars 2 Wiki
Jump to navigationJump to search
/v2/commerce/prices
- HTTP method
- GET
- Format
- json
- API version
- version 2
- Release date
- 2014-09-10
- Scope
- none
- Optional
- none
This resource returns current aggregated buy and sell listing information from the trading post.
Parameters
ids(optional list of numbers) – A comma-separated list of item ids to query the listings for.
A single id can also be requested as a subresource.
Response
If the root endpoint (/v2/commerce/prices) is accessed without specifying an id, a list of all ids is returned. When multiple ids are requested using the ids parameter, a list of response objects is returned.
For each requested item id, an object with the following properties is returned:
id(number) – The item id.whitelisted(boolean) – Indicates whether or not a free to play account can purchase or sell this item on the trading post.buys(object) – Buy information.sells(object) – Sell information.
Each buys & sells object has the following properties:
unit_price(number) – The highest buy order or lowest sell offer price in coins.quantity(number) – The amount of items being sold/bought.
Example
https://api.guildwars2.com/v2/commerce/prices/19684
{
"id": 19684,
"whitelisted": false,
"buys": {
"quantity": 145975,
"unit_price": 7018
},
"sells": {
"quantity": 126,
"unit_price": 7019
}
}
http://api.guildwars2.com/v2/commerce/prices?ids=19684,19709
[
{
"id": 19684,
"whitelisted": false,
"buys": {
"quantity": 145975,
"unit_price": 7018
},
"sells": {
"quantity": 126,
"unit_price": 7019
}
},
{
"id": 19709,
"whitelisted": false,
"buys": {
"quantity": 0,
"unit_price": 0
},
"sells": {
"quantity": 1593,
"unit_price": 192
}
}
]
