---
title: "BTC-USD directional price forecast"
method: GET
path: "/api/v1/forecast/btc"
tags: ["forecast", "paid"]
---

# BTC-USD directional price forecast

`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

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.

## Query parameters

- `horizon` '1h' | '4h' | '24h'

## Response `200`

Forecast returned (payment verified)

- object
  - `asset` string, required: Normalized asset identifier (e.g. BTC-USD, ETH-USD, SOL-USD).
  - `horizon` '1h' | '4h' | '24h', required: Forecast horizon as requested.
  - `source` string: Model or data source identifier (e.g. 'Kronos-small', 'Binance').
  - `generated_at` string, date-time: UTC timestamp when this forecast was computed.
  - `price` object, required: Price snapshot at forecast time.
    - `close` number, required: Last close price in USD.
    - `atr` number, required: ATR(14) in USD.
  - `forecast` object, required: Core forecast output.
    - `up_prob` number, required: Probability of upward price movement over the horizon (0–1).
    - `range_low` number, required: Estimated lower bound of the price range (close − 1.5×ATR).
    - `range_high` number, required: Estimated upper bound of the price range (close + 1.5×ATR).
    - `horizon_bars` integer: Number of candles the horizon spans (e.g. 20).
    - `confidence` number, required: Model confidence score (0–1).
    - `expected_close` number, nullable: Median predicted close from the Kronos ML model. null on fallback.
    - `pred_high` number, nullable: P90 predicted bar high. null on fallback.
    - `pred_low` number, nullable: P10 predicted bar low. null on fallback.
    - `pred_volatility` number, nullable: Forward 1-bar volatility as a fraction of price. null on fallback.
    - `prob_up` number, nullable: P(close > current price) from the Kronos ML model.
    - `quantiles` object, nullable: Predicted close price distribution (p10–p90). null on fallback.
      - `p10` number
      - `p25` number
      - `p50` number
      - `p75` number
      - `p90` number
  - `model` string, required: Model used: 'Kronos-small' (ML) or 'kronos-signal-composite-v1 (fallback)' (indicator heuristic).
  - `inference_seconds` number, nullable: Inference latency from the Kronos ML service. Only present on ML path.
  - `disclaimer` string, required: Mandatory disclaimer. Probabilistic output only; not financial advice.

## Other responses

- `402`: Payment Required — x402 micropayment instructions in response body

---

[API](https://skmtc.dev/kronossignals/apis/kronos-crypto-data-api.md) · [All operations](https://skmtc.dev/kronossignals/apis/kronos-crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kronossignals/apis/kronos-crypto-data-api/revisions/bfdcf7230e93?raw)