Skip to content

Latest commit

 

History

History
53 lines (37 loc) · 2.38 KB

File metadata and controls

53 lines (37 loc) · 2.38 KB

RoxyAPI - Agent Guide

Postman collections for the RoxyAPI catalog: astrology, Vedic astrology, tarot, numerology, I Ching, biorhythm, dreams, crystals, angel numbers, Human Design, forecast, and location. One API key, every domain. This guide helps an AI agent call the API these collections cover.

Base URL and auth

  • Base URL: https://roxyapi.com/api/v2/{domain}
  • Send your key in the X-API-Key header on every request. The same key works across every domain.
  • Get a key: https://roxyapi.com/account

Domains

Domain Base path
Western astrology /api/v2/astrology
Vedic astrology /api/v2/vedic-astrology
Tarot /api/v2/tarot
Numerology /api/v2/numerology
I Ching /api/v2/iching
Biorhythm /api/v2/biorhythm
Dreams /api/v2/dreams
Crystals /api/v2/crystals
Angel numbers /api/v2/angel-numbers
Human Design /api/v2/human-design
Forecast /api/v2/forecast
Location /api/v2/location

The exact endpoints, parameters, and response fields are in the API reference and the OpenAPI spec at https://roxyapi.com/api/v2/{domain}/openapi.json. Always read field names from the spec, never guess.

Critical rule: geocode before any chart endpoint

Astrology and Vedic chart endpoints need latitude and longitude. Resolve a place name to coordinates with the location domain first, then pass them in. Never guess coordinates.

Multi-language responses

Add ?lang= to any request. Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to English. Domains without a translation yet fall back to English.

Errors

Success returns the data directly. Failures return { "error": "...", "code": "..." } with an HTTP status. There is no success wrapper.

Using these collections

  • Fork the public workspace into your own.
  • Or download roxyapi-collections.zip from the latest release and import it, along with the included RoxyAPI environment. Set the apiKey variable to your key.
  • Bruno and Insomnia import directly from the spec URLs above.

Links