API v1.0 — Now Live

Build with Cosmic Intelligence

Integrate astrological wisdom into your applications. Calculate natal charts, analyze planetary transits, and generate unique rune glyphs with our powerful API.

Get Started Try Interactive Demo

Quickstart

Get up and running in minutes with your preferred language

Python 
from odins_oracle import OracleClient

# Initialize client
client = OracleClient(api_key="your_api_key")

# Calculate natal chart
chart = client.natal_chart(
    birth_date="1990-06-15",
    birth_time="14:30",
    latitude=41.8781,
    longitude=-87.6298
)

print(f"Sun: {chart.sun.sign}")
print(f"Moon: {chart.moon.sign}")
print(f"Rising: {chart.rising.sign}")
JavaScript 
import { OracleClient } from '@odins-oracle/sdk';

// Initialize client
const client = new OracleClient({ apiKey: 'your_api_key' });

// Calculate natal chart
const chart = await client.natalChart({
  birthDate: '1990-06-15',
  birthTime: '14:30',
  latitude: 41.8781,
  longitude: -87.6298
});

console.log(`Sun: ${chart.sun.sign}`);
console.log(`Moon: ${chart.moon.sign}`);
console.log(`Rising: ${chart.rising.sign}`);
cURL 
curl -X POST https://api.odins-oracle.com/v1/natal-chart \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "birth_date": "1990-06-15",
    "birth_time": "14:30",
    "latitude": 41.8781,
    "longitude": -87.6298
  }'

API Reference

Complete endpoint documentation with request/response schemas

POST /v1/natal-chart Calculate a complete natal chart ▼

Request Parameters

birth_date string Birth date in YYYY-MM-DD format required
birth_time string Birth time in 24-hour HH:MM format required
latitude number Birth location latitude (-90 to 90) required
longitude number Birth location longitude (-180 to 180) required
timezone string IANA timezone identifier (e.g., "America/Chicago") optional

Response Schema

{
  "birth_data": {
    "date": "1990-06-15",
    "time": "14:30",
    "timezone": "UTC",
    "location": "Unknown",
    "latitude": 41.8781,
    "longitude": -87.6298
  },
  "julian_day": 2448041.104,
  "planets": [
    {
      "planet": "SUN",
      "glyph": "☉",
      "longitude": 84.1234,
      "sign": "Gemini",
      "degree": 24,
      "minute": 7,
      "retrograde": false,
      "house": 8
    }
  ],
  "houses": [...],
  "aspects": [...],
  "chart_signature": {
    "sun_sign": "Gemini",
    "moon_sign": "Virgo",
    "rising_sign": "Libra",
    "mc_sign": "Cancer"
  },
  "rune_glyph": "ᚠᚢᚦᚨ"
}
POST /v1/transits Calculate current transits for a natal chart ▼

Request Parameters

natal_chart_id string ID of previously calculated natal chart required
date string Transit date in YYYY-MM-DD format (defaults to today) optional
GET /v1/planets List all supported planets and their glyphs ▼

Response

{
  "planets": [
    { "id": "SUN", "name": "Sun", "glyph": "☉" },
    { "id": "MOON", "name": "Moon", "glyph": "☽" },
    { "id": "MERCURY", "name": "Mercury", "glyph": "☿" }
  ]
}

Interactive Playground

Try the API live — no authentication required for demo

Natal Chart Calculator POST /v1/natal-chart
Response Ready 
// Click "Send Request" to see the response

SDKs

Official libraries for popular languages

🐍

Python

Full-featured Python SDK with async support, type hints, and comprehensive error handling.

pip install odins-oracle
Documentation → GitHub →
⚡

JavaScript

Modern JavaScript/TypeScript SDK for Node.js and browsers. Promise-based with full type definitions.

npm install @odins-oracle/sdk
Documentation → GitHub →

Use Case Recipes

Common integration patterns and examples

Web App

Birth Chart Generator

Build a beautiful birth chart visualization for your users

  1. 1Collect birth data via form
  2. 2Call /v1/natal-chart endpoint
  3. 3Render SVG chart from response
  4. 4Display planetary positions
Mobile

Daily Horoscope App

Send personalized daily insights based on transits

  1. 1Store user natal charts
  2. 2Schedule daily transit checks
  3. 3Generate personalized text
  4. 4Push notification delivery
AI Agent

Astrology-Powered Assistant

Give your AI agent cosmic context awareness

  1. 1Calculate user's natal chart
  2. 2Fetch current transits
  3. 3Inject into LLM context
  4. 4Generate cosmic insights

Pricing

Simple, transparent pricing for every stage

Seeker

Free
Forever
  • 100 API calls / month
  • Natal chart calculations
  • Basic transit data
  • Community support
Get Started

Oracle

$49/mo
Best for growing apps
  • 10,000 API calls / month
  • All chart calculations
  • Transit & aspect analysis
  • Priority support
  • 99.9% uptime SLA
Start Trial

Cathedral

$199/mo
For enterprises
  • 100,000 API calls / month
  • Everything in Oracle
  • Custom rune generation
  • Dedicated support
  • Custom integrations
Contact Sales