Documentation (API)


Gem Exchange History

This JSON resource finds historical data for the gem exchange.

Response
  • timestamp (string) - The timestamp in milliseconds (UTC).
  • coins_per_gem_c2g (integer) - The coins to gem conversion rate displayed in copper.
  • coins_per_gem_g2c (integer) - The gem to coins conversion rate displayed in copper.
Example

Find ID By Name

This JSON resource finds all item ids that match your item name query. If a match is found, an array of objects is returned. Otherwise, null is returned.

Response
  • name (string) - The item name.
  • item_id (integer) - The item id.
Example

Items

This JSON resource returns item information based on the item id specified. If a match is found, an object is returned. Otherwise, null is returned.

Response
  • item_id (integer) - The id of the item.
  • name (string) - The name of the item.
  • icon (string) - The image icon URL of the item.
  • rarity (string) - The rarity of the item.
  • level (integer) - The level of the item.
  • type (string) - The type of the item. This field is hidden if there is no type.
  • subtype (string) - The subtype of the item. This field is hidden if there is no subtype.
  • weight (string) - The weight class of the item. This field is hidden if there is no weight class.
  • buy (integer) - The top buy order price of the item (in copper).
  • sell (integer) - The top sell order price of the item (in copper).
  • supply (integer) - The supply of the item.
  • demand (integer) - The demand of the item.
  • profit (integer) - The profit of the item (in copper) if it were to be flipped using the buy order and sold using the sell order (including the 15% Trading Post listing fees).
Example
  • https://www.gw2shinies.com/api/json/item/45143
    [{
    	"item_id":"45143",
    	"name":"Jatoro's Coat",
    	"icon":"https:\/\/render.guildwars2.com\/file\/FB0AA64F98303AE5112408EF3DC8C7307EA118F8\/61011.png",
    	"rarity":"Exotic",
    	"level":"80",
    	"type":"Armor",
    	"subtype":"Coat",
    	"weight":"Light",
    	"buy":"6050",
    	"sell":"16791",
    	"supply":"136",
    	"demand":"48",
    	"profit":"8222"
    }]
    

Mystic Forge

This JSON resource finds all mystic forge recipes (currently only Skill Point based recipes) that match your item id query. If a match is found, an array of objects is returned. If no keyword is entered, all recipes are returned. Otherwise, null is returned.

Response
  • type (string) - The type of recipe. The types included are:
    • promo - This is a promotion recipe.
    • weapon - This is a weapon recipe.
    • amulet - This is an amulet recipe.
    • recipe - This is a crafting recipe that can be learned.
  • target_recipe (integer) - The item to be created.
  • recipe_item_1 (integer) - The first item to be used in the mystic forge.
  • recipe_item_1_quantity (integer) - The quantity of the first item.
  • recipe_item_2 (integer) - The second item to be used in the mystic forge.
  • recipe_item_2_quantity (integer) - The quantity of the second item.
  • recipe_item_3 (integer) - The third item to be used in the mystic forge.
  • recipe_item_3_quantity (integer) - The quantity of the third item.
  • recipe_item_4 (integer) - The fourth item to be used in the mystic forge.
  • recipe_item_4_quantity (integer) - The quantity of the fourth item.
  • average_yield (double) - The average yield of a recipe (based on research pulled from the Guild Wars 2 Wiki).
Example
  • https://www.gw2shinies.com/api/json/forge/24274
    [{
    	"type":"promo",
    	"target_recipe":"24274",
    	"recipe_item_1":"24273",
    	"recipe_item_1_quantity":"250",
    	"recipe_item_2":"24274",
    	"recipe_item_2_quantity":"1",
    	"recipe_item_3":"20796",
    	"recipe_item_3_quantity":"2",
    	"recipe_item_4":"20799",
    	"recipe_item_4_quantity":"5",
    	"average_yield":"18.51"
    }]
    

Recipes

This JSON resource finds all crafting recipes that match the item id specified (based on the item being created). If a match is found, an array of objects is returned. If the 'tp' keyword is entered, all recipes (that can be traded) are returned. Otherwise, null is returned.

