Western Astrology API reference

curl "https://roxyapi.com/api/v2/astrology/signs" \
  -H "X-API-Key: YOUR_KEY"

[
  {
    "id": "aries",
    "name": "Aries",
    "symbol": "♈",
    "element": "fire",
    "elementLocalized": "Fuego",
    "dates": {
      "start": "Mar 21",
      "end": "Apr 19"
    },
    "description": "Ambitious, independent, impatient"
  }
]

curl "https://roxyapi.com/api/v2/astrology/signs/aries" \
  -H "X-API-Key: YOUR_KEY"

{
  "id": "aries",
  "name": "Aries",
  "symbol": "♈",
  "symbolName": "The Ram",
  "element": "fire",
  "elementLocalized": "Fuego",
  "modality": "cardinal",
  "modalityLocalized": "Cardinal",
  "rulingPlanet": "Mars",
  "rulingPlanetLocalized": "Marte",
  "dates": {
    "start": "Mar 21",
    "end": "Apr 19"
  },
  "keywords": [
    "ambitious",
    "courageous"
  ],
  "description": {
    "short": "Ambitious, independent, impatient",
    "long": "Aries, the first sign in the zodiac, belongs to those born between March 21 and April 19. Aries are the trailblazers. Passionate and independent, an Aries will never do something just because everyone else is doing it. Competitive to the max, the best way to motivate an Aries is to turn something into a contest."
  },
  "famous": [
    "Leonardo da Vinci",
    "Lady Gaga"
  ],
  "strengths": [
    "You are the most courageous and ambitious sign, the leader of every pack.",
    "Your determination is unmatched when it comes to getting what you want."
  ],
  "motto": "I am.",
  "gifts": "Whether it is backpacking around the world, launching a business, or training for a marathon, once an Aries sets a goal they will achieve it. Rams never need a plus one: they love their own company.",
  "challenges": "The world according to an Aries makes so much sense that they have a hard time accepting alternative viewpoints. Slowing down is also tough, and to maintain relationships an Aries must learn to adapt to other ways of doing and seeing.",
  "weapon": "Strong, adamant, and forged in fire, it is fitting that the Aries secret weapon is iron, one of the strongest elements. Weld it, cast it, or temper it, and iron takes on a seemingly limitless range of shapes.",
  "compatibleSigns": [
    "Leo",
    "Sagittarius"
  ]
}

curl "https://roxyapi.com/api/v2/astrology/planet-meanings" \
  -H "X-API-Key: YOUR_KEY"

[
  {
    "id": "sun",
    "name": "Sun",
    "symbol": "☉",
    "tagline": "Self-awareness and ego",
    "category": "personal",
    "rulership": "Leo",
    "description": "The Sun represents your core identity, ego, and conscious will. It governs vitality, self-expression, and life purpose. Your Sun sign is the foundation of your natal chart."
  }
]

curl "https://roxyapi.com/api/v2/astrology/planet-meanings/sun" \
  -H "X-API-Key: YOUR_KEY"

{
  "id": "sun",
  "name": "Sun",
  "symbol": "☉",
  "tagline": "Self-awareness and ego",
  "category": "personal",
  "temperature": "Hot",
  "orbit": "365.25 days",
  "retrograde": false,
  "rulership": "Leo",
  "detriment": "Aquarius",
  "exaltation": "Aries",
  "exultation": "Aries",
  "fall": "Libra",
  "keywords": {
    "positive": [
      "Vitality",
      "Confidence"
    ],
    "negative": [
      "Ego",
      "Arrogance"
    ]
  },
  "description": {
    "short": "The Sun represents your core identity, ego, and conscious will. It governs vitality, self-expression, and life purpose. Your Sun sign is the foundation of your natal chart, shaping how you assert yourself and pursue your goals.",
    "long": "The Sun traveling through the zodiac creates what we think of as our astrological year. In the natal chart, the Sun represents who we are and who we strive to be. Unlike the Moon, which represents our emotional responses, the Sun stands for our most rational selves and the way we interact with the world on a daily basis. Approximately every 30 days the Sun transits to a new sign and brings a fresh sense of perspective."
  }
}

