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 },
      …
    ]
  }
]