API:2/itemstats

From Guild Wars 2 Wiki
Jump to: navigation, search

/v2/itemstats

HTTP method
GET
Format
json
API version
version 2
Release date
2016-03-11
Scope
none
Optional
none

This resource returns information about itemstats for items that are in the game.

Endpoints

  • None - Request the list of all available itemstats ids when the root endpoint (v2/itemstats) has been accessed.
  • id - (Optional) Request itemstats for the specified id when accessing the endpoint (v2/itemstats/id). Cannot be used when specifying the ids parameter.

Parameters

  • lang – (Optional) Request localized information.
  • ids - (Optional; Comma Delimited List|all) Request an array of itemstats for the specified ids or all itemstats. Cannot be used when using the id endpoint. Limited to 200 ids per request.

Response

For each requested itemstats id, an object with the following properties is returned:

  • id (integer) (default/null value: 0) - The itemstat id.
  • name (string) (default/null value: "") - The name of the set of stats.
  • attributes (array of objects) (default/null value: {} empty array) – List of attribute bonuses. Each object may contain the following :

Example

https://api.guildwars2.com/v2/itemstats

[
 50,
 68,
 69,
 ...,
 1189,
 1190,
 1191
]

https://api.guildwars2.com/v2/itemstats/584

{
  "id": 584,
  "name": "Berserker's",
  "attributes": [
    {
      "attribute": "Power",
      "multiplier": 0.35,
      "value": 32
    },
    {
      "attribute": "Precision",
      "multiplier": 0.25,
      "value": 18
    },
    {
      "attribute": "CritDamage",
      "multiplier": 0.25,
      "value": 18
    }
  ]
}

https://api.guildwars2.com/v2/itemstats?ids=1012

[
 {
  "id":1012,
  "name":"Apostate's",
  "attributes": [
   {
    "attribute": "Toughness",
    "multiplier": 0.25,
    "value": 0
   },
   {
    "attribute": "Healing",
    "multiplier": 0.25,
    "value": 0
   },
   {
    "attribute": "ConditionDamage",
    "multiplier": 0.35,
    "value": 0
   }
  ]
 }
]

https://api.guildwars2.com/v2/itemstats?ids=1012&lang=de

[
 {
  "id":1012,
  "name":"Häretischer",
   {
    "attribute": "Toughness",
    "multiplier": 0.25,
    "value": 0
   },
   {
    "attribute": "Healing",
    "multiplier": 0.25,
    "value": 0
   },
   {
    "attribute": "ConditionDamage",
    "multiplier": 0.35,
    "value": 0
   }
  ]
 }
]

References

  1. ^ a b Daniel Snider, ArenaNet API gitter - "Effectively, each item has a single generated number based on level/item type/handedness, etc. That number is then multiplied across those "multiplier" values you see in the response. The "value" is added on top of that, so the formula to compute a stat for an item is hidden_item_number * multiplier + value where multiplier and value are from the itemstat response. hidden_item_number isn't exposed anywhere (as of 22nd May 2018), but I'd like to do so in v2/items/:id"

    "Bonetti's Rapier has a hidden value of 341.44 It's infix upgrade is https://api.guildwars2.com/v2/itemstats/161 so Precision will be round(341.44 * 0.25 + 0) == 85"