{"uid":"cap_Bcvc4I40WJdm8zYwzbhx_","slug":"kronos-btc-forecast-api-1b7346aa","name":"Kronos BTC Forecast API","description":"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.","url":"https://kronossignals.com/api/v1/forecast/btc","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5yIsvOORTn7M6KZ5mIwaz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a probabilistic Bitcoin price forecast with technical indicators and directional confidence over a chosen time horizon","exampleAgentPrompt":"What's the Kronos signal composite forecast for BTC over the next 4 hours — give me the up probability, confidence, and expected price range?","exampleUseCases":[{"title":"Alert me if Bitcoin turns bullish","prompt":"Check the Kronos BTC forecast for the next hour and let me know if the up probability crosses above 65% — I want to know immediately if the technical signal flips bullish."},{"title":"Monitor 24-hour Bitcoin momentum","prompt":"Give me the latest Kronos composite signal for Bitcoin over the next 24 hours, including the RSI, MACD, and the directional probability — I need to know if momentum is building or fading."},{"title":"Validate trade entry with technicals","prompt":"Pull the Kronos forecast for BTC over the next 4 hours and show me the confidence score, price range, and whether the EMA and MACD indicators are aligned — I want to confirm it's a good entry point before I trade."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:44:42.457Z","isFirstParty":false}