curl -X POST "https://roxyapi.com/api/v2/astrology/natal-chart" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-07-15","time":"14:30:00","latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'

{
  "birthDetails": {
    "date": "1990-07-15",
    "time": "14:30:00",
    "latitude": 40.7128,
    "longitude": -74.006,
    "timezone": -4
  },
  "planets": [
    {
      "name": "Sun",
      "nameLocalized": "Sol",
      "longitude": 112.45,
      "latitude": 0.01,
      "sign": "Cancer",
      "signLocalized": "Cáncer",
      "degree": 22.45,
      "house": 7,
      "speed": 0.9571,
      "isRetrograde": false,
      "dignity": "domicile",
      "interpretation": {
        "summary": "Your Sun in Cancer in The Seventh House reveals how you express self-awareness and ego in the realm of partnerships.",
        "detailed": "Sun represents self-awareness and ego. In Cancer, this energy becomes nurturing, protective, emotionally intelligent...",
        "keywords": [
          "Nurturing",
          "Protective"
        ]
      }
    }
  ],
  "houses": [
    {
      "number": 1,
      "longitude": 45.32,
      "sign": "Taurus",
      "signLocalized": "Tauro",
      "degree": 15.32
    }
  ],
  "houseSystem": "placidus",
  "aspects": [
    {
      "planet1": "Sun",
      "planet1Localized": "Sol",
      "planet2": "Moon",
      "planet2Localized": "Luna",
      "type": "TRINE",
      "typeLocalized": "Trígono",
      "angle": 120,
      "orb": 2.5,
      "isApplying": true,
      "strength": 75,
      "interpretation": "harmonious",
      "aspectInterpretation": {
        "summary": "Your Sun forms a very strong conjunction (0) with Jupiter, currently separating (weakening). This neutral aspect highlights themes of blend, difficult, and unite.",
        "keywords": [
          "blend",
          "difficult"
        ]
      }
    }
  ],
  "patterns": [
    {
      "kind": "GRAND_TRINE",
      "name": "Grand Trine",
      "planets": [
        "Sun",
        "Moon"
      ],
      "apex": "Mars",
      "element": "water",
      "modality": "cardinal",
      "dissociate": false,
      "tightness": 78,
      "interpretation": "Grand Trine in Water signs binds Sun, Moon, and Mars in flowing harmony, gifts that come easily but ask to be activated.",
      "interpretationKey": "aspectPattern.grandTrine",
      "interpretationVars": {
        "element": "Water",
        "planet1": "Sun",
        "planet2": "Moon",
        "planet3": "Mars"
      }
    }
  ],
  "aspectsInterpretation": {
    "summary": "Your chart contains 15 aspects: 8 harmonious, 5 challenging, and 2 neutral. This creates a harmonious overall pattern.",
    "dominant": "harmonious",
    "harmonious": 8,
    "challenging": 5,
    "neutral": 2
  },
  "ascendant": {
    "sign": "Taurus",
    "signLocalized": "Tauro",
    "degree": 15.32,
    "longitude": 45.32
  },
  "midheaven": {
    "sign": "Aquarius",
    "signLocalized": "Acuario",
    "degree": 8.76,
    "longitude": 308.76
  },
  "partOfFortune": {
    "sign": "Aries",
    "degree": 27.24,
    "longitude": 27.24,
    "house": 8,
    "sect": "night",
    "signLocalized": "Leo"
  },
  "vertex": {
    "sign": "Virgo",
    "degree": 12.9,
    "longitude": 162.9,
    "house": 6,
    "signLocalized": "Cáncer"
  },
  "summary": {
    "dominantElement": "Water",
    "dominantElementLocalized": "Agua",
    "dominantModality": "Cardinal",
    "dominantModalityLocalized": "Cardinal",
    "retrogradePlanets": [
      "Mercury",
      "Saturn"
    ],
    "retrogradePlanetsLocalized": [
      "Mercurio",
      "Saturno"
    ],
    "elementDistribution": {
      "Fire": 2,
      "Earth": 3,
      "Air": 1,
      "Water": 4
    },
    "modalityDistribution": {
      "Cardinal": 4,
      "Fixed": 3,
      "Mutable": 3
    }
  }
}