Response
  • recipe_id (integer) - The id of the recipe.
  • type (string) - The crafting process type.
  • required_rating (integer) - The rating required to craft the recipe.
  • output_id (integer) - The id of the item being created.
  • output_name (string) - The name of the item being created.
  • output_rarity (string) - The rarity of the item being created.
  • output_quantity (integer) - The output quantity of the item being created.
  • output_buy (integer) - The top buy order price of the item being created (in copper).
  • output_sell (integer) - The top sell order price of the item being created (in copper).
  • ingredients (array) - An array containing up to 4 ingredients, including the item ids and quantities.
    • ing1_id (integer) - The id of the first ingredient.
    • ing1_name (string) - The name of the first ingredient.
    • ing1_rarity (string) - The rarity of the first ingredient.
    • ing1_quantity (integer) - The item quantity required for the first ingredient.
    • ing1_buy (integer) - The top buy order price of the first ingredient (in copper).
    • ing1_sell (integer) - The top sell order price of the first ingredient (in copper).
    • ing2_id (integer) - The id of the second ingredient.
    • ing2_name (string) - The name of the second ingredient.
    • ing2_rarity (string) - The rarity of the second ingredient.
    • ing2_quantity (integer) - The item quantity required for the second ingredient.
    • ing2_buy (integer) - The top buy order price of the second ingredient (in copper).
    • ing2_sell (integer) - The top sell order price of the second ingredient (in copper).
    • ing3_id (integer) - The id of the third ingredient.
    • ing3_name (string) - The name of the third ingredient.
    • ing3_rarity (string) - The rarity of the third ingredient.
    • ing3_quantity (integer) - The item quantity required for the third ingredient.
    • ing3_buy (integer) - The top buy order price of the third ingredient (in copper).
    • ing3_sell (integer) - The top sell order price of the third ingredient (in copper).
    • ing4_id (integer) - The id of the fourth ingredient.
    • ing4_name (string) - The name of the fourth ingredient.
    • ing4_rarity (string) - The rarity of the fourth ingredient.
    • ing4_quantity (integer) - The item quantity required for the fourth ingredient.
    • ing4_buy (integer) - The top buy order price of the fourth ingredient (in copper).
    • ing4_sell (integer) - The top sell order price of the fourth ingredient (in copper).
  • disciplines (array) - An array containing up to 8 disciplines that use this recipe. The disciplines included are:
    • Armorsmith
    • Artificer
    • Chef
    • Huntsman
    • Jeweler
    • Leatherworker
    • Tailor
    • Weaponsmith
  • total_cost_buy (integer) - The total cost of the ingredients using top buy order values (in copper).
  • total_cost_sell (integer) - The total cost of the ingredients using top sell order values (in copper).
  • profit_buy (integer) - The profit of the item (in copper) if it were to be flipped using all ingredient buy order values and sold using the top sell order of the output item (including the 15% Trading Post listing fees).
  • profit_sell (integer) - The profit of the item (in copper) if it were to be flipped using all ingredient sell order values and sold using the top sell order of the output item (including the 15% Trading Post listing fees).
Example
  • https://www.gw2shinies.com/api/json/recipe/19685
    [{
    	"recipe_id":"21",
    	"type":"Refinement",
    	"required_rating":"400",
    	"output_id":"19685",
    	"output_name":"Orichalcum Ingot",
    	"output_rarity":"Basic",
    	"output_quantity":"1",
    	"output_buy":"730",
    	"output_sell":"800",
    	"ingredients":{
    		"ing1_id":19701,
    		"ing1_name":"Orichalcum Ore",
    		"ing1_rarity":"Basic",
    		"ing1_quantity":"2",
    		"ing1_buy":"360",
    		"ing1_sell":"405"
    		},
    	"disciplines":[
    		"Armorsmith",
    		"Artificer",
    		"Huntsman",
    		"Jeweler",
    		"Weaponsmith"
    		],
    	"total_cost_buy":"720",
    	"total_cost_sell":"810",
    	"profit_buy":"-40",
    	"profit_sell":"-130"
    }]
    

Trading History

This JSON resource finds historical data using a specified item id. If a match is found, an array of objects is returned. Otherwise, null is returned. This API is updated once every 15 minutes.

Response
  • timestamp (string) - The timestamp of the item displayed in milliseconds (UTC).
  • buy (integer) - The top buy order price of the item displayed in copper.
  • sell (integer) - The top sell order price of the item displayed in copper.
  • supply (integer) - The supply of the item.
  • demand (integer) - The demand of the item.
Example