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!

Spells

Catalog of class spells. Each spell inlines the abilities it grants (each with its resolved gameplay effects) and its costs, plus an icon_url pointing at the asset endpoint. The description is rendered in the requested locale with placeholder values substituted and styling markup stripped.

Each spell row also carries:

tier (int | null) — the spell's knowledge tier (1–5). Equals the memory cost; null for Sorcerer cooldown spells that have no tier.
cost_type — slug describing how the spell is paid for: count (memory slots consumed), cooldown, cooldown_end, etc.
casting_time — cast duration in seconds.
cooldown — recovery duration in seconds.
source_type — element slug (arcane, fire, ice, …) indicating the spell's damage school.
range — effective range in cm (as shipped by the codex).

GET /v2/spells

&locale = Resolve Text_* keys to translated strings (names, flavor, enum labels)

Default: en

&sort = `field:order` or `asc|desc` (default field per endpoint)

&cursor = Opaque cursor from the previous response's `pagination.next`; omit for the first page.

&limit = Pagination

Options: 1 - 200

Default: 50

GET/v2/spells

GET /v2/spells/{id}

&id = Pick any spell id from the list

Accepts either the canonical envelope (id.spell.aqua_prison) or the raw upstream key (Id_Spell_AquaPrison).

GET/v2/spells/{id}

id (path)

GET /v2/spells/{id}/icon

&id = Pick any spell id from the list

&size = Icon transforms — resize to N (square) or WxH. 1–512 per axis.

Example: 64 or 64x96

&dpr = Icon transforms — pixel-density multiplier (1, 2, or 3). Combine with size for retina renders.

&format = Icon transforms — re-encode. Omit to keep the source format.

&trim = Icon transforms — auto-strip transparent margin (1% fuzz).

&bg = Icon transforms — background fill (#RRGGBB, #RRGGBBAA, or transparent).

Example: #000000 or transparent

GET/v2/spells/{id}/icon

id (path)