Gems

The socketable gems — four families, each cut at seven rarities, 28 in all. A gem is an item, so its id is an item id (id.item.ruby_5001); these routes add the socketing detail — what it costs to inset a gem of that rarity, and the attribute pool its family can inscribe. Both are served through the standard paginated envelope on the list and a bare object on the single-gem route. Always reflects the current patch.

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).