# Agent Task Cheatsheet

One-line semantics for the most-reached-for endpoints, grouped by API domain. Read this first when an agent needs a starting point. Full request and response schemas live in each per-product OpenAPI spec at `/api/v2/{slug}/openapi.json`.

## Astrology

- `POST /astrology/natal-chart` — Western birth chart with planets, houses, aspects, ascendant, midheaven.
- `GET /astrology/horoscope/{sign}/daily` — Daily horoscope. Also `/weekly` and `/monthly` variants.
- `POST /astrology/synastry` — Inter-chart aspect analysis between two people.
- `POST /astrology/compatibility-score` — Percent plus category breakdowns and archetype.
- `POST /astrology/transits` — Current sky. Pass optional `natalChart` for personalized aspects.
- `GET /astrology/moon-phase/current` — Current moon phase, illumination, sign.

### TypeScript SDK example

```typescript
roxy.astrology.generateNatalChart({ body: { date: '1990-06-15', time: '14:30:00', latitude: 40.7128, longitude: -74.006, timezone: -5 } })
```

### Python SDK example

```python
roxy.astrology.generate_natal_chart(date="1990-06-15", time="14:30:00", latitude=40.7128, longitude=-74.006, timezone=-5)
```

## Vedic

- `POST /vedic-astrology/birth-chart` — Kundli with twelve rashi houses, planet placements, interpretations.
- `POST /vedic-astrology/panchang/detailed` — Daily panchang with rahu kaal, muhurtas, gulika, chandrabalam, tarabalam.
- `POST /vedic-astrology/panchang/basic` — Tithi, nakshatra, yoga, karana.
- `POST /vedic-astrology/panchang/choghadiya` — Eight day and eight night electional periods.
- `POST /vedic-astrology/dasha/current` — Current Mahadasha, Antardasha, Pratyantardasha.
- `POST /vedic-astrology/dasha/major` — Full 120-year Vimshottari timeline.
- `POST /vedic-astrology/dosha/manglik` — Mangal Dosha check.
- `POST /vedic-astrology/dosha/kalsarpa` — Kaal Sarp Dosha check.
- `POST /vedic-astrology/dosha/sadhesati` — Sade Sati (Saturn transit) check.
- `POST /vedic-astrology/compatibility` — Guna Milan (36-point Ashtakoota matching).
- `POST /vedic-astrology/navamsa` — D9 chart.
- `POST /vedic-astrology/kp/chart` — KP chart with cusps, planets, sub-lords.
- `POST /vedic-astrology/kp/planets` — KP planets with sub-lord and sub-sub-lord.
- `POST /vedic-astrology/kp/ruling-planets` — KP ruling planets for horary.
- `GET /vedic-astrology/nakshatras/{id}` — Single nakshatra detail (e.g. `ashwini`, `pushya`).

### TypeScript SDK example

```typescript
roxy.vedicAstrology.computeBirthChart({ body: { date: '1990-06-15', time: '14:30:00', latitude: 28.6139, longitude: 77.2090, timezone: 'Asia/Kolkata' } })
```

### Python SDK example

```python
roxy.vedic_astrology.compute_birth_chart(date="1990-06-15", time="14:30:00", latitude=28.6139, longitude=77.209, timezone="Asia/Kolkata")
```

## Numerology

- `POST /numerology/life-path` — Pythagorean life path with master-number (11, 22, 33) and karmic-debt detection.
- `POST /numerology/chart` — Full profile: life path, expression, soul urge, personality, birth day, maturity.
- `POST /numerology/compatibility` — Couple matching by life-path / expression / soul urge. No birth time needed.
- `POST /numerology/personal-year` — Annual forecast from birthdate plus target year.
- `POST /numerology/expression` — Name-based destiny number.

### TypeScript SDK example

```typescript
roxy.numerology.computeLifePath({ body: { year: 1990, month: 6, day: 15 } })
```

### Python SDK example

```python
roxy.numerology.compute_life_path(year=1990, month=6, day=15)
```

## Tarot

