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

Live Demo

See what you can build with the Asshology API.

Asshology Demo

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