Document Phase 3; fix CSV decimals and Alpaca price steps (refs #33 #31 #32 #27)

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:
Alby96andClaude Opus 5.5 committed 2026-11-10 21:24:38 +01:00
1 parent 4c4f848d80
commit 60d5ebbc05
10 files changed
+169 -30

No files matched your search

+32 -2
View File
@@ -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.