AstroWay/api v2.201.6 · id
semua sistem normal
// astrology api · POST /v1/symbolic-directions

API Arah Gerak Matahari

Arah gerak matahari memindahkan seluruh carta maju satu angka: jarak yang ditempuh Matahari oleh progresi sekunder. Setiap planet, setiap kuspis dan kedua sudut bergeser dengan busur yang sama, sehingga aspek natal yang dua derajat dari tepat menjadi tepat sekitar dua tahun kemudian. Endpoint ini mengembalikan carta yang diarahkan dan busur yang menghasilkannya.

Endpoint
POST /v1/symbolic-directions
Cost
50 credits
Latency
~50 ms
Tier
Tier 3
// 01 / What it computes

API Arah Gerak Matahari

Dari data kelahiran dan tanggal target, endpoint pertama-tama memprogresikan carta hari-per-tahun, mengukur seberapa jauh Matahari yang telah bergerak dari posisi natalnya, dan mengambil jarak itu sebagai busur. Kemudian ia menambahkan busur ke setiap bujur natal sekaligus: semua planet, semua kuspis rumah, ascendant dan MC. Respon membawa posisi yang diarahkan di bawah data.planets dan data.houses, busur itu sendiri dalam derajat di bawah data.arc, dan kunci yang menghasilkannya di bawah data.key. Karena satu busur diterapkan secara seragam, geometri carta natal dipertahankan dan hanya hubungannya dengan derajat natal yang berubah, yang membuat teknik ini sangat ekonomis untuk dibaca: satu angka memberi tahu Anda keadaan seluruh carta pada usia tertentu. Dua kunci lain tersedia di endpoint yang sama. Atur kunci ke naibod untuk laju rata-rata matahari 59'08.3" per tahun, atau abaikan untuk satu derajat per tahun biasa. Mengirim converse true mengarahkan mundur dari momen kelahiran bukan maju, membalik tanda busur.

// 02 / Live request

POST/v1/symbolic-directions

curl -X POST https://api.astroway.info/v1/symbolic-directions \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52,
  "targetDate": "2026-05-15",
  "key": "solar_arc"
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "arc": 34.5083,
    "key": "solar_arc",
    "planets": [
      {
        "id": 0,
        "name": "Sun",
        "longitude": 88.8843,
        "isRetrograde": false
      }
    ],
    "houses": {
      "system": "P",
      "ascendant": 204.4763,
      "mc": 111.5826
    }
  }
}
// 03 / Parameters

Parameters

nametypeRequired
date string (YYYY-MM-DD) yes Birth date.
time string (HH:MM:SS) yes Local clock time at birth.
timezoneOffset number (hours) yes UTC offset in effect at the birth moment. Decimal allowed for half-hour zones.
latitude number yes Birth-place latitude, decimal degrees (north positive).
longitude number yes Birth-place longitude, decimal degrees (east positive).
targetDate string (YYYY-MM-DD) yes The date the chart is directed to.
key string no Directional key: solar_arc (the arc of the progressed Sun), naibod (59'08.3" per year), or one_degree (the default, 1° per year).
converse boolean no Direct backwards from the birth moment instead of forwards. Reverses the sign of the arc.
// 04 / When to use it

When to use it

Gunakan arah gerak matahari ketika Anda memerlukan timing yang simbolis daripada astronomis, dan ketika Anda menginginkannya dalam bentuk yang pembaca bisa ikuti. Karena semua bergerak pada satu laju, kontak yang diarahkan mendarat pada tahun tertentu bukan jendela waktu, yang cocok untuk fitur garis waktu hidup, laporan tonggak usia, atau narasi AI yang harus menjelaskan apa tentang tahun tertentu. Ini berpasangan secara alami dengan progresi sekunder, karena busur berasal dari Matahari yang sama yang diprogresikan: progresi memberi Anda carta dalam bergerak, arah gerak matahari memberi Anda seluruh carta yang diterjemahkan maju. Bandingkan ketiga kunci ketika presisi penting bagi audiens Anda. Arah gerak matahari mengikuti Matahari sebenarnya dan bervariasi sedikit menurut tanggal kelahiran, Naibod menggunakan laju rata-rata, dan satu derajat per tahun adalah konvensi bilangan bulat. Untuk kelahiran pertengahan Mei, ketiganya menghasilkan sekitar 34.5, 35.5 dan 36.0 derajat selama 36 tahun, cukup dekat untuk setuju pada dekade dan cukup jauh untuk menamai tahun yang berbeda.

// 05 / Notes

Notes

Busur adalah jarak yang ditempuh oleh Matahari yang diprogresikan secara sekunder, hari per tahun, yang merupakan definisi standar; kunci Naibod menggunakan gerakan harian rata-rata Matahari, 59'08.3" per tahun. Untuk arah gerak matahari, carta yang diprogresikan dihitung maju dan arah perjalanan diterapkan sekali, sehingga arah sebaliknya mengembalikan busur yang dinotasikan bukan digandakan. Posisi berasal dari mesin Swiss Ephemeris di zodiak tropis, pada badan dan sistem rumah yang sama dengan endpoint natal.

Try the Arah Gerak Matahari API

Grab a key and make your first call in under a minute.

99.9% SLA · paket berbayar · 30d status →