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!
Data Retention
How long each kind of data stays queryable. Game data (items, monsters, spells, …) is a snapshot of the current patch and has no retention window: it is replaced wholesale when a new patch is imported. The live feeds below are time-series. Some are kept forever, some roll off.
| Data | Endpoint | Retention |
|---|---|---|
| Trade chat | /v2/trades/chat | 14 days |
| Market listings | /v2/market | 30 days |
| Price history | /v2/market/analytics/… | 30 days |
| Population | /v2/population/history | Indefinite |
| Server status | /v2/status/history | 90 days |
| Leaderboards | /v2/leaderboard | Indefinite |
| Patches & notes | /v2/patches | Indefinite |
Trade chat
/v2/trades/chat serves a rolling 14 day window. Messages older than that are deleted permanently. There is no archive, so mirror the feed on your side if you need longer history.
Market
Listings on /v2/market are kept for 30 days. A listing's lifecycle fields (has_sold, has_expired, sold_at) are resolved shortly after it leaves the in-game marketplace; listings live at most 7 days in game. The pre-computed price history behind /v2/market/analytics/{item_id}/prices/history rolls off on the same 30 day window, so price charts cover at most the last month.
Population
Raw population samples are kept indefinitely. /v2/population/history answers coarse intervals (1h, 1d, 1w, 2w, 4w) from pre-computed aggregates and everything else straight from the raw samples, so any interval can reach the full history.
Server status
/v2/status/history serves per-component daily uptime buckets for the last 90 days. Older status samples are purged.
Permanent archives
Leaderboards (/v2/leaderboard) keep every season's final standings. Patches and patch notes (/v2/patches) are a permanent catalog. Neither is ever pruned.