Chessy

Study chess positions.

Endpoints

All examples are using URL-encoded FEN position rnb1kbnr/pp2pppp/1q1p4/8/Q3P3/5N2/PPP2PPP/RNB1KB1R b KQkq - 2 5

/attacking

 

Query params → ?fen=<FEN>

Example

https://chessy.p.rapidapi.com/attacking
?fen=rnb1kbnr%2Fpp2pppp%2F1q1p4%2F8%2FQ3P3%2F5N2%2FPPP2PPP%2FRNB1KB1R%20b%20KQkq%20-%202%205

{
  "black": {
    "b6": ["b2", "f2"]
  },
  "white": {
    "a4": ["a7", "e8"]
  }
}

/defending

 

Query params → ?fen=<FEN>

Example

https://chessy.p.rapidapi.com/defending
?fen=rnb1kbnr%2Fpp2pppp%2F1q1p4%2F8%2FQ3P3%2F5N2%2FPPP2PPP%2FRNB1KB1R%20b%20KQkq%20-%202%205

{
  "black": {
    "a7": ["b6"],
    "a8": ["a7", "b8"],
    "b6": ["a7", "b7", "d6"],
    "c8": ["b7"],
    "e7": ["d6"],
    "e8": ["e7", "f7", "f8"],
    "f8": ["e7", "g7"],
    "g8": ["e7"],
    "h8": ["g8", "h7"]
  },
  "white": {
    "a1": ["a2", "b1"],
    "a4": ["a2", "c2", "e4"],
    "c1": ["b2"],
    "e1": ["f1", "f2"],
    "f1": ["g2"],
    "f3": ["e1", "h2"],
    "g2": ["f3"],
    "h1": ["f1", "h2"]
  }
}

/defenses

 

Query params → ?fen=<FEN>

Example

https://chessy.p.rapidapi.com/defenses
?fen=rnb1kbnr%2Fpp2pppp%2F1q1p4%2F8%2FQ3P3%2F5N2%2FPPP2PPP%2FRNB1KB1R%20b%20KQkq%20-%202%205

{
  "black": {
    "a7": ["a8", "b6"],
    "b6": ["a7"],
    "b7": ["b6", "c8"],
    "b8": ["a8"],
    "d6": ["b6", "e7"],
    "e7": ["e8", "f8", "g8"],
    "f7": ["e8"],
    "f8": ["e8"],
    "g7": ["f8"],
    "g8": ["h8"],
    "h7": ["h8"]
  },
  "white": {
    "a2": ["a1", "a4"],
    "b1": ["a1"],
    "b2": ["c1"],
    "c2": ["a4"],
    "e1": ["f3"],
    "e4": ["a4"],
    "f1": ["e1", "h1"],
    "f2": ["e1"],
    "f3": ["g2"],
    "g2": ["f1"],
    "h2": ["f3", "h1"]
  }
}

/info

Gets detailed information for requested squares.

 

Query params → ?fen=<FEN>&squares=<SQUARES>

Example

https://chessy.p.rapidapi.com/info
?fen=rnb1kbnr%2Fpp2pppp%2F1q1p4%2F8%2FQ3P3%2F5N2%2FPPP2PPP%2FRNB1KB1R%20b%20KQkq%20-%202%205
&squares=a4,b6,f2

{
  "a4": {
    "attacking": ["a7", "e8"],
    "defending": ["a2", "c2", "e4"],
    "defenses": null,
    "piece": {
      "color": "white",
      "type": "queen"
    },
    "sights": ["a2", "a3", "a5", "a6", "a7", "b3", "b4", "b5", "c2", "c4", "c6", "d4", "d7", "e4", "e8"],
    "threats": null
  },
  "b6": {
    "attacking": ["b2", "f2"],
    "defending": ["a7", "b7", "d6"],
    "defenses": ["a7"],
    "piece": {
      "color": "black",
      "type": "queen"
    },
    "sights": ["a5", "a6", "a7", "b2", "b3", "b4", "b5", "b7", "c5", "c6", "c7", "d4", "d6", "d8", "e3", "f2"],
    "threats": null
  },
  "f2": {
    "attacking": null,
    "defending": null,
    "defenses": ["e1"],
    "piece": {
      "color": "white",
      "type": "pawn"
    },
    "sights": ["e3", "g3"],
    "threats": ["b6"]
  }
}

