Vagibond

Follow Vagibond

Stay connected with us on social media for updates on new ventures.

Thanks for subscribing!
Visit Asshology Site
🔮
Asshology is the cosmic guide for wandering souls. The fortunes are procedurally generated and change daily.

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

html
<script src="https://asshology.vagibond.com/asshology-core.js"></script>

2. Get a Zodiac Sign

javascript
// 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
scariesMar 21 - Apr 19Fire
tourassApr 20 - May 20Earth
germiniMay 21 - Jun 20Air
cankerJun 21 - Jul 22Water
leblowJul 23 - Aug 22Fire
vaggoAug 23 - Sep 22Earth
liebraSep 23 - Oct 22Air
scabrioOct 23 - Nov 21Water
vagitariusNov 22 - Dec 21Fire
crapricornDec 22 - Jan 19Earth
vagiquariusJan 20 - Feb 18Air
fescesFeb 19 - Mar 20Water

Sign Object Structure

javascript
{
  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.

javascript
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.

javascript
const week = Asshology.getWeeklyFortune('scaries');
// [{ day: 0, category: 'love', fortune: '...' }, ...]

getDailyWisdom()

Returns today's hobo wisdom quote.

javascript
const wisdom = Asshology.getDailyWisdom();
// "Home is where you park your cart."

getLuckyNumbers(signId)

Returns lucky numbers (can counts) for the specified sign.

javascript
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.

javascript
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

html
<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

v1.0.0 January 2026 Initial Release