Vagibond

Follow Vagibond

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

Thanks for subscribing!
📜
The Hole of Glory API provides access to 500+ verses of sacred scripture from the Church of the Universal Nomadic Traveler.

Hole of Glory API

Access the sacred scriptures of C.U.N.T. programmatically. The Hole of Glory API provides verse lookup, making it easy to embed scripture in your applications or create verse cards for social sharing.

Quickstart

Fetch a verse with a simple REST request.

Fetch a Verse

bash
# Get verse by book:chapter:verse (10:3:7 = Book 10, Chapter 3, Verse 7)
curl "https://api.vagibond.com/holeofglory/verse?ref=10_3_7"

Response

json
{
  "book": "THE FURGE OF THE ELMOS",
  "bookId": "furge-of-the-elmos",
  "bookNumber": 10,
  "chapter": 3,
  "verse": 7,
  "ref": "3:7",
  "fullRef": "10_3_7",
  "text": "The authentic stench of the wanderer cannot be faked...",
  "url": "https://cunt.vagibond.com/holeofglory/?book=furge-of-the-elmos&verse=3:7"
}

Get Verse Endpoint

Fetch a specific verse from the sacred scriptures.

GET /api/holeofglory/verse

Query Parameters

Parameter Type Description
ref string Required. Verse reference. Supports two formats:
  • book_chapter_verse (e.g., 10_3_7) - Book 10, Chapter 3, Verse 7
  • chapter_verse (e.g., 3_7) - Searches all books for Chapter 3, Verse 7
Use underscores or colons as separators (10_3_7 or 10:3:7).
book string Optional. Filter by book ID (e.g., furge-of-the-elmos).

Response Fields

Field Type Description
bookstringFull book name
bookIdstringBook slug identifier
bookNumbernumberBook number (1-10)
chapternumberChapter number
versenumberVerse number
refstringChapter:verse reference (e.g., "3:7")
fullRefstringFull reference with underscores (e.g., "10_3_7")
textstringThe verse text
urlstringDirect URL to view verse in Hole of Glory

Reference Format

The Hole of Glory uses a hierarchical reference system:

text
Format: BOOK_CHAPTER_VERSE

Examples:
  10_3_7   → Book 10 (The Furge of the Elmos), Chapter 3, Verse 7
  1_1_1    → Book 1 (Cuntemplations), Chapter 1, Verse 1
  5_2_3    → Book 5 (The Morning Golden Blessing), Chapter 2, Verse 3

The 10 Sacred Books

# Book Name Book ID
1Cuntemplationscuntemplations
2The Book of Bindlebook-of-bindle
3Epistles to the Indigentepistles-to-the-indigent
4The Sacred Spitsacred-spit
5The Morning Golden Blessingmorning-golden-blessing
6Trampsalmstrampsalms
7The Hobo Proverbshobo-proverbs
8The Acts of the Apostatesacts-of-the-apostates
9The Revelation of Dustyrevelation-of-dusty
10The Furge of the Elmosfurge-of-the-elmos

Gutter Embeds

When you post to Gutter with a #HoleOfGlory hashtag, verse cards are automatically embedded.

Hashtag Format

text
#HoleOfGlory10_3_7

Format: #HoleOfGlory{BOOK}_{CHAPTER}_{VERSE}

Examples:
  #HoleOfGlory10_3_7  → The Furge of the Elmos 3:7
  #HoleOfGlory1_1_1   → Cuntemplations 1:1
  #HoleOfGlory6_2_5   → Trampsalms 2:5

When a grunt contains this hashtag, Gutter automatically:

Examples

JavaScript

javascript
// Fetch a verse
const response = await fetch('https://api.vagibond.com/holeofglory/verse?ref=10_3_7');
const verse = await response.json();

console.log(`"${verse.text}"`);
console.log(`— ${verse.book} ${verse.ref}`);

// Output:
// "The authentic stench of the wanderer cannot be faked..."
// — THE FURGE OF THE ELMOS 3:7

Python

python
import requests

# Fetch verse of the day
response = requests.get('https://api.vagibond.com/holeofglory/verse', params={
    'ref': '10_3_7'
})

verse = response.json()
print(f'"{verse["text"]}"')
print(f'— {verse["book"]} {verse["ref"]}')

Display a Random Verse

javascript
// Popular verse references to randomly select from
const POPULAR_VERSES = [
  '1_1_1', '1_2_3', '2_1_1', '3_1_1',
  '6_1_1', '7_1_1', '10_3_7', '10_3_14'
];

async function getRandomVerse() {
  const ref = POPULAR_VERSES[Math.floor(Math.random() * POPULAR_VERSES.length)];
  const response = await fetch(`https://api.vagibond.com/holeofglory/verse?ref=${ref}`);
  return response.json();
}

Changelog

v1.0.0 January 2025
  • Initial release
  • Get verse endpoint with 3-part reference format
  • CORS support for cross-origin requests
  • Gutter hashtag embed integration