curl -X POST "https://roxyapi.com/api/v2/astrology/planets" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2025-12-18","time":"12:00:00","latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'

{
  "planets": [
    {
      "name": "Sun",
      "longitude": 267.45,
      "latitude": 0.01,
      "sign": "Sagittarius",
      "degree": 27.45,
      "speed": 0.9571,
      "isRetrograde": false,
      "symbol": "☉",
      "tagline": "Self-awareness & ego",
      "description": "The Sun represents your core identity, ego, and conscious will. It governs vitality, self-expression, and life purpose.",
      "keywords": [
        "Identity",
        "Vitality"
      ],
      "interpretation": {
        "summary": "Sun in Sagittarius (Archer) brings adventurous, optimistic, independent energy to the themes of self-awareness and ego. This placement gives your Sun expression a distinctly Sagittarius character, shaping how you navigate these areas of life.",
        "planetMeaning": "The Sun represents your core identity, ego, and conscious will. It governs vitality, self-expression, and life purpose.",
        "signExpression": "Independent and strong-willed, Sagittarius personalities are all about going off the beaten path. Sagittarius is not afraid to step away from the pack, and is a natural born leader who goes after what they want, regardless of what other people think.",
        "keywords": [
          "active",
          "awareness"
        ]
      }
    }
  ]
}

curl -X POST "https://roxyapi.com/api/v2/astrology/planets/monthly" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026,"month":8}'

{
  "year": 2026,
  "month": 8,
  "days": [
    {
      "date": "2026-08-01",
      "positions": [
        {
          "planet": "Mars",
          "planetLocalized": "Marte",
          "longitude": 83.4062,
          "sign": "Gemini",
          "signLocalized": "Geminis",
          "degreeInSign": 23.4062,
          "isRetrograde": false
        }
      ]
    }
  ]
}

curl "https://roxyapi.com/api/v2/astrology/moon-phase/current" \
  -H "X-API-Key: YOUR_KEY"

{
  "date": "2025-12-18",
  "phase": "Waxing Gibbous Moon",
  "illumination": 78.5,
  "age": 10.25,
  "sign": "Pisces",
  "degree": 15.42,
  "distance": 384400,
  "meaning": {
    "name": "Waxing Gibbous Moon",
    "symbol": "🌔",
    "description": "The waxing gibbous moon is there when we are close to our goals...",
    "keywords": [
      "assess",
      "refine"
    ],
    "energy": "waxing",
    "illumination": "50-100% (Nearly Full)"
  }
}

curl "https://roxyapi.com/api/v2/astrology/moon-phase/upcoming" \
  -H "X-API-Key: YOUR_KEY"

{
  "phases": [
    {
      "date": "2025-12-26",
      "phase": "New Moon"
    }
  ]
}

curl "https://roxyapi.com/api/v2/astrology/moon-phase/calendar/2026/3" \
  -H "X-API-Key: YOUR_KEY"

{
  "year": 2025,
  "month": 12,
  "monthName": "December",
  "calendar": [
    {
      "date": "2025-12-01",
      "phase": "Waxing Crescent Moon",
      "illumination": 5.2
    }
  ]
}

curl -X POST "https://roxyapi.com/api/v2/astrology/synastry" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"person1":{"date":"1990-07-15","time":"14:30:00","latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York","nodeType":"true","name":"Alex"},"person2":{"date":"1990-07-15","time":"14:30:00","latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York","nodeType":"true","name":"Alex"}}'

