release: v1.2.59

Author: github-actions[bot]

AGENTS.md

@@ -43,7 +43,7 @@ Type `roxy.` to see all available namespaces. Type `roxy.{domain}.` to see every
 |-----------|----------------|
 | `roxy.astrology` | Western astrology API for natal birth charts, daily, weekly, and monthly horoscopes with unique content per sign, syn... |
 | `roxy.vedicAstrology` | Vedic astrology (Jyotish) and KP API for kundli generation with 15 divisional charts (D1-D60), Ashtakoot Gun Milan ku... |
-| `roxy.forecast` | Merge upcoming transit aspects, sign ingresses, retrograde stations, new and full moons, biorhythm critical days, and... |
+| `roxy.forecast` | Forecast API that merges upcoming transit aspects, sign ingresses, retrograde stations, new and full moons, biorhythm... |
 | `roxy.humanDesign` | Generate the full Human Design bodygraph from a birth moment: type, strategy, inner authority, profile, definition, i... |
 | `roxy.numerology` | Numerology API to calculate life path, expression, soul urge, personality, and maturity numbers, with Pinnacle and Ch... |
 | `roxy.tarot` | Tarot reading API with the complete 78-card Rider-Waite-Smith deck and card meanings for love, career, health, and sp... |
@@ -52,7 +52,7 @@ Type `roxy.` to see all available namespaces. Type `roxy.{domain}.` to see every
 | `roxy.crystals` | Crystal healing API covering the most popular and widely-searched healing crystals and gemstones, from Amethyst and R... |
 | `roxy.dreams` | Dream interpretation API with a 2,000+ symbol dream dictionary and psychological meanings covering animals, objects,... |
 | `roxy.angelNumbers` | Angel numbers API with meanings for 111, 222, 333, 444, 555, 666, 777, 888, 999, 1111, and 75+ sequences covering eve... |
-| `roxy.location` | City search and geocoding API with 23,000+ cities across 240+ countries, returning latitude, longitude, IANA timezone... |
+| `roxy.location` | Location and timezone API with city search and geocoding across 23,000+ cities in 240+ countries, returning latitude,... |
 | `roxy.usage` | Monitor your API usage, check rate limits, and track request consumption |
 | `roxy.languages` | List the response languages accepted by the `lang` query parameter on every i18n-aware endpoint |
 <!-- END:DOMAINS -->

README.md

@@ -87,7 +87,7 @@ const { latitude, longitude, timezone } = data.cities[0];
 |-----------|----------------|
 | `roxy.astrology` | Western astrology API for natal birth charts, daily, weekly, and monthly horoscopes with unique content per sign, syn... |
 | `roxy.vedicAstrology` | Vedic astrology (Jyotish) and KP API for kundli generation with 15 divisional charts (D1-D60), Ashtakoot Gun Milan ku... |
-| `roxy.forecast` | Merge upcoming transit aspects, sign ingresses, retrograde stations, new and full moons, biorhythm critical days, and... |
+| `roxy.forecast` | Forecast API that merges upcoming transit aspects, sign ingresses, retrograde stations, new and full moons, biorhythm... |
 | `roxy.humanDesign` | Generate the full Human Design bodygraph from a birth moment: type, strategy, inner authority, profile, definition, i... |
 | `roxy.numerology` | Numerology API to calculate life path, expression, soul urge, personality, and maturity numbers, with Pinnacle and Ch... |
 | `roxy.tarot` | Tarot reading API with the complete 78-card Rider-Waite-Smith deck and card meanings for love, career, health, and sp... |
@@ -96,7 +96,7 @@ const { latitude, longitude, timezone } = data.cities[0];
 | `roxy.crystals` | Crystal healing API covering the most popular and widely-searched healing crystals and gemstones, from Amethyst and R... |
 | `roxy.dreams` | Dream interpretation API with a 2,000+ symbol dream dictionary and psychological meanings covering animals, objects,... |
 | `roxy.angelNumbers` | Angel numbers API with meanings for 111, 222, 333, 444, 555, 666, 777, 888, 999, 1111, and 75+ sequences covering eve... |
-| `roxy.location` | City search and geocoding API with 23,000+ cities across 240+ countries, returning latitude, longitude, IANA timezone... |
+| `roxy.location` | Location and timezone API with city search and geocoding across 23,000+ cities in 240+ countries, returning latitude,... |
 | `roxy.usage` | Monitor your API usage, check rate limits, and track request consumption |
 | `roxy.languages` | List the response languages accepted by the `lang` query parameter on every i18n-aware endpoint |
 <!-- END:DOMAINS -->

