Skip to main content

Documentation Index

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

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

Every API key is tied to one IP. To apply for a key, DM southctrl on Discord.
Use the endpoint path below, replace the required params, and send Authorization: Bearer YOUR_API_KEY.

Quick Start

1

Choose a coin

Pick the symbol or query supported by the route.
2

Call the endpoint

Send a request with your API key in the Bearer header.
3

Read market data

Use the response for price, symbol, and market details.
Useful for dashboards, bots, and price lookup commands.

Endpoint

GET https://rocks.rive.wtf/api/crypto

Description

Fetches real-time cryptocurrency data including price, market cap, volume, and 24-hour price changes for any supported cryptocurrency.

Authentication

This endpoint requires authentication via Bearer token in the Authorization header.

Query Parameters

coin
string
required
cryptocurrency identifier (e.g., “bitcoin”, “ethereum”, “dogecoin”).

Example Request

curl -X GET "https://rocks.rive.wtf/api/crypto?coin=bitcoin" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response (JSON)

{
  "change_percent_24h": -5.29462,
  "id": "bitcoin",
  "market_cap": 1686484127551.0,
  "name": "Bitcoin",
  "price": 84289.0,
  "symbol": "btc",
  "volume_24h": 70923572029.0
}

Response Fields

id
string
unique identifier for the cryptocurrency
name
string
full name of the cryptocurrency
symbol
string
trading symbol (ticker) for the cryptocurrency
price
number
Current price in USD
market_cap
number
Total market capitalization in USD
volume_24h
number
Trading volume over the last 24 hours in USD
change_percent_24h
number
Percentage change in price over the last 24 hours (can be negative)

Notes

  • Prices and market data are updated in real-time
  • All monetary values are in USD
  • change_percent_24h field can be negative (indicating a price decrease) or positive (indicating a price increase)
  • Coin identifiers are typically lowercase versions of the cryptocurrency name (e.g., “bitcoin”, “ethereum”, “cardano”)