{
  "person1": {
    "name": "Alex",
    "ascendant": {
      "sign": "Taurus",
      "signLocalized": "Tauro",
      "degree": 15.32
    },
    "sunSign": "Cancer",
    "sunSignLocalized": "Cáncer",
    "moonSign": "Pisces",
    "moonSignLocalized": "Piscis",
    "planets": [
      {
        "name": "Sun",
        "nameLocalized": "Sol",
        "longitude": 114.52,
        "sign": "Cancer",
        "signLocalized": "Cáncer",
        "degree": 24.52,
        "house": 3,
        "houseInOtherChart": 7,
        "isRetrograde": false
      }
    ]
  },
  "person2": {
    "name": "Jordan",
    "ascendant": {
      "sign": "Virgo",
      "signLocalized": "Virgo",
      "degree": 22.18
    },
    "sunSign": "Pisces",
    "sunSignLocalized": "Piscis",
    "moonSign": "Scorpio",
    "moonSignLocalized": "Escorpio",
    "planets": [
      {
        "name": "Sun",
        "nameLocalized": "Sol",
        "longitude": 114.52,
        "sign": "Cancer",
        "signLocalized": "Cáncer",
        "degree": 24.52,
        "house": 3,
        "houseInOtherChart": 7,
        "isRetrograde": false
      }
    ]
  },
  "compatibilityScore": 78,
  "interAspects": [
    {
      "planet1": "Venus",
      "planet1Localized": "Venus",
      "planet2": "Mars",
      "planet2Localized": "Marte",
      "type": "TRINE",
      "typeLocalized": "Trígono",
      "angle": 120,
      "orb": 2.5,
      "strength": 75,
      "interpretation": "harmonious",
      "meaning": {
        "name": "Trine",
        "description": {
          "short": "Planets in trine support each other. Trines, by nature, are accepting. They allow us to accept others, ourselves, and situations. The talents that trines offer a native are so natural that they are almost unconscious.",
          "long": "These talents are second nature and completely natural. So, for example, if a chart has Venus trine Neptune, the native may be poetic, romantic, or artistic, and may easily accept a romantic partner for who they are."
        },
        "keywords": [
          "accept",
          "accepting"
        ],
        "nature": "harmonious",
        "relationshipContext": "Strong physical and romantic attraction. Natural chemistry and mutual desire create magnetic pull between partners."
      }
    }
  ],
  "summary": {
    "total": 24,
    "harmonious": 12,
    "challenging": 8,
    "neutral": 4,
    "byType": {
      "TRINE": 5,
      "SEXTILE": 7,
      "SQUARE": 6,
      "OPPOSITION": 2
    }
  },
  "analysis": {
    "overall": "This relationship shows strong compatibility with genuine potential for lasting partnership. Most interactions feel natural and supportive, with a healthy mix of comfort and growth. Where challenges arise, both partners have the tools to work through them constructively.",
    "strengths": [
      "More harmonious aspects than challenging ones create a supportive foundation.",
      "Harmonious Moon aspects indicate emotional understanding and nurturing."
    ],
    "challenges": [
      "Challenging Sun aspects may create ego conflicts or competing life directions.",
      "Challenging Mars aspects may bring tension, arguments, or competing desires."
    ]
  }
}

curl -X POST "https://roxyapi.com/api/v2/astrology/houses" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-07-15","time":"14:30:00","latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'

{
  "date": "1990-07-15",
  "time": "14:30:00",
  "latitude": 40.7128,
  "longitude": -74.006,
  "timezone": -4,
  "houseSystem": "placidus",
  "ascendant": {
    "sign": "Taurus",
    "degree": 15.32,
    "longitude": 45.32
  },
  "midheaven": {
    "sign": "Aquarius",
    "degree": 8.76,
    "longitude": 308.76
  },
  "houses": [
    {
      "number": 1,
      "longitude": 45.32,
      "sign": "Taurus",
      "degree": 15.32
    }
  ],
  "comparison": {
    "whole-sign": {
      "houses": [
        {
          "number": 1,
          "longitude": 210,
          "sign": "Scorpio",
          "degree": 0
        },
        {
          "number": 2,
          "longitude": 240,
          "sign": "Sagittarius",
          "degree": 0
        }
      ]
    }
  }
}

curl -X POST "https://roxyapi.com/api/v2/astrology/aspects" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-07-15","time":"14:30:00","timezone":"America/New_York"}'

