Transit API'si

İstek

Örnek harita için bir aylık gerçek bir istek:

curl -X POST https://api.natalchart.ai/v1/transits \
  -H "Authorization: Bearer $NATALCHART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234},"from":"2026-09-18","to":"2026-10-18"}'

Yanıt

Bu isteğe verilen yanıtın bir bölümü: ana alanlar; her liste ilk üç öğesine kısaltılmıştır.

{
  "window": {
    "from": "2026-09-18",
    "to": "2026-10-18"
  },
  "events": [
    {
      "kind": "aspect",
      "at": "2026-09-19T10:10:33.151Z",
      "date": "2026-09-19",
      "position": "14°06′ Libra",
      "house": 8,
      "body": "Mercury",
      "target": "Neptune",
      "aspect": "Square",
      "exactness": 0,
      "targetPosition": "14°06′ Capricorn",
      "targetHouse": 11,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "at": "2026-09-22T09:53:49.800Z",
      "date": "2026-09-22",
      "position": "18°00′ Leo",
      "house": 7,
      "body": "Jupiter",
      "target": "Pluto",
      "aspect": "Square",
      "exactness": 0,
      "targetPosition": "18°00′ Scorpio",
      "targetHouse": 8,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "at": "2026-09-23T20:47:58.234Z",
      "date": "2026-09-23",
      "position": "0°51′ Libra",
      "house": 7,
      "body": "Sun",
      "target": "Saturn",
      "aspect": "Trine",
      "exactness": 0,
      "targetPosition": "0°51′ Aquarius",
      "targetHouse": 12,
      "significance": "low"
    }
  ]
}

Yanıtta neler var

• window: istediğiniz tarihler.
• events: tarih sırasıyla en fazla 60 olay (transit gök cisimlerinin natal gök cisimlerine yaptığı tam açılar, burca girişler ve durağanlıklar); her biri UTC cinsinden anı, konumu ve ilgili evlerle birlikte. Aralıkta daha fazlası varsa en önemlileri tutulur.
• activeOnFirstDay: ilk gün zaten orb içinde olan transitler, kullanılan orblarla birlikte.
• Her olay, ilgili gök cisimlerine göre belirlenen bir önem derecesi (high, medium ya da low) taşır.

Limitler

• Yalnızca API Pro'da; istek başına en fazla 92 gün ve 60 olay. Ücretsiz anahtarla uç nokta 403 koduyla ve bir yükseltme bağlantısıyla yanıt verir.
• 1800 ile 2399 arasındaki doğumlar. Bir transitin evleri için doğum saati gerekir; saat yoksa evler dışarıda bırakılır.
• Her tam an Swiss Ephemeris ile aranır ve UTC cinsinden verilir.
• Doğum verileri okunur, kullanılır ve unutulur: istek gövdeleri asla saklanmaz.

Yapay zekâ asistanlarında

https://www.natalchart.ai/mcp adresindeki MCP sunucusu üzerinden asistanlar bir dönem için transits aracını, tek bir gün için daily_transits aracını çağırır ve transitleri tahmin etmek yerine gerçek transitleri okur.

API'nin geri kalanı

Aynı anahtar astroloji API'sinin tamamını açar: doğum haritaları, günlük transitler, sinastri, bir dönemin transitleri, Güneş dönüşleri, en iyi günler ve astrokartografi. Tüm uç noktalar, alanlar ve hatalar belgelerde yer alır; neyin istek sayıldığını ise fiyatlar sayfası açıklar.

Sorular