API:2/commerce/listings
From Guild Wars 2 Wiki
Jump to navigationJump to search
/v2/commerce/listings
- HTTP method
- GET
- Format
- json
- API version
- version 2
- Release date
- 2014-09-08
- Scope
- none
- Optional
- none
This resource returns current buy and sell listings 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/listings) 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.buys(array) – A list of all buy listings, descending from highest buy order.sells(array) – A list of all sell listings, ascending from lowest sell offer.
Each listing object has the following properties:
listings(number) – The number of individual listings this object refers to (e.g. two players selling at the same price will end up in the same listing)unit_price(number) – The sell offer or buy order price in coins.quantity(number) – The amount of items being sold/bought in this listing.
Example
https://api.guildwars2.com/v2/commerce/listings/19684
{
"id": 19684,
"buys": [
{ "listings": 105, "unit_price": 9, "quantity": 7033 },
{ "listings": 1, "unit_price": 5, "quantity": 45 },
{ "listings": 23, "unit_price": 1, "quantity": 1962 },
…
],
"sells": [
{ "listings": 1, "unit_price": 99, "quantity": 211 },
{ "listings": 5, "unit_price": 100, "quantity": 699 },
{ "listings": 74, "unit_price": 101, "quantity": 17746 },
…
]
}
http://api.guildwars2.com/v2/commerce/listings?ids=19684,19709
[
{
"id": 19709,
"buys": [
{ "listings": 81, "unit_price": 8, "quantity": 3092 },
{ "listings": 9, "unit_price": 1, "quantity": 335 },
…
],
"sells": [
{ "listings": 2, "unit_price": 63, "quantity": 499 },
{ "listings": 3, "unit_price": 64, "quantity": 289 },
…
]
},
{
"id": 19684,
"buys": [
{ "listings": 1, "unit_price": 5, "quantity": 45 },
{ "listings": 23, "unit_price": 1, "quantity": 1962 },
…
],
"sells": [
{ "listings": 4, "unit_price": 98, "quantity": 951 },
{ "listings": 1, "unit_price": 99, "quantity": 211 },
…
]
}
]
