AI Predictions API

Overview

The predictions API streams intraday forecasts generated by our transformer ensemble. Each datapoint includes a confidence score, expected move, and contributing factors so you can automate execution or enrich your dashboards.

Endpoint

• GET /api/predictions – Returns forecasts for the requested symbol, horizon, and granularity.
• Query parameters:
  • symbol (required) – e.g. BTCUSDT.
  • horizon – 15m, 1h, or 6h.
  • limit – Up to 96 datapoints per request.

Response

{
  "data": [
    {
      "symbol": "BTCUSDT",
      "horizon": "1h",
      "prediction": 66890.42,
      "baseline": 66210.18,
      "expectedMovePct": 1.02,
      "confidence": 0.79,
      "factors": {
        "orderflow": 0.42,
        "funding": 0.18,
        "macro": 0.15,
        "ai_residual": 0.25
      },
      "generatedAt": "2025-11-04T18:10:00.000Z"
    }
  ]
}

Websocket beta

Subscribe to wss://api.txh.one/predictions to receive push updates whenever the model refreshes. Provide your API token using the Authorization header during the handshake. Each message mirrors the REST payload.