docs/llms-full.txt

@@ -158,6 +158,7 @@ const { data } = await roxy.astrology.calculateTransitAspects({
     planets: ['Jupiter', 'Saturn', 'Pluto'],
     aspectTypes: ['CONJUNCTION', 'OPPOSITION', 'TRINE', 'SQUARE'],
     minStrength: 50,
+    houseSystem: 'placidus',
   },
 });
 
@@ -1020,7 +1021,7 @@ const { data } = await roxy.vedicAstrology.getHeliacalVisibility({
 
 ## Forecast — `roxy.forecast`
 
-Merge upcoming transit aspects, sign ingresses, retrograde stations, new and full moons, biorhythm critical days, and...
+Forecast API that merges upcoming transit aspects, sign ingresses, retrograde stations, new and full moons, biorhythm...
 
 ```typescript
 // Cross-domain forecast timeline - Transits, ingresses, stations, dasha changes, critical days
@@ -1667,7 +1668,7 @@ const { data } = await roxy.angelNumbers.getDailyAngelNumber({ body: { seed: 'us
 
 ## Location and Timezone — `roxy.location`
 
-City search and geocoding API with 23,000+ cities across 240+ countries, returning latitude, longitude, IANA timezone...
+Location and timezone API with city search and geocoding across 23,000+ cities in 240+ countries, returning latitude,...
 
 ```typescript
 // Search cities worldwide - Geocoding autocomplete with coordinates and timezone

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@roxyapi/sdk",
-	"version": "1.2.58",
+	"version": "1.2.59",
 	"description": "TypeScript SDK for Roxy — the multi-domain spiritual intelligence API",
 	"type": "module",
 	"exports": {

specs/openapi.json

@@ -39,7 +39,7 @@
     },
     {
       "name": "Forecast",
-      "description": "Merge upcoming transit aspects, sign ingresses, retrograde stations, new and full moons, biorhythm critical days, and Vimshottari dasha changes into one time-ordered forecast for a single subject. The only cross-domain forecast timeline behind one key, positions verified against NASA JPL Horizons, available over Remote MCP with typed SDKs. Horizon capped at 90 days."
+      "description": "Forecast API that merges upcoming transit aspects, sign ingresses, retrograde stations, new and full moons, biorhythm critical days, and Vimshottari dasha changes into one time-ordered forecast for a single subject. The only cross-domain forecast timeline behind one key, positions verified against NASA JPL Horizons, available over Remote MCP with typed SDKs. Horizon capped at 90 days."
     },
     {
       "name": "Human Design",
@@ -75,7 +75,7 @@
     },
     {
       "name": "Location and Timezone",
-      "description": "City search and geocoding API with 23,000+ cities across 240+ countries, returning latitude, longitude, IANA timezone, and DST-aware UTC offset. The location layer for birth chart forms, horoscope apps, event planners, and any feature that needs place-to-coordinates resolution. Fully offline dataset with no third party geocoding call, and fields that map directly to the astrology endpoints. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs."
+      "description": "Location and timezone API with city search and geocoding across 23,000+ cities in 240+ countries, returning latitude, longitude, IANA timezone, and DST-aware UTC offset. The location layer for birth chart forms, horoscope apps, event planners, and any feature that needs place-to-coordinates resolution. Fully offline dataset with no third party geocoding call, and fields that map directly to the astrology endpoints. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs."
     },
     {
       "name": "Usage",
@@ -19601,6 +19601,18 @@
                     "maximum": 100,
                     "example": 50,
                     "description": "Minimum aspect strength threshold (0-100). Higher values return only tighter, more potent aspects. Useful for filtering out wide-orb aspects."
+                  },
+                  "houseSystem": {
+                    "type": "string",
+                    "enum": [
+                      "placidus",
+                      "whole-sign",
+                      "equal",
+                      "koch"
+                    ],
+                    "default": "placidus",
+                    "example": "placidus",
+                    "description": "House system used to divide the natal chart into 12 houses. Every house number in the response is read against these natal cusps, for the natal bodies and the transiting bodies alike. Placidus (default) is time sensitive and the most widely used in Western astrology. Whole Sign assigns one sign per house. Equal divides into 30 degree segments from the Ascendant. Koch emphasizes higher latitudes. Quadrant systems fall back to Whole Sign above the polar circle."
                   }
                 },
                 "required": [
@@ -19623,6 +19635,17 @@
                       "example": "2026-02-03 12:00:00",
                       "description": "Date and time of the transit calculation."
                     },
+                    "houseSystem": {
+                      "type": "string",
+                      "enum": [
+                        "placidus",
+                        "whole-sign",
+                        "equal",
+                        "koch"
+                      ],
+                      "example": "placidus",
+                      "description": "House system actually used for the natal cusps behind every house number in this response. Differs from the requested system only above the polar circle, where quadrant systems fall back to Whole Sign."
+                    },
                     "transitPlanets": {
                       "type": "array",
                       "items": {
@@ -19677,8 +19700,8 @@
                             "type": "integer",
                             "minimum": 1,
                             "maximum": 12,
-                            "example": 7,
-                            "description": "House placement (1-12). Determined by the selected house system and birth location."
+                            "example": 10,
+                            "description": "Natal house (1-12) this transiting body is currently passing through, read against the natal house cusps. This is the life area the transit activates, so it is driven by the natal birth time and location rather than by the transit moment."
                           },
                           "speed": {
                             "type": "number",
@@ -19702,7 +19725,7 @@
                           "isRetrograde"
                         ]
                       },
-                      "description": "Current transiting positions in the tropical zodiac. All 14 celestial bodies: the 10 classical planets (Sun through Pluto), the lunar nodes, Chiron, and Black Moon Lilith."
+                      "description": "Current transiting positions in the tropical zodiac, each placed in the natal house it is passing through. All 14 celestial bodies: the 10 classical planets (Sun through Pluto), the lunar nodes, Chiron, and Black Moon Lilith."
                     },
                     "natalPlanets": {
                       "type": "array",
@@ -19783,7 +19806,7 @@
                           "isRetrograde"
                         ]
                       },
