From Guild Wars 2 Wiki
(Redirected from API)
Jump to: navigation, search

The Guild Wars 2 API (application programming interface) is an interface that enables third-party applications to access data directly from the Guild Wars 2 servers. The current version of the API is version 1. For recent changes of the API, see the API changelog.

To discuss the Guild Wars 2 API, or in case of problems or required help, visit the official API development forums.

Guild Wars 2 API Terms of Use

These APIs are wholly owned by ArenaNet, LLC ("ArenaNet"). Any use of the APIs must comply with the Website Terms of Use and Content Terms of Use, however you may use the APIs to make commercial products so long as they are otherwise compliant and do not compete with ArenaNet. ArenaNet may revoke your right to use the APIs at any time. In addition, ArenaNet may create and/or amend any terms or conditions applicable to the APIs or their use at any time and from time to time. You understand and agree that ArenaNet is in the process of developing a full license agreement for these APIs and ArenaNet will publish it when it is complete. Your continued use of the APIs constitutes acceptance of the full license agreement and any related terms or conditions when they are posted.

Help topics

  • Maps: How to use the map resources and the tile service to create maps.

Version 2 endpoints

The API version 2 provides the following endpoints:


These endpoints access account data and require an API key to view.

  • account: Returns information about an account associated with an API key.
  • account/bank: Returns information about a bank associated with an API key.
  • account/materials: Returns information about a material storage associated with an API key.
  • characters: Returns information on an account's characters.
  • commerce/transactions: Returns information on an account's past and current trading post transactions.
  • tokeninfo: Returns information about the supplied API Key.


  • items: Returns information about items
  • materials: Returns information about materials
  • recipes: Returns information about recipes
  • recipes/search: A search interface for recipes
  • skins: Returns information about skins

Map information

  • continents: Returns a list of continents and information about each continent
  • floors: Returns detailed information about a map floor
  • maps: Returns information about maps in the game

Trading post


Version 1 endpoints

The API version 1 provides the following endpoints:

Dynamic events

  • events: Returns the current status of events for a specific world.
    • Note: This endpoint is obsolete due to the implementation of Megaserver technology. There are plans to replace it with something that returns data about the rotating world bosses, but nothing specific has been announced.
  • event_names: Returns a list of localized event names.
  • map_names: Returns a list of localized map names.
  • world_names: Returns a list of localized world names.
  • event_details: Returns detailed information about events.



Map information

  • continents: Returns a list of continents and information about each continent.
  • maps: Returns a list of maps in the game.
  • map_floor: Returns detailed information about a map floor

World vs. World


  • build: Returns the current build id.
  • colors: Returns a list of dyes in the game.
  • files: Returns commonly requested assets.


  • Tile service: Provides world map tiles to create Guild Wars 2 maps
  • Render service: Provides access to in-game assets.
  • Additional resources are available as assets.

Other resources

  • Mumble - Open source voice chat software. Guild Wars 2 provides real-time character position, map_id, and other information via Mumble's Link plugin.
  • Chat link format

List of wrappers

  • A list of wrapper libraries that provide high-level access to the API is available here.

List of applications

  • A list of applications that use the API is available here.

See also