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