@roxyapi/sdk 1.2.58 → 1.2.60

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/src/types.gen.ts CHANGED
@@ -35,9 +35,13 @@ export type NatalChartResponse = {
35
35
  */
36
36
  planets: Array<{
37
37
  /**
38
- * Planet or point name (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, North Node, South Node, Chiron, Black Moon Lilith). The lunar nodes are the mean node; software using the true node may show node positions up to 1.75 degrees different.
38
+ * Planet or point name (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, North Node, South Node, Chiron, Black Moon Lilith). Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use nameLocalized for anything a reader sees. The lunar nodes are the mean node; software using the true node may show node positions up to 1.75 degrees different.
39
39
  */
40
40
  name: string;
41
+ /**
42
+ * Planet or point name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
43
+ */
44
+ nameLocalized?: string;
41
45
  /**
42
46
  * Tropical ecliptic longitude in degrees (0-360).
43
47
  */
@@ -47,9 +51,13 @@ export type NatalChartResponse = {
47
51
  */
48
52
  latitude: number;
49
53
  /**
50
- * Tropical zodiac sign this planet occupies.
54
+ * Tropical zodiac sign this planet occupies. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use signLocalized for anything a reader sees.
51
55
  */
52
56
  sign: string;
57
+ /**
58
+ * Zodiac sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
59
+ */
60
+ signLocalized?: string;
53
61
  /**
54
62
  * Degree within the zodiac sign (0-29.999).
55
63
  */
@@ -97,9 +105,13 @@ export type NatalChartResponse = {
97
105
  */
98
106
  longitude: number;
99
107
  /**
100
- * Zodiac sign on this house cusp.
108
+ * Zodiac sign on this house cusp. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
101
109
  */
102
110
  sign: string;
111
+ /**
112
+ * Zodiac sign name on this cusp in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
113
+ */
114
+ signLocalized?: string;
103
115
  /**
104
116
  * Degree within the zodiac sign (0-29.999).
105
117
  */
@@ -114,17 +126,29 @@ export type NatalChartResponse = {
114
126
  */
115
127
  aspects: Array<{
116
128
  /**
117
- * First planet in the aspect pair.
129
+ * First planet in the aspect pair. Always English, whatever the lang parameter says. Use planet1Localized for anything a reader sees.
118
130
  */
119
131
  planet1: string;
120
132
  /**
121
- * Second planet in the aspect pair.
133
+ * First planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
134
+ */
135
+ planet1Localized?: string;
136
+ /**
137
+ * Second planet in the aspect pair. Always English, whatever the lang parameter says. Use planet2Localized for anything a reader sees.
122
138
  */
123
139
  planet2: string;
124
140
  /**
125
- * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.).
141
+ * Second planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
142
+ */
143
+ planet2Localized?: string;
144
+ /**
145
+ * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.). Always English, whatever the lang parameter says. Use typeLocalized for anything a reader sees.
126
146
  */
127
147
  type: string;
148
+ /**
149
+ * Aspect type name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
150
+ */
151
+ typeLocalized?: string;
128
152
  /**
129
153
  * Exact angle of this aspect type in degrees.
130
154
  */
@@ -227,9 +251,13 @@ export type NatalChartResponse = {
227
251
  */
228
252
  ascendant: {
229
253
  /**
230
- * Zodiac sign on the Ascendant (rising sign).
254
+ * Zodiac sign on the Ascendant (rising sign). Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
231
255
  */
232
256
  sign: string;
257
+ /**
258
+ * Ascendant sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
259
+ */
260
+ signLocalized?: string;
233
261
  /**
234
262
  * Degree within the Ascendant sign (0-29.999).
235
263
  */
@@ -244,9 +272,13 @@ export type NatalChartResponse = {
244
272
  */
245
273
  midheaven: {
246
274
  /**
247
- * Zodiac sign on the Midheaven (MC).
275
+ * Zodiac sign on the Midheaven (MC). Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
248
276
  */
249
277
  sign: string;
278
+ /**
279
+ * Midheaven sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
280
+ */
281
+ signLocalized?: string;
250
282
  /**
251
283
  * Degree within the Midheaven sign (0-29.999).
252
284
  */
@@ -276,6 +308,10 @@ export type NatalChartResponse = {
276
308
  * Chart sect used for the calculation. Day (diurnal) when the Sun is above the horizon, night (nocturnal) when below. Day charts use Ascendant plus Moon minus Sun, night charts use Ascendant plus Sun minus Moon.
277
309
  */
278
310
  sect: 'day' | 'night';
311
+ /**
312
+ * Part of Fortune sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
313
+ */
314
+ signLocalized?: string;
279
315
  };
280
316
  /**
281
317
  * Vertex. The western intersection of the prime vertical with the ecliptic, often read as a point of fated encounters and turning-point relationships. The opposite point is the Anti-Vertex.
@@ -293,23 +329,39 @@ export type NatalChartResponse = {
293
329
  * Absolute ecliptic longitude of the Vertex (0-360).
294
330
  */
295
331
  longitude: number;
332
+ /**
333
+ * Vertex sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
334
+ */
335
+ signLocalized?: string;
296
336
  };
297
337
  /**
298
338
  * Chart summary with dominant element, modality, retrograde planets, and distribution analysis.
299
339
  */
300
340
  summary: {
301
341
  /**
302
- * Most represented element in the chart (Fire, Earth, Air, Water).
342
+ * Most represented element in the chart (Fire, Earth, Air, Water). Always English, whatever the lang parameter says. Use dominantElementLocalized for anything a reader sees.
303
343
  */
304
344
  dominantElement: string;
305
345
  /**
306
- * Most represented modality in the chart (Cardinal, Fixed, Mutable).
346
+ * Element name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
347
+ */
348
+ dominantElementLocalized?: string;
349
+ /**
350
+ * Most represented modality in the chart (Cardinal, Fixed, Mutable). Always English, whatever the lang parameter says. Use dominantModalityLocalized for anything a reader sees.
307
351
  */
308
352
  dominantModality: string;
309
353
  /**
310
- * Planets in retrograde motion at the time of birth.
354
+ * Modality name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
355
+ */
356
+ dominantModalityLocalized?: string;
357
+ /**
358
+ * Planets in retrograde motion at the time of birth. Always English, whatever the lang parameter says. Use retrogradePlanetsLocalized for anything a reader sees.
311
359
  */
312
360
  retrogradePlanets: Array<string>;
361
+ /**
362
+ * The same retrograde bodies in the requested language, for display only. Index aligned with retrogradePlanets, so entry n of one names entry n of the other. Present only when lang is set to a language other than English, since in English it would repeat retrogradePlanets exactly.
363
+ */
364
+ retrogradePlanetsLocalized?: Array<string>;
313
365
  /**
314
366
  * Count of planets in each element. Shows elemental emphasis in the personality.
315
367
  */
@@ -484,17 +536,29 @@ export type AspectsResponse = {
484
536
  */
485
537
  aspects: Array<{
486
538
  /**
487
- * First planet in the aspect pair.
539
+ * First planet in the aspect pair. Always English, whatever the lang parameter says. Use planet1Localized for anything a reader sees.
488
540
  */
489
541
  planet1: string;
490
542
  /**
491
- * Second planet in the aspect pair.
543
+ * First planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
544
+ */
545
+ planet1Localized?: string;
546
+ /**
547
+ * Second planet in the aspect pair. Always English, whatever the lang parameter says. Use planet2Localized for anything a reader sees.
492
548
  */
493
549
  planet2: string;
494
550
  /**
495
- * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.).
551
+ * Second planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
552
+ */
553
+ planet2Localized?: string;
554
+ /**
555
+ * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.). Always English, whatever the lang parameter says. Use typeLocalized for anything a reader sees.
496
556
  */
497
557
  type: string;
558
+ /**
559
+ * Aspect type name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
560
+ */
561
+ typeLocalized?: string;
498
562
  /**
499
563
  * Exact angle defining this aspect type in degrees.
500
564
  */
@@ -761,9 +825,13 @@ export type TransitsResponse = {
761
825
  */
762
826
  transitPlanets: Array<{
763
827
  /**
764
- * Planet name (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, North Node, South Node, Chiron, Black Moon Lilith). The lunar nodes are the mean node; software using the true node may show node positions up to 1.75 degrees different.
828
+ * Planet name (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, North Node, South Node, Chiron, Black Moon Lilith). Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use nameLocalized for anything a reader sees. The lunar nodes are the mean node; software using the true node may show node positions up to 1.75 degrees different.
765
829
  */
766
830
  name: string;
831
+ /**
832
+ * Planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
833
+ */
834
+ nameLocalized?: string;
767
835
  /**
768
836
  * Tropical ecliptic longitude in degrees (0-360). Primary coordinate for sign and aspect calculation.
769
837
  */
@@ -773,9 +841,13 @@ export type TransitsResponse = {
773
841
  */
774
842
  latitude: number;
775
843
  /**
776
- * Tropical zodiac sign the planet currently occupies. Changes when longitude crosses a 30-degree boundary.
844
+ * Tropical zodiac sign the planet currently occupies. Changes when longitude crosses a 30-degree boundary. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
777
845
  */
778
846
  sign: string;
847
+ /**
848
+ * Zodiac sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
849
+ */
850
+ signLocalized?: string;
779
851
  /**
780
852
  * Degree within the current zodiac sign (0-29.999). Indicates how far into the sign the planet has progressed.
781
853
  */
@@ -794,17 +866,29 @@ export type TransitsResponse = {
794
866
  */
795
867
  transitAspects?: Array<{
796
868
  /**
797
- * Transiting planet forming the aspect.
869
+ * Transiting planet forming the aspect. Always English, whatever the lang parameter says. Use transitPlanetLocalized for anything a reader sees.
798
870
  */
799
871
  transitPlanet: string;
800
872
  /**
801
- * Natal planet being aspected.
873
+ * Transiting planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
874
+ */
875
+ transitPlanetLocalized?: string;
876
+ /**
877
+ * Natal planet being aspected. Always English, whatever the lang parameter says. Use natalPlanetLocalized for anything a reader sees.
802
878
  */
803
879
  natalPlanet: string;
804
880
  /**
805
- * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.).
881
+ * Natal planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
882
+ */
883
+ natalPlanetLocalized?: string;
884
+ /**
885
+ * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.). Always English, whatever the lang parameter says. Use typeLocalized for anything a reader sees.
806
886
  */
807
887
  type: string;
888
+ /**
889
+ * Aspect type name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
890
+ */
891
+ typeLocalized?: string;
808
892
  /**
809
893
  * Exact angle of this aspect type in degrees.
810
894
  */
@@ -1108,6 +1192,10 @@ export type RelocationChartResponse = {
1108
1192
  * Degree within the zodiac sign on this cusp (0-29.999).
1109
1193
  */
1110
1194
  degree: number;
1195
+ /**
1196
+ * Zodiac sign name on this cusp in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
1197
+ */
1198
+ signLocalized?: string;
1111
1199
  }>;
1112
1200
  /**
1113
1201
  * House system used for the relocated chart (placidus, whole-sign, equal, or koch). Quadrant systems fall back to whole-sign above the polar circle.
@@ -1118,9 +1206,13 @@ export type RelocationChartResponse = {
1118
1206
  */
1119
1207
  ascendant: {
1120
1208
  /**
1121
- * Tropical zodiac sign on this relocated angle.
1209
+ * Tropical zodiac sign on this relocated angle. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
1122
1210
  */
1123
1211
  sign: string;
1212
+ /**
1213
+ * Zodiac sign name on this angle in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
1214
+ */
1215
+ signLocalized?: string;
1124
1216
  /**
1125
1217
  * Degree within the zodiac sign on this angle (0-29.999).
1126
1218
  */
@@ -1135,9 +1227,13 @@ export type RelocationChartResponse = {
1135
1227
  */
1136
1228
  midheaven: {
1137
1229
  /**
1138
- * Tropical zodiac sign on this relocated angle.
1230
+ * Tropical zodiac sign on this relocated angle. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
1139
1231
  */
1140
1232
  sign: string;
1233
+ /**
1234
+ * Zodiac sign name on this angle in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
1235
+ */
1236
+ signLocalized?: string;
1141
1237
  /**
1142
1238
  * Degree within the zodiac sign on this angle (0-29.999).
1143
1239
  */
@@ -1163,6 +1259,10 @@ export type RelocationChartResponse = {
1163
1259
  * Absolute ecliptic longitude of the Vertex (0-360).
1164
1260
  */
1165
1261
  longitude: number;
1262
+ /**
1263
+ * Vertex sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
1264
+ */
1265
+ signLocalized?: string;
1166
1266
  };
1167
1267
  /**
1168
1268
  * How relocation reshapes the chart: Ascendant shift, planets that change house, angular planets, and the move geometry from the birthplace.
@@ -1177,9 +1277,13 @@ export type RelocationChartResponse = {
1177
1277
  */
1178
1278
  planetsChangedHouse: Array<{
1179
1279
  /**
1180
- * Body that occupies a different house after relocation.
1280
+ * Body that occupies a different house after relocation. Always English, whatever the lang parameter says. Use planetLocalized for anything a reader sees.
1181
1281
  */
1182
1282
  planet: string;
1283
+ /**
1284
+ * Body name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
1285
+ */
1286
+ planetLocalized?: string;
1183
1287
  /**
1184
1288
  * House this body occupied in the birthplace chart (1-12).
1185
1289
  */
@@ -1190,9 +1294,13 @@ export type RelocationChartResponse = {
1190
1294
  relocatedHouse: number;
1191
1295
  }>;
1192
1296
  /**
1193
- * Bodies within three degrees of a relocated angle (Ascendant, Imum Coeli, Descendant, or Midheaven), where their influence is strongest at this location.
1297
+ * Bodies within three degrees of a relocated angle (Ascendant, Imum Coeli, Descendant, or Midheaven), where their influence is strongest at this location. Always English, whatever the lang parameter says. Use angularPlanetsLocalized for anything a reader sees.
1194
1298
  */
1195
1299
  angularPlanets: Array<string>;
1300
+ /**
1301
+ * The same angular bodies in the requested language, for display only. Index aligned with angularPlanets. Present only when lang is set to a language other than English.
1302
+ */
1303
+ angularPlanetsLocalized?: Array<string>;
1196
1304
  /**
1197
1305
  * Great-circle distance from the birthplace to the new location in kilometers.
1198
1306
  */
@@ -1246,6 +1354,14 @@ export type RelocationPlanet = {
1246
1354
  * Whether the planet appears to move backward from Earth perspective. Retrograde periods signal review and introspection.
1247
1355
  */
1248
1356
  isRetrograde: boolean;
1357
+ /**
1358
+ * Body name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
1359
+ */
1360
+ nameLocalized?: string;
1361
+ /**
1362
+ * Zodiac sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
1363
+ */
1364
+ signLocalized?: string;
1249
1365
  /**
1250
1366
  * Relocated placement interpretation. The planet keeps its natal sign, so this reads its meaning through the new house it occupies at this location.
1251
1367
  */
@@ -1845,17 +1961,25 @@ export type ProgressionsResponse = {
1845
1961
  */
1846
1962
  planets: Array<{
1847
1963
  /**
1848
- * Body name in canonical English. One of the 10 classical planets, the lunar nodes, Chiron, or Black Moon Lilith.
1964
+ * Body name in canonical English. One of the 10 classical planets, the lunar nodes, Chiron, or Black Moon Lilith. Unchanged by the lang parameter, so it stays safe to compare against in code. Use nameLocalized for anything a reader sees.
1849
1965
  */
1850
1966
  name: string;
1967
+ /**
1968
+ * Body name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
1969
+ */
1970
+ nameLocalized?: string;
1851
1971
  /**
1852
1972
  * Progressed tropical ecliptic longitude in degrees (0 to 360).
1853
1973
  */
1854
1974
  longitude: number;
1855
1975
  /**
1856
- * Tropical zodiac sign the progressed body falls in.
1976
+ * Tropical zodiac sign the progressed body falls in. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
1857
1977
  */
1858
1978
  sign: string;
1979
+ /**
1980
+ * Zodiac sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
1981
+ */
1982
+ signLocalized?: string;
1859
1983
  /**
1860
1984
  * Degree of the progressed body within its zodiac sign (0 to 29.999).
1861
1985
  */
@@ -1886,9 +2010,13 @@ export type ProgressionsResponse = {
1886
2010
  */
1887
2011
  longitude: number;
1888
2012
  /**
1889
- * Tropical zodiac sign the progressed angle falls in.
2013
+ * Tropical zodiac sign the progressed angle falls in. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
1890
2014
  */
1891
2015
  sign: string;
2016
+ /**
2017
+ * Zodiac sign name on this angle in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
2018
+ */
2019
+ signLocalized?: string;
1892
2020
  /**
1893
2021
  * Degree of the progressed angle within its zodiac sign (0 to 29.999).
1894
2022
  */
@@ -1903,9 +2031,13 @@ export type ProgressionsResponse = {
1903
2031
  */
1904
2032
  longitude: number;
1905
2033
  /**
1906
- * Tropical zodiac sign the progressed angle falls in.
2034
+ * Tropical zodiac sign the progressed angle falls in. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
1907
2035
  */
1908
2036
  sign: string;
2037
+ /**
2038
+ * Zodiac sign name on this angle in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
2039
+ */
2040
+ signLocalized?: string;
1909
2041
  /**
1910
2042
  * Degree of the progressed angle within its zodiac sign (0 to 29.999).
1911
2043
  */
@@ -8347,6 +8479,191 @@ export type PostAstrologyPlanetsResponses = {
8347
8479
 
8348
8480
  export type PostAstrologyPlanetsResponse = PostAstrologyPlanetsResponses[keyof PostAstrologyPlanetsResponses];
8349
8481
 
8482
+ export type PostAstrologyPlanetsMonthlyData = {
8483
+ body?: {
8484
+ /**
8485
+ * Year for the monthly ephemeris (1900-2100). Defaults to the current year (UTC).
8486
+ */
8487
+ year?: number;
8488
+ /**
8489
+ * Month number (1-12) for the ephemeris. Defaults to the current month (UTC).
8490
+ */
8491
+ month?: number;
8492
+ };
8493
+ path?: never;
8494
+ query?: {
8495
+ /**
8496
+ * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
8497
+ */
8498
+ lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
8499
+ };
8500
+ url: '/astrology/planets/monthly';
8501
+ };
8502
+
8503
+ export type PostAstrologyPlanetsMonthlyErrors = {
8504
+ /**
8505
+ * Validation error. `issues[]` lists every failed field.
8506
+ */
8507
+ 400: {
8508
+ /**
8509
+ * First issue summary.
8510
+ */
8511
+ error: string;
8512
+ code: 'validation_error';
8513
+ /**
8514
+ * Every validation failure. Use this to rebuild a valid request.
8515
+ */
8516
+ issues: Array<{
8517
+ /**
8518
+ * Dot-separated field path, or "(root)" for top-level.
8519
+ */
8520
+ path: string;
8521
+ message: string;
8522
+ /**
8523
+ * Zod issue code (invalid_type, too_small, too_big, invalid_string, ...).
8524
+ */
8525
+ code?: string;
8526
+ /**
8527
+ * Expected type for invalid_type.
8528
+ */
8529
+ expected?: string;
8530
+ /**
8531
+ * Minimum bound for too_small issues.
8532
+ */
8533
+ minimum?: number | string;
8534
+ /**
8535
+ * Maximum bound for too_big issues.
8536
+ */
8537
+ maximum?: number | string;
8538
+ inclusive?: boolean;
8539
+ /**
8540
+ * Format name for string issues (regex, email, url, uuid).
8541
+ */
8542
+ format?: string;
8543
+ /**
8544
+ * Regex pattern when format is regex.
8545
+ */
8546
+ pattern?: string;
8547
+ }>;
8548
+ };
8549
+ /**
8550
+ * Invalid or missing API key
8551
+ */
8552
+ 401: {
8553
+ /**
8554
+ * Human-readable error message. May change wording.
8555
+ */
8556
+ error: string;
8557
+ /**
8558
+ * Machine-readable error code. Stable identifier.
8559
+ */
8560
+ code: string;
8561
+ };
8562
+ /**
8563
+ * Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
8564
+ */
8565
+ 405: {
8566
+ error: string;
8567
+ code: 'method_not_allowed';
8568
+ /**
8569
+ * Allowed HTTP methods for this path. Mirrors the Allow response header.
8570
+ */
8571
+ allow: Array<string>;
8572
+ /**
8573
+ * Link to the product page for this domain.
8574
+ */
8575
+ docs?: string;
8576
+ };
8577
+ /**
8578
+ * Monthly rate limit exceeded
8579
+ */
8580
+ 429: {
8581
+ /**
8582
+ * Human-readable error message. May change wording.
8583
+ */
8584
+ error: string;
8585
+ /**
8586
+ * Machine-readable error code. Stable identifier.
8587
+ */
8588
+ code: string;
8589
+ };
8590
+ /**
8591
+ * Internal server error
8592
+ */
8593
+ 500: {
8594
+ /**
8595
+ * Human-readable error message. May change wording.
8596
+ */
8597
+ error: string;
8598
+ /**
8599
+ * Machine-readable error code. Stable identifier.
8600
+ */
8601
+ code: string;
8602
+ };
8603
+ };
8604
+
8605
+ export type PostAstrologyPlanetsMonthlyError = PostAstrologyPlanetsMonthlyErrors[keyof PostAstrologyPlanetsMonthlyErrors];
8606
+
8607
+ export type PostAstrologyPlanetsMonthlyResponses = {
8608
+ /**
8609
+ * Monthly ephemeris data
8610
+ */
8611
+ 200: {
8612
+ /**
8613
+ * Year of the ephemeris. Echoes the year that was requested, or the current UTC year when it was omitted.
8614
+ */
8615
+ year: number;
8616
+ /**
8617
+ * Month of the ephemeris. Echoes the month that was requested, or the current UTC month when it was omitted.
8618
+ */
8619
+ month: number;
8620
+ /**
8621
+ * Daily planetary position entries for the entire month.
8622
+ */
8623
+ days: Array<{
8624
+ /**
8625
+ * Date in YYYY-MM-DD format.
8626
+ */
8627
+ date: string;
8628
+ /**
8629
+ * Tropical positions of all 14 Western bodies on this date at noon UTC.
8630
+ */
8631
+ positions: Array<{
8632
+ /**
8633
+ * Body name, one of the 14 bodies Western astrology reads: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, North Node, South Node, Chiron, Black Moon Lilith. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use planetLocalized for anything a reader sees.
8634
+ */
8635
+ planet: string;
8636
+ /**
8637
+ * Body name in the requested language, for display. Present only when lang is set to a language other than English, since in English it would repeat planet exactly.
8638
+ */
8639
+ planetLocalized?: string;
8640
+ /**
8641
+ * Tropical ecliptic longitude in degrees (0-360), measured from the vernal equinox. This is the Western zodiac, not the sidereal one, so the two differ by the ayanamsa of roughly 24 degrees.
8642
+ */
8643
+ longitude: number;
8644
+ /**
8645
+ * Tropical zodiac sign the body occupies on this date. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use signLocalized for anything a reader sees.
8646
+ */
8647
+ sign: string;
8648
+ /**
8649
+ * Zodiac sign name in the requested language, for display. Present only when lang is set to a language other than English, since in English it would repeat sign exactly.
8650
+ */
8651
+ signLocalized?: string;
8652
+ /**
8653
+ * Degrees traversed within the current sign (0-30). Useful for precise transit tracking and for printing a position as sign plus degree.
8654
+ */
8655
+ degreeInSign: number;
8656
+ /**
8657
+ * Whether the body is in apparent retrograde motion on this date. The lunar nodes are always retrograde and Black Moon Lilith is always direct.
8658
+ */
8659
+ isRetrograde: boolean;
8660
+ }>;
8661
+ }>;
8662
+ };
8663
+ };
8664
+
8665
+ export type PostAstrologyPlanetsMonthlyResponse = PostAstrologyPlanetsMonthlyResponses[keyof PostAstrologyPlanetsMonthlyResponses];
8666
+
8350
8667
  export type GetAstrologyMoonPhaseCurrentData = {
8351
8668
  body?: never;
8352
8669
  path?: never;
@@ -9044,38 +9361,58 @@ export type PostAstrologySynastryResponses = {
9044
9361
  */
9045
9362
  ascendant: {
9046
9363
  /**
9047
- * Ascendant (rising sign) of this person.
9364
+ * Ascendant (rising sign) of this person. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
9048
9365
  */
9049
9366
  sign: string;
9367
+ /**
9368
+ * Ascendant sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9369
+ */
9370
+ signLocalized?: string;
9050
9371
  /**
9051
9372
  * Degree within the Ascendant sign (0-29.999).
9052
9373
  */
9053
9374
  degree: number;
9054
9375
  };
9055
9376
  /**
9056
- * Sun sign (zodiac sign) of this person. Core identity and ego expression.
9377
+ * Sun sign (zodiac sign) of this person. Core identity and ego expression. Always English, whatever the lang parameter says. Use sunSignLocalized for anything a reader sees.
9057
9378
  */
9058
9379
  sunSign: string;
9059
9380
  /**
9060
- * Moon sign of this person. Emotional nature and inner needs.
9381
+ * Sun sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9382
+ */
9383
+ sunSignLocalized?: string;
9384
+ /**
9385
+ * Moon sign of this person. Emotional nature and inner needs. Always English, whatever the lang parameter says. Use moonSignLocalized for anything a reader sees.
9061
9386
  */
9062
9387
  moonSign: string;
9388
+ /**
9389
+ * Moon sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9390
+ */
9391
+ moonSignLocalized?: string;
9063
9392
  /**
9064
9393
  * Planet positions for person 1, enough to render this side of a dual wheel without a second request. Per-planet interpretations are not repeated here; call the natal chart endpoint for an individual reading.
9065
9394
  */
9066
9395
  planets: Array<{
9067
9396
  /**
9068
- * Planet or point name. Matches the names used in interAspects.
9397
+ * Planet or point name. Matches the names used in interAspects. Always English, whatever the lang parameter says. Use nameLocalized for anything a reader sees.
9069
9398
  */
9070
9399
  name: string;
9400
+ /**
9401
+ * Planet or point name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9402
+ */
9403
+ nameLocalized?: string;
9071
9404
  /**
9072
9405
  * Ecliptic longitude in degrees (0-360) measured from 0 Aries. This is the value a wheel plots.
9073
9406
  */
9074
9407
  longitude: number;
9075
9408
  /**
9076
- * Zodiac sign containing the planet.
9409
+ * Zodiac sign containing the planet. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
9077
9410
  */
9078
9411
  sign: string;
9412
+ /**
9413
+ * Zodiac sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9414
+ */
9415
+ signLocalized?: string;
9079
9416
  /**
9080
9417
  * Degree within the sign (0-29.999).
9081
9418
  */
@@ -9103,38 +9440,58 @@ export type PostAstrologySynastryResponses = {
9103
9440
  */
9104
9441
  ascendant: {
9105
9442
  /**
9106
- * Ascendant (rising sign) of this person.
9443
+ * Ascendant (rising sign) of this person. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
9107
9444
  */
9108
9445
  sign: string;
9446
+ /**
9447
+ * Ascendant sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9448
+ */
9449
+ signLocalized?: string;
9109
9450
  /**
9110
9451
  * Degree within the Ascendant sign (0-29.999).
9111
9452
  */
9112
9453
  degree: number;
9113
9454
  };
9114
9455
  /**
9115
- * Sun sign (zodiac sign) of this person. Core identity and ego expression.
9456
+ * Sun sign (zodiac sign) of this person. Core identity and ego expression. Always English, whatever the lang parameter says. Use sunSignLocalized for anything a reader sees.
9116
9457
  */
9117
9458
  sunSign: string;
9118
9459
  /**
9119
- * Moon sign of this person. Emotional nature and inner needs.
9460
+ * Sun sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9461
+ */
9462
+ sunSignLocalized?: string;
9463
+ /**
9464
+ * Moon sign of this person. Emotional nature and inner needs. Always English, whatever the lang parameter says. Use moonSignLocalized for anything a reader sees.
9120
9465
  */
9121
9466
  moonSign: string;
9467
+ /**
9468
+ * Moon sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9469
+ */
9470
+ moonSignLocalized?: string;
9122
9471
  /**
9123
9472
  * Planet positions for person 2, enough to render this side of a dual wheel without a second request. Per-planet interpretations are not repeated here; call the natal chart endpoint for an individual reading.
9124
9473
  */
9125
9474
  planets: Array<{
9126
9475
  /**
9127
- * Planet or point name. Matches the names used in interAspects.
9476
+ * Planet or point name. Matches the names used in interAspects. Always English, whatever the lang parameter says. Use nameLocalized for anything a reader sees.
9128
9477
  */
9129
9478
  name: string;
9479
+ /**
9480
+ * Planet or point name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9481
+ */
9482
+ nameLocalized?: string;
9130
9483
  /**
9131
9484
  * Ecliptic longitude in degrees (0-360) measured from 0 Aries. This is the value a wheel plots.
9132
9485
  */
9133
9486
  longitude: number;
9134
9487
  /**
9135
- * Zodiac sign containing the planet.
9488
+ * Zodiac sign containing the planet. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
9136
9489
  */
9137
9490
  sign: string;
9491
+ /**
9492
+ * Zodiac sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9493
+ */
9494
+ signLocalized?: string;
9138
9495
  /**
9139
9496
  * Degree within the sign (0-29.999).
9140
9497
  */
@@ -9158,17 +9515,29 @@ export type PostAstrologySynastryResponses = {
9158
9515
  */
9159
9516
  interAspects: Array<{
9160
9517
  /**
9161
- * Planet from person 1 chart.
9518
+ * Planet from person 1 chart. Always English, whatever the lang parameter says. Use planet1Localized for anything a reader sees.
9162
9519
  */
9163
9520
  planet1: string;
9164
9521
  /**
9165
- * Planet from person 2 chart.
9522
+ * Person 1 planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9523
+ */
9524
+ planet1Localized?: string;
9525
+ /**
9526
+ * Planet from person 2 chart. Always English, whatever the lang parameter says. Use planet2Localized for anything a reader sees.
9166
9527
  */
9167
9528
  planet2: string;
9168
9529
  /**
9169
- * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.).
9530
+ * Person 2 planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9531
+ */
9532
+ planet2Localized?: string;
9533
+ /**
9534
+ * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.). Always English, whatever the lang parameter says. Use typeLocalized for anything a reader sees.
9170
9535
  */
9171
9536
  type: string;
9537
+ /**
9538
+ * Aspect type name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9539
+ */
9540
+ typeLocalized?: string;
9172
9541
  /**
9173
9542
  * Exact angle of this aspect type in degrees.
9174
9543
  */
@@ -9849,6 +10218,10 @@ export type PostAstrologyTransitAspectsData = {
9849
10218
  * Minimum aspect strength threshold (0-100). Higher values return only tighter, more potent aspects. Useful for filtering out wide-orb aspects.
9850
10219
  */
9851
10220
  minStrength?: number;
10221
+ /**
10222
+ * 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.
10223
+ */
10224
+ houseSystem?: 'placidus' | 'whole-sign' | 'equal' | 'koch';
9852
10225
  };
9853
10226
  path?: never;
9854
10227
  query?: {
@@ -9974,7 +10347,11 @@ export type PostAstrologyTransitAspectsResponses = {
9974
10347
  */
9975
10348
  transitDate: string;
9976
10349
  /**
9977
- * 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.
10350
+ * 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.
10351
+ */
10352
+ houseSystem: 'placidus' | 'whole-sign' | 'equal' | 'koch';
10353
+ /**
10354
+ * 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.
9978
10355
  */
9979
10356
  transitPlanets: Array<{
9980
10357
  /**
@@ -9998,7 +10375,7 @@ export type PostAstrologyTransitAspectsResponses = {
9998
10375
  */
9999
10376
  degree: number;
10000
10377
  /**
10001
- * House placement (1-12). Determined by the selected house system and birth location.
10378
+ * 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.
10002
10379
  */
10003
10380
  house: number;
10004
10381
  /**
@@ -10009,9 +10386,17 @@ export type PostAstrologyTransitAspectsResponses = {
10009
10386
  * Whether the planet appears to move backward from Earth perspective. Retrograde periods signal review and introspection.
10010
10387
  */
10011
10388
  isRetrograde: boolean;
10389
+ /**
10390
+ * Body name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
10391
+ */
10392
+ nameLocalized?: string;
10393
+ /**
10394
+ * Zodiac sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
10395
+ */
10396
+ signLocalized?: string;
10012
10397
  }>;
10013
10398
  /**
10014
- * Natal (birth chart) planetary positions used as the baseline for transit aspect comparison.
10399
+ * Natal (birth chart) planetary positions used as the baseline for transit aspect comparison, each placed in its natal house.
10015
10400
  */
10016
10401
  natalPlanets: Array<{
10017
10402
  /**
@@ -10046,6 +10431,14 @@ export type PostAstrologyTransitAspectsResponses = {
10046
10431
  * Whether the planet appears to move backward from Earth perspective. Retrograde periods signal review and introspection.
10047
10432
  */
10048
10433
  isRetrograde: boolean;
10434
+ /**
10435
+ * Body name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
10436
+ */
10437
+ nameLocalized?: string;
10438
+ /**
10439
+ * Zodiac sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
10440
+ */
10441
+ signLocalized?: string;
10049
10442
  }>;
10050
10443
  /**
10051
10444
  * Transit-to-natal aspects with interpretations, strength ratings, and guidance. Each aspect represents a transiting planet forming a geometric angle to a natal planet.
@@ -10083,6 +10476,18 @@ export type PostAstrologyTransitAspectsResponses = {
10083
10476
  * Aspect nature. Harmonious (trine, sextile) flows easily. Challenging (square, opposition) creates tension and growth. Neutral (conjunction) blends energies.
10084
10477
  */
10085
10478
  interpretation: 'harmonious' | 'challenging' | 'neutral';
10479
+ /**
10480
+ * First planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
10481
+ */
10482
+ planet1Localized?: string;
10483
+ /**
10484
+ * Second planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
10485
+ */
10486
+ planet2Localized?: string;
10487
+ /**
10488
+ * Aspect type name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
10489
+ */
10490
+ typeLocalized?: string;
10086
10491
  transitInterpretation?: {
10087
10492
  /**
10088
10493
  * Narrative interpretation of this transit aspect and its life impact.
@@ -10162,6 +10567,18 @@ export type PostAstrologyTransitAspectsResponses = {
10162
10567
  * Aspect nature. Harmonious (trine, sextile) flows easily. Challenging (square, opposition) creates tension and growth. Neutral (conjunction) blends energies.
10163
10568
  */
10164
10569
  interpretation: 'harmonious' | 'challenging' | 'neutral';
10570
+ /**
10571
+ * First planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
10572
+ */
10573
+ planet1Localized?: string;
10574
+ /**
10575
+ * Second planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
10576
+ */
10577
+ planet2Localized?: string;
10578
+ /**
10579
+ * Aspect type name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
10580
+ */
10581
+ typeLocalized?: string;
10165
10582
  } | null;
10166
10583
  /**
10167
10584
  * Transit aspect counts grouped by aspect type (conjunction, trine, square, opposition, sextile, etc.). Useful for quickly assessing the transit weather.
@@ -14808,20 +15225,25 @@ export type PostVedicAstrologyPlanetaryPositionsResponse = PostVedicAstrologyPla
14808
15225
  export type PostVedicAstrologyPlanetaryPositionsMonthlyData = {
14809
15226
  body?: {
14810
15227
  /**
14811
- * Year for monthly ephemeris (1900-2100).
15228
+ * Year for monthly ephemeris (1900-2100). Defaults to the current year (UTC).
14812
15229
  */
14813
- year: number;
15230
+ year?: number;
14814
15231
  /**
14815
- * Month number (1-12) for ephemeris.
15232
+ * Month number (1-12) for ephemeris. Defaults to the current month (UTC).
14816
15233
  */
14817
- month: number;
15234
+ month?: number;
14818
15235
  /**
14819
15236
  * Coordinate system for longitude output. "sidereal" (Nirayana) uses Lahiri ayanamsa - standard for Vedic astrology. "tropical" (Sayana) uses raw ecliptic longitude matching Western astrology. Defaults to "sidereal".
14820
15237
  */
14821
15238
  coordinateSystem?: 'sidereal' | 'tropical';
14822
15239
  };
14823
15240
  path?: never;
14824
- query?: never;
15241
+ query?: {
15242
+ /**
15243
+ * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
15244
+ */
15245
+ lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
15246
+ };
14825
15247
  url: '/vedic-astrology/planetary-positions/monthly';
14826
15248
  };
14827
15249
 
@@ -14935,11 +15357,11 @@ export type PostVedicAstrologyPlanetaryPositionsMonthlyResponses = {
14935
15357
  */
14936
15358
  200: {
14937
15359
  /**
14938
- * Year of the ephemeris.
15360
+ * Year of the ephemeris. Echoes the year that was requested, or the current UTC year when it was omitted.
14939
15361
  */
14940
15362
  year: number;
14941
15363
  /**
14942
- * Month of the ephemeris.
15364
+ * Month of the ephemeris. Echoes the month that was requested, or the current UTC month when it was omitted.
14943
15365
  */
14944
15366
  month: number;
14945
15367
  /**
@@ -14955,17 +15377,25 @@ export type PostVedicAstrologyPlanetaryPositionsMonthlyResponses = {
14955
15377
  */
14956
15378
  positions: Array<{
14957
15379
  /**
14958
- * Planet name, one of the Navagraha (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu).
15380
+ * Planet name, one of the Navagraha (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu). Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use planetLocalized for anything a reader sees.
14959
15381
  */
14960
15382
  planet: string;
15383
+ /**
15384
+ * Planet name in the requested language, for display. Present only when lang is set to a language other than English, since in English it would repeat planet exactly. Rahu and Ketu are rendered as the lunar nodes they are, so Spanish returns Nodo Norte and Nodo Sur while Hindi returns their Sanskrit names.
15385
+ */
15386
+ planetLocalized?: string;
14961
15387
  /**
14962
15388
  * Sidereal ecliptic longitude in degrees (0-360) using Lahiri ayanamsa.
14963
15389
  */
14964
15390
  longitude: number;
14965
15391
  /**
14966
- * Zodiac sign (rashi) the planet occupies on this date.
15392
+ * Zodiac sign (rashi) the planet occupies on this date. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use signLocalized for anything a reader sees.
14967
15393
  */
14968
15394
  sign: string;
15395
+ /**
15396
+ * Zodiac sign name in the requested language, for display. Present only when lang is set to a language other than English, since in English it would repeat sign exactly.
15397
+ */
15398
+ signLocalized?: string;
14969
15399
  /**
14970
15400
  * Degrees traversed within the current sign (0-30). Useful for precise transit tracking.
14971
15401
  */
@@ -21425,13 +21855,13 @@ export type PostVedicAstrologyAspectsResponse = PostVedicAstrologyAspectsRespons
21425
21855
  export type PostVedicAstrologyAspectsMonthlyData = {
21426
21856
  body?: {
21427
21857
  /**
21428
- * Year for monthly analysis (1900-2100).
21858
+ * Year for monthly analysis (1900-2100). Defaults to the current year (UTC).
21429
21859
  */
21430
- year: number;
21860
+ year?: number;
21431
21861
  /**
21432
- * Month number (1-12).
21862
+ * Month number (1-12). Defaults to the current month (UTC).
21433
21863
  */
21434
- month: number;
21864
+ month?: number;
21435
21865
  /**
21436
21866
  * Timezone offset from UTC in hours. Output times are converted to this timezone. Defaults to 0 (UTC).
21437
21867
  */
@@ -21442,7 +21872,12 @@ export type PostVedicAstrologyAspectsMonthlyData = {
21442
21872
  coordinateSystem?: 'sidereal' | 'tropical';
21443
21873
  };
21444
21874
  path?: never;
21445
- query?: never;
21875
+ query?: {
21876
+ /**
21877
+ * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
21878
+ */
21879
+ lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
21880
+ };
21446
21881
  url: '/vedic-astrology/aspects/monthly';
21447
21882
  };
21448
21883
 
@@ -21556,11 +21991,11 @@ export type PostVedicAstrologyAspectsMonthlyResponses = {
21556
21991
  */
21557
21992
  200: {
21558
21993
  /**
21559
- * Year of the aspect analysis.
21994
+ * Year of the aspect analysis. Echoes the year that was requested, or the current UTC year when it was omitted.
21560
21995
  */
21561
21996
  year: number;
21562
21997
  /**
21563
- * Month of the aspect analysis.
21998
+ * Month of the aspect analysis. Echoes the month that was requested, or the current UTC month when it was omitted.
21564
21999
  */
21565
22000
  month: number;
21566
22001
  /**
@@ -21572,13 +22007,21 @@ export type PostVedicAstrologyAspectsMonthlyResponses = {
21572
22007
  */
21573
22008
  events: Array<{
21574
22009
  /**
21575
- * First planet forming the aspect. One of the Navagraha, Sun through Ketu.
22010
+ * First planet forming the aspect. One of the Navagraha, Sun through Ketu. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use planet1Localized for anything a reader sees.
21576
22011
  */
21577
22012
  planet1: string;
21578
22013
  /**
21579
- * Second planet forming the aspect.
22014
+ * First planet name in the requested language, for display. Present only when lang is set to a language other than English, since in English it would repeat planet1 exactly.
22015
+ */
22016
+ planet1Localized?: string;
22017
+ /**
22018
+ * Second planet forming the aspect. Always English, whatever the lang parameter says. Use planet2Localized for anything a reader sees.
21580
22019
  */
21581
22020
  planet2: string;
22021
+ /**
22022
+ * Second planet name in the requested language, for display. Present only when lang is set to a language other than English.
22023
+ */
22024
+ planet2Localized?: string;
21582
22025
  /**
21583
22026
  * Aspect type. major: conjunction (0 deg), opposition (180 deg), trine (120 deg), square (90 deg), sextile (60 deg). Minor: vigintile (18 deg), semi-sextile (30 deg), undecile (32.73 deg), semi-quintile (36 deg), novile (40 deg), semi-square (45 deg), septile (51.43 deg), quintile (72 deg), binovile (80 deg), centile (100 deg), biseptile (102.86 deg), tredecile (108 deg), sesqui-square (135 deg), bi-quintile (144 deg), quincunx (150 deg), triseptile (154.29 deg), quadranovile (160 deg).
21584
22027
  */
@@ -21620,13 +22063,13 @@ export type PostVedicAstrologyAspectsMonthlyResponse = PostVedicAstrologyAspects
21620
22063
  export type PostVedicAstrologyAspectsLunarData = {
21621
22064
  body?: {
21622
22065
  /**
21623
- * Year for monthly analysis (1900-2100).
22066
+ * Year for monthly analysis (1900-2100). Defaults to the current year (UTC).
21624
22067
  */
21625
- year: number;
22068
+ year?: number;
21626
22069
  /**
21627
- * Month number (1-12).
22070
+ * Month number (1-12). Defaults to the current month (UTC).
21628
22071
  */
21629
- month: number;
22072
+ month?: number;
21630
22073
  /**
21631
22074
  * Timezone offset from UTC in hours. Output times are converted to this timezone. Defaults to 0 (UTC).
21632
22075
  */
@@ -21637,7 +22080,12 @@ export type PostVedicAstrologyAspectsLunarData = {
21637
22080
  coordinateSystem?: 'sidereal' | 'tropical';
21638
22081
  };
21639
22082
  path?: never;
21640
- query?: never;
22083
+ query?: {
22084
+ /**
22085
+ * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
22086
+ */
22087
+ lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
22088
+ };
21641
22089
  url: '/vedic-astrology/aspects/lunar';
21642
22090
  };
21643
22091
 
@@ -21751,11 +22199,11 @@ export type PostVedicAstrologyAspectsLunarResponses = {
21751
22199
  */
21752
22200
  200: {
21753
22201
  /**
21754
- * Year of the lunar aspect analysis.
22202
+ * Year of the lunar aspect analysis. Echoes the year that was requested, or the current UTC year when it was omitted.
21755
22203
  */
21756
22204
  year: number;
21757
22205
  /**
21758
- * Month of the lunar aspect analysis.
22206
+ * Month of the lunar aspect analysis. Echoes the month that was requested, or the current UTC month when it was omitted.
21759
22207
  */
21760
22208
  month: number;
21761
22209
  /**
@@ -21767,9 +22215,13 @@ export type PostVedicAstrologyAspectsLunarResponses = {
21767
22215
  */
21768
22216
  events: Array<{
21769
22217
  /**
21770
- * Planet that the Moon forms an aspect with.
22218
+ * Planet that the Moon forms an aspect with. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use planetLocalized for anything a reader sees.
21771
22219
  */
21772
22220
  planet: string;
22221
+ /**
22222
+ * Planet name in the requested language, for display. Present only when lang is set to a language other than English, since in English it would repeat planet exactly.
22223
+ */
22224
+ planetLocalized?: string;
21773
22225
  /**
21774
22226
  * Aspect type. major: conjunction, opposition, trine, square, sextile. Minor: vigintile, semi-sextile, undecile, semi-quintile, novile, semi-square, septile, quintile, binovile, centile, biseptile, tredecile, sesqui-square, bi-quintile, quincunx, triseptile, quadranovile.
21775
22227
  */
@@ -22082,13 +22534,13 @@ export type PostVedicAstrologyTransitResponse = PostVedicAstrologyTransitRespons
22082
22534
  export type PostVedicAstrologyTransitMonthlyData = {
22083
22535
  body?: {
22084
22536
  /**
22085
- * Year for monthly transit analysis (1900-2100).
22537
+ * Year for monthly transit analysis (1900-2100). Defaults to the current year (UTC).
22086
22538
  */
22087
- year: number;
22539
+ year?: number;
22088
22540
  /**
22089
- * Month number (1-12) for transit analysis.
22541
+ * Month number (1-12) for transit analysis. Defaults to the current month (UTC).
22090
22542
  */
22091
- month: number;
22543
+ month?: number;
22092
22544
  /**
22093
22545
  * Timezone offset from UTC in hours. Output times are converted to this timezone. Defaults to 0 (UTC).
22094
22546
  */
@@ -22099,7 +22551,12 @@ export type PostVedicAstrologyTransitMonthlyData = {
22099
22551
  coordinateSystem?: 'sidereal' | 'tropical';
22100
22552
  };
22101
22553
  path?: never;
22102
- query?: never;
22554
+ query?: {
22555
+ /**
22556
+ * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
22557
+ */
22558
+ lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
22559
+ };
22103
22560
  url: '/vedic-astrology/transit/monthly';
22104
22561
  };
22105
22562
 
@@ -22213,25 +22670,37 @@ export type PostVedicAstrologyTransitMonthlyResponses = {
22213
22670
  */
22214
22671
  200: {
22215
22672
  /**
22216
- * Year of the monthly transit analysis.
22673
+ * Year of the monthly transit analysis. Echoes the year that was requested, or the current UTC year when it was omitted.
22217
22674
  */
22218
22675
  year: number;
22219
22676
  /**
22220
- * Month of the monthly transit analysis.
22677
+ * Month of the monthly transit analysis. Echoes the month that was requested, or the current UTC month when it was omitted.
22221
22678
  */
22222
22679
  month: number;
22680
+ /**
22681
+ * Timezone offset from UTC in hours that the event dates and times are reported in. Echoes the requested timezone.
22682
+ */
22683
+ timezone: number;
22223
22684
  /**
22224
22685
  * Planetary positions at the beginning of the month (day 1, 00:00 UTC).
22225
22686
  */
22226
22687
  startingPositions: Array<{
22227
22688
  /**
22228
- * Planet (graha) name. One of the 9 Navagraha used in Vedic transit (Gochar) analysis.
22689
+ * Planet (graha) name. One of the 9 Navagraha used in Vedic transit (Gochar) analysis. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use planetLocalized for anything a reader sees.
22229
22690
  */
22230
22691
  planet: string;
22231
22692
  /**
22232
- * Zodiac sign (rashi) the planet occupies at the start of the month.
22693
+ * Planet name in the requested language, for display. Present only when lang is set to a language other than English.
22694
+ */
22695
+ planetLocalized?: string;
22696
+ /**
22697
+ * Zodiac sign (rashi) the planet occupies at the start of the month. Always English. Use signLocalized for anything a reader sees.
22233
22698
  */
22234
22699
  sign: string;
22700
+ /**
22701
+ * Zodiac sign name in the requested language, for display. Present only when lang is set to a language other than English.
22702
+ */
22703
+ signLocalized?: string;
22235
22704
  /**
22236
22705
  * Sidereal longitude at the start of the month.
22237
22706
  */
@@ -22242,17 +22711,29 @@ export type PostVedicAstrologyTransitMonthlyResponses = {
22242
22711
  */
22243
22712
  transitEvents: Array<{
22244
22713
  /**
22245
- * Planet that changes sign (rashi) during this month. One of the Navagraha: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu.
22714
+ * Planet that changes sign (rashi) during this month. One of the Navagraha: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use planetLocalized for anything a reader sees.
22246
22715
  */
22247
22716
  planet: string;
22248
22717
  /**
22249
- * Zodiac sign the planet is leaving (previous rashi).
22718
+ * Planet name in the requested language, for display. Present only when lang is set to a language other than English, since in English it would repeat planet exactly.
22719
+ */
22720
+ planetLocalized?: string;
22721
+ /**
22722
+ * Zodiac sign the planet is leaving (previous rashi). Always English. Use fromSignLocalized for anything a reader sees.
22250
22723
  */
22251
22724
  fromSign: string;
22252
22725
  /**
22253
- * Zodiac sign the planet is entering (new rashi transit).
22726
+ * Name of the sign being left, in the requested language, for display. Present only when lang is set to a language other than English.
22727
+ */
22728
+ fromSignLocalized?: string;
22729
+ /**
22730
+ * Zodiac sign the planet is entering (new rashi transit). Always English. Use toSignLocalized for anything a reader sees.
22254
22731
  */
22255
22732
  toSign: string;
22733
+ /**
22734
+ * Name of the sign being entered, in the requested language, for display. Present only when lang is set to a language other than English.
22735
+ */
22736
+ toSignLocalized?: string;
22256
22737
  /**
22257
22738
  * Date of the sign change (YYYY-MM-DD). Adjusted to requested timezone.
22258
22739
  */
@@ -22474,20 +22955,25 @@ export type PostVedicAstrologyParallelsResponse = PostVedicAstrologyParallelsRes
22474
22955
  export type PostVedicAstrologyParallelsMonthlyData = {
22475
22956
  body?: {
22476
22957
  /**
22477
- * Year for monthly parallel analysis (1900-2100).
22958
+ * Year for monthly parallel analysis (1900-2100). Defaults to the current year (UTC).
22478
22959
  */
22479
- year: number;
22960
+ year?: number;
22480
22961
  /**
22481
- * Month number (1-12) for parallel analysis.
22962
+ * Month number (1-12) for parallel analysis. Defaults to the current month (UTC).
22482
22963
  */
22483
- month: number;
22964
+ month?: number;
22484
22965
  /**
22485
22966
  * Timezone offset from UTC in hours. Output times are converted to this timezone. Defaults to 0 (UTC).
22486
22967
  */
22487
22968
  timezone?: number | string;
22488
22969
  };
22489
22970
  path?: never;
22490
- query?: never;
22971
+ query?: {
22972
+ /**
22973
+ * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
22974
+ */
22975
+ lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
22976
+ };
22491
22977
  url: '/vedic-astrology/parallels/monthly';
22492
22978
  };
22493
22979
 
@@ -22601,11 +23087,11 @@ export type PostVedicAstrologyParallelsMonthlyResponses = {
22601
23087
  */
22602
23088
  200: {
22603
23089
  /**
22604
- * Year of the parallel analysis.
23090
+ * Year of the parallel analysis. Echoes the year that was requested, or the current UTC year when it was omitted.
22605
23091
  */
22606
23092
  year: number;
22607
23093
  /**
22608
- * Month of the parallel analysis.
23094
+ * Month of the parallel analysis. Echoes the month that was requested, or the current UTC month when it was omitted.
22609
23095
  */
22610
23096
  month: number;
22611
23097
  /**
@@ -22613,13 +23099,21 @@ export type PostVedicAstrologyParallelsMonthlyResponses = {
22613
23099
  */
22614
23100
  events: Array<{
22615
23101
  /**
22616
- * First planet in the parallel or contraparallel pair.
23102
+ * First planet in the parallel or contraparallel pair. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use planet1Localized for anything a reader sees.
22617
23103
  */
22618
23104
  planet1: string;
22619
23105
  /**
22620
- * Second planet in the pair.
23106
+ * First planet name in the requested language, for display. Present only when lang is set to a language other than English, since in English it would repeat planet1 exactly.
23107
+ */
23108
+ planet1Localized?: string;
23109
+ /**
23110
+ * Second planet in the pair. Always English, whatever the lang parameter says. Use planet2Localized for anything a reader sees.
22621
23111
  */
22622
23112
  planet2: string;
23113
+ /**
23114
+ * Second planet name in the requested language, for display. Present only when lang is set to a language other than English.
23115
+ */
23116
+ planet2Localized?: string;
22623
23117
  /**
22624
23118
  * Parallel = same declination (acts like conjunction in strength). Contraparallel = opposite declination (acts like opposition).
22625
23119
  */