- Icons, models and images — including inline art in patch notes — now redirect straight to the CDN instead of an API-relative path.
- Nested payloads across market, merchants, item /sources, loot, quests, spawners, maps and modules now carry icon and icon_url, so you can render art without extra lookups.
- New ?is_new=1 filter and patch, patch_name and is_new fields flag entities that debuted in the current build (items, modules, monsters, spells, abilities).
- ?luck=0..500 now works on /v2/items/{id}/sources too, scaling reverse-loot drop rates.
- /v2/items/{id}/sources now includes a containers collection, so reverse drop lookups cover chests, treasure hoards, ore nodes and other containers alongside monster drops.
- List limit now clamps to 50 (was 25).
- Gem bonuses now include enchant_min and enchant_max.
Release Ledger
Changelog
Every change to the DarkerDB API, the GrimVault overlay and the site, release by release. Newest first.
APIv2.0.2
GrimVaultv1.0.13
Websitev2.0.2
- List endpoints now paginate at 25 results with cursor paging — pass the cursor from pagination.next.
- Spawners reshaped (breaking): candidates, placements and a flat modules list carrying each tile's real x / y / z / yaw coordinates.
- Loot rows now carry drop_rate, rarity_grade, map_tier and category.
- Loot endpoints accept ?luck=0..500; the curves are served at /v2/luck.
- Faster market attribute filters with stably-ordered rows.
- Renamed /v2/dungeon_grades to /v2/maps/grades.
- Module ids renamed (breaking): id.dungeon_module.* is now id.module.*.
- The top rarity is spelled legendary everywhere.
- Complete Season 10 spell, skill, perk, monster and item data.
- The full game database is now queryable on /v2 — list and detail endpoints for every entity type at api.darkerdb.com/v2: /v2/items, /v2/monsters, /v2/maps, /v2/modules, /v2/spawners, /v2/containers, /v2/merchants, /v2/quests, /v2/religions, /v2/classes, /v2/skills, /v2/spells, /v2/perks and /v2/emotes.
- Monsters carry loot, abilities and locations, rendered /portrait images, rotatable 3D /model assets, and archetype grouping via ?archetypes=1.
- New /v2/containers endpoints for treasure props, each with an /icon, a 3D /model and its drop table.
- Reworked loot model: drop groups with per-rarity drop rates replace the old flat tables.
- /v2/merchants/{id} inlines buy, craft, sell-back and quest data.
- Minimap images for maps and modules (/v2/maps/{id}/image, /v2/modules/{id}/image) plus per-module spawns.
- New /v2/facets enum dictionaries, replacing /v2/enums.
- Patch catalog: /v2/patches, /v2/patches/{id} and /v2/patches/{id}/changelog for patch-to-patch diffs.
- API keys now carry scopes and an allowed-origins whitelist, with per-scope rate limits.
- /v1 stays live for back-compat; new integrations should target /v2. On api.katforge.com the canonical mount stays /v1/realms/darkerdb/* unchanged.
- Data updated to Patch #96.
- New endpoint: /v1/quests.
- New endpoint: /v1/quests/{id}.
- Added rerolling secondary attribute ranges (gemming) to /v1/items prefixed with "enchanted".
- Added a retention period of 1 month to market data.
- Added a retention period of 2 weeks to trade chat data.
- Changed Foot to Feet in the item data.
- Added item=... and rarity=... as another way to query /v1/price-check.
- Added new item attributes: headshot_damage_bonus, demon_damage_bonus, demon_damage_reduction, undead_damage_reduction to /v1/items.
- Updated items to Patch #85.
- Removed endpoint: /v1/market/analytics/sellers/rankings.
- Removed endpoint: /v1/market/analytics/volume/rankings.
- New endpoint: /v1/price-check.
- Added item filters to /v1/trades/chat.
- Searching for items by name is now case-insensitive and allows partial matches.
- Improved the performance of the pre-defined intervals on /v1/market/analytics/{item_id}/prices/history.
- Updated items to Patch #83.
- Removed endpoint: /v1/ranks.
- Removed endpoint: /v1/ranks/{id}/icon.
- Removed endpoint: /v1/ladders.
- Renamed endpoint: /v1/leaderboards/{ladder}/{mode}/{metric} to /v1/leaderboards/{id}.
- New endpoint: /v1/leaderboards.
- Added usable_by parameter to items.
- Added new rarity type: Artifact.
- Fixed an issue with cursor pagination.
- Removed the next page from cursor pagination when at the end of the list.
- Fixed an issue with the server history endpoint providing duplicate timestamps.
- Updated items to Patch #81.
- New endpoint: /v1/characters.
- New endpoint: /v1/characters/{id}.
- New endpoint: /v1/ranks.
- New endpoint: /v1/ranks/{id}/icon.
- New endpoint: /v1/ladders.
- new endpoint: /v1/leaderboard/{ladder}/{mode}/{metric}.
- Improved performance of /v1/trades/chat.
- You can now search by sellers in the /v1/market endpoint.
- Items posted in trade chat are now translated to english.
- Fixed an issue causing certain items to not properly register as sold causing the price history charts to not work.
- The following fields are now case-insensitive on the items endpoint: archetype, name, rarity, type, armor_type, hand_type, misc_type, slot_type, utility_type.
- Fixed has_sold (and other boolean flags) not working properly.
- Fixed an issue with rubysilver market listings not being properly tracked.
- Significantly improved the performance of /v1/market/analytics/{item_id}/prices/history.
- Removed the has_sold filter from /v1/market/analytics/{item_id}/prices/history. All prices are now based on only sold items.
- Changed 1M interval to 4w. Added 2w interval.
- Update item data to patch #79-1.
- Added pagination for certain endpoints with multiple results.
- Added meta and whoami fields to the response envelope.
- The /v1/market endpoint now sorts in ascending order by default. Pass &order=desc to sort by created_at descending.
- Several changes and improvements to /v1/items including additional search filters.
- Renamed /v1/icons?item_id=... to /v1/items/{id}/icon.
- New endpoint: /v1/items/attributes.
- New endpoint: /v1/items/rarities.
- New endpoint: /v1/items/{id}.
- New endpoint: /v1/market/analytics/{item_id}/prices/history.
- New endpoint: /v1/market/analytics/sellers/rankings.
- New endpoint: /v1/market/analytics/volume/rankings.
- New endpoint: /v1/population/history.
- New endpoint: /v1/trades/chat.
- Added Sorcerer flag (512) to the required_class bitmask for the items API.
- Added adventure points and experience to the items endpoint.
- The marketplace endpoint now supports filtering on primary and secondary rolls.
- Initial release of https://api.darkerdb.com.