ADR 0009 records the Phase 3 choices; API-NOTES gains the verified trading facts and what Anubis does with each; ROADMAP and STATE mark the phase done with the live-demo conformance waiting for the user's keys. Two defects found while writing the notes: - The positions CSV used dot decimals; SPEC 13 asks for decimal commas. Trailing zeros are dropped so both engines give the same text. - Alpaca's catalogue has no tick, so limit and stop prices were sent unrounded and would get 422 "sub-penny". OrderRules.TickOf applies Alpaca's rule (2 decimals from 1 $, 4 below) to orders, stops and the simulator's own check. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
4c4f848d80
commit
60d5ebbc05
10 files changed
+169
-30
No files matched your search
+32
-2
@@ -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.
|
||||
|
||||
+16
-16
@@ -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
|
||||
|
||||
|
||||
+15
-5
@@ -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 |
|
||||
|
||||
@@ -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.
|
||||
@@ -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);
|
||||
}
|
||||
|
||||
/// <summary>The positions as CSV for a spreadsheet: semicolons, dot decimals, one row per position.</summary>
|
||||
/// <summary>The positions as CSV for an Italian spreadsheet (SPEC 13): semicolons, decimal commas, no thousands separator, one row per position.</summary>
|
||||
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', ' ');
|
||||
}
|
||||
|
||||
@@ -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)))
|
||||
|
||||
@@ -201,6 +201,21 @@ public static class OrderRules
|
||||
return spec.MinNotional ?? (spec.Venue == Venues.Alpaca ? AlpacaMinimumNotional : 0m);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 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).
|
||||
/// </summary>
|
||||
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)
|
||||
{
|
||||
|
||||
@@ -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";
|
||||
}
|
||||
|
||||
@@ -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");
|
||||
|
||||
@@ -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));
|
||||
|
||||
Reference in new issue
Block a user