diff --git a/docs/API-NOTES.md b/docs/API-NOTES.md index 34f3b34..ae9e02a 100644 --- a/docs/API-NOTES.md +++ b/docs/API-NOTES.md @@ -151,8 +151,11 @@ Ogni fatto non verificabile resta dietro una protezione. I nomi delle impostazio | A2 conto reale italiano | Anubis funziona tutto in paper. L'apertura del conto reale è una voce di `GO-LIVE.md`. | 2, 9 | | A3 crypto su Alpaca | L'adapter Alpaca non espone la crypto. | 2 | | A5 notizie Alpaca nel piano gratuito | Fonte facoltativa (`news.alpaca.enabled`): si spegne da sola se risponde 401/403; restano le fonti della sezione 4.4. | 7 | -| O3b coppie del demo europeo | Elenco fisso di coppie in EUR e USDC, confrontato con `account/instruments` appena ci sono le chiavi demo. | 3 | -| O7 liquidità | Elenco fisso di coppie ammesse e filtro sullo spread prima di ogni ordine. | 3, 5 | +| O3b coppie del demo europeo | Elenco fisso di coppie in EUR e USDC, confrontato con `account/instruments` appena ci sono le chiavi demo (in attesa dell'utente). | 3 | +| O7 liquidità | Elenco fisso di coppie ammesse (Fase 2); il filtro sullo spread prima di ogni ordine arriva con le strategie. | 5 | +| Permessi delle chiavi Alpaca | Alpaca non ha permessi per chiave né un modo di leggerli: Anubis tratta ogni chiave come capace di ordinare e mai di prelevare, e usa solo il conto paper. | 3 | +| Riuso dell'id d'ordine dopo la chiusura | Anubis non lo riusa mai: ogni ordine ha un id nuovo e deterministico (ADR 0001). | 3 | +| Attività `FEE` e dividendi di Alpaca | Il conto paper non li simula: si confrontano con la riconciliazione quando ci saranno le chiavi (ADR 0009). | 3, 6 | | F3b limite del calendario | Una richiesta all'ora, al massimo una ogni 5 minuti anche ai riavvii; la pagina di blocco conta come errore. | 2 | | M3 velocità del classificatore | Misura nella Fase 7; sopra i 50 ms per titolo si segnala all'utente. | 7 | | V2 blocco ETF di Alpaca | Filtro ETF di Anubis attivo di base, indipendente dal broker. | 2 | @@ -188,6 +191,33 @@ Fatti controllati scrivendo gli adapter dei dati, il 10/11/2026. Le risposte reg **Non verificabile senza scambi reali** - Se OKX ometta i minuti senza scambi o li dia a volume zero. Il collector tratta un minuto mancante come buco, lo riscarica una volta e poi lo segna "non recuperabile, forse minuti senza scambi". +## Verifiche della Fase 3 (conti e ordini) + +Fatti controllati sulla documentazione ufficiale il 10/11/2026, scrivendo la parte conti degli adapter. Nessuna chiave, nessun ordine: le risposte d'esempio della documentazione stanno in `tests/Anubis.Tests/Fixtures/alpaca-trading` e `okx-trading`, e la batteria di conformità (`BrokerConformanceTests`) le usa senza rete. + +| Fonte | Fatto | Cosa fa Anubis | +|---|---|---| +| Alpaca | Gli ordini su frazioni di azione accettano solo la validità `day`, stop compresi; con `gtc` la risposta è 422 "fractional orders must be DAY orders". | Stop `gtc` sulle azioni intere; sulla parte frazionaria uno stop `day` rimesso a ogni seduta (ADR 0009, punto 8). | +| Alpaca | `client_order_id` fino a 128 caratteri; un id già usato da un ordine attivo dà 422 con codice 40010001. Non è scritto se si possa riusare dopo la chiusura. | Id deterministici `ANU…`, mai riusati; un 422 di id doppio significa che l'invio precedente è arrivato, e l'ordine si rilegge con `orders:by_client_order_id`. | +| Alpaca | Prezzi limite e stop: 2 decimali da 1 $ in su, 4 sotto; altrimenti 422 42210000 "sub-penny increment". | I prezzi si arrotondano prima dell'invio, verso il lato prudente. | +| Alpaca | Nessuna commissione. Tasse dal listino del 12/10/2026: SEC 0,0000206 sul controvalore delle vendite, FINRA TAF a zero, CAT 0,000003 $ per azione su acquisti e vendite, arrotondate per eccesso al centesimo una volta al giorno. | Il simulatore le arrotonda per eccesso a ogni esecuzione (più prudente). | +| Alpaca | Il conto paper non simula tasse né dividendi; il 10% delle esecuzioni è parziale a caso. | Le attività `FEE` e `DIV` si leggono ma si confrontano con il registro solo con le chiavi. | +| Alpaca | Le chiavi non hanno permessi né un modo per leggerli; l'unico segnale è `transfers_blocked` del conto. | Una chiave Alpaca vale "ordina, non preleva". Anubis la usa solo verso il conto paper. | +| Alpaca | Gli ordini `gtc` si annullano da soli dopo 90 giorni (`expires_at`). | Il gestore rimette lo stop quando lo vede chiuso. | +| Alpaca | Il flusso `trade_updates` ha due eventi in più (`order_replace_rejected`, `order_cancel_rejected`) e lo stato `held`. | Lo stato si prende dall'ordine dentro il messaggio; uno stato sconosciuto conta come "inviato" e le esecuzioni arrivano comunque dalla richiesta REST. | +| OKX | `clOrdId` è unico solo tra gli ordini aperti; il doppione dà 51016 ("Client order ID already exists"), 51065 per gli algoritmici. | 51016 e 51065 vogliono dire "l'invio precedente è arrivato": si rilegge l'ordine invece di rimandarlo. | +| OKX | Un ordine annullato senza esecuzioni sparisce dallo storico dopo 2 ore. | Un ordine OKX sconosciuto al broker da più di 2 ore si considera annullato (ADR 0009). | +| OKX | Le esecuzioni non hanno un `fillId`: la chiave è `tradeId`, unica per strumento. | Ogni esecuzione si registra una volta come `instId:tradeId`. | +| OKX | Un ordine market spot che supera il saldo viene ridotto e eseguito, non rifiutato. | Il registro prende la quantità eseguita davvero, non quella chiesta. | +| OKX | Gli ordini trigger (stop) non bloccano le monete: se allo scatto il saldo è minore, OKX vende quello che c'è. | Gli stop seguono la quantità della posizione dopo ogni esecuzione. | +| OKX | `account/config` dà `perm` con `read_only`, `trade`, `withdraw`, e `feeType` (0 commissione nella moneta ricevuta, 1 nella valuta di quotazione). La chiave d'esempio della documentazione ha `withdraw`. | La chiave d'esempio è rifiutata (test `KeysAreAskedToTheBrokerBeforeTheyAreKept`); una chiave con `withdraw` tiene il conto in modalità prudente. | +| OKX | Il canale `orders` è su `/ws/v5/private` e non manda lo stato iniziale; `orders-algo` è su `/ws/v5/business`. | Il flusso serve solo ad accorgersi prima: ordini ed esecuzioni si rileggono comunque via REST a intervalli regolari, che coprono anche i buchi del flusso. | +| OKX | La pagina delle tariffe e l'esempio di `trade-fee` mostrano ancora 0,08% maker e 0,10% taker; l'avviso per l'Europa dice 0,10% e 0,20% dal 25/09/2026 (O5). | Il simulatore usa la tariffa più alta; con le chiavi vale `trade-fee` del conto. | + +**In attesa delle chiavi dei conti di prova** +- Le classi `AlpacaPaperConformance` e `OkxDemoConformance` (categoria `LiveDemo`) eseguono la stessa batteria sui veri conti di prova. Senza chiavi risultano "in attesa dell'utente". +- Da controllare con le chiavi: l'elenco delle coppie del demo europeo (O3b), se OKX chieda `tradeQuoteCcy` ai conti europei, i caratteri ammessi in `client_order_id` su Alpaca. + ## Versioni di .NET e dei pacchetti ammessi Ultime versioni stabili lette dall'API di NuGet il 10 novembre 2026. Quelle già in uso sono fissate in `Directory.Packages.props`. Gli altri pacchetti si aggiungono nella fase in cui servono, dopo un nuovo controllo della versione. diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index e5a9be6..53ac18b 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -10,9 +10,9 @@ aperta la fase. Se questo file e Gitea divergono, vale Gitea e si corregge quest | Fase | Titolo | Stato | |---|---|---| | 0 | [Preparazione](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/27) | Completata | -| 1 | [Fondamenta](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/28) | Da fare | -| 2 | [Dati di mercato](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/29) | Da fare | -| 3 | [Conti, ordini, contabilità](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/30) | Da fare | +| 1 | [Fondamenta](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/28) | Completata | +| 2 | [Dati di mercato](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/29) | Completata (azioni in attesa delle chiavi Alpaca) | +| 3 | [Conti, ordini, contabilità](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/30) | Completata (conti di prova in attesa delle chiavi) | | 4 | [Backtest e laboratorio](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/31) | Da fare | | 5 | [Strategie, portafoglio, rischio](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/32) | Da fare | | 6 | [Motore dal vivo in simulazione](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/33) | Da fare | @@ -111,22 +111,22 @@ Ordini sicuri e ogni euro tracciato. **Lavori** -- [ ] [#26](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/26) Conti e ordini nell'interfaccia BrokerAdapter e simulatore interno (PaperBroker) -- [ ] [#27](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/27) OMS: macchina a stati, identificativi deterministici, limite che insegue, ritmo degli invii -- [ ] [#28](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/28) Stop di protezione: stop sul broker, stop che seguono la quantità, stop già superato, residui invendibili -- [ ] [#29](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/29) Ambienti, capitale affidato e contabilità: registro, lotti, patrimonio, rendimento corretto -- [ ] [#30](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/30) Riconciliazione con i conti e modalità prudente -- [ ] [#31](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/31) Adapter Alpaca (paper) e OKX (demo) e batteria di conformità `live_demo` -- [ ] [#32](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/32) Schermata Conti e posizioni; conti in Impostazioni e nel primo avvio -- [ ] [#33](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/33) Chiusura della fase, revisione indipendente e tag `fase-3` +- [x] [#26](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/26) Conti e ordini nell'interfaccia BrokerAdapter e simulatore interno (PaperBroker) +- [x] [#27](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/27) OMS: macchina a stati, identificativi deterministici, limite che insegue, ritmo degli invii +- [x] [#28](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/28) Stop di protezione: stop sul broker, stop che seguono la quantità, stop già superato, residui invendibili +- [x] [#29](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/29) Ambienti, capitale affidato e contabilità: registro, lotti, patrimonio, rendimento corretto +- [x] [#30](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/30) Riconciliazione con i conti e modalità prudente +- [x] [#31](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/31) Adapter Alpaca (paper) e OKX (demo) e batteria di conformità `live_demo` +- [x] [#32](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/32) Schermata Conti e posizioni; conti in Impostazioni e nel primo avvio +- [x] [#33](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/33) Chiusura della fase, revisione indipendente e tag `fase-3` **Criteri di accettazione** -- [ ] I test di proprietà contabili passano -- [ ] La batteria di conformità passa sul simulatore e, se le chiavi demo ci sono, sui due conti di prova (altrimenti su risposte d'esempio, criterio in attesa dell'utente) -- [ ] I test con guasti di questa parte passano -- [ ] Un test dimostra che gli adapter rifiutano un ambiente reale senza il consenso della configurazione d'avvio, in Docker e su desktop -- [ ] La schermata Conti e posizioni corrisponde al mockup +- [x] I test di proprietà contabili passano (`RandomFillsNeverBreakTheBooks`: esecuzioni casuali a seme fisso, registro, lotti e liquidità sempre in pari) +- [ ] La batteria di conformità passa sul simulatore e, se le chiavi demo ci sono, sui due conti di prova (altrimenti su risposte d'esempio, criterio in attesa dell'utente) — **simulatore e risposte d'esempio fatti** (`PaperBrokerConformance`, `AlpacaDocConformance`, `OkxDocConformance`); **conti di prova in attesa dell'utente** (`AlpacaPaperConformance`, `OkxDemoConformance`) +- [x] I test con guasti di questa parte passano (risposta persa e mai rimandata, esecuzioni doppie, broker che non risponde, stop scattato senza avviso, differenze non spiegate: `OrderManagerTests`, `ReconcilerTests`) +- [x] Un test dimostra che gli adapter rifiutano un ambiente reale senza il consenso della configurazione d'avvio, in Docker e su desktop (`RealAccountsAreRefusedWithoutTheStartupConsent`, `BrokerAdaptersRefuseARealAccountBeforeAnyRequest`) +- [x] La schermata Conti e posizioni corrisponde al mockup (`TheDemoShowsTheFiguresOfTheMockup` e screenshot a 1440 e 390 px, chiaro e scuro) ## Fase 4 — Backtest e laboratorio diff --git a/docs/STATE.md b/docs/STATE.md index 77fe03e..c9572ed 100644 --- a/docs/STATE.md +++ b/docs/STATE.md @@ -4,7 +4,7 @@ Aggiornato: 2026-11-10 ## Fase corrente -**Fase 2 — Dati di mercato: completata**, con la parte azionaria in attesa delle chiavi del conto di prova Alpaca. La prossima è la Fase 3 (Conti, ordini, contabilità), da iniziare con il via dell'utente. +**Fase 3 — Conti, ordini, contabilità: completata**, con le prove sui conti di prova in attesa delle chiavi demo di OKX e di Alpaca. La prossima è la Fase 4 (Backtest e laboratorio), da iniziare con il via dell'utente. ## Fatto @@ -54,6 +54,14 @@ Aggiornato: 2026-11-10 - Universi azionario e crypto "a una certa data", senza ETF né fondi. - Rapporto di qualità dei dati (`anubis data report`, `/api/data/quality`) e sezione Dati in Impostazioni con lo stato di ogni fonte. - Prova sui dati reali: BTC, ETH e SOL in EUR dal 21/11/2023 (1.085 giorni ciascuna, nessun buco) e BTCUSDT di Binance dal 17/08/2017 (3.363 giorni). +- **Fase 3** (scelte nell'ADR 0009, fatti verificati in `docs/API-NOTES.md`): + - Interfaccia comune dei conti (`IBrokerAccount`), simulatore interno (`PaperBroker`) e parte conti degli adapter Alpaca (paper) e OKX (demo). Nessun conto reale viene creato; gli adapter rifiutano l'ambiente reale prima di qualsiasi richiesta. + - Gestore degli ordini: stati che vanno solo avanti, id deterministici mai rimandati due volte, limite che insegue il prezzo, al massimo sei invii al minuto con le vendite per prime. + - Stop sul broker per ogni posizione: permanenti sulle azioni intere, giornalieri sulle frazioni, sempre allineati alla quantità; stop già superato; residui invendibili. + - Contabilità per strategia in sola aggiunta: esecuzioni, lotti, registro della liquidità, capitale affidato in euro diviso per quote, dividendi e frazionamenti, fotografie del patrimonio ogni 5 minuti, rendimento ponderato nel tempo. + - Riconciliazione ogni 5 minuti con modalità prudente, scelta "allinea" o "escludi", blocco delle chiavi che permettono i prelievi. + - Schermata Conti e posizioni come il mockup, esportazione CSV delle posizioni; in Impostazioni chiavi (verificate col broker prima di salvarle) e capitale affidato; la Panoramica indica il capitale come primo passo. + - Batteria di conformità sul simulatore e sulle risposte d'esempio della documentazione; sui conti di prova parte da sola quando ci sono le chiavi. ## In corso @@ -61,12 +69,14 @@ Nulla. ## Prossimo passo -Fase 3, conti, ordini e contabilità: simulatore interno, gestione degli ordini, stop di protezione, contabilità, riconciliazione. Servono le chiavi demo di OKX Europe e quelle del conto di prova Alpaca (vedi sotto); senza, la batteria di conformità gira su risposte d'esempio. +Fase 4, backtest e laboratorio: motore di prova sullo storico, con gli stessi costi e le stesse regole d'ordine della Fase 3, e il confronto "senza bot". Con le chiavi dei conti di prova si possono chiudere i due criteri in attesa (azioni della Fase 2, conti di prova della Fase 3). ## Da sapere - Le immagini .NET 10 sono su Ubuntu 24.04, non Debian (ADR 0006). -- La modalità dimostrativa mostra solo le parti già costruite: conti, posizioni, strategie e notizie della Panoramica arrivano con le loro fasi. +- La modalità dimostrativa mostra solo le parti già costruite: strategie e notizie della Panoramica arrivano con le loro fasi. Nella demo il motore di trading è spento. +- Le chiavi dei conti di prova si inseriscono da Impostazioni → Conti e chiavi oppure nel file `.env`; quelle nelle variabili d'ambiente valgono di più. Una chiave OKX che permette i prelievi viene rifiutata. +- Il capitale affidato si decide in euro in Impostazioni → Conti e chiavi. Finché non c'è, le strategie osservano soltanto. - `tasks dev` fuori da Docker usa la cartella dei dati vera dell'utente: per prove usa `tasks seed-demo`. - Alpaca non ha più conti senza margine: il divieto di leva lo impone Anubis (API-NOTES A14). - OKX: WebSocket sulla porta 443, la 8443 è chiusa (API-NOTES O3). @@ -80,9 +90,9 @@ Fase 3, conti, ordini e contabilità: simulatore interno, gestione degli ordini, | Cosa | Da quando serve | Senza | |---|---|---| -| Via libera per la Fase 3 | Subito | Non si parte | +| Via libera per la Fase 4 | Subito | Non si parte | | Chiavi del conto paper di Alpaca (`ALPACA_API_KEY_DEMO`, `ALPACA_API_SECRET_DEMO`) | Già dalla Fase 2 (dati azionari) | Parte azionaria spenta; storico azionario dal 2016 in attesa | -| Chiavi demo di OKX Europe | Fase 3 (ordini sui conti di prova) | Batteria di conformità su risposte d'esempio; criteri in attesa | +| Chiavi demo di OKX Europe, senza permesso di prelievo | Fase 3 (ordini sui conti di prova) | Batteria di conformità su risposte d'esempio; criterio della Fase 3 in attesa | | Un token Gitea con permesso `write:package` come segreto `REGISTRY_TOKEN` | Fase 9 (pubblicazione dell'immagine) | Pubblicazione a mano | | Token del bot Telegram e chat autorizzata (facoltativi) | Fase 6 | Test con un finto server | | Chiavi FRED e Finnhub (facoltative, gratuite) | Già dalla Fase 2 | Calendario limitato alla settimana corrente; filtro trimestrali spento | diff --git a/docs/adr/0009-scelte-fase-3.md b/docs/adr/0009-scelte-fase-3.md new file mode 100644 index 0000000..47b8adf --- /dev/null +++ b/docs/adr/0009-scelte-fase-3.md @@ -0,0 +1,77 @@ +# 0009 — Scelte della Fase 3: conti, ordini, contabilità + +Data: 2026-11-10 · Stato: accettata · Precisa la specifica (sezioni 7, 8.6, 9, 13.5, 13.6) e gli ADR 0003, 0007 e 0008, senza aggiungere componenti esterni + +## Contesto + +La Fase 3 collega Anubis ai conti: un'interfaccia comune per i broker, il simulatore interno, il gestore degli ordini con gli stop, la contabilità per strategia, la riconciliazione e la schermata Conti e posizioni. Non ci sono ancora chiavi dei conti di prova, quindi tutto è provato sul simulatore e su risposte d'esempio della documentazione. Alcune scelte non sono scritte nella specifica, o la precisano. Le raccolgo qui. + +## Decisione + +**1. Due interfacce separate per i broker.** `IBrokerAccount` (ordini, posizioni, esecuzioni, permessi della chiave) è distinta da `IMarketDataSource` della Fase 2. Il simulatore interno (`PaperBroker`) e i due adapter (`AlpacaTrading`, `OkxTrading`) la implementano allo stesso modo e passano la stessa batteria di prove. + +**2. Mai conti veri in questa fase.** +- Si creano solo i conti "simulatore" e, con le chiavi di prova, "Alpaca paper" e "OKX demo". Un conto reale non viene mai creato. +- Gli adapter rifiutano l'ambiente reale prima di qualsiasi richiesta se manca il consenso di avvio (SPEC 2.2). Lo controllano i test `LiveSafetyTests`. + +**3. Le strategie partono in osservazione, e dove possono.** +- Le tre strategie di base partono nello stadio "osservazione": non ci sono ancora prove storiche (Fase 4). +- Quando compaiono le chiavi di prova, una strategia passa al conto di prova solo se il suo registro sul simulatore è vuoto. Con una storia resta dov'è, così i risultati non si mescolano. + +**4. Il simulatore ha i soldi che i registri gli danno.** Il simulatore non ha denaro proprio: il suo saldo è almeno la liquidità che i registri delle strategie gli affidano, e cresce quando l'utente aumenta il capitale. + +**5. Commissioni prudenti nel simulatore.** +- OKX: 0,10% maker e 0,20% taker, la tariffa annunciata dal 25/09/2026 (API-NOTES O5), trattenuta nella moneta comprata come fa OKX. La pagina delle tariffe e l'esempio di `trade-fee` mostrano ancora 0,08% e 0,10%: il simulatore usa la più alta. Con le chiavi, la tariffa vera del conto si legge da `trade-fee`. +- Alpaca: nessuna commissione, solo le tasse regolamentari del listino di ottobre 2026 (SEC 0,0000206 sul controvalore delle vendite, CAT 0,000003 $ per azione su acquisti e vendite, TAF a zero), arrotondate per eccesso a ogni esecuzione: più prudente dell'arrotondamento giornaliero del broker. +- Le attività `FEE` di Alpaca non entrano ancora nei registri: si confrontano con la riconciliazione quando ci saranno le chiavi. + +**6. Le esecuzioni si registrano da una sola fonte.** Il flusso degli ordini avvisa che qualcosa è cambiato; le esecuzioni si leggono sempre dalla richiesta REST (`GetFills`) e si salvano una volta sola per conto ed esecuzione. Flusso e richiesta non creano doppioni. + +**7. Ogni ordine ha la sua storia.** Anche la creazione è un evento di `order_events`: si vede quando l'ordine è nato, non solo quando è cambiato. + +**8. Gli stop.** +- Ogni posizione ha uno stop sul broker. Se il prezzo non si conosce, è vecchio o il mercato è chiuso, lo stop si mette comunque: meglio uno stop in più che una posizione scoperta. +- Alpaca: stop permanente (`gtc`) sulle azioni intere; sulle frazioni il broker accetta solo ordini `day`, che il gestore rimette dopo la scadenza. A mercato chiuso restano "in coda per l'apertura" e intanto li sorveglia Anubis. +- Un ordine OKX annullato e sconosciuto al broker da più di 2 ore si considera annullato. + +**9. Contabilità per strategia, in sola aggiunta.** +- `fills`, `lots` e `cash_ledger` non si modificano mai: un errore si corregge con una riga di storno. Un test cerca `UPDATE` e `DELETE` su queste tabelle in tutto il codice. +- Il capitale affidato si decide in euro per broker e si divide tra le strategie secondo le quote. Alpaca lo converte al cambio BCE del giorno e da lì tiene il registro in dollari. +- Ridurre il capitale sotto la liquidità libera di una strategia è rifiutato: il bot non vende per restituire capitale. +- I dividendi vanno a chi aveva il titolo alla chiusura prima della data di stacco, calcolato dalle esecuzioni. Caso limite noto: un frazionamento tra l'acquisto e lo stacco. + +**10. Patrimonio e rendimenti.** +- Ogni 5 minuti una fotografia per strategia, per conto e per mondo (circa 7 righe). +- Mondo simulato e mondo reale non si sommano mai: Panoramica e Conti mostrano un solo mondo, quello reale se esiste un conto reale, altrimenti quello simulato. +- I risultati tolgono i versamenti e i prelievi di capitale; la percentuale è ponderata nel tempo (TWR). +- Le carte dei conti in dollari usano l'ultimo cambio; l'effetto del cambio si mostra a parte. +- Il confronto "senza bot" sui conti reali arriva con la Fase 4. + +**11. Riconciliazione.** +- Ogni 5 minuti registro e conto si confrontano. Sul simulatore si controllano solo la coerenza interna e gli stop. +- Una differenza che si spiega da sola (esecuzione in ritardo, frazionamento, stop da rimettere) si sistema. Una che resta porta il conto in modalità prudente: niente nuovi acquisti, vendite e stop proseguono. +- Dopo 15 minuti l'utente sceglie: **allinea** (il registro prende i numeri del conto, con una riga di rettifica che conta come movimento di capitale, non come risultato) o **escludi** (la differenza resta fuori dal registro e non si segnala più). +- Una chiave che permette i prelievi tiene il conto in modalità prudente finché non viene sostituita: non si allinea né si esclude. + +**12. Chiavi inserite dall'interfaccia.** +- Impostazioni → Conti e chiavi accetta le chiavi dei conti di prova. Prima di salvarle Anubis chiede al broker cosa possono fare. Le rifiuta se permettono i prelievi o se non possono fare ordini. +- Salvate, sono cifrate (SPEC 15.4), non si rimostrano mai e il motore riparte da solo per usarle. +- Le chiavi nelle variabili d'ambiente valgono di più e si cambiano solo lì. +- Finché non c'è capitale affidato, la Panoramica indica questo passo come il primo. + +**13. Batteria di conformità dei broker.** +- Una classe astratta di prove, eseguita sul simulatore, sulle risposte d'esempio della documentazione di Alpaca e OKX e, con le chiavi, sui veri conti di prova (categoria `LiveDemo`). +- Senza chiavi le prove dal vivo risultano "in attesa dell'utente". +- La chiave d'esempio di OKX nella documentazione ha il permesso `withdraw`: la batteria verifica che Anubis lo legga. + +**14. La schermata Conti e posizioni.** +- Il valore di ogni posizione si arrotonda al centesimo nella sua valuta, come lo mostra la tabella, così colonne e totali tornano a vista. +- La modalità dimostrativa carica righe di registro, operazioni chiuse, stop, cambio e stato della riconciliazione: è il registro stesso a calcolare i numeri del mockup. + +**15. Niente operazioni nella modalità dimostrativa.** Il motore di trading è spento nella demo: la demo mostra l'appendice F e non manda nulla. + +## Conseguenze + +- Tutto il percorso dell'ordine è provato senza rete. Le prove con i veri conti di prova aspettano le chiavi dell'utente. +- Dove la specifica lascia spazio, si è scelta la strada più prudente: stop sempre presenti, commissioni piene, nessuna vendita forzata, nessun conto reale. +- I casi limite rimasti (dividendo dopo un frazionamento, attività `FEE` di Alpaca) sono scritti qui e si ricontrollano con le chiavi. diff --git a/src/Anubis.Server/AccountsView.cs b/src/Anubis.Server/AccountsView.cs index 4e8bcc8..15f6f3b 100644 --- a/src/Anubis.Server/AccountsView.cs +++ b/src/Anubis.Server/AccountsView.cs @@ -151,7 +151,7 @@ internal sealed record AccountsView( return new AccountsView(cards, rows.Select(r => r.Row).ToList(), pending, others, alpacaStops, residueRows, slices, fx?.Rate, fx?.Date, fxEffect, market.Open, market.Next); } - /// The positions as CSV for a spreadsheet: semicolons, dot decimals, one row per position. + /// The positions as CSV for an Italian spreadsheet (SPEC 13): semicolons, decimal commas, no thousands separator, one row per position. public string Csv(string? broker) { var text = new StringBuilder("strumento;nome;conto;strategia;quantita;prezzo_medio;prezzo_ora;valuta;valore_eur;risultato_eur;stop;aperta_il\n"); @@ -164,7 +164,8 @@ internal sealed record AccountsView( return text.ToString(); - static string Number(decimal value) => value.ToString(CultureInfo.InvariantCulture); + // Trailing zeros dropped, so both database engines give the same text. + static string Number(decimal value) => (value / 1.000000000000000000000000000000000m).ToString(CultureInfo.InvariantCulture).Replace('.', ','); static string Clean(string value) => value.Replace(';', ',').Replace('\n', ' '); } diff --git a/src/Anubis/Trading/OrderManager.Protection.cs b/src/Anubis/Trading/OrderManager.Protection.cs index 9ad618f..9f50528 100644 --- a/src/Anubis/Trading/OrderManager.Protection.cs +++ b/src/Anubis/Trading/OrderManager.Protection.cs @@ -203,7 +203,7 @@ public sealed partial class OrderManager return; } - var level = OrderRules.StopPrice(position.StopPrice.Value, instrument.Spec.TickSize); + var level = OrderRules.StopPrice(position.StopPrice.Value, OrderRules.TickOf(instrument.Spec, position.StopPrice.Value)); var desired = DesiredStops(instrument, position.Quantity); var current = open.Select(o => (o.Quantity - o.Filled, o.TimeInForce)).OrderBy(x => x.Item1).ToList(); if (open.All(o => o.Stop == level) && current.SequenceEqual(desired.OrderBy(x => x.Quantity))) diff --git a/src/Anubis/Trading/OrderRules.cs b/src/Anubis/Trading/OrderRules.cs index f2c491b..ee7f75f 100644 --- a/src/Anubis/Trading/OrderRules.cs +++ b/src/Anubis/Trading/OrderRules.cs @@ -201,6 +201,21 @@ public static class OrderRules return spec.MinNotional ?? (spec.Venue == Venues.Alpaca ? AlpacaMinimumNotional : 0m); } + /// + /// The price step at a price: the venue's tick, or Alpaca's rule when the catalogue has none (2 decimals from 1 $, + /// 4 below; otherwise 422 "sub-penny increment", API-NOTES Fase 3). + /// + public static decimal? TickOf(InstrumentSpec spec, decimal price) + { + ArgumentNullException.ThrowIfNull(spec); + if (spec.TickSize is > 0m) + { + return spec.TickSize; + } + + return spec.Venue == Venues.Alpaca ? (price >= 1m ? 0.01m : 0.0001m) : null; + } + public static decimal RoundDown(decimal value, decimal step) => step <= 0m ? value : Math.Floor(value / step) * step; public static decimal RoundUp(decimal value, decimal step) => step <= 0m ? value : Math.Ceiling(value / step) * step; @@ -242,8 +257,8 @@ public static class OrderRules return new(rounded, null, null, OrderReasons.BelowMinimumSize); } - var limit = limitPrice is null ? (decimal?)null : LimitPrice(limitPrice.Value, side, spec.TickSize); - var stop = stopPrice is null ? (decimal?)null : StopPrice(stopPrice.Value, spec.TickSize); + var limit = limitPrice is null ? (decimal?)null : LimitPrice(limitPrice.Value, side, TickOf(spec, limitPrice.Value)); + var stop = stopPrice is null ? (decimal?)null : StopPrice(stopPrice.Value, TickOf(spec, stopPrice.Value)); var price = limit ?? stop ?? referencePrice; if (price <= 0m) { diff --git a/src/Anubis/Trading/PaperBroker.cs b/src/Anubis/Trading/PaperBroker.cs index 317e4c1..56e9691 100644 --- a/src/Anubis/Trading/PaperBroker.cs +++ b/src/Anubis/Trading/PaperBroker.cs @@ -682,7 +682,7 @@ public sealed class PaperBroker : IBrokerAccount, IDisposable return "stop_must_be_sell"; } - if (spec.TickSize is > 0m && price is { } p && OrderRules.RoundDown(p, spec.TickSize.Value) != p) + if (price is { } p && OrderRules.TickOf(spec, p) is { } tick && OrderRules.RoundDown(p, tick) != p) { return "price_not_on_tick"; } diff --git a/tests/Anubis.Tests/AccountsScreenTests.cs b/tests/Anubis.Tests/AccountsScreenTests.cs index 1b45644..344b7ec 100644 --- a/tests/Anubis.Tests/AccountsScreenTests.cs +++ b/tests/Anubis.Tests/AccountsScreenTests.cs @@ -49,7 +49,7 @@ public sealed class AccountsScreenTests CollectionAssert.AreEqual(new byte[] { 0xEF, 0xBB, 0xBF }, bytes[..3], "Excel reads the accents only with the BOM."); var lines = System.Text.Encoding.UTF8.GetString(bytes[3..]).Split('\n', StringSplitOptions.RemoveEmptyEntries); Assert.HasCount(11, lines); - StringAssert.StartsWith(lines[1], "BTC/EUR;Bitcoin;okx;crypto_trend;0.0182;68950;71420;EUR;1299.84;44.95;66180;", lines[1]); + StringAssert.StartsWith(lines[1], "BTC/EUR;Bitcoin;okx;crypto_trend;0,0182;68950;71420;EUR;1299,84;44,95;66180;", lines[1]); var settings = await server.TextAsync("/impostazioni"); StringAssert.Contains(settings, "Conti e chiavi"); diff --git a/tests/Anubis.Tests/TradingRulesTests.cs b/tests/Anubis.Tests/TradingRulesTests.cs index cf4e6ea..0b6bab4 100644 --- a/tests/Anubis.Tests/TradingRulesTests.cs +++ b/tests/Anubis.Tests/TradingRulesTests.cs @@ -68,6 +68,12 @@ public sealed class TradingRulesTests Assert.IsTrue(stop.IsValid); Assert.AreEqual(380.13m, stop.StopPrice); + // The Alpaca catalogue has no tick: 2 decimals from 1 $, 4 below, as Alpaca asks (else 422 sub-penny). + var asListed = Stock("MSFT") with { TickSize = null }; + Assert.AreEqual(380.13m, OrderRules.Round(asListed, OrderSide.Sell, OrderKind.Stop, 1m, 400m, stopPrice: 380.123m).StopPrice); + Assert.AreEqual(0.4568m, OrderRules.Round(asListed, OrderSide.Sell, OrderKind.Stop, 10m, 0.5m, stopPrice: 0.45671m).StopPrice); + Assert.AreEqual(412.34m, OrderRules.Round(asListed, OrderSide.Buy, OrderKind.Limit, 1m, 412m, 412.345m).LimitPrice); + Assert.AreEqual((12m, 0.345m), OrderRules.SplitWhole(12.345m)); Assert.IsTrue(OrderRules.IsUnsellable(btc, 0.000005m, 60000m)); Assert.IsFalse(OrderRules.IsUnsellable(btc, 0.001m, 60000m));