Single puzzle by id
API · /chesspuzzles-api
Chess Puzzles API
Serve chess tactics puzzles on demand: a random puzzle (optionally constrained by theme and rating), a single puzzle by id, full search and filtering by tactic theme and difficulty rating, and the complete list of available themes. Every puzzle includes the starting position as FEN, the full solution as UCI moves, the side to move, the difficulty rating, popularity and play count, theme and opening tags and a direct link to train it on Lichess. Built on a curated 20,000-puzzle sample of the open Lichess puzzle database (CC0) spanning 73 themes and ratings from roughly 400 to 3100. Every endpoint accepts input via the query string or the request body and returns lean JSON. Pure server-side data (no third-party upstream), so responses are instant and always available. Ideal for chess apps, training tools, "puzzle of the day" features and games.
API health
healthy- Uptime
- 100.00%
- Server probes · 24h
- Avg latency
- 82 ms
- Server probes · 24h
- Subscribers
- 3,518
- active
- Total calls
- 76
- last 7 days
Pricing
Pick a tier — billed monthly, cancel anytime.
Free
Free
- 18,000 calls / month
- 3 requests / second
- Hard cap (429 above quota, no overage)
- 18,000 calls/month, 3 req/s
- Random, search, single puzzle & themes — FEN + solution + Lichess link
- No credit card
Basic
€3.50 /month
- 220,000 calls / month
- 8 requests / second
- Hard cap (429 above quota, no overage)
- 220,000 requests/month, 8 req/s
- All endpoints, full theme & rating filtering
- Commercial use included
- Email support
Pro
€11.00 /month
- 1,800,000 calls / month
- 25 requests / second
- Hard cap (429 above quota, no overage)
- 1,800,000 requests/month, 25 req/s
- High throughput for chess apps & training tools
- Priority email support
- Commercial use allowed
Mega
€31.00 /month
- 9,000,000 calls / month
- 60 requests / second
- Hard cap (429 above quota, no overage)
- 9,000,000 requests/month, 60 req/s
- Highest throughput for production chess products
- Priority support
- Commercial use allowed
Built by
Related APIs
Other APIs with overlapping tags.
Lichess API
Lichess as an API — the open-source chess platform, returned as clean JSON, no key. Look up any player's profile (titles, ratings across bullet, blitz, rapid and classical, game counts, country, FIDE rating), their rating history per variant and online status; pull the top players for any performance type; fetch a user's recent games with openings, clocks, results and full move lists; get a Stockfish cloud evaluation of any position by FEN (best lines, centipawn or mate scores); serve the daily puzzle or any puzzle by id (with solution and themes); and list current, upcoming and finished tournaments. Live data straight from lichess.org. Distinct from Chess.com player stats: Lichess is its own platform with cloud engine analysis, a puzzle database and arena tournaments — ideal for chess apps, coaching tools, analysis boards, bots and leaderboards. 9 data endpoints. Authenticated with an x-oanor-key; fair-use rate limits per plan.
api.oanor.com/lichess-api
Chess Openings API
The Encyclopaedia of Chess Openings (ECO) as an API — 3,161 named chess openings and variations with their ECO code (A00–E99), full name, family/variation and the exact move sequence (PGN and a clean move list). Search openings by name, ECO code or ECO volume; list every opening under a code (e.g. B20 → 27 Sicilian lines); pick a random opening; and — the killer feature — identify which opening a game is in from a sequence of moves (e.g. "1. e4 c5 2. Nf3" → Sicilian Defense). Ideal for chess apps, game analysis, training tools, bots and trivia. Open data from the lichess-org/chess-openings project.
api.oanor.com/chessopenings-api
Chess.com API
Public Chess.com data — player profiles (title, country, followers, join date), rating stats across rapid, blitz, bullet and daily with win/loss/draw records and personal bests, and the live leaderboards. Great for chess apps, dashboards, coaching tools, streamers and esports analytics.
api.oanor.com/chess-api
Epic Games Store Free Games API
Live free-games promotions from the Epic Games Store. The games that are free to claim right now (with the window they are free) and the ones becoming free soon — each with title, description, publisher, original price, store slug, cover image and store URL. The iconic "Epic free game this week" as a clean API for gaming, deal-alert, calendar and dashboard apps. Distinct from cross-store deal aggregators — Epic's own giveaways.
api.oanor.com/epicgames-api
Frequently asked questions
Quick answers about pricing, quotas, and integration.
How do I get an API key for Chess Puzzles API?
What's the rate limit for Chess Puzzles API?
How much does Chess Puzzles API cost?
Can I cancel my subscription anytime?
Is Chess Puzzles API GDPR-compliant?
Pick an endpoint from the list on the left to see its details and try it.
Code snippets
Sign up to get an API key, then call any path under your slug.
curl https://api.oanor.com/chesspuzzles-api/SOME_PATH \
-H "x-oanor-key: oanor_test_..."
const res = await fetch("https://api.oanor.com/chesspuzzles-api/SOME_PATH", {
headers: { "x-oanor-key": "oanor_test_..." }
});
const data = await res.json();
$ch = curl_init("https://api.oanor.com/chesspuzzles-api/SOME_PATH");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
$response = curl_exec($ch);
import requests
r = requests.get(
"https://api.oanor.com/chesspuzzles-api/SOME_PATH",
headers={"x-oanor-key": "oanor_test_..."},
)
print(r.json())
Ratings
Sign in to rate.
No reviews yet.
Discussion
Ask questions, share usage tips, get answers from the provider and other developers. Public — anyone can read.
Sign in to start a thread or reply.
Sign inNew thread
·
-
Provider answer
🔒 This thread is locked — no new replies.
-
·
- No threads yet — start the discussion.
Support
Private 1:1 support with the provider — billing questions, integration issues, account problems. Only you and the provider team can see these threads.
Sign in to open a support ticket.
Sign inOpen new ticket
Describe what you need help with. The provider team gets an email and replies on the ticket page.
-
·
Urgent - No tickets yet for this API.