Gems

Socketable gem items across four families and seven rarities. Each row adds its socket cost and available bonus pool.

Each gem row carries:

  • id — the gem's item id (id.item.ruby_5001).
  • family — gem family slug (ruby, …); the seven rarities of a family share it.
  • name — localized display name (Ruby (Perfect)).
  • rarity — the gem's rarity tier; joins to items.rarity.
  • gear_score (int | null) — gear score, when the codex sets one.
  • icon / icon_url — the asset hash and its ready-to-use CDN URL.
  • cost — gold to socket a gem of this rarity into a piece of gear.
  • bonuses — every attribute this gem family can inscribe, identical across the family's seven rarities. Each entry has property (item-attribute slug, joins to item_attributes.attribute in the Items schema), name (localized), effect_type (tag slug classifying the bonus), value_ratio (relative magnitude hint — the real per-rarity ranges are runtime SetByCaller, not in the cooked data), and enchant_order (tooltip sort).

GET/v2/gems

familyoptional
Gem family
rarityoptional
Gem rarity
localeoptionalglobal
Language used to resolve localized names, descriptions, and labels.
Default
en

All 28 gems, one row per gem item.

GET/v2/gems/{id}

idpath
Gem item id — pick any from the /v2/gems listing
Example
id.item.ruby_5001
localeoptionalglobal
Language used to resolve localized names, descriptions, and labels.
Default
en

One gem, same shape as a list row, returned bare (not enveloped).