Skip to main content
Hyperoru provides a comprehensive market data layer that feeds into strategies, signals, and analytics. Data flows from exchanges through caches into the services that consume it.

​
Price data

Real-time price data is fetched by background tasks and stored in the PriceCache for instant access. 
curl https://api.hyperoru.com/api/crypto/price/BTC

​
K-line data (candlesticks)

Historical and real-time candlestick data at multiple timeframes. 
curl "https://api.hyperoru.com/api/klines?symbol=BTC&interval=1h&limit=100"

​
Supported timeframes

IntervalCodeUse case
1 minute1mScalping, high-frequency signals
5 minutes5mShort-term momentum
15 minutes15mIntraday trading
1 hour1hSwing trading, general analysis
4 hours4hPosition trading
1 day1dTrend analysis, regime detection
Each candle contains: 
{
  "open_time": 1689350400000,
  "open": 67500.0,
  "high": 67800.0,
  "low": 67200.0,
  "close": 67523.4,
  "volume": 1234.56,
  "close_time": 1689354000000
}

​
Technical indicators

Pre-computed indicators available through the API and the program strategy MarketData object.
IndicatorParametersOutput
RSIPeriod (default: 14)Single value 0–100
MACDFast (12), slow (26), signal (9)MACD line, signal line, histogram
Bollinger BandsPeriod (20), std dev (2)Upper, middle, lower bands
EMAPeriodSingle smoothed value
SMAPeriodSingle average value
ATRPeriod (14)Volatility measure
curl "https://api.hyperoru.com/api/crypto/indicators?symbol=BTC&indicator=rsi&period=14"

​
Market flow

Real-time order flow and market microstructure data.
Tracks the net difference between buy and sell volume over time. Rising CVD with rising price confirms bullish momentum.
curl "https://api.hyperoru.com/api/market-flow/cvd?symbol=BTC&interval=1h"
Aggregated bid/ask depth at configurable price levels, useful for identifying support/resistance zones.
curl "https://api.hyperoru.com/api/market-flow/depth?symbol=BTC&levels=20"
Buy vs sell taker volume over time. Spikes in taker volume often precede significant price moves.
curl "https://api.hyperoru.com/api/market-flow/taker-volume?symbol=BTC&interval=5m"
Detection of large individual orders that may indicate institutional activity or whale movements.
curl "https://api.hyperoru.com/api/market-flow/large-orders?symbol=BTC&min_value=100000"

​
Market regime classification

The regime classifier categorizes current market conditions into discrete states:
RegimeDescription
Trending UpSustained directional move with bullish bias
Trending DownSustained directional move with bearish bias
RangingPrice oscillating within a defined range
VolatileHigh volatility without clear direction
CalmLow volatility, narrow range, low volume
curl "https://api.hyperoru.com/api/market-regime?symbol=BTC"

{
  "symbol": "BTC",
  "regime": "trending_up",
  "confidence": 0.82,
  "duration_hours": 18.5,
  "timestamp": "2025-07-15T14:30:00Z"
}
Use the {market_regime} template variable in prompt strategies to condition AI decisions on the current market state.

​
Sampling pool

The sampling pool collects periodic market snapshots used for AI context. Each snapshot captures prices, volumes, and indicator values across all watchlist symbols. 
curl "https://api.hyperoru.com/api/sampling/latest?limit=10"
Snapshots in the sampling pool are automatically included in prompt strategies via the {sampling_data} template variable, giving the LLM a rolling window of recent market context.