Guild Wars 2

Read your Guild Wars 2 account, characters, and wallet, and look up the game's worlds, from ArenaNet's official API.

Actions

Action	What it does
Get account	Get the connected Guild Wars 2 account's summary: name, home world, guilds, expansions, and achievement points.
Get bank	List the items in the account's bank (empty slots omitted), with each item's name resolved.
Get character	Get one character's core details: race, profession, level, and playtime.
Get gem/gold exchange	Get the current gem exchange rate for a quantity: how many coins a number of gems is worth, or how many gems a number of coins buys.
Get guild	Get a guild's name and tag by its guild id (the GUID from an account or character).
Get material storage	List the account's material-storage stacks that hold at least one item, with each material's name resolved.
Get trading-post price	Get the current trading-post buy and sell prices for an item id.
Get wallet	Get the account's wallet: how much of each currency (gold, karma, etc.) it holds, with each currency named.
List characters	List the names of the account's characters.
List worlds	List the game's worlds (servers) and their populations.
Look up item	Look up a game item by its id: name, type, rarity, required level, and vendor value.

Get account

Get the connected Guild Wars 2 account's summary: name, home world, guilds, expansions, and achievement points.

Inputs

None.

Outputs

accesslist: Owned expansions, e.g. 'HeartOfThorns'.
agenumber: Total played time in seconds.
commandertrue/false: Whether the account owns a commander tag.
createdtext: Account creation date (ISO-8601).
daily_apnumber: Daily achievement points earned.
fractal_levelnumber: Highest fractal level.
guildslist: GUIDs of the guilds the account belongs to.
idtext: Stable account GUID.
monthly_apnumber: Monthly achievement points earned.
nametext: Account name (e.g. 'Name.1234').
worldnumber: Home world id (resolve via List worlds).
wvw_ranknumber: World vs. World rank.

Example output

{
  "access": [
    "GuildWars2",
    "HeartOfThorns",
    "PathOfFire",
    "EndOfDragons"
  ],
  "age": 22911780,
  "commander": true,
  "created": "2013-04-25T22:09:00Z",
  "daily_ap": 7659,
  "fractal_level": 100,
  "guilds": [
    "116E0C0E-0035-44A9-BB22-4AE3E23127E5"
  ],
  "id": "C19467C6-F5AD-E211-8756-78E7D1936222",
  "monthly_ap": 1129,
  "name": "Ricky.1234",
  "world": 1019,
  "wvw_rank": 514
}

Get bank

List the items in the account's bank (empty slots omitted), with each item's name resolved.

Inputs

None.

Outputs

countnumber: Number of occupied bank slots.
itemslist: Items held in the bank.

Example output

{
  "count": 1,
  "items": [
    {
      "count": 5,
      "id": 12134,
      "name": "Bowl of Fruit Salad"
    }
  ]
}

Get character

Get one character's core details: race, profession, level, and playtime.

Inputs

CharacternametextRequired: The character to look up.

Outputs

agenumber: Time played on this character, in seconds.
createdtext: Creation date (ISO-8601).
deathsnumber: Number of deaths.
gendertext: Gender.
guildtext: GUID of the character's guild, if any.
levelnumber: Character level (max 80).
nametext: Character name.
professiontext: Profession, e.g. 'Ranger'.
racetext: Race, e.g. 'Sylvari'.
titlenumber: Equipped title id, if any.

Example output

{
  "age": 3821445,
  "created": "2015-08-13T05:03:00Z",
  "deaths": 892,
  "gender": "Female",
  "guild": "116E0C0E-0035-44A9-BB22-4AE3E23127E5",
  "level": 80,
  "name": "Eranu Skybringer",
  "profession": "Ranger",
  "race": "Sylvari",
  "title": 277
}

Get gem/gold exchange

Get the current gem exchange rate for a quantity: how many coins a number of gems is worth, or how many gems a number of coins buys. Public data.

Inputs

ConvertdirectiontextRequired: Which way to convert.One of: gems (Gems → coins (gold)), coins (Coins (copper) → gems).
AmountquantitynumberRequired: The amount to convert: a number of gems, or a number of copper coins (10000 copper = 1 gold).At least 1.

Outputs

coins_per_gemnumber: Current coins-per-gem rate.
coins_receivedobject: Coins received (when converting gems).
directiontext: 'gems' or 'coins'.
gems_receivednumber: Gems received (when converting coins).
input_quantitynumber: The amount converted.

Example output

{
  "coins_per_gem": 3200,
  "coins_received": {
    "copper": 1280000,
    "copper_remainder": 0,
    "display": "128g",
    "gold": 128,
    "silver": 0
  },
  "direction": "gems",
  "input_quantity": 400
}

Get guild

