kronossignals.com

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