Tints/shades/tones ramp API

Builds tint (toward white), shade (toward black), and tone (toward gray) ramps plus a perceptually-even OKLCH monochromatic scale from one base color, N steps each. Answers 'Give me lighter/darker variants of this color.', 'Build a color scale for a design system.'

Price$0.04per request

MethodPOST

Route/v1/design/color-ramp

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

colorpalettetintsshadestonesmonochromaticrampscaleoklchdesign

API URLhttps://x402.hexl.dev/v1/design/color-ramp

Integration docs

Example request

{
  "color": "#1d4ed8",
  "steps": 5
}

Example response

{
  "base": "#1d4ed8",
  "steps": 5,
  "tints": [
    "#1d4ed8",
    "#567ae2",
    "#8ea7ec",
    "#c7d3f5",
    "#ffffff"
  ],
  "shades": [
    "#1d4ed8",
    "#163ba2",
    "#0f276c",
    "#071436",
    "#000000"
  ],
  "tones": [
    "#1d4ed8",
    "#365bc2",
    "#4f67ac",
    "#677496",
    "#808080"
  ],
  "monochromatic": [
    "#160056",
    "#030098",
    "#2052dc",
    "#5894ff",
    "#94d7ff"
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "color"
  ],
  "properties": {
    "color": {
      "type": "string",
      "examples": [
        "#1d4ed8"
      ]
    },
    "steps": {
      "type": "number",
      "examples": [
        5
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}