Game Result Codes question

I am processing game result codes right now and have questions about some of them. Any help would be appreciated. I got the game result codes from

https://www.chess.com/news/view/published-data-api#game-results

I have questions about the following codes

1- Abandoned: What is the difference between abandoned and resigned? 

2- Lose: Why would it say lose? Why wouldnt it say resigned, or checkmated? 

I want to know if these are used and if I should expect them to come up in endpoints. I have been checking some of them and most say "win" or "checkmated" or "agreed" etc... 

I agree there is some lack of clarity.

"win" and "lose" would appear to overlap with everything else.

"abandoned" and "timeout" ... they look like they overlap, so some expansion of the definitions would be good.

@NichtGut:

1. Resigned is an action: a player concedes the game. I would expect it to be distinguished from a timeout in daily chess and from a loss on time in live

2. Lose could cover losing on time in live chess? But I'm guessing. Clock "flag" fall ending while a player is actively playing is not really "timeout" and certainly isn't "abandoned".

I too would like to know the official answers!

Thats very true, I forgot about live games. I was only seeing daily games. Still abandoned and timeout are weird, and the existance of lose too. Hopefully we get official answers. 

We likely will. I suspect "win" and "lose" are there for safety, so that if nothing more specific is right for some reason there will always be a way to convey the result.

I could imagine reasons to use "abandoned" for daily games ... closed account? But it's all guesswork unless we dig up enough examples (and I'm not keen to; other things to do this evening) so simplest if we get an official explanation and documentation update for the subtleties. 

By coincidence I'm working on this at the moment, trying to collate all results of matches in the TMCL tournament. So far I've managed to derive all the information I need from the match endpoints themselves (I prefer to keep the number of API requests to the bare minimum if I can).

But I found the games' results information lacking in detail to say the least. The formal match endpoint description refers loosely to 'win' & 'lose' but as far as I can see the 'lose' category is never used. The list I've found is as follows:-

• 'win': 1
• 'stalemate': 0.5
• 'repetition': 0.5
• 'insufficient': 0.5
• 'agreed': 0.5
• 'checkmated': 0
• 'resigned': 0
• 'timeout': 0

Those are the only categories of game results that I've found so far after scouring through a lot of matches. I copied & pasted that from my script & I've left the points in that I'm using to calculate revised team scores (we adjust final score to penalise teams for closed accounts due to fair play). Those are for Daily play of course.

If you know of any other uncommon result category that I've missed, I'd be most grateful if you'd drop me a line!

I'd imagine there's something for the 50 move rule. Perhaps there's also something for when one side is out of time but the other doesn't have mating material. Maybe there's also something if a game is adjudicated as a win or draw for some reason.

Good point! What we need is for the developers to provide a complete & exhaustive list. What's the best & quickest way to request that?

Yeah.

50move is for the 50 move rule draw

then there is timevsinsufficient for timeout vs insufficient material

I guess this thread is good for chess.com API team to answer our question. If they see it...

They'll see it. But it's barely Monday afternoon in my timezone so give them a chance. I suspect a little code review will be wanted before anyone is willing to give "definitive" answers.

It would be cool if they could just tell us they are working on giving us an answer so we know they have seen our question.

They might not be in to work on Monday morning yet!!

Or re-reading your question, you'd like a note here that the issue is under review if an immediate answer is not possible. Language, written only communication, sometimes tricky.

Yep if they could leave a note as you say.

UPDATE

I was navigating trough the dark depths of JSON endpoints and I think I found something

Lose seems to be used to describe the result of a match. 

https://api.chess.com/pub/match/1

https://api.chess.com/pub/match/2

If you look for "result" you will see the team that loses will have "lose" as their result in both endpoints. 

I still dont know what the heck is going on with "abandoned".

The term 'lose' is used with reference to players' own games in the match endpoint description. On a closer look, I notice that although matches in_progress & finished are included together, they're not of identical formats!

For example, look at an in_progress match & you'll see timeout data in the player stats but not for a match that's finished.

When a player loses I usually see "checkmated" or "resigned". I have only seen "lose" to describe the results of matches

https://api.chess.com/pub/club/team-australia-melbourne-vic/matches

If you search for "lose" you will see its used to describe the result so its also used for that. 

 Finished and current matches are not the same as you said, a developer just said on the notes they are only shown in current and future matches.

Sorry, just wanted to update with what I've found. Threecheck was missing.

win: 1,
stalemate: 0.5,
repetition: 0.5,
insufficient: 0.5,
agreed: 0.5,
checkmated: 0,
resigned: 0,
timeout: 0,
threecheck: 0