API:2/commerce/transactions

From Guild Wars 2 Wiki
Jump to navigationJump to search

/v2/commerce/transactions

HTTP method
GET
Format
json
API version
version 2
Release date
2015-05-13
Scope
account
tradingpost
Optional
none

This resource provides access to the current and historical transactions of a player. This is an authenticated endpoint. Results are cached for five minutes.[1]

Parameters

None

Response

If no second-level endpoint was specified (https://api.guildwars2.com/v2/commerce/transactions), the response will contain a list of valid second-level endpoints:

  • current – Currently unfulfilled transactions.
  • history – Fulfilled transactions of the past 90 days.

If a second-level endpoint was defined, the response will contain a list of third-level endpoints - no matter which second-level endpoint was specified:

  • buys
  • sells

By requesting a third-level endpoint, the response will contain a paginated list of transactions. Each transaction is an object with the following properties:

  • id (number) – Id of the transaction.
  • item_id (number) – The item id.
  • price (number) – The price in coins.
  • quantity (number) – The quantity of the item.
  • created (string) – The date of creation, using ISO-8601 standard.
  • purchased (string) – The date of purchase, using ISO-8601 standard. Not shown in current second-level endpoint.

Example

Request

 https://api.guildwars2.com/v2/commerce/transactions/history/sells
 Authorization: Bearer api-key-here

Response

 [
   {
     "id":2750477618,
     "item_id":24612,
     "price":1788,
     "quantity":1,
     "created":"2015-05-09T17:13:26+00:00",
     "purchased":"2015-05-09T17:24:20+00:00"
   },
   {
     "id":2741711490,
     "item_id":20553,
     "price":12374,
     "quantity":1,
     "created":"2015-05-05T17:27:43+00:00",
     "purchased":"2015-05-05T18:41:45+00:00"
   }
 ]

References