Quick Start

Five minutes from signup to a full natal chart in JSON.

// quickstart

Get your API key in 60 seconds

10,000 credits/month free forever. No credit card required.

1. 01
   Sign up

   Email + password. One account for all AstroWay products.
2. 02
   Create a key

   In dashboard click "Create key". Pick aw_live_ or aw_test_ (sandbox).
3. 03
   Make a request

   POST /v1/chart with X-Api-Key header. Full natal chart in JSON.

Sign up for free→Read quickstart

1. Sign up at astroway.info

   AstroWay API uses a shared account with the rest of the ecosystem. The free plan gives you 10,000 credits/month with no credit card.

2. Create a key in the dashboard

   Every key starts with aw_live_ (production) or aw_test_ (sandbox, doesn’t consume credits). Copy the key immediately - it’s shown in plain text only once.

   Caution

   The key is a secret. Never commit it to git, never put it in frontend code, never send via messengers. For frontend, use an intermediate backend or short-lived session tokens (Phase 3).

3. Make your first request

   cURL

   first-request.sh

   curl -X POST https://api.astroway.info/v1/chart \
     -H "X-Api-Key: aw_live_your_key_here" \
     -H "Content-Type: application/json" \
     -d '{
       "date": "1990-07-14",
       "time": "14:30:00",
       "timezoneOffset": 3,
       "latitude": 50.4501,
       "longitude": 30.5234,
       "houseSystem": "P"
     }'

   Node.js

   first-request.ts

   // native fetch - Node 18+ / Bun / Deno / browser. With the SDK: npm install @astroway/sdk
   const r = await fetch('https://api.astroway.info/v1/chart', {
     method: 'POST',
     headers: {
       'X-Api-Key': process.env.ASTROWAY_API_KEY!,
       'Content-Type': 'application/json',
     },
     body: JSON.stringify({
       date: '1990-07-14',
       time: '14:30:00',
       timezoneOffset: 3,
       latitude: 50.4501,
       longitude: 30.5234,
       houseSystem: 'P',
     }),
   });
   
   const { data: chart } = await r.json();
   console.log(chart.planets[0]);

   Python

   first_request.py

   # requests or httpx. With the SDK: pip install astroway
   import os, requests
   
   r = requests.post(
       'https://api.astroway.info/v1/chart',
       headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
       json={
           'date': '1990-07-14',
           'time': '14:30:00',
           'timezoneOffset': 3,
           'latitude': 50.4501,
           'longitude': 30.5234,
           'houseSystem': 'P',
       },
   )
   chart = r.json()['data']
   print(chart['planets'][0])

   PHP

   first-request.php

   <?php
   use GuzzleHttp\Client;
   
   $client = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
   
   $response = $client->post('chart', [
       'headers' => [
           'X-Api-Key'    => getenv('ASTROWAY_API_KEY'),
           'Content-Type' => 'application/json',
       ],
       'json' => [
           'date' => '1990-07-14',
           'time' => '14:30:00',
           'timezoneOffset' => 3,
           'latitude' => 50.4501,
           'longitude' => 30.5234,
           'houseSystem' => 'P',
       ],
   ]);
   
   $chart = json_decode((string) $response->getBody(), true)['data'];
   print_r($chart['planets'][0]);

   timezoneOffset is the offset the clocks kept on that date, in hours. If you do not know it, send "timezone": "Europe/Kyiv" instead, or "timezone": "auto" to take it from the coordinates, and the server works it out, summer time included: field formats.

4. Read the response

   Response - full JSON with planet positions, house cusps, aspects, and metadata. Abbreviated example:

   {
     "ok": true,
     "data": {
       "julianDay": 2448493.0625,
       "planets": [
         { "id": 0, "name": "Sun", "longitude": 150.894819, "latitude": 0.00019, "isRetrograde": false, "declination": 11.15726 },
         { "id": 1, "name": "Moon", "longitude": 321.634655, "latitude": 2.834053, "isRetrograde": false, "declination": -11.609723 }
       ],
       "houses": {
         "system": "P",
         "cusps": [264.384681, 306.997683, 353.867426],
         "ascendant": 264.384681,
         "mc": 207.315669
       },
       "aspects": [
         {
           "planet1": "Sun",
           "planet2": "Moon",
           "type": { "name": "Opposition", "angle": 180, "isMajor": true },
           "exactAngle": 170.739837,
           "orb": 9.260163,
           "isApplying": true
         }
       ],
       "chartSect": "diurnal",
       "meta": { "engineVersion": "2.10.03", "calculatedAt": "2026-08-22T20:53:31.431Z" }
     }
   }

   Response headers:

   X-Credits-Used: 20
   X-Credits-Remaining: 9980
   X-Credits-Limit: 10000
   X-Credits-Reset: 2026-09-01T00:00:00.000Z
   X-RateLimit-Limit: 10
   X-RateLimit-Remaining: 9
   X-RateLimit-Reset: 1787432304
   X-Request-Id: 8aec43e9bc749b37e998a489bbad1757

5. Check your balance

   Dashboard shows real-time usage: api.astroway.info/dashboard. Or via API:

   curl https://api.astroway.info/v1/keys/usage \
     -H "X-Api-Key: aw_live_your_key_here"

Next

• Authentication: best practices, key rotation, sandbox mode
• Credits & Rate Limits: pricing table, rate limiting, overage
• Example: Natal chart: detailed /v1/chart walkthrough
• Runnable integrations on GitHub - Discord/Slack bots, OpenAI tools, Cloudflare, FastAPI on the official SDKs
• Full API reference: all 760 endpoints with playground