Get a guild's name and tag by its guild id (the GUID from an account or character). Richer details need a guild-leader key.

Inputs

Guild IDguild_idtextRequired: The guild's GUID (e.g. from Get account).

Outputs

idtext: Guild GUID.
member_countnumber: Members (leader key only).
nametext: Guild name.
tagtext: Guild tag.

Example output

{
  "id": "116E0C0E-0035-44A9-BB22-4AE3E23127E5",
  "level": null,
  "member_capacity": null,
  "member_count": null,
  "motd": null,
  "name": "Edit Conflict",
  "tag": "eC"
}

Get material storage

List the account's material-storage stacks that hold at least one item, with each material's name resolved.

Inputs

None.

Outputs

countnumber: Number of stocked material stacks.
materialslist: Stocked material stacks.

Example output

{
  "count": 1,
  "materials": [
    {
      "category": 5,
      "count": 250,
      "id": 19721,
      "name": "Glob of Ectoplasm"
    }
  ]
}

Get trading-post price

Get the current trading-post buy and sell prices for an item id. Public data.

Inputs

Item IDitem_idtextRequired: The item's numeric id.

Outputs

buy_priceobject: Highest buy order, as gold/silver/copper.
buy_quantitynumber: Quantity wanted at the buy price.
idnumber: Item id.
sell_priceobject: Lowest sell listing, as gold/silver/copper.
sell_quantitynumber: Quantity listed at the sell price.

Example output

{
  "buy_price": {
    "copper": 132,
    "copper_remainder": 32,
    "display": "1s 32c",
    "gold": 0,
    "silver": 1
  },
  "buy_quantity": 800000,
  "id": 24295,
  "sell_price": {
    "copper": 150,
    "copper_remainder": 50,
    "display": "1s 50c",
    "gold": 0,
    "silver": 1
  },
  "sell_quantity": 500000,
  "whitelisted": false
}

Get wallet

Get the account's wallet: how much of each currency (gold, karma, etc.) it holds, with each currency named.

Inputs

None.

Outputs

walletlist: The account's currencies and amounts.

Example output

{
  "wallet": [
    {
      "id": 1,
      "name": "Coin",
      "value": 100001
    },
    {
      "id": 2,
      "name": "Karma",
      "value": 4820157
    }
  ]
}

List characters

List the names of the account's characters.

Inputs

None.

Outputs

characterslist: The account's character names.

Example output

{
  "characters": [
    "Eranu Skybringer",
    "Ricky Ironhide",
    "Alt Necro"
  ]
}

List worlds

List the game's worlds (servers) and their populations. This is public data; use it to turn an account's world id into a name.

Inputs

None.

Outputs

worldslist: The game's worlds.

Example output

{
  "worlds": [
    {
      "id": 1019,
      "name": "Blackgate",
      "population": "Full"
    },
    {
      "id": 1001,
      "name": "Anvil Rock",
      "population": "Medium"
    }
  ]
}

Look up item

Look up a game item by its id: name, type, rarity, required level, and vendor value. Public data.

Inputs

Item IDitem_idtextRequired: The item's numeric id (e.g. from your bank or materials).

Outputs

idnumber: Item id.
levelnumber: Required level.
nametext: Item name.
raritytext: Rarity, e.g. 'Exotic'.
typetext: Item type.
vendor_valueobject: Vendor sell value, broken into gold/silver/copper.

Example output

{
  "chat_link": "[&AgHvdwEA]",
  "description": "",
  "icon": "https://render.guildwars2.com/file/\u2026/bifrost.png",
  "id": 30703,
  "level": 80,
  "name": "The Bifrost",
  "rarity": "Legendary",
  "type": "Weapon",
  "vendor_value": {
    "copper": 100000,
    "copper_remainder": 0,
    "display": "10g",
    "gold": 10,
    "silver": 0
  }
}

ActionsCopy Anchor Link

Get accountCopy Anchor Link

Inputs

Outputs

Get bankCopy Anchor Link

Inputs

Outputs

Get characterCopy Anchor Link

Inputs

Outputs

Get gem/gold exchangeCopy Anchor Link

Inputs

Outputs

Get guildCopy Anchor Link

Inputs

Outputs

Get material storageCopy Anchor Link

Inputs

Outputs

Get trading-post priceCopy Anchor Link

Inputs

Outputs

Get walletCopy Anchor Link

Inputs

Outputs

List charactersCopy Anchor Link

Inputs

Outputs

List worldsCopy Anchor Link

Inputs

Outputs

Look up itemCopy Anchor Link

Inputs

Outputs

On this page

Actions

Get account

Get bank

Get character

Get gem/gold exchange

Get guild

Get material storage

Get trading-post price

Get wallet

List characters

List worlds

Look up item