{
  "date": "1990-07-15",
  "time": "14:30:00",
  "timezone": -4,
  "aspectsFound": 12,
  "aspects": [
    {
      "planet1": "Sun",
      "planet1Localized": "Sol",
      "planet2": "Moon",
      "planet2Localized": "Luna",
      "type": "TRINE",
      "typeLocalized": "Trígono",
      "angle": 120,
      "orb": 2.5,
      "isApplying": true,
      "strength": 75,
      "interpretation": "harmonious",
      "meaning": {
        "name": "Trine",
        "description": {
          "short": "Planets in trine support each other. Trines, by nature, are accepting. They allow us to accept others, ourselves, and situations. The talents that trines offer a native are so natural that they are almost unconscious.",
          "long": "These talents are second nature and completely natural. So, for example, if a chart has Venus trine Neptune, the native may be poetic, romantic, or artistic, and may easily accept a romantic partner for who they are. With Venus square Neptune the same qualities exist, but expressing them takes conscious work rather than coming naturally."
        },
        "keywords": [
          "accept",
          "accepting"
        ],
        "nature": "harmonious"
      }
    }
  ],
  "patterns": [
    {
      "kind": "GRAND_TRINE",
      "name": "Grand Trine",
      "planets": [
        "Sun",
        "Moon"
      ],
      "apex": "Mars",
      "element": "water",
      "modality": "cardinal",
      "dissociate": false,
      "tightness": 78,
      "interpretation": "Grand Trine in Water signs binds Sun, Moon, and Mars in flowing harmony, gifts that come easily but ask to be activated.",
      "interpretationKey": "aspectPattern.grandTrine",
      "interpretationVars": {
        "element": "Water",
        "planet1": "Sun",
        "planet2": "Moon",
        "planet3": "Mars"
      }
    }
  ],
  "summary": {
    "totalAspects": 12,
    "harmonious": 7,
    "challenging": 4,
    "neutral": 1,
    "byType": {
      "CONJUNCTION": 2,
      "TRINE": 3,
      "SQUARE": 2,
      "SEXTILE": 2,
      "OPPOSITION": 1
    }
  }
}

curl -X POST "https://roxyapi.com/api/v2/astrology/aspects/monthly" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026,"month":3,"timezone":"America/New_York","nodeType":"true"}'

{
  "year": 2026,
  "month": 3,
  "timezone": -4,
  "events": [
    {
      "planet1": "Mars",
      "planet1Localized": "Marte",
      "planet2": "Saturn",
      "planet2Localized": "Saturno",
      "aspect": "square",
      "aspectLocalized": "Cuadratura",
      "nature": "challenging",
      "natureLocalized": "desafiante",
      "date": "2026-03-15",
      "time": "14:32",
      "datetime": "2026-03-15T14:32",
      "orb": 0.02,
      "separation": 89.98,
      "planet1Longitude": 15.4821,
      "planet2Longitude": 105.4632
    }
  ]
}

curl -X POST "https://roxyapi.com/api/v2/astrology/aspect-patterns" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-07-15","time":"14:30:00","latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'

{
  "patterns": [
    {
      "kind": "GRAND_TRINE",
      "name": "Grand Trine",
      "planets": [
        "Sun",
        "Moon"
      ],
      "apex": "Mars",
      "element": "water",
      "modality": "cardinal",
      "dissociate": false,
      "tightness": 78,
      "interpretation": "Grand Trine in Water signs binds Sun, Moon, and Mars in flowing harmony, gifts that come easily but ask to be activated.",
      "interpretationKey": "aspectPattern.grandTrine",
      "interpretationVars": {
        "element": "Water",
        "planet1": "Sun",
        "planet2": "Moon",
        "planet3": "Mars"
      }
    }
  ],
  "total": 3,
  "options": {
    "strictOrbs": false,
    "include": []
  }
}

curl -X POST "https://roxyapi.com/api/v2/astrology/transits" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2025-12-19","time":"12:00:00","timezone":0,"nodeType":"true"}'

