API:2/itemstats

From Guild Wars 2 Wiki
Jump to navigationJump to 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
   }
  ]
 }
]

Notes

  • "attribute_adjustment" data extracted from API:2/items to allow for calculations of prefix stats for level 80 Exotic and Ascended equipment:
Type Details type Rarity
Exotic Ascended
Armor Shoulders / Gloves / Boots 128.04 134.442
Helm / HelmAquatic 170.72 179.256
Leggings 256.08 268.884
Coat 384.12 403.326
Back item Back item 85.36 89.628
Trinket Accessory 213.4 224.07
Ring 256.08 268.884
Amulet 341.44 358.512
Weapon Axe / Dagger / Mace / Pistol / Scepter / Sword / Focus / Shield / Torch / Warhorn 341.44 358.512
Greatsword / Hammer / LongBow / Rifle / ShortBow / Staff / Harpoon / Speargun / Trident 682.88 717.024

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 attribute_adjustment * multiplier + value where multiplier and value are from the itemstat response."

    "Bonetti's Rapier has an attribute_adjustment 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"