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
familyoptionalGem family
rarityoptionalGem rarity
localeoptionalglobalLanguage used to resolve localized names, descriptions, and labels.
All 28 gems, one row per gem item.
GET/v2/gems/{id}
idpathGem item id — pick any from the /v2/gems listing
localeoptionalglobalLanguage used to resolve localized names, descriptions, and labels.
One gem, same shape as a list row, returned bare (not enveloped).