{
  "transitDate": "2025-12-19",
  "transitTime": "12:00:00",
  "timezone": 0,
  "transitPlanets": [
    {
      "name": "Sun",
      "nameLocalized": "Sol",
      "longitude": 267.45,
      "latitude": 0.01,
      "sign": "Sagittarius",
      "signLocalized": "Sagitario",
      "degree": 27.45,
      "speed": 0.9571,
      "isRetrograde": false
    }
  ],
  "transitAspects": [
    {
      "transitPlanet": "Sun",
      "transitPlanetLocalized": "Sol",
      "natalPlanet": "Mars",
      "natalPlanetLocalized": "Marte",
      "type": "CONJUNCTION",
      "typeLocalized": "Conjunción",
      "angle": 0,
      "orb": 1.2,
      "isApplying": true,
      "strength": 88,
      "nature": "neutral",
      "interpretation": {
        "summary": "Sun activates your natal Mars neutrally",
        "timing": "Active for a few days",
        "impact": "Self-awareness and ego merges with Assertiveness and aggression. Intensifies this energy.",
        "guidance": "Pay attention to how this combination manifests. Strong energy requires conscious direction.",
        "keywords": [
          "blend",
          "difficult"
        ]
      }
    }
  ],
  "summary": {
    "totalAspects": 8,
    "harmonious": 4,
    "challenging": 3,
    "neutral": 1
  }
}

curl -X POST "https://roxyapi.com/api/v2/astrology/transits/monthly" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026,"month":3,"timezone":"America/New_York","nodeType":"true"}'

{
  "year": 2026,
  "month": 3,
  "timezone": -4,
  "startingPositions": [
    {
      "planet": "Sun",
      "planetLocalized": "Sol",
      "sign": "Aquarius",
      "signLocalized": "Acuario",
      "longitude": 311.4823
    }
  ],
  "transitEvents": [
    {
      "planet": "Venus",
      "planetLocalized": "Venus",
      "fromSign": "Aquarius",
      "fromSignLocalized": "Acuario",
      "toSign": "Pisces",
      "toSignLocalized": "Piscis",
      "date": "2026-03-02",
      "time": "00:56",
      "datetime": "2026-03-02T00:56",
      "isRetrograde": false
    }
  ]
}

curl -X POST "https://roxyapi.com/api/v2/astrology/transit-aspects" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"natalChart":{"date":"1990-07-15","time":"14:30:00","latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York","nodeType":"true"}}'

{
  "transitDate": "2026-02-03 12:00:00",
  "houseSystem": "placidus",
  "houses": [
    {
      "number": 1,
      "longitude": 45.32,
      "sign": "Taurus",
      "degree": 15.32,
      "signLocalized": "Tauro"
    }
  ],
  "ascendant": {
    "sign": "Taurus",
    "signLocalized": "Tauro",
    "degree": 15.32,
    "longitude": 45.32
  },
  "transitPlanets": [
    {
      "name": "Sun",
      "longitude": 112.45,
      "latitude": 0.01,
      "sign": "Cancer",
      "degree": 22.45,
      "house": 10,
      "speed": 0.9571,
      "isRetrograde": false,
      "nameLocalized": "Sol",
      "signLocalized": "Cáncer"
    }
  ],
  "natalPlanets": [
    {
      "name": "Sun",
      "longitude": 112.45,
      "latitude": 0.01,
      "sign": "Cancer",
      "degree": 22.45,
      "house": 7,
      "speed": 0.9571,
      "isRetrograde": false,
      "nameLocalized": "Sol",
      "signLocalized": "Cáncer"
    }
  ],
  "aspects": [
    {
      "planet1": "Sun",
      "planet2": "Moon",
      "type": "TRINE",
      "angle": 120,
      "orb": 2.5,
      "isApplying": true,
      "strength": 75,
      "interpretation": "harmonious",
      "planet1Localized": "Sol",
      "planet2Localized": "Luna",
      "typeLocalized": "Trígono",
      "transitInterpretation": {
        "summary": "Sun supports your natal Moon harmoniously",
        "timing": "Active for a few days",
        "impact": "Self-awareness and ego flows easily with Inner emotional life. Opportunities arise naturally in this area.",
        "guidance": "Take advantage of this supportive energy. Things flow easily, so act on opportunities.",
        "keywords": [
          "accept",
          "accepting"
        ]
      }
    }
  ],
  "summary": {
    "total": 12,
    "harmonious": 5,
    "challenging": 4,
    "neutral": 3,
    "byType": {
      "CONJUNCTION": 2,
      "TRINE": 3,
      "SQUARE": 2,
      "SEXTILE": 1
    }
  }
}

curl -X POST "https://roxyapi.com/api/v2/astrology/parallels/monthly" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026,"month":3,"timezone":"America/New_York","orb":1.5}'

