Watch the API in action

From a birth date to a chart

One server-side request. A ready-to-display SVG. Watch a real birth-chart response become a chart for your app.

36 seconds · Silent, with on-screen explanations and optional captions. Edited walkthrough of a successful production API request recorded November 20, 2026. Birth details are synthetic; credentials are never shown. Timing is edited, not a latency benchmark.

Reproduce this result

Use January 1, 1990, 12:00 in America/New_York, at latitude 40.7128 and longitude -74.006. The example selects tropical zodiac, equal houses, a dark theme and aspect lines.

With a private scoped key available as COSMICEPHEMERIS_KEY, download the JSON request and run this in a server-side shell. The response is JSON containing the SVG:

curl --fail-with-body --silent --show-error \
  https://api.cosmicephemeris.com/api/astro/natal-svg \
  -H "Content-Type: application/json" \
  -H "x-api-key: $COSMICEPHEMERIS_KEY" \
  --data-binary @birth-chart-demo-request.json \
  --output chart-response.json

The Node.js tutorial walks through account and key setup, generates the chart and saves chart.svg as a file. The required scope is astro:natal-svg. Each admitted call uses one standard unit; the Free plan includes 500 per UTC calendar month.

Download the exact SVG shown in the video · Download the complete Node.js example

Video transcript

  1. 0:00–0:05 — One request, one chart. Cosmic Ephemeris turns birth details into a natal-chart SVG.
  2. 0:05–0:12 — Set the input. Use the synthetic New York birth details, tropical zodiac and equal houses.
  3. 0:12–0:20 — Send the request. POST the JSON to /api/astro/natal-svg. The scoped API key stays in the server environment.
  4. 0:20–0:25 — Read the response. The recorded request returned HTTP 200 and JSON containing the SVG. Save the svg field as birth-chart.svg.
  5. 0:25–0:31 — Display the result. Open the generated SVG to see the chart wheel, house divisions and aspect lines.
  6. 0:31–0:36 — Build your own. Follow the birth-chart tutorial at cosmicephemeris.com/guides/birth-chart-svg-nodejs.html.

Compare Cosmic Ephemeris with Prokerala · Build a Moon-phase calendar next