src.utils.candle
🦉 AthenaAI is an AI-powered ensemble machine-learning trading bot for PocketOption, built on BinaryOptionsToolsV2 → Get it on GitLab
💬 Need help? Join the Chipa Discord · ⚡ Go no-code with ChipaEditor
Source: src/utils/candle.py. Two plain dataclasses with no methods.
@dataclass Candle
One OHLCV bar.
| Field | Type | Default | Meaning |
|---|---|---|---|
timestamp | float | — | Unix epoch seconds (UTC) of the candle |
open | float | — | Open price |
high | float | — | High price |
low | float | — | Low price |
close | float | — | Close price |
volume | float | 0.0 | Volume (0 when the feed has none — volume features then use neutral fallbacks) |
Produced by AITradingBot._parse_candle() (live feed, see bot.md) and src.training.dataset.load_candles() (CSV, see dataset.md); consumed by FeatureEngine.compute() and RegimeDetector.detect().
@dataclass TradeRecord
One placed trade, updated in place when its result arrives.
| Field | Type | Default | Meaning |
|---|---|---|---|
id | str | — | Trade ID returned by PocketOption buy()/sell() |
direction | str | — | "call" or "put" (string value of Direction) |
asset | str | — | Trading pair, e.g. "EURUSD" |
stake | float | — | Amount risked in $ |
confidence | float | — | Ensemble confidence at entry (fraction, 0–1) |
regime | str | — | Regime string value at entry |
entry_time | float | — | Unix epoch seconds when placed |
expiry | int | 120 | AI-chosen expiry in seconds |
result | Optional[str] | None | "win" / "loss" / "draw" once resolved |
profit | Optional[float] | None | $ profit (stake × 0.85 on win, −stake on loss, 0.0 on draw) |
exit_time | Optional[float] | None | Unix epoch seconds when resolved |
features_json | Optional[str] | None | Feature vector at entry, JSON-encoded list — this is what the journal reload retrains from |
Internals note: src/bot.py additionally attaches two dynamic, non-declared attributes after placing a trade — record._features (the raw np.ndarray) and record._direction_int (1 for CALL, 0 for PUT). These are used by _result_checker() for online learning and are never persisted; only features_json reaches the database (journal.md).
Usage
from src.utils.candle import Candle, TradeRecord
c = Candle(timestamp=1720569600.0, open=1.0812, high=1.0815,
low=1.0810, close=1.0814, volume=132.0)
t = TradeRecord(id="abc123", direction="call", asset="EURUSD",
stake=25.0, confidence=0.66, regime="ranging",
entry_time=1720569660.0, expiry=300)See also
- journal.md — how
TradeRecordmaps to thetradestable - bot.md — lifecycle of a
TradeRecord
💬 Unsure how this interacts with the rest of the configuration? Ask in the Chipa Discord — or prototype strategies no-code with ChipaEditor.