{
  "year": 2026,
  "month": 3,
  "timezone": -4,
  "orb": 1.5,
  "events": [
    {
      "planet1": "Venus",
      "planet1Localized": "Venus",
      "planet2": "Saturn",
      "planet2Localized": "Saturno",
      "type": "parallel",
      "date": "2026-03-14",
      "time": "09:42",
      "datetime": "2026-03-14T09:42",
      "orb": 0.01,
      "declination1": -12.4183,
      "declination2": -12.4102
    }
  ]
}

curl -X POST "https://roxyapi.com/api/v2/astrology/ecliptic-crossings" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026}'

{
  "year": 2026,
  "timezone": -4,
  "events": [
    {
      "planet": "Venus",
      "planetLocalized": "Venus",
      "direction": "ascending",
      "date": "2026-03-14",
      "time": "09:42",
      "datetime": "2026-03-14T09:42",
      "longitude": 24.7831,
      "sign": "Aries",
      "signLocalized": "Aries"
    }
  ]
}

curl -X POST "https://roxyapi.com/api/v2/astrology/solar-return" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birthDate":"1990-07-15","birthTime":"14:30:00","returnYear":2026,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'

{
  "birthDate": "1990-07-15",
  "solarReturnDate": "2026-07-15T08:42:00",
  "solarReturnYear": 2026,
  "location": {
    "latitude": 40.7128,
    "longitude": -74.006,
    "timezone": -4
  },
  "chart": {
    "birthDetails": {
      "date": "1990-07-15",
      "time": "14:30:00",
      "latitude": 40.7128,
      "longitude": -74.006,
      "timezone": -4
    },
    "planets": [
      {
        "name": "Sun",
        "longitude": 112.45,
        "latitude": 0.01,
        "sign": "Cancer",
        "degree": 22.45,
        "house": 7,
        "speed": 0.9571,
        "isRetrograde": false
      }
    ],
    "houses": [
      {
        "number": 1,
        "longitude": 45.32,
        "sign": "Taurus",
        "degree": 15.32
      }
    ],
    "houseSystem": "placidus",
    "aspects": [
      {
        "planet1": "Sun",
        "planet2": "Moon",
        "type": "TRINE",
        "angle": 120,
        "orb": 2.5,
        "isApplying": true,
        "strength": 75,
        "interpretation": "harmonious"
      }
    ],
    "partOfFortune": {
      "sign": "Aries",
      "degree": 27.24,
      "longitude": 27.24,
      "house": 8,
      "sect": "night"
    },
    "vertex": {
      "sign": "Virgo",
      "degree": 12.9,
      "longitude": 162.9,
      "house": 6
    }
  },
  "natalSunPosition": {
    "longitude": 112.45,
    "sign": "Cancer",
    "degree": 22.45
  },
  "interpretation": {
    "summary": "Solar Return chart for your 2026 birthday year. This chart is cast for the exact moment the Sun returns to its natal position, symbolizing a new solar year.",
    "purpose": "Solar return charts are used for annual forecasting. The chart reveals themes, opportunities, and challenges for the year ahead from birthday to birthday. Focus on the Ascendant sign, angular planets, and aspects to natal positions.",
    "keyThemes": [
      "Annual themes and life direction",
      "Career and public life developments"
    ]
  }
}

curl -X POST "https://roxyapi.com/api/v2/astrology/lunar-return" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birthDate":"1990-07-15","birthTime":"14:30:00","returnDate":"2026-02-12","latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'

