Explore the 
DarkerDB API documentation, your gateway to harnessing Dark and Darker game data. Use our APIs to track in-game market trends, analyze live player stats, and access detailed item data, including stats, descriptions, and market data. Download game assets like item icons to enhance your apps or generate interactive tooltips. Feel free to get in touch with us in our Discord for support or to request new features or data!
Leaderboards
One leaderboard per distinct id in the flat ladder table — 68 today. The catalog is fixed and small, so the list endpoint is not paginated. Per-leaderboard entries are page-paginated, ranked by score (highest first).
Ids use the standard id.leaderboard.<slug> envelope, like every other resource: id.leaderboard.ea7_hof_dhr_b, id.leaderboard.ea1_d. The slug is the lowercased Dark and Darker code, so it still preserves the original — ea7 = Early Access Season 7, hof = Hall of Fame, shr / dhr / thr = Solo / Duo / Trio, b / tc / ko / ea = Boss Slayer / Treasure Collector / Killer Outlaw / Escape Artist. You no longer need to decode them — each board returns its human season, mode, and metric directly.
GET /v2/leaderboards
Flat list of every leaderboard. No pagination. Each row carries id, key, state, season, mode, metric, began_at, ended_at, updated_at, num_entries. Boards not yet labelled return null for season / mode / metric.
began_at / ended_at are the live season window, sourced from the game's season catalog. An active season has a null ended_at. state is a lowercase enum: season, preseason.
GET /v2/leaderboards/{id}
Score-ranked entries for one leaderboard, wrapped alongside the board's leaderboard metadata and page / page_size / total. Each entry carries position, previous_position, character, character_id, class, rank, rank_level, karma, score.