BTC-USD directional price forecast

Returns a directional price forecast for BTC-USD computed from live Binance OHLCV data. The primary model is Kronos-small (ML); fallback is a composite EMA(20/50)/RSI(14)/MACD(12,26,9)/ATR(14) heuristic. Costs $0.05 USDC on Base mainnet via x402. Returns probability of upward movement, price range (ATR-based), p10–p90 quantiles, and the model used.

get/api/v1/forecast/btc

Request

Base URL: https://kronossignals.com (the document declares no server; this is the origin it was published from)
URL: https://kronossignals.com/api/v1/forecast/btc
Auth: none declared

Query parameters

horizon'1h' | '4h' | '24h'

Forecast horizon. 1h = 1-hour candles, 4h = 4-hour candles, 24h = daily candles. Defaults to 1h.

Response

Forecast returned (payment verified)

assetstring required

Normalized asset identifier (e.g. BTC-USD, ETH-USD, SOL-USD).

horizon'1h' | '4h' | '24h' required

Forecast horizon as requested.

sourcestring

Model or data source identifier (e.g. 'Kronos-small', 'Binance').

generated_atstring date-time

UTC timestamp when this forecast was computed.

modelstring required

Model used: 'Kronos-small' (ML) or 'kronos-signal-composite-v1 (fallback)' (indicator heuristic).

inference_secondsnumber nullable

Inference latency from the Kronos ML service. Only present on ML path.

disclaimerstring required

Mandatory disclaimer. Probabilistic output only; not financial advice.

Example response

{
  "asset": "BTC-USD",
  "horizon": "1h",
  "source": "Kronos-small",
  "price": {
    "close": 107500,
    "atr": 850.42
  },
  "forecast": {
    "up_prob": 0.62,
    "range_low": 106224.37,
    "range_high": 108775.63,
    "horizon_bars": 20,
    "confidence": 0.75,
    "expected_close": 107620.5,
    "pred_high": 108900,
    "pred_low": 106200,
    "pred_volatility": 0.0079,
    "prob_up": 0.62
  },
  "model": "Kronos-small",
  "inference_seconds": 0.23
}

Changes

No recorded changes to this operation across all 1 revision of this API.