/obscured

 

Query params → ?fen=<FEN>

Example

https://chessy.p.rapidapi.com/obscured
?fen=rnb1kbnr%2Fpp2pppp%2F1q1p4%2F8%2FQ3P3%2F5N2%2FPPP2PPP%2FRNB1KB1R%20b%20KQkq%20-%202%205

{
  "black": ["a1", "a2", "a3", "a4", "b1", "c1", "c2", "c3", "c4", "d1", "d2", "d3", "d5", "e1", "e2", "e4", "f1", "f3", "f4", "g1", "g2", "g3", "g5", "h1", "h2", "h4", "h5"],
  "white": ["a8", "b6", "b7", "b8", "c5", "c7", "c8", "d6", "d8", "e6", "e7", "f6", "f7", "f8", "g4", "g6", "g7", "g8", "h5", "h7", "h8"]
}

/sights

 

Query params → ?fen=<FEN>

Example

https://chessy.p.rapidapi.com/sights
?fen=rnb1kbnr%2Fpp2pppp%2F1q1p4%2F8%2FQ3P3%2F5N2%2FPPP2PPP%2FRNB1KB1R%20b%20KQkq%20-%202%205

{
  "black": {
    "a7": ["b6"],
    "a8": ["a7", "b8"],
    "b6": ["a5", "a6", "a7", "b2", "b3", "b4", "b5", "b7", "c5", "c6", "c7", "d4", "d6", "d8", "e3", "f2"],
    "b7": ["a6", "c6"],
    "b8": ["a6", "c6", "d7"],
    "c8": ["b7", "d7", "e6", "f5", "g4", "h3"],
    "d6": ["c5", "e5"],
    "e7": ["d6", "f6"],
    "e8": ["d7", "d8", "e7", "f7", "f8"],
    "f7": ["e6", "g6"],
    "f8": ["e7", "g7"],
    "g7": ["f6", "h6"],
    "g8": ["e7", "f6", "h6"],
    "h7": ["g6"],
    "h8": ["g8", "h7"]
  },
  "white": {
    "a1": ["a2", "b1"],
    "a2": ["b3"],
    "a4": ["a2", "a3", "a5", "a6", "a7", "b3", "b4", "b5", "c2", "c4", "c6", "d4", "d7", "e4", "e8"],
    "b1": ["a3", "c3", "d2"],
    "b2": ["a3", "c3"],
    "c1": ["b2", "d2", "e3", "f4", "g5", "h6"],
    "c2": ["b3", "d3"],
    "e1": ["d1", "d2", "e2", "f1", "f2"],
    "e4": ["d5", "f5"],
    "f1": ["a6", "b5", "c4", "d3", "e2", "g2"],
    "f2": ["e3", "g3"],
    "f3": ["d2", "d4", "e1", "e5", "g1", "g5", "h2", "h4"],
    "g2": ["f3", "h3"],
    "h1": ["f1", "g1", "h2"],
    "h2": ["g3"]
  }
}

/threats

 

Query params → ?fen=<FEN>

Example

https://chessy.p.rapidapi.com/threats
?fen=rnb1kbnr%2Fpp2pppp%2F1q1p4%2F8%2FQ3P3%2F5N2%2FPPP2PPP%2FRNB1KB1R%20b%20KQkq%20-%202%205

{
  "black": {
    "a7": ["a4"],
    "e8": ["a4"]
  },
  "white": {
    "b2": ["b6"],
    "f2": ["b6"]
  }
}