Skip to main content

​
Quick Start Guide

Get up and running with the rocks.rive.wtf API in just a few minutes.

​
Step 1: Get Your API Key

1

Add on Discord

Add southctrl on Discord to request your API key
2

Send Request

Message southctrl with your request for API access
3

Receive API Key

You’ll receive your unique API key via Discord DM
4

Keep it Secure

Store your API key securely - never share it publicly or commit it to repositories
Important: Your API key is personal and should be kept confidential. Do not share it with others or expose it in client-side code.

​
Step 2: Make Your First Request

Let’s fetch a random Bible verse: 
curl -X GET "https://rocks.rive.wtf/api/bible/random?translation=web" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Expected Response

{
  "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"
  }
}

​
Step 3: Explore More Endpoints

Now that you’ve made your first request, explore other endpoints:

Weather API

Get current weather and forecasts

Crypto Prices

Real-time cryptocurrency prices

Movie Data

Search movies and TV shows

Gaming Stats

Access Steam, Xbox, and more

​
Common Use Cases

Use endpoints like /api/valorant, /api/weather, or /api/wouldyourather to enhance your Discord bot with live data.Popular endpoints for bots:
  • Would You Rather: Fun questions for engagement
  • Weather: Location-based weather updates
  • Valorant: Player stats and ranks
  • Urban Dictionary: Word definitions
Combine /api/instagram, /api/tiktok, and /api/twitter to create a unified social media monitoring dashboard.Track metrics like:
  • Follower counts
  • Post engagement
  • Profile information
  • Recent activity
Use /api/steam/player, /api/xbox, or /api/valorant to build gaming leaderboards and stat trackers.Available gaming platforms:
  • Steam (games & players)
  • Xbox Live
  • Valorant
  • Roblox
  • Minecraft
  • osu!
  • Clash Royale
Integrate ESPN endpoints for real-time sports scores and updates in your application.Supported sports:
  • NBA Basketball
  • NFL Football
  • NHL Hockey
  • MLS Soccer

​
Rate Limiting

The API implements rate limiting to ensure fair usage. If you exceed the rate limit, you’ll receive a 429 status code. Contact southctrl on Discord if you need higher limits.

​
Best Practices

Cache Responses

Cache API responses when possible to reduce unnecessary requests

Handle Errors

Always implement proper error handling for failed requests

Secure Your Key

Never expose your API key in client-side code or public repositories

Use HTTPS

All requests must use HTTPS for security

​
Next Steps

Bible

Explore all available endpoints and their documentation

Authentication Guide

Learn about security best practices

​
Need Help?

Contact Support

Discord: southctrlFor API key requests, bug reports, feature requests, or general support, reach out via Discord.
Have questions about a specific endpoint? Check the detailed documentation in the API Reference section.