{"slug":"chess402-vercel-app-api-masters-36f92f","title":"Masters opening explorer for a position","host":"chess402.vercel.app","method":"POST","resource":"https://chess402.vercel.app/api/masters","category":"other","description":"Masters opening explorer for a position. Returns top moves, win/draw/loss rates, and recent top master games from the Lichess masters database.","price_listed":0.003,"price_asked":0.003,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":248,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"fen":"rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1","moves":12,"play":"e2e4,e7e5","topGames":4},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"description":"Masters opening explorer request: FEN plus optional filters and play sequence.","properties":{"fen":{"description":"Standard FEN position string, e.g. 'rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1'","maxLength":100,"minLength":15,"type":"string"},"moves":{"description":"Max number of top moves to return. Default 12.","maximum":50,"minimum":1,"type":"integer"},"play":{"description":"Comma-separated UCI move sequence to apply to the FEN before lookup (e.g. 'e2e4,e7e5').","maxLength":500,"type":"string"},"since":{"description":"Include games from this year onward.","maximum":2100,"minimum":1500,"type":"integer"},"topGames":{"description":"Number of recent top games to include. Default 4.","maximum":15,"minimum":0,"type":"integer"},"until":{"description":"Include games up to this year.","maximum":2100,"minimum":1500,"type":"integer"}},"required":["fen"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":{},"description":"Masters database aggregate stats for the position.","properties":{"black":{"description":"Total black wins at this position.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"draws":{"description":"Total draws at this position.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"moves":{"description":"Top moves ordered by frequency.","items":{"additionalProperties":{},"properties":{"averageRating":{"description":"Average rating of players who played this move.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"black":{"description":"Games won by black from this move.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"draws":{"description":"Drawn games from this move.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"game":{"anyOf":[{"additionalProperties":{},"properties":{"black":{"additionalProperties":false,"description":"Black player.","properties":{"name":{"description":"Player name.","type":"string"},"rating":{"description":"Player rating.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["name","rating"],"type":"object"},"id":{"description":"Lichess game id.","type":"string"},"month":{"description":"Month string (YYYY-MM).","type":"string"},"uci":{"description":"UCI move played in this game.","type":"string"},"white":{"additionalProperties":false,"description":"White player.","properties":{"name":{"description":"Player name.","type":"string"},"rating":{"description":"Player rating.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["name","rating"],"type":"object"},"winner":{"anyOf":[{"enum":["white","black"],"type":"string"},{"type":"null"}],"description":"Winner, or null for a draw."},"year":{"description":"Year the game was played.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["uci","id","winner","white","black","year"],"type":"object"},{"type":"null"}],"description":"Representative game for this move, if available."},"opening":{"anyOf":[{"additionalProperties":{},"properties":{"eco":{"description":"ECO opening code.","type":"string"},"name":{"description":"Opening name.","type":"string"}},"required":["eco","name"],"type":"object"},{"type":"null"}],"description":"ECO opening classification for this move, when recognized."},"san":{"description":"SAN move string.","type":"string"},"uci":{"description":"UCI move string.","type":"string"},"white":{"description":"Games won by white from this move.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["uci","san","white","draws","black"],"type":"object"},"type":"array"},"opening":{"anyOf":[{"additionalProperties":{},"properties":{"eco":{"description":"ECO opening code.","type":"string"},"name":{"description":"Opening name.","type":"string"}},"required":["eco","name"],"type":"object"},{"type":"null"}],"description":"ECO opening classification for the position, when recognized."},"topGames":{"description":"Recent top master games at this position.","items":{"additionalProperties":{},"properties":{"black":{"additionalProperties":false,"description":"Black player.","properties":{"name":{"description":"Player name.","type":"string"},"rating":{"description":"Player rating.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["name","rating"],"type":"object"},"id":{"description":"Lichess game id.","type":"string"},"month":{"description":"Month string (YYYY-MM).","type":"string"},"uci":{"description":"UCI move played in this game.","type":"string"},"white":{"additionalProperties":false,"description":"White player.","properties":{"name":{"description":"Player name.","type":"string"},"rating":{"description":"Player rating.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["name","rating"],"type":"object"},"winner":{"anyOf":[{"enum":["white","black"],"type":"string"},{"type":"null"}],"description":"Winner, or null for a draw."},"year":{"description":"Year the game was played.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["uci","id","winner","white","black","year"],"type":"object"},"type":"array"},"white":{"description":"Total white wins at this position.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["white","draws","black","moves"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.003,"price_match":true,"latency_ms":248,"error":null}],"description_full":"Masters opening explorer for a position. Returns top moves, win/draw/loss rates, and recent top master games from the Lichess masters database.","last_updated":"2026-09-17T03:59:42.112Z","schemes":["exact"]}