Skip to content

Natal Chart as Sound​

POST
/api/sound/natal

A birth chart rendered as sound.

The chart is turned into a score by a deterministic procedure and synthesised server-side.
What comes back is audio, 45 seconds by default, walking the chart once
from the Ascendant.

It is deterministic. The same birth moment always produces the same file, and no model is
involved at any point.

profile picks how it is rendered: kepler (default) or aurora, a warmer version of
the same chart. length is full (default) or short, and skipSilence cuts the
passages where nothing sounds — the piece is then shorter than the length you asked for.

The sound is not a contract: a better mapping changes what this endpoint returns. The
X-Sound-Mapping response header carries the version that produced the bytes.

For a player that highlights the wheel in step with the audio, use /api/sound/natal/timeline,
which answers with a signed audio URL and the marker timeline in one call.

Authorizations​

ApiKeyAuth

API key for authentication. Get your API key from the dashboard.

Type
API Key (header: X-Api-Key)

Request Body​

application/json
JSON
{
  
"dateTime": "string",
  
"location": {
  
  
"longitude": 0,
  
  
"latitude": 0,
  
  
"timezone": "string"
  
},
  
"houseSystem": "placidus",
  
"points": [
  
  
"string"
  
],
  
"length": "full",
  
"duration": 0,
  
"profile": "kepler",
  
"skipSilence": false,
  
"format": "mp3"
}

Responses​

The chart, rendered

audio/mpeg
JSON
[
]

Playground​

Authorization
Body

Samples​

Powered by VitePress OpenAPI

AstroAPI Documentation