-                      "description": "Natal (birth chart) planetary positions used as the baseline for transit aspect comparison."
+                      "description": "Natal (birth chart) planetary positions used as the baseline for transit aspect comparison, each placed in its natal house."
                     },
                     "aspects": {
                       "type": "array",
@@ -20102,6 +20125,7 @@
                   },
                   "required": [
                     "transitDate",
+                    "houseSystem",
                     "transitPlanets",
                     "natalPlanets",
                     "aspects",

src/types.gen.ts

@@ -9849,6 +9849,10 @@ export type PostAstrologyTransitAspectsData = {
          * Minimum aspect strength threshold (0-100). Higher values return only tighter, more potent aspects. Useful for filtering out wide-orb aspects.
          */
         minStrength?: number;
+        /**
+         * House system used to divide the natal chart into 12 houses. Every house number in the response is read against these natal cusps, for the natal bodies and the transiting bodies alike. Placidus (default) is time sensitive and the most widely used in Western astrology. Whole Sign assigns one sign per house. Equal divides into 30 degree segments from the Ascendant. Koch emphasizes higher latitudes. Quadrant systems fall back to Whole Sign above the polar circle.
+         */
+        houseSystem?: 'placidus' | 'whole-sign' | 'equal' | 'koch';
     };
     path?: never;
     query?: {
@@ -9974,7 +9978,11 @@ export type PostAstrologyTransitAspectsResponses = {
          */
         transitDate: string;
         /**
-         * Current transiting positions in the tropical zodiac. All 14 celestial bodies: the 10 classical planets (Sun through Pluto), the lunar nodes, Chiron, and Black Moon Lilith.
+         * House system actually used for the natal cusps behind every house number in this response. Differs from the requested system only above the polar circle, where quadrant systems fall back to Whole Sign.
+         */
+        houseSystem: 'placidus' | 'whole-sign' | 'equal' | 'koch';
+        /**
+         * Current transiting positions in the tropical zodiac, each placed in the natal house it is passing through. All 14 celestial bodies: the 10 classical planets (Sun through Pluto), the lunar nodes, Chiron, and Black Moon Lilith.
          */
         transitPlanets: Array<{
             /**
@@ -9998,7 +10006,7 @@ export type PostAstrologyTransitAspectsResponses = {
              */
             degree: number;
             /**
-             * House placement (1-12). Determined by the selected house system and birth location.
+             * Natal house (1-12) this transiting body is currently passing through, read against the natal house cusps. This is the life area the transit activates, so it is driven by the natal birth time and location rather than by the transit moment.
              */
             house: number;
             /**
@@ -10011,7 +10019,7 @@ export type PostAstrologyTransitAspectsResponses = {
             isRetrograde: boolean;
         }>;
         /**
-         * Natal (birth chart) planetary positions used as the baseline for transit aspect comparison.
+         * Natal (birth chart) planetary positions used as the baseline for transit aspect comparison, each placed in its natal house.
          */
         natalPlanets: Array<{
             /**

src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.2.58';
+export const VERSION = '1.2.59';