Documentation

1 · Widget embed (no code)

The fastest way. Add one script tag with your license key, then drop widget tags anywhere on the page:

<script src="https://astrosolutions.app/sdk.js" data-key="YOUR_KEY" defer></script>

<div data-astro-widget="horoscope" data-all="true"></div>
<div data-astro-widget="transits" data-days="30"></div>
<div data-astro-widget="natal-form"></div>

2 · REST API (Business & Agency plans)

Call the engine directly and render however you like. Authenticate with the X-Api-Key header; generate keys in your dashboard. Base URL https://astrosolutions.app/v1/public.

Endpoints

GET   /positions?at=ISO            # live planetary positions
GET   /transits?from=&to=&limit=   # global sky events
GET   /horoscope?sign=leo          # today's horoscope for a sign
GET   /cities?q=london             # geocode + timezone
POST  /natal-chart                 # full chart from birth data

Example — natal chart

curl -X POST https://astrosolutions.app/v1/public/natal-chart   -H "X-Api-Key: ask_..." -H "Content-Type: application/json"   -d '{"birthDate":"1990-04-15","birthTime":"14:30",
       "timezone":"Europe/London","latitude":51.5,"longitude":-0.13}'

Response shape

{
  "success": true,
  "data": {
    "positions": [{ "planet":"sun","sign":"Aries","degreeInSign":25.2,... }],
    "angles": { "ascendant": {...}, "midheaven": {...} },
    "houses": { "system":"whole_sign","cusps":[...] },
    "aspects": [...]
  }
}

Errors & limits

Rate limits scale with your plan. A Postman collection is available — ask support.