API AIgnal.tech — Документация

Документация по JSON-ответу

- signal ("buy" | "sell" | "hold")

Итоговый сигнал ансамбля по большинству голосов.

- confidence (float)

Средняя уверенность моделей, поддержавших итоговый сигнал (0–1).

- updated_at (str, ISO8601)

Время формирования прогноза (UTC).

- predicted_return (float)

Прогнозируемая доходность на следующей свече (в долях, например 0.0023 = +0.23%).

- expected_price (float)

Ожидаемая цена закрытия.

- current_price (float)

Цена закрытия последней свечи.

- profit_after_fee (float)

Прогнозируемая доходность с учётом комиссии (transaction_cost).

- profit_usd_after_fee (float)

То же самое, но выражено в долларах США.

- threshold_used (float)

Среднее стандартное отклонение предсказаний, использованное как порог фильтрации шума.

- transaction_cost (float)

Используемая комиссия (по умолчанию 0.0005 = 0.05%).

- model_version (str)

Версия модели/ансамбля для отслеживания экспериментов.

- model_votes (list[dict])

Содержит подробности по каждой модели.

Таким образом вы можете:

- быстро использовать signal + confidence для простых решений,

- использовать predicted_return, profit_after_fee и profit_usd_after_fee для точного расчёта PnL,

- анализировать работу каждой модели через model_votes.

{
        "signal": "buy",                        // Итоговое решение ансамбля (покупать)
        "confidence": 0.83,                     // Средняя уверенность моделей, проголосовавших за "buy"
    
        "predicted_return": 0.0021,             // Прогноз доходности = +0.21 % (в долях)
        "expected_price": 114170.4,             // Ожидаемая цена закрытия = 113 930.0 × (1 + 0.0021)
        "current_price": 113930.0,              // Цена закрытия последней свечи (реальное значение)
    
        "profit_after_fee": 0.0016,             // Чистая доходность после комиссии (0.16 %)
        "profit_usd_after_fee": 182.29,         // То же в USD = 0.0016 × 113 930.0
    
        "threshold_used": 0.0008,               // Среднее σ предсказаний (порог фильтрации шума)
        "transaction_cost": 0.0005,             // Комиссия (0.05 %)
        "prediction_horizon": 1,                // Горизонт прогноза: 1 свеча вперёд
        "updated_at": "2025-09-10T18:22:36Z",   // Время формирования прогноза (UTC)
    
        "model_votes": [                        // Голоса каждой модели
        {
            "model": "RandomForest",
            "pred": 0.0023,
            "threshold": 0.0007,
            "signal": "buy",
            "confidence": 0.87,
            "expected_price": 114190.1,
            "current_price": 113930.0
        },
        {
            "model": "LightGBM",
            "pred": 0.0018,
            "threshold": 0.0009,
            "signal": "buy",
            "confidence": 0.79,
            "expected_price": 114135.1,
            "current_price": 113930.0
        },
        {
            "model": "CatBoost",
            "pred": 0.0021,
            "threshold": 0.0008,
            "signal": "buy",
            "confidence": 0.84,
            "expected_price": 114170.4,
            "current_price": 113930.0
        }
        ],
    
        "model_version": "2025-09-01_v1",
        "candles": [
        { "time": "2025-08-23T18:00:00Z", "open": 59000, "high": 59500, "low": 58800, "close": 59300 },
        { "time": "2025-08-23T19:00:00Z", "open": 59300, "high": 59800, "low": 59000, "close": 59650 }
        /* … ещё N свечей … */
        ]
    }