Open source
Trading Analytics for Laravel
composer require roundly-consulting/trading-analytics-for-laravelPrehľad
Výpočtová knižnica, ktorá z prúdu obchodov zostaví kompletný prehľad výkonnosti: realizovaný a nerealizovaný zisk a stratu (P&L), kumulatívne výnosy, mieru výhier, série, profit factor, expectancy, maximálny drawdown a Sharpeho a Sortinov pomer — globálne aj podľa obchodného páru, základnej a kótovanej meny, zvlášť pre nákupy a predaje. Každé číslo sa počíta v bcmath a vracia ako hodnotový objekt nad reťazcom, takže súčty sa nikdy nerozídu. Nič neukladá a nemá žiadne migrácie: cez fasádu TradingAnalytics mu odovzdajte obchody, riadky z databázy alebo zoradený dopyt a čítajte výsledky, alebo ich vráťte priamo z controllera ako JSON. Jeden prechod bez histórie obchodov — pamäť sa nezväčšuje, nech je história akokoľvek dlhá. Licencia MIT a minimum závislostí: ext-bcmath, Laravel a dva základné balíky Roundly.
Čo získate
Kompletná sada metrík
Realizovaný a nerealizovaný P&L, kumulatívne výnosy, miera výhier, série, profit factor, expectancy, max drawdown, Sharpe a Sortino — 17 výsledkov.
Podľa párov a mien
Každá metrika globálne aj podľa obchodného páru, základnej a kótovanej meny — zvlášť spolu, pre nákupy a pre predaje.
Presnosť bcmath
Všetka aritmetika beží v bcmath a každé číslo je hodnotový objekt nad reťazcom — žiadne odchýlky pohyblivej čiarky v súčtoch.
Jeden prechod, stála pamäť
Odovzdajte obchody, riadky alebo zoradený dopyt — dopyty sa streamujú po stránkach a engine si nedrží históriu obchodov, takže pamäť sa nezväčšuje.
Len metriky, ktoré potrebujete
only() a except() s automatickými závislosťami a metrics() na zistenie všetkých kalkulátorov, ktoré engine spúšťa.
Výstup pripravený pre API
Engine aj každý výsledok implementujú Arrayable, Jsonable a JsonSerializable — vráťte ich priamo z controllera.
Fasáda, DI a rozšírenia
Jedna fasáda TradingAnalytics alebo injektovateľný manažér, k tomu háčiky, vlastné kalkulátory a vlastná podtrieda Analytics cez using().
Dokumentácia
Inštalácia
Inštalácia cez Composer — bez migrácií, šablón či príkazov na nastavenie — a voliteľné publikovanie konfiguračného súboru.
Konfigurácia
Dva konfiguračné kľúče (predvolená škála bcmath a obdobie pre mieru výhier), ich env premenné a ako ich prepíše jeden beh.
Fasáda TradingAnalytics
Celé API na jednej fasáde — vytvorenie či spustenie enginu pre obchody, riadky alebo dopyt, lenivé mapovanie, zoznam kalkulátorov a vlastný engine.
Bez fasády
Injektujte TradingAnalyticsManager s rovnakým API bez statických volaní alebo spúšťajte triedu enginu Analytics priamo.
Vytváranie obchodov
Vytvárajte hodnotové objekty Trade z pomenovaných skalárov, riadkov poľa alebo polí NumericValueAsString — otvorené aj uzavreté, s validáciou.
Načítanie histórie obchodov
Odovzdajte fasáde priamo query builder, Eloquent builder alebo reláciu — streamuje sa po stránkach podľa času zatvorenia, v pamäti je vždy jedna.
Poradie obchodov
Drawdown, série a priebežný kumulatívny výnos sledujú poradie zatvárania — obchody mimo poradia vyhodia výnimku namiesto skreslených čísel.
P&L a ROI jedného obchodu
Zistite pár, stav, hrubý a čistý P&L a ROI jedného obchodu alebo ho serializujte do poľa s oboma hodnotami.
Spustenie enginu
Spustite engine cez fasádu TradingAnalytics — nastavte presnosť a obdobie, vyberte metriky a všetko vypočítajte v jednom prechode.
Výber metrík
Spúšťajte len potrebné kalkulátory cez only() a except(), nájdite ich cez metrics() a pozrite si, ktoré závislosti sa pridajú.
Čítanie výsledkov
Všetky výsledkové vlastnosti a ako fungujú rozpady — globálne, podľa páru, základnej a kótovanej meny, vždy na total, buy a sell.
Presnosť
Ktoré hodnoty sa riadia škálou behu a ktoré majú pevnú — bcmath oreže a pomery sa najprv delia v plnej presnosti.
Zisk a strata (P&L)
Realizovaný a nerealizovaný P&L, hrubý aj čistý po poplatkoch, s rozdelením na zisky a straty a profit factor podľa párov a mien.
Kumulatívne výnosy
Zložené výnosy v percentách, hrubé aj čisté po poplatkoch, s geometrickým priemerom na obchod a priebežnými maximami a minimami.
Miera výhier a série
Víťazné obchody a miera výhier, najdlhšie série výhier a prehier a miera výhier po dňoch, týždňoch alebo mesiacoch.
Expectancy, drawdown a rizikové pomery
Expectancy, pomer rizika a výnosu, maximálny drawdown a Sharpeho a Sortinov pomer — všetko z uzavretých obchodov v bcmath.
Objem, hodnota, poplatky a čas
Obchodované množstvo a nominálna hodnota, súčty poplatkov, ako často sa obchody otvárajú a ako dlho pozície zostávajú otvorené.
JSON a odpovede API
Vráťte engine alebo ktorýkoľvek výsledok priamo z controllera — každý objekt je Arrayable, Jsonable a JsonSerializable.
Práca s NumericValueAsString
Hodnotový objekt nad bcmath za každým číslom — vytvorenie, aritmetika a meniteľnosť, zaokrúhľovanie, porovnania a formátovanie.
Enumy Direction a Period
Enumy Direction (buy/sell) a Period (daily/weekly/monthly), ich doménové metódy a zdieľaní pomocníci pre výbery a validáciu.
Rozšírenie enginu
Háčiky pre každý obchod aj po prechode, vlastné kalkulátory cez AnalyticsInterface, podtriedy Analytics cez using() a pomocníci BcMath.
Výnimky
Každá výnimka balíka dedí z TradingAnalyticsException — neplatné obchody, nezoradené zdroje, škály a čísla, neznáme kalkulátory či enginy.
Testovanie
Testujte svoje prehľady na ručne vytvorených obchodoch — bez databázy a bez náhradných implementácií — a overujte presné reťazce.
Požiadavky
PHP 8.4+ s rozšírením bcmath a Laravel 12 alebo 13 — bez databázových tabuliek, migrácií či frontov.
Prejavte lásku k open source
Tento balík je zadarmo pod licenciou MIT. Ak vám šetrí čas, jednorazový príspevok alebo členstvo na Patreone nám pomôže ho ďalej udržiavať, testovať a dokumentovať.
Ďalšie spôsoby podpory vrátane kryptomienOdoslaním daru súhlasíte s našimi podmienkami prijímania darov.
Chcete to zabudovať do svojho produktu?
Naše balíky integrujeme do zákazkových Laravel a AI riešení. Napíšte nám, na čom pracujete, a ozveme sa do 48 hodín.