{
  "birthDate": "1990-07-15",
  "lunarReturnDate": "2026-02-13T19:22:00",
  "location": {
    "latitude": 40.7128,
    "longitude": -74.006,
    "timezone": -4
  },
  "chart": {
    "birthDetails": {
      "date": "1990-07-15",
      "time": "14:30:00",
      "latitude": 40.7128,
      "longitude": -74.006,
      "timezone": -4
    },
    "planets": [
      {
        "name": "Sun",
        "longitude": 112.45,
        "latitude": 0.01,
        "sign": "Cancer",
        "degree": 22.45,
        "house": 7,
        "speed": 0.9571,
        "isRetrograde": false
      }
    ],
    "houses": [
      {
        "number": 1,
        "longitude": 45.32,
        "sign": "Taurus",
        "degree": 15.32
      }
    ],
    "houseSystem": "placidus",
    "aspects": [
      {
        "planet1": "Sun",
        "planet2": "Moon",
        "type": "TRINE",
        "angle": 120,
        "orb": 2.5,
        "isApplying": true,
        "strength": 75,
        "interpretation": "harmonious"
      }
    ],
    "partOfFortune": {
      "sign": "Aries",
      "degree": 27.24,
      "longitude": 27.24,
      "house": 8,
      "sect": "night"
    },
    "vertex": {
      "sign": "Virgo",
      "degree": 12.9,
      "longitude": 162.9,
      "house": 6
    }
  },
  "natalMoonPosition": {
    "longitude": 228.72,
    "sign": "Scorpio",
    "degree": 18.72
  },
  "interpretation": {
    "summary": "Lunar Return chart for this month. This chart is cast for the exact moment the Moon returns to its natal position, occurring approximately every 27-28 days.",
    "purpose": "Lunar return charts are used for monthly forecasting. The chart reveals themes, emotional patterns, and focus areas for the coming month. Pay attention to the Moon house position and aspects to other planets for emotional tone and priorities.",
    "keyThemes": [
      "Emotional patterns and inner needs",
      "Domestic and family matters"
    ]
  }
}

curl -X POST "https://roxyapi.com/api/v2/astrology/composite-chart" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"person1":{"date":"1990-07-15","time":"14:30:00","latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York","nodeType":"true"},"person2":{"date":"1990-07-15","time":"14:30:00","latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York","nodeType":"true"}}'

{
  "person1": {
    "date": "1990-07-15",
    "time": "14:30:00",
    "latitude": 40.7128,
    "longitude": -74.006,
    "timezone": -4
  },
  "person2": {
    "date": "1990-07-15",
    "time": "14:30:00",
    "latitude": 40.7128,
    "longitude": -74.006,
    "timezone": -4
  },
  "compositePlanets": [
    {
      "name": "Sun",
      "longitude": 112.45,
      "latitude": 0.01,
      "sign": "Cancer",
      "degree": 22.45,
      "house": 7,
      "speed": 0.9571,
      "isRetrograde": false,
      "compositeInterpretation": {
        "summary": "Sun in Cancer (Crab) brings intuitive, nurturing, protective energy to the themes of self-awareness and ego. This placement gives your Sun expression a distinctly Cancer character, shaping how you navigate these areas of life.",
        "relationshipMeaning": "The composite Sun in cancer represents the core identity and purpose of your relationship. This is what you create together and how others see you as a couple.",
        "keywords": [
          "active",
          "awareness"
        ]
      }
    }
  ],
  "compositeHouses": [
    {
      "number": 1,
      "sign": "Gemini",
      "degree": 15.32,
      "longitude": 75.32
    }
  ],
  "compositeAscendant": {
    "sign": "Gemini",
    "degree": 15.32,
    "longitude": 75.32
  },
  "compositeMidheaven": {
    "sign": "Aquarius",
    "degree": 8.76,
    "longitude": 308.76
  },
  "aspects": [
    {
      "planet1": "Sun",
      "planet2": "Moon",
      "type": "TRINE",
      "angle": 120,
      "orb": 2.5,
      "isApplying": true,
      "strength": 75,
      "interpretation": "harmonious"
    }
  ],
  "interpretation": {
    "summary": "This relationship has strong harmonious energy with natural flow and compatibility.",
    "strengths": [
      "The composite Sun in cancer represents the core identity and purpose of your relationship. This is what you create together and how others see you as a couple.",
      "The composite Moon in aquarius shows your emotional bond and how you nurture each other. This reveals your shared feelings and domestic life together."
    ],
    "challenges": [
      "More challenging aspects than harmonious - requires work and understanding."
    ]
  }
}

curl -X POST "https://roxyapi.com/api/v2/astrology/compatibility-score" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"person1":{"date":"1990-07-15","time":"14:30:00","latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York","nodeType":"true"},"person2":{"date":"1990-07-15","time":"14:30:00","latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York","nodeType":"true"}}'