- `POST /tarot/daily` — Seeded daily card.
- `POST /tarot/draw` — Custom draw of N cards (1-78).
- `POST /tarot/spreads/three-card` — Past / present / future.
- `POST /tarot/spreads/celtic-cross` — Ten-position spread.
- `POST /tarot/yes-no` — One-question, one-card reading.
- `POST /tarot/spreads/love` — Five-position relationship spread.
- `GET /tarot/cards` — 78-card catalog.
- `GET /tarot/cards/{id}` — Card detail with upright, reversed, and life-area meanings.

### TypeScript SDK example

```typescript
roxy.tarot.drawCards({ body: { count: 3 } })
```

### Python SDK example

```python
roxy.tarot.draw_cards(count=3)
```

## Biorhythm

- `POST /biorhythm/daily` — Seeded daily biorhythm reading.
- `POST /biorhythm/forecast` — Multi-day range (30 to 90 days) with best, worst, and critical days.
- `POST /biorhythm/compatibility` — Cycle alignment between two people.
- `POST /biorhythm/critical-days` — Zero-crossing days in a 90 to 180 day window.

### TypeScript SDK example

```typescript
roxy.biorhythm.dailyReading({ body: { birthDate: '1990-06-15' } })
```

### Python SDK example

```python
roxy.biorhythm.daily_reading(birth_date="1990-06-15")
```

## I-Ching

- `POST /iching/daily` — Seeded daily hexagram.
- `POST /iching/daily/cast` — Seeded three-coin daily variant.
- `GET /iching/cast` — Random three-coin cast (optional `seed` for determinism).
- `GET /iching/hexagrams/{number}` — Hexagram 1 to 64 detail.

### TypeScript SDK example

```typescript
roxy.iching.castReading({})
```

### Python SDK example

```python
roxy.iching.cast_reading()
```

## Crystals

- `GET /crystals/zodiac/{sign}` — Crystals paired with a zodiac sign.
- `GET /crystals/chakra/{chakra}` — Chakra stones (`root`, `heart`, `third-eye`, etc.).
- `GET /crystals/birthstone/{month}` — Birthstones by month (1 to 12).
- `GET /crystals/search?q=` — Free-text crystal search.

### TypeScript SDK example

```typescript
roxy.crystals.byZodiac({ path: { sign: 'aries' } })
```

### Python SDK example

```python
roxy.crystals.by_zodiac(sign="aries")
```

## Dreams

- `GET /dreams/symbols/{id}` — Dream symbol detail (e.g. `flying`, `teeth-falling-out`).
- `GET /dreams/symbols` — Browse catalog.
- `POST /dreams/daily` — Daily dream symbol prompt.

### TypeScript SDK example

```typescript
roxy.dreams.lookupSymbol({ path: { id: 'flying' } })
```

### Python SDK example

```python
roxy.dreams.lookup_symbol(id="flying")
```

## Angel Numbers

- `GET /angel-numbers/numbers/{number}` — Canonical number meaning (string param, e.g. `1111`, `777`).
- `GET /angel-numbers/lookup?number=` — Universal lookup for any positive integer with digit-root fallback.
- `POST /angel-numbers/daily` — Daily-message endpoint.

### TypeScript SDK example

```typescript
roxy.angelNumbers.lookup({ query: { number: 1111 } })
```

### Python SDK example

```python
roxy.angel_numbers.lookup(number=1111)
```

## Location

- `GET /location/search?q={city}` — City search. Paginated envelope: `{ total, limit, offset, cities: [...] }`. Each city has `city`, `province`, `country`, `iso2`, `latitude`, `longitude`, `timezone` (IANA string, e.g. `"Asia/Kolkata"`), `utcOffset` (decimal hours, DST-adjusted for today), `population`. Chart endpoints accept `timezone` as either the IANA string or `utcOffset` decimal — both work, IANA is preferred because it resolves to the DST-correct offset for the request's `date`. Call first for any coordinate-dependent endpoint.

### TypeScript SDK example

```typescript
roxy.location.search({ query: { q: 'Mumbai' } })
```

### Python SDK example

```python
roxy.location.search(q="Mumbai")
```