Čítanie výsledkov

Po calculate() je každá metrika verejnou vlastnosťou inštancie Analytics — null, ak jej kalkulátor nebežal:

Komentáre v príkladoch ukazujú reťazcovú podobu každej hodnoty pre tri ukážkové obchody zo sekcie Spustenie enginu, s ->scale(2).

Rozpady

Kde to dáva zmysel, metrika poskytuje globálnu hodnotu ->global a rozpady ->forPair(), ->forBaseCurrency() a ->forQuoteCurrency(), každý rozdelený na total, buy a sell. Páry sa zapisujú ako ZÁKLAD/KÓTA, presne tak, ako ich vracia Trade::pair():

// Every level splits into total, buy and sell
$analytics->counts->global->total;                  // '3' — every trade
$analytics->counts->global->buy;                    // '2'
$analytics->counts->global->sell;                   // '1'

$analytics->counts->forPair('ETH/USD')->total;      // '2'
$analytics->counts->forBaseCurrency('ETH')->sell;   // '1'
$analytics->counts->forQuoteCurrency('USD')->total; // '3'

Agregáty

Metriky typu suma — volume, value, commission, duration, P&L a kumulatívny výnos — majú na každej úrovni agregát aj s párom, ktorý určil krajné hodnoty. Každý agregát nesie aj count — počet obchodov, z ktorých vznikol — a jeho priemer delí presne týmto počtom: realizované hodnoty uzavretými obchodmi, nerealizované otvorenými:

$pnl = $analytics->realizedProfitAndLoss->net->global->total;

$pnl->total;        // '781.00' — the sum
$pnl->count;        // 3 — the trades that fed it: here, the closed trades
$pnl->average;      // '260.33' — the total divided by that count
$pnl->highest;      // '990.00' — the best single trade
$pnl->highestPair;  // 'BTC/USD'
$pnl->lowest;       // '-306.00' — the worst single trade
$pnl->lowestPair;   // 'ETH/USD'

Obchody bez zisku a straty a prázdne hodnoty

• Obchod s P&L presne 0 je uzavretý obchod, ktorý nevyhral ani neprehral: započíta sa do menovateľa miery výhier aj do expectancy, ale nie do priemernej straty pomeru rizika a výnosu, a ukončí sériu výhier aj prehier.
• Menej ako dva obchody alebo obchody otvorené v tej istej sekunde nechajú frekvenciu na 0 bez jednotky.
• Hodnota, ktorú nie je čím deliť — bez straty pri profit factore či pomere rizika a výnosu, bez odchýlky pri Sharpeho či Sortinovom pomere —, zostáva 0.

Tvary výsledkov

Prechádzanie rozpadov

Verejné polia perPair, perBaseCurrency a perQuoteCurrency obsahujú všetky rozpady z behu, s kľúčom podľa páru alebo meny:

foreach ($analytics->realizedProfitAndLoss->net->perPair as $pair => $pnl) {
    echo $pair, ': ', $pnl->total->total, PHP_EOL;
}
// BTC/USD: 990.00
// ETH/USD: -209.00

array_keys($analytics->counts->perBaseCurrency);  // ['BTC', 'ETH']
array_keys($analytics->counts->perQuoteCurrency); // ['USD']

forPair() a ďalšie metódy rozpadov vrátia pre pár alebo menu bez obchodov nulové hodnoty — nikdy null.

Viac kótovaných mien

Globálne súčty sčítajú sumy zo všetkých kótovaných mien tak, ako sú. Ak obchodujete voči viacerým kótovaným menám, sumy čítajte po menách cez forQuoteCurrency().