# Kronos BTC Forecast API

> Kronos BTC Forecast API is a paid API for AI agents from kronossignals.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns a probabilistic Bitcoin price forecast with technical indicators and directional confidence over a chosen time horizon

## Facts

- Endpoint: GET https://kronossignals.com/api/v1/forecast/btc
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kronos-btc-forecast-api-1b7346aa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Bcvc4I40WJdm8zYwzbhx_

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability kronos-btc-forecast-api-1b7346aa
```

Example prompt: What's the Kronos signal composite forecast for BTC over the next 4 hours — give me the up probability, confidence, and expected price range?

## When to prefer this

Choose this endpoint when you need a fast, cheap ($0.01 USDC), machine-readable BTC price forecast combining multiple technical indicators (EMA, RSI, MACD, ATR) into a single directional probability signal. It is especially useful for agents that need to make automated trading or alerting decisions based on BTC momentum without building their own indicator pipeline. Prefer it over raw exchange data feeds when a composite confidence-weighted signal is needed out of the box.

## Known failure modes

- Invalid horizon parameter value (not 1h/4h/24h) returns a 400 error
- Payment not received or x402 payment handshake fails — returns 402 Payment Required
- Upstream Binance data unavailable — may return 503 or stale data
- Rate limiting or overage may return 429 Too Many Requests
- Malformed request headers may return 400 or 422

## How this service works

Real-time and ML-forecasted Bitcoin (BTC) price. Kronos deep-learning model: up-probability, expected close, price range, p10-p90 quantiles, forward volatility across 1h/4h/24h horizons. Crypto price prediction / price forecast API for AI agents and trading bots. Pay-per-call via x402 on Base USDC. Live track record at /api/stats: ~54% directional hit, ~70% in-range over 15k+ scored forecasts — measured on served predictions, not a backtest.

## Output

A JSON object containing the BTC-USD asset tag, model name (kronos-signal-composite-v1 using EMA/RSI/MACD/ATR), current close price and ATR, the data source (Binance), the requested horizon, a forecast block with directional probability (up_prob), confidence score, and low/high price range, plus a full set of technical indicators (RSI14, MACD, MACD signal, MACD histogram, EMA20, EMA50, ATR14), and a disclaimer that results are heuristic signals not financial advice.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "horizon": {
       "enum": [
        "1h",
        "4h",
        "24h"
       ],
       "type": "string",
       "default": "1h",
       "description": "Forecast horizon: 1h = 1-hour candles, 4h = 4-hour candles, 24h = daily candles"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "asset": "BTC-USD",
  "model": "kronos-base-60path-t1-v2",
  "price": {
   "atr": 800,
   "close": 107500
  },
  "cached": true,
  "source": "Kronos-base (cached, 60-path MC)",
  "horizon": "1h",
  "forecast": {
   "n_paths": 60,
   "prob_up": 0.67,
   "up_prob": 0.67,
   "pred_low": 106100,
   "pred_high": 108500,
   "quantiles": {
    "p10": 106300,
    "p25": 107000,
    "p50": 107620,
    "p75": 108200,
    "p90": 108700
   },
   "range_low": 106300,
   "confidence": 0.67,
   "range_high": 108700,
   "horizon_bars": 1,
   "expected_close": 107620.5,
   "pred_volatility": 0.0079
  },
  "disclaimer": "Kronos-base ML forecast (60-path Monte-Carlo), cached; regenerated every ~20 min. Informational only, not financial advice.",
  "generated_at": "2026-07-01T10:00:00.000Z",
  "cache_age_seconds": 180
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kronos-btc-forecast-api-1b7346aa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kronossignals.com](https://www.zero.xyz/host/kronossignals.com/llms.txt)