Skip to main content

Symbols

GET /api/crypto/symbols

List all available cryptocurrency symbols. Example request
curl https://api.hyperoru.com/api/crypto/symbols
Example response
{
  "symbols": ["BTC", "ETH", "SOL", "ARB", "DOGE"]
}

Price

GET /api/crypto/price/

Get the current or historical price for a symbol.
symbol
string
required
Symbol name (e.g. BTC).
date
string
Historical date (ISO 8601). Returns current price if omitted.
Example request
curl https://api.hyperoru.com/api/crypto/price/BTC
Example response
{
  "symbol": "BTC",
  "price": 68500.25,
  "date": "2026-04-09T12:00:00Z"
}

Market status

GET /api/crypto/status/

Check data availability and market status for a symbol.
symbol
string
required
Symbol name.
Example request
curl https://api.hyperoru.com/api/crypto/status/BTC
Example response
{
  "symbol": "BTC",
  "has_data": true,
  "kline_count": 525600
}

GET /api/crypto/popular

Get a curated list of popular trading symbols. Example request
curl https://api.hyperoru.com/api/crypto/popular
Example response
{
  "symbols": ["BTC", "ETH", "SOL", "ARB", "DOGE", "WIF", "PEPE"]
}

Market price (single)

GET /api/market/price/

Get the current market price for a symbol (alias for crypto price).
symbol
string
required
Symbol name.
Example request
curl https://api.hyperoru.com/api/market/price/ETH
Example response
{
  "symbol": "ETH",
  "price": 3450.80
}

Market prices (multiple)

GET /api/market/prices

Get current prices for multiple symbols at once.
symbols
string
required
Comma-separated list of symbols.
Example request
curl "https://api.hyperoru.com/api/market/prices?symbols=BTC,ETH,SOL"
Example response
{
  "prices": {
    "BTC": 68500.25,
    "ETH": 3450.80,
    "SOL": 145.30
  }
}

Kline

GET /api/market/kline/

Get OHLCV kline (candlestick) data for a symbol.
symbol
string
required
Symbol name.
interval
string
Kline interval: 1m, 5m, 15m, 1h, 4h, 1d. Defaults to 1h.
limit
integer
Number of candles to return. Defaults to 100.
Example request
curl "https://api.hyperoru.com/api/market/kline/BTC?interval=1h&limit=24"
Example response
[
  {
    "timestamp": "2026-04-09T00:00:00Z",
    "open": 68000.0,
    "high": 68800.0,
    "low": 67500.0,
    "close": 68500.0,
    "volume": 1234.56
  }
]

Market status

GET /api/market/status/

Check market data health for a symbol.
symbol
string
required
Symbol name.
Example request
curl https://api.hyperoru.com/api/market/status/BTC
Example response
{
  "symbol": "BTC",
  "has_data": true,
  "kline_count": 525600
}

Market health

GET /api/market/health

Overall market data service health check. Example request
curl https://api.hyperoru.com/api/market/health
Example response
{
  "status": "ok",
  "symbols_tracked": 50,
  "last_update": "2026-04-09T12:00:00Z"
}

Kline with indicators

GET /api/market/kline-with-indicators/

Get kline data enriched with technical indicators.
symbol
string
required
Symbol name.
interval
string
Kline interval. Defaults to 1h.
indicators
string
Comma-separated indicator names (e.g. rsi,macd,ema).
Example request
curl "https://api.hyperoru.com/api/market/kline-with-indicators/BTC?interval=1h&indicators=rsi,macd"
Example response
[
  {
    "timestamp": "2026-04-09T00:00:00Z",
    "open": 68000.0,
    "high": 68800.0,
    "low": 67500.0,
    "close": 68500.0,
    "volume": 1234.56,
    "indicators": { "rsi": 55.3, "macd": { "value": 120.5, "signal": 110.2, "histogram": 10.3 } }
  }
]

Available indicators

GET /api/market/indicators/available

List all supported technical indicators. Example request
curl https://api.hyperoru.com/api/market/indicators/available
Example response
{
  "indicators": [
    { "name": "rsi", "description": "Relative Strength Index", "params": ["period"] },
    { "name": "macd", "description": "Moving Average Convergence Divergence", "params": ["fast", "slow", "signal"] },
    { "name": "ema", "description": "Exponential Moving Average", "params": ["period"] }
  ]
}