Track · illustrate

Illustrate track

Vector primitives: zodiac / planet / aspect glyphs, UI icons, country flags, ornaments, data-viz, chart wheels. One endpoint, dispatched on type.

Endpoints

Route	Auth	Notes
`GET /api/v1/illustrate`	public	Every type.
`POST /api/v1/illustrate?type=chart-wheel`	public	Full natal chart (body exceeds URL length).

Types

/api/v1/illustrate?type=<type>&slug=<id>

`type`	Slug examples	Purpose
`zodiac`	`aries`, `taurus`, … (12)	Zodiac glyphs at 24×24.
`planet`	`sun`, `moon`, `mercury`, …, `chiron` (14)	Planet + point glyphs.
`aspect`	`conjunction`, `opposition`, `trine`, `square`, `sextile`	Aspect glyphs.
`icon`	36 UI slugs (waffle, gear, sign-out, sparkle, …)	Utility icons.
`flag`	30 countries via `country=<CC>` + `style=monoline\	full`	Country flags. 24×16 viewBox.
`ornament`	`compass-rose`, `brass-divider`, `corner-mark`, `starfield`, `moon-phase`, `chart-ring`, `blob`, `ppp-banner`	Decorative primitives.
`pattern`	Aspect-pattern names (grand-trine, t-square, yod, …)	3–4 planet aspect compositions.
`scene`	`pulse`, `orbit-loader`, `wave`, `constellation`, `moon-cycle`, `wordmark-draw`, `gradient-mesh`, `particles`	Animated primitives via SMIL.
`viz`	`sparkline`, `progress-arc`, `donut`, `bar`, `heatmap`, `diverging-bar`	Data-driven charts from `values=`.
`composition`	`blob-cluster`, `silhouette`	Multi-blob organic shapes.
`chart-wheel`	—	GET for empty preview, POST for full chart.

Common params

size — clamped per type (default 48).
color — #hex / rgb() / hsl() / named. Default brass #d4a550.
stroke — line thickness [0.5, 4], default 1.2.

Per-type extras live on the OpenAPI reference. Highlights:

Flags

<img src="https://urja.insightsbyomkar.com/api/v1/illustrate?type=flag&country=IN&style=full&size=32" alt="India flag" />

30 supported countries covering every billing-market tier Insights by Omkar offers. style=monoline uses the caller's color; style=full renders brand-accurate fills with simplified iconography (24px-legible reductions of seals + complex star counts).

<img src="https://urja.insightsbyomkar.com/api/v1/illustrate?type=ornament&slug=ppp-banner&accent=brass" width="800" height="80" alt="" />

accent is a palette-key alias: brass / midnight / ink / parchment / muted / rose. Optional tintColor adds a faint centre wash for PPP / region-pricing banners.

Data viz

<img src="https://urja.insightsbyomkar.com/api/v1/illustrate?type=viz&slug=sparkline&values=1,2,3,5,8,13&width=240&height=60" alt="" />

values is a comma-separated number list (max 200). progress-arc uses percent=0..100 instead.

Chart wheel (POST)

Natal chart data exceeds URL length. POST the body:

curl -X POST "https://urja.insightsbyomkar.com/api/v1/illustrate?type=chart-wheel&size=600" \
  -H "content-type: application/json" \
  -d '{
    "houses": [...12 cusps in degrees...],
    "planets": [{"body":"sun","longitude":175.3}, ...],
    "aspects": [{"from":"sun","to":"moon","aspect":"trine"}]
  }'

Response contract

image/svg+xml; 1-day browser / 7-day CDN cache; public (no scope).