Astrology API, what to build and how to call it

{
  "sign": "Aries",
  "date": "2026-04-23",
  "overview": "The Sun forms a semi-sextile to Neptune today, in your second house of finances and personal values, where earnings and belongings get counted, and their worth gets decided. Two different jobs are being done here, one by the will and one by the pull toward what is not literal. Adjacent things rarely understand each other, and the gap shows in the detail rather than the outline.",
  "love": "The Moon leaves Cancer today, and it registers in your fifth house of romance, creativity, and joy. Nothing at this speed lasts long enough to be a plan, which is most of the use of it.",
  "career": "Mars energizes your first house, fueling personal drive and initiative. You come across as bold and decisive in every interaction. Take the lead on projects that require courage. Nothing is forcing a move at work, which makes this a good stretch for the work nobody is watching.",
  "health": "Watch your first house for this one, because the Sun forms a semi-sextile to Neptune today. Neither the will nor the pull toward what is not literal is the whole of what is happening. The two have almost nothing in common, and the mismatch registers as a small steady irritation.",
  "finance": "Watch your second house for this one, because the Sun forms a semi-sextile to Neptune today. The one wants to be recognized for what it has actually done. The other wants the boundary between things to matter less. The two have almost nothing in common, and the mismatch registers as a small steady irritation.",
  "advice": "The Sun forms a semi-sextile to Neptune today, sitting in your second house. Start with an honest figure rather than a comfortable one.",
  "column": "In your second house of finances and personal values, the thing to know is that the Sun forms a semi-sextile to Neptune today. The will and the pull toward what is not literal are not asking for the same thing. Something sits slightly out of true, too small to name and too persistent to ignore. Running with that, the Moon leaves Cancer today. This is your fourth house, where the household sits, along with everything it inherited from before. Small decisions get made in this register, and they get made fast. Translated into something doable, this comes to the ground under the arrangement checked before more weight goes onto it. Settle on an honest figure rather than a comfortable one.",
  "events": [
    {
      "type": "aspect",
      "at": "2026-04-23T03:32:30Z",
      "bodies": [
        "Sun",
        "Neptune"
      ],
      "aspect": "semi-sextile",
      "house": 2,
      "through": "2026-04-26T08:04:33Z"
    },
    {
      "type": "sign-ingress",
      "at": "2026-04-23T19:40:39Z",
      "bodies": [
        "Moon"
      ],
      "sign": "leo",
      "house": 5,
      "through": "2026-04-26T01:04:22Z"
    }
  ],
  "luckyNumber": 9,
  "luckyColor": "Red",
  "compatibleSigns": [
    "Leo",
    "Sagittarius",
    "Gemini"
  ],
  "activeTransits": [
    "Sun in Taurus (2nd house of finances and personal values)",
    "Moon in Cancer (4th house of home and emotional foundations)",
    "Mercury in Aries (1st house of identity and self-expression)",
    "Venus in Taurus (2nd house of finances and personal values)",
    "Mars in Aries (1st house of identity and self-expression)",
    "Jupiter in Cancer (4th house of home and emotional foundations)",
    "Saturn in Aries (1st house of identity and self-expression)"
  ],
  "moonSign": "Cancer",
  "moonPhase": "Waxing Crescent Moon",
  "energyRating": 7
}

npm install @roxyapi/ui-react

'use client';
import { RoxyHoroscopeCard, type RoxyHoroscopeCardProps } from '@roxyapi/ui-react';
import { useState } from 'react';

export function DailyHoroscope() {
  const [data, setData] = useState<RoxyHoroscopeCardProps['data']>(undefined);

  async function load(sign: string) {
    const res = await fetch(`/api/horoscope?sign=${sign}`); // your backend route
    setData(await res.json());
  }

  if (!data) return <button onClick={() => load('aries')}>Read the Aries forecast</button>;

  return <RoxyHoroscopeCard data={data} period="daily" />;
}

// app/api/horoscope/route.ts (server side, holds the key)
import { createRoxy } from '@roxyapi/sdk';

const roxy = createRoxy(process.env.ROXY_API_KEY!);

export async function GET(req: Request) {
  const sign = new URL(req.url).searchParams.get('sign') ?? 'aries';
  const { data } = await roxy.astrology.getDailyHoroscope({ path: { sign } });
  return Response.json(data);
}

curl -X POST https://roxyapi.com/api/v2/astrology/natal-chart \
  -H "X-API-Key: $ROXY_API_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"
  }'

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