Skip to content
Public REST API · No auth · v1
FFXIV dye data, served from the edge.
125 standard dyes, color matching, harmonies on five colour wheels, and localization in 6 languages. No auth required.
Base
https://data.xivdyetools.app/v1GET
/v1/dyes/1{ "success": true, "data": { "stainID": 1, "itemID": 5729, "name": "Snow White", "hex": "#e4dfd0", "category": "Neutral", "acquisition": "Dye Vendor", "cost": 216, "currency": "Gil", "consolidationType": "A", "marketItemID": 52254 }, "meta": { "requestId": "9f2c…", "apiVersion": "v1" }}
Full Dye Database125 standard dyes (schema v2, stainID-keyed). Hex, RGB, HSV, categories, acquisition methods, vendor costs, and Patch 7.5 consolidation groups.
Color MatchingFind the closest FFXIV dye to any hex color using six distance methods — CIEDE2000 (default), Oklab, CIE76, redmean, RGB, and distinguishability %.
No Auth RequiredEvery endpoint is anonymous. Open CORS — callable from any browser, Dalamud plugin, Discord bot, or mobile app.
Edge CachedDeployed globally on Cloudflare Workers. Dye data is cached 1 hour in browsers and 24 hours at the edge.
6 LanguagesDye names available in English, Japanese, German, French, Korean, and Chinese via the locale query parameter.
Consistent EnvelopesEvery /v1 response uses the same { success, data, meta } envelope with typed error codes and per-request UUIDs for easy debugging.
Character EquipmentResolve the gear in a .chara file to real items — one search per file, icons proxied, six languages — and read its dyes as stain IDs.
HarmonyA dye for every slot of ten harmony types, measured on any of five colour wheels — RGB, RYB, Munsell, OKLCH hue, OKLCH lightness — the same selector the Harmony Explorer runs.