Skip to main content

Documentation Index

Fetch the complete documentation index at: https://ruins.docs.rive.wtf/llms.txt

Use this file to discover all available pages before exploring further.

Quickstart

1. Get an API key

1

Message southctrl on Discord

DM southctrl to apply for a key.
2

Wait for review

Keys are issued manually.
3

Use your key securely

Prefer environment variables; never commit keys to git.
Each key is bound to one IP. If your server IP changes, you may need a new key.

2. Call the API

Replace YOUR_API_KEY with your token. The examples use the Bible random verse route as a smoke test.
curl -sS -X GET "https://rocks.rive.wtf/api/bible/random?translation=web" \
  -H "Authorization: Bearer YOUR_API_KEY"

3. Expected shape

{
  "success": true,
  "verse": {
    "book": "John",
    "chapter": 3,
    "verse": 16,
    "text": "For God so loved the world, that he gave his one and only Son...",
    "translation": "web"
  }
}

Next steps

Weather

Current conditions and forecasts

Crypto

Market data endpoints

Movies & TV

OMDB search and metadata

Steam

Apps, news, and player summaries

Rate limits

If you receive 429, slow down or cache responses. DM southctrl if you need higher limits for a documented use case.

Need help?

DM southctrl on Discord for keys, bugs, or feature ideas.