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