System & Status Endpoints

The 3 System & Status endpoints tell you whether the Raiden Terminal API is up, how healthy its database and Solana ingest are, and the current SOL/USD price. Two of them are free.

Paths are relative to https://terminal.raiden.wtf/api and every request carries your key in the X-API-Key header (see Authentication). Each call costs the credits shown next to it.

Health check

GET/healthfree

A liveness probe: check that the API is up.

Request


curl -s "https://terminal.raiden.wtf/api/health" \
  -H "X-API-Key: $RAIDEN_KEY"

Response


{ "status": "ok" }

Database and ingest stats

GET/stats1 credit

Database and ingest health: counts, throughput, freshness, storage and top tokens.

tokens_usdc counts the tokens with a non-SOL quote recorded (USDC or any other token). The name is kept for compatibility.

Request


curl -s "https://terminal.raiden.wtf/api/stats" \
  -H "X-API-Key: $RAIDEN_KEY"

Response


{
  "tokens": 2841233,
  "tokens_graduated": 18742,
  "tokens_usdc": 312,
  "positions": 84211905,
  "swaps": 631884201,
  "tips": 49120377,
  "swaps_1m": 4123,
  "swaps_5m": 20817,
  "swaps_1h": 248913,
  "tokens_1h": 1842,
  "tips_1h": 19204,
  "lag_seconds": 1.8,
  "db_size": 982331486208,
  "tables": [
    {
      "name": "swaps",
      "bytes": 612338954240
    }
  ],
  "compressed_bytes": 731884965888,
  "uncompressed_bytes": 1893402746880,
  "chunks": 4187,
  "tips_by_provider": [
    {
      "provider": "jito",
      "count": 31884201,
      "lamports": "1284991200000"
    }
  ],
  "top_tokens": [
    {
      "mint": "9xQm…pump",
      "volume": "488888889000",
      "trades": 18422
    }
  ],
  "activity": [
    {
      "t": 1782640800,
      "count": 248913
    }
  ],
  "server": {
    "load1": 3.42,
    "load5": 2.98,
    "load15": 2.71,
    "cpus": 16,
    "mem_used": 41875931136,
    "mem_total": 67430866944
  }
}

SOL price in USD

GET/sol-pricefree

The current SOL/USD price, from Binance with CoinGecko as the fallback.

Caching. Refreshed server-side in the background about every 5 seconds and served from memory, so the call never blocks on an upstream fetch.

Response fields.

stale_s — age of the quote in seconds.

Request


curl -s "https://terminal.raiden.wtf/api/sol-price" \
  -H "X-API-Key: $RAIDEN_KEY"

Response


{ "usd": 152.34, "stale_s": 2 }