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
- 0:00–0:05 — One request, one chart. Cosmic Ephemeris turns birth details into a natal-chart SVG.
- 0:05–0:12 — Set the input. Use the synthetic New York birth details, tropical zodiac and equal houses.
- 0:12–0:20 — Send the request. POST the JSON to
/api/astro/natal-svg. The scoped API key stays in the server environment. - 0:20–0:25 — Read the response. The recorded request returned HTTP 200 and JSON containing the SVG. Save the
svgfield asbirth-chart.svg. - 0:25–0:31 — Display the result. Open the generated SVG to see the chart wheel, house divisions and aspect lines.
- 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