Asshology API
Add hobo horoscopes and fortune telling to your application. The Asshology API provides zodiac signs, daily fortunes, compatibility readings, and cosmic wisdom for the transient community.
Quickstart
Get up and running with Asshology in under a minute.
1. Include the Script
<script src="https://asshology.vagibond.com/asshology-core.js"></script>
2. Get a Zodiac Sign
// Get sign from date of birth const sign = Asshology.getSign('1985-03-25'); console.log(sign.name); // "Scaries" console.log(sign.symbol); // "♈" // Get today's fortune const fortune = Asshology.getDailyFortune('scaries'); // Check compatibility const match = Asshology.getCompatibility('scaries', 'vagitarius');
The 12 Zodiac Signs
The Hobo Zodiac consists of 12 unique signs, each with their own traits, lucky items, and compatible signs.
| Symbol | Sign | Dates | Element |
|---|---|---|---|
| ♈ | scaries | Mar 21 - Apr 19 | Fire |
| ♉ | tourass | Apr 20 - May 20 | Earth |
| ♊ | germini | May 21 - Jun 20 | Air |
| ♋ | canker | Jun 21 - Jul 22 | Water |
| ♌ | leblow | Jul 23 - Aug 22 | Fire |
| ♍ | vaggo | Aug 23 - Sep 22 | Earth |
| ♎ | liebra | Sep 23 - Oct 22 | Air |
| ♏ | scabrio | Oct 23 - Nov 21 | Water |
| ♐ | vagitarius | Nov 22 - Dec 21 | Fire |
| ♑ | crapricorn | Dec 22 - Jan 19 | Earth |
| ♒ | vagiquarius | Jan 20 - Feb 18 | Air |
| ♓ | fesces | Feb 19 - Mar 20 | Water |
Sign Object Structure
{
id: 'scaries',
symbol: '♈',
name: 'Scaries',
dates: 'Mar 21 - Apr 19',
element: 'Fire',
rulingPlanet: 'Boxcars',
description: 'Bold, impulsive, first to jump a moving train...',
traits: ['adventurous', 'impulsive', 'courageous'],
luckyItems: ['red bandana', 'steel-toed boots'],
compatibility: ['vagitarius', 'leblow', 'vagiquarius']
}
Fortune Methods
getDailyFortune(signId)
Returns today's fortune for the specified sign. Fortunes are deterministic per day.
const fortune = Asshology.getDailyFortune('vagitarius'); // "The 3:47 freight train will take you somewhere magical."
getWeeklyFortune(signId)
Returns an array of 7 daily fortunes for the upcoming week.
const week = Asshology.getWeeklyFortune('scaries'); // [{ day: 0, category: 'love', fortune: '...' }, ...]
getDailyWisdom()
Returns today's hobo wisdom quote.
const wisdom = Asshology.getDailyWisdom(); // "Home is where you park your cart."
getLuckyNumbers(signId)
Returns lucky numbers (can counts) for the specified sign.
const lucky = Asshology.getLuckyNumbers('crapricorn'); // { numbers: [7, 13, 21, 34, 42], description: 'Your lucky can counts for today' }
Compatibility
getCompatibility(signId1, signId2)
Check romantic compatibility between two signs.
const result = Asshology.getCompatibility('scaries', 'vagitarius'); // Returns: { sign1: { ... }, // Full sign object sign2: { ... }, // Full sign object score: 95, compatible: true, description: "Scaries and Vagitarius are a cosmic match!" }
Example: Daily Horoscope Widget
<div id="horoscope"></div> <script src="https://asshology.vagibond.com/asshology-core.js"></script> <script> const userDOB = '1985-11-25'; const sign = Asshology.getSign(userDOB); const fortune = Asshology.getDailyFortune(sign.id); document.getElementById('horoscope').innerHTML = ` <h2>${sign.symbol} ${sign.name}</h2> <p>${fortune}</p> `; </script>
Changelog
- 12 Hobo Zodiac signs with full personality profiles
- Daily and weekly fortune generation
- Sign compatibility checking
- Lucky numbers and daily wisdom
- Date-based sign lookup