Browse retro game catalogs, fetch paginated pricing summaries, and inspect historical sales from one compact `v1` API.
Routes and query parameters are on the left. A runnable request example for each route is on the right.
/v1/metaDiscover API version info, supported filters, and canonical endpoint paths.
const response = await fetch("https://api.retroledger.com/v1/meta", {
headers: {
"x-api-key": process.env.RETROLEDGER_API_KEY!,
},
});
const data = await response.json();
console.log(data);/v1/platformsList active platforms available through the API.
const response = await fetch("https://api.retroledger.com/v1/platforms", {
headers: {
"x-api-key": process.env.RETROLEDGER_API_KEY!,
},
});
const data = await response.json();
console.log(data);/v1/gamesFetch paginated games with aggregate pricing and search or platform filters.
platformstringPlatform code such as NES, SNES, N64, GB, GBC, GEN, or SMS.
qstringTitle or slug search.
conditionstringFilter metrics to a condition such as loose or cib.
daysintegerRolling lookback window for price metrics.
limitintegerPage size, up to 500.
offsetintegerOffset-based pagination.
reviewStatusstringapproved, pending, rejected, or all.
sortBystringtitle, liquidity, revenue, avgPrice, or latestSale.
const response = await fetch("https://api.retroledger.com/v1/games?platform=GEN&sortBy=latestSale&limit=25", {
headers: {
"x-api-key": process.env.RETROLEDGER_API_KEY!,
},
});
const data = await response.json();
console.log(data);/v1/games/:slugFetch a single game with summary metrics and condition breakdowns.
conditionstringOptional condition filter for metrics.
daysintegerRolling lookback window for summary metrics.
reviewStatusstringapproved, pending, rejected, or all.
const response = await fetch("https://api.retroledger.com/v1/games/sonic-the-hedgehog-genesis?days=180", {
headers: {
"x-api-key": process.env.RETROLEDGER_API_KEY!,
},
});
const data = await response.json();
console.log(data);/v1/games/:slug/pricesFetch paginated historical sales for one game.
conditionstringOptional condition filter.
daysintegerRolling lookback window for historical sales.
reviewStatusstringapproved, pending, rejected, or all.
limitintegerPage size, up to 500.
offsetintegerOffset-based pagination.
const response = await fetch("https://api.retroledger.com/v1/games/sonic-the-hedgehog-genesis/prices?condition=loose&days=365&limit=50", {
headers: {
"x-api-key": process.env.RETROLEDGER_API_KEY!,
},
});
const data = await response.json();
console.log(data);/v1/prices/:gameSlugLegacy alias for the single-game price history route.
conditionstringOptional condition filter.
daysintegerRolling lookback window for historical sales.
reviewStatusstringapproved, pending, rejected, or all.
limitintegerPage size, up to 500.
offsetintegerOffset-based pagination.
const response = await fetch("https://api.retroledger.com/v1/prices/sonic-the-hedgehog-genesis?days=90", {
headers: {
"x-api-key": process.env.RETROLEDGER_API_KEY!,
},
});
const data = await response.json();
console.log(data);