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

Notes

  • Two prefixes found on items are not currently whitelisted, these are 1556 and 1559 (Plaguedoctor's and Diviner's).
  • Empirically found "hidden_item_number" data 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.78
Armor Helm / HelmAquatic 170.72 180.67
Armor Leggings 256.08 269.57
Armor Coat 383 404
Back item Back item 85.5 89.1
Trinket Accessory 213.4 224.05
Trinket Ring 256.08 268.85
Trinket Amulet 341.44 358.47
Weapon Axe / Dagger / Mace / Pistol / Scepter / Sword / Focus / Shield / Torch / Warhorn 341.44 358.47
Weapon Greatsword / Hammer / LongBow / Rifle / ShortBow / Staff / Harpoon / Speargun / Trident 682.88 716.94

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"