Guild Wars 2

Just turned on a couple of new endpoints:

• /v2/pvp/stats (example, github)
• /v2/pvp/games (example, github)
• /v2/character/:id/specializations (example, github)

/v2/pvp/stats

Requires “pvp” permission.

Dumps a bunch of aggregate pvp data — basically some of the stuff that’s displayed in the in-game UI. Some of it’s missing (e.g., fav map, etc). Consider this an initial pass — going to try to add more details here at some point.

/v2/pvp/games

Requires “pvp” permission.

Dumps the most recent pvp games played. This is a very very initial implementation; there honestly isn’t much useful here right now. There’s a lot more I want to do with this endpoint, but data needs to be plumbed through multiple services owned by multiple teams (who are all already busy) so it’s going to take some time.

As an important note, this endpoint only serves the 10 most recent games (that have occurred within the last 30 days, IIRC). I realize this is terrible and would like to make it a bit more reasonable, but it’s gonna take some time to get better data retention. Highly recommend any applications interested in this data use a server component which periodically polls+persists the endpoint data.

/v2/characters/:id/specializations

Requires “builds” permission.

The specializations are available in both /v2/characters (in the .specializations field) and in /v2/characters/:id/specializations. Data is provided for all of PvE, PvP and WvW builds (specializations can be cross-referenced against /v2/specializations, traits against /v2/traits which I just turned on).

Skills and PvP equipment will be coming at some point in the future but probably not this month (sorry!).

Questions/comments?

Archomeda.6472:

Lawton Campbell.8517:

As an important note, this endpoint only serves the 10 most recent games (that have occurred within the last 30 days, IIRC).

Hmm, apparently I have 10 matches listed, and the dates range from 2015-07-12T02:27:08.000Z to 2015-07-14T03:09:30.000Z. So it would seem that the retention is higher than 30 days

Uhh maybe it’s 90 days. Will double-check and get back to you.

Archomeda.6472:

Edit: A question, what are the possibilities of the results? Currently I have Buy, Defeat, Victory and Forfeit. And what triggers what to show up?

Eww gross, I missed a “Buy” typo coming from our upstream data source. I’m going to patch that to “Bye”. There’s also “Desertion”.

I’m not sure what bye/desertion mean TBH.

Archomeda.6472:

Edit2: I also saw that I’ve had a couple matches of which neither team has reached 500 points. These matches have the map 1011, I’m assuming that’s Battle of the Champion’s Dusk? It’s not yet listed in /v2/maps.

I’ll whitelist the map in a sec, pretty sure that’s the stronghold map. When neither team has 500 points it means the timer was hit.

queicherius.2563:

Wooo! Finally sharing with traits! Thank you so much for this.

Woot! That was really fast

queicherius.2563:

Something interesting is going on with my trait ids here

My guess is that that’s a character I didnt log in yet after the change for traits?

UHHH. Looks like we’re reading garbage memory. That’s kind of surprising; I thought the interfaces I was using automatically detect this (apparently not!).

Thanks for the report <3

sookya.8625:

is it possible to add the Character ID (next to profession) to the PVP-Game-API? With only having the profession, there is no possibility to check with which character the person played, if he has more than one character per profession (2 guards for example).

Planning on adding that at some point in the future. This data is coming from the MMR component which doesn’t currently care about character names so it doesn’t have the data. Gonna take awhile to get all the good stuff (character names and builds) plumbed through the system.

queicherius.2563:

• Do “Solo Ranked” and “Team Ranked” get added together for the “Ranked” ladder? If yes, what are the 49 “Ranked” matches, that are additional if you add “solo” and “team” together? Based on the raw data: (282+288+2+1)-(75+74+185+190) = 49. What exactly are the definitions of these ladders?
• Assuming that “solo ranked” and “team ranked” are included in the “ranked” matches, the aggregate number does not match up with the ladders number: (567+503+6+23+17)-(282+288+2+1+213+157+6+21+16) = 130. Are these custom arenas?

So, back in the days of glory there were two game modes — soloq and team (“solo ranked” and “team ranked”). These are distinct from the modes we have now — unranked and ranked. New accounts won’t have the former but old accounts have their old data still in the system.

AFAIK custom arenas are tracked in the other aggregates, but not in the ladders.

queicherius.2563:

• What is the “none” ladder for?

I’m not entirely sure actually. I think it’s debris from a bug at some point.

queicherius.2563:

Edit: While I am at it, the timezone offeset for the played matches seems wrong. The match I played a few minutes ago is dated “2015-09-10T18:34:54.000Z”, when it should be “2015-09-10T10:34:54.000Z” or “2015-09-10T18:44:54+08:00”.

Ick, I wonder where that’s coming from. Should be able to bandaid that sometime next week.

MarkPhilips.5169:

It would be really interesting tracking roster compositions for every game (which profession people used, especially for ranked/unranked) and the stats pvp team lately added in the game (like total damage done etc.) that we can hardly analyze at the end of the match.

zweiter.1267:

In addition to this, it would be super cool, if the api delivers the team- and enemy-team composition (only the professions, not the character names/id’s).

We’ll add those in at some point; it’s probably gonna be a month or two from now though ;_;

Nabrok.9023:

Patches.7584:

Does the game keep track “Top X” awards internally? eg: Top Condition Damage Received.

I’m curious if this will ever be available in the API.

It’d be neat to get it via pvp/games, but a counter in pvp/stats would be cool as well.

That stuff really should be available in game for at least the last match you were in. As it is you have about 5 seconds to look at it before it’s gone forever.

Yeah, AFAIK it’s currently only tracked by the map instance server and not persisted anywhere. Might take a look at the current state of all the pvp stuff next week, I really want match rosters.

Ryan.9387:

My current PvP stats from the in game window are different
Ranger : 3834
From the API : 3701

Which in-game data are you looking at?

Note that the in-game UI considers a “bye” as a victory and a “forfeit” as a defeat when it displays aggregates — that might be the cause of the discrepancy. Both the in-game UI and the API are pulling from the same internal API, so it’s unlikely they’re out-of-sync.

fro.8967:

Lawton Campbell.8517:

the in-game UI considers a “bye” as a victory and a “forfeit” as a defeat

What about desertions?

Ah, those are counted as defeats too.

Ryan.9387:

Can we get an idea of the data coming to the pvp api in the coming months? I’m not looking for a date, more so an idea of what will/will not be added long term. The info well help drive the design of my website.

Specifically things like:
Account names for all players
Per player score
The detailed stats tab
Builds
League info

Ideally I’d like all of those things in (and more), but I can’t really commit to features or a timeline. Especially when it’s the competitive team doing all the backend work for me on those parts