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>
41 KiB
Note sulle API
Controllo del 10 novembre 2026 dei fatti della sezione 4 di docs/SPEC.md (verificati il 9 ottobre 2026). Sono state lette solo pagine pubbliche e fatte solo chiamate pubbliche senza chiave. Nessuna registrazione, nessuna chiave usata.
Ogni fatto ha uno di questi esiti:
- confermato: vale ancora come scritto nella specifica;
- cambiato: vale in parte o non vale più; la colonna Dettaglio dice cosa è diverso;
- non verificabile: le pagine pubbliche non bastano per verificarlo. Il fatto resta dietro una protezione, elencata in fondo alla pagina.
Sono segnati non più rilevante, senza essere ricontrollati, i fatti che non toccano più il progetto:
- gli strumenti abbandonati con l'ADR 0003 (
alpaca-py,ccxt,ib_async); - le fonti che la specifica esclude e Anubis non usa.
Prima di scrivere ogni adapter, si rilegge la documentazione corrente e si aggiorna questa pagina (SPEC 4).
4.1 Alpaca
| # | Fatto (SPEC 4.1) | Esito | Dettaglio | Fonte |
|---|---|---|---|---|
| A1 | Conto paper per tutti, 100.000 $ finti, solo dati IEX | confermato | Chiunque nel mondo lo apre con un'email. Il saldo si può azzerare con un importo a scelta. | https://docs.alpaca.markets/docs/paper-trading |
| A2 | Conto reale per residenti italiani: "più di 195 paesi", nessun elenco | non verificabile | Nessuna pagina ufficiale dà più né il numero né l'elenco. L'Italia compare tra i paesi del bonifico in valuta locale e del passaporto UE di Alpaca Europe (luglio 2026). Nessuna fonte dice però che un privato italiano può aprire un conto Trading API. | https://alpaca.markets/support/countries-alpaca-is-available · https://alpaca.markets/blog/alpaca-completes-eea-passporting-to-29-countries-expanding-access-to-regulated-investment-services-across-europe/ |
| A3 | Crypto su Alpaca non disponibile ai residenti UE | non verificabile | La documentazione parla solo di "alcune giurisdizioni internazionali". La pagina delle regioni ammesse risponde 404. Non cambia nulla: la crypto resta su OKX. | https://docs.alpaca.markets/docs/crypto-trading |
| A4 | Piano Basic: tempo reale solo IEX, 30 simboli via WebSocket, storico dal 2016, SIP solo se vecchio di almeno 15 minuti, 200 chiamate al minuto; piano a pagamento 99 $ al mese | confermato | Il flusso delayed_sip esiste come WebSocket. Attenzione: nelle API dei dati il parametro feed vale sip se non lo si indica. |
https://docs.alpaca.markets/docs/about-market-data-api · https://docs.alpaca.markets/docs/market-data-faq |
| A4b | I volumi IEX sono una piccola parte del mercato: i filtri di liquidità usano le barre giornaliere consolidate | confermato | Discende da A4: le barre SIP si chiedono con un end vecchio di almeno 15 minuti. |
come A4 |
| A5 | Notizie: Benzinga, REST e WebSocket v1beta1/news, storico dal 2015, campi headline, summary, symbols, created_at, source; gratuite? |
cambiato | URL e campi confermati. In più ci sono id, author, updated_at, content, url e images. La fonte non è più solo Benzinga: gli esempi mostrano anche "fiscal.ai". Lo storico dal 2015 e la presenza nel piano gratuito non sono più scritti. Senza tempo reale, le notizie via REST arrivano con 15 minuti di ritardo. |
https://docs.alpaca.markets/us/reference/news-3 · https://docs.alpaca.markets/us/docs/streaming-real-time-news |
| A6 | Tipi d'ordine e validità; opg rifiutati 09:28–19:00 ET, cls 15:50–19:00 ET |
confermato | Dopo le 19:00 ET questi ordini vanno in coda per l'asta del giorno dopo. | https://docs.alpaca.markets/docs/orders-at-alpaca |
| A7 | Frazioni da 1 $; solo market, limit, stop e stop-limit con day; niente opg/cls, niente vendite allo scoperto |
confermato | In più: gli importi hanno al massimo 2 decimali, e gli ordini in importo non si modificano (si annullano e si rimandano). Le frazioni ora sono ammesse anche fuori orario, solo con ordini limit. | https://docs.alpaca.markets/docs/fractional-trading |
| A8 | Fuori orario: solo limit con extended_hours=true |
confermato | Validità solo day o gtc, niente bracket. Anubis opera solo in orario regolare. |
https://docs.alpaca.markets/docs/orders-at-alpaca |
| A9 | PDT: soglia dei 25.000 $ tolta il 4 giugno 2026; campi PDT facoltativi; usare buying_power |
cambiato | Data confermata. I campi pattern_day_trader, daytrade_count, last_daytrade_count, daytrading_buying_power e last_daytrading_buying_power sono stati tolti dall'API entro il 6 luglio 2026: possono mancare del tutto. |
https://alpaca.markets/blog/finra-retires-the-pdt-rule-introducing-alpacas-new-intraday-margin-framework/ |
| A10 | Nessuna commissione, solo tasse regolamentari sulle vendite; conto in dollari; cambio sui versamenti circa 1,5% | cambiato | La tassa FINRA TAF è solo sulle vendite, ma la tassa CAT si paga anche sugli acquisti. L'1,5% vale per il bonifico in valuta locale (Italia compresa), con un massimo di 40 $. | https://docs.alpaca.markets/docs/regulatory-fees · https://alpaca.markets/support/currencycloud-transfer-questions |
| A11 | Calendario e orologio: /v2/calendar e /v2/clock |
cambiato | Funzionano ancora, ma la documentazione li chiama "legacy". I nuovi sono GET /v3/calendar/{market} e GET /v3/clock?markets=…, che indicano anche la fase della seduta. Nessuna data di chiusura per i /v2. |
https://docs.alpaca.markets/us/reference/calendar-2.md · https://docs.alpaca.markets/us/reference/legacyclock.md |
| A12 | Azioni societarie: GET https://data.alpaca.markets/v1/corporate-actions con symbols, types, start, end; nel piano gratuito? |
confermato | Il sito le mette nel piano gratuito. Senza start e end restituisce solo il giorno corrente; la paginazione usa page_token, con limit da 1 a 1000. |
https://docs.alpaca.markets/us/reference/corporateactions-1 · https://alpaca.markets/data |
| A13 | Ordini di segno opposto rifiutati con 403, con le eccezioni bracket, OCO e trailing stop | confermato | Vale anche per paper e crypto. Uno stop-limit conta come stop se accoppiato a un ordine market o stop. | https://docs.alpaca.markets/docs/user-protection |
| A14 | Su un conto senza margine il ricavato di una vendita può non essere spendibile fino al regolamento | cambiato | Alpaca non offre conti senza margine: tutti i conti sono a margine. Sotto i 2.000 $ il conto è "limited margin", con potere d'acquisto 1x. Il ricavato si reinveste subito in azioni, ma non si usa per la crypto né si preleva prima del regolamento (T+1). | https://alpaca.markets/support/alpaca-cash-accounts · https://docs.alpaca.markets/docs/account-plans |
| A15 | Nessun indicatore ETF negli asset Alpaca; nasdaqtraded.txt ha la colonna ETF Y/N |
confermato | La colonna ETF è la sesta. |
https://docs.alpaca.markets/us/reference/get-v2-assets-1.md · https://www.nasdaqtrader.com/dynamic/SymDir/nasdaqtraded.txt |
| A16 | Indirizzi e autenticazione da scrivere in casa | confermato | Paper https://paper-api.alpaca.markets, dati https://data.alpaca.markets, intestazioni APCA-API-KEY-ID e APCA-API-SECRET-KEY. WebSocket IEX wss://stream.data.alpaca.markets/v2/iex, autenticazione {"action":"auth",…} con risposta authenticated. |
https://docs.alpaca.markets/docs/real-time-stock-pricing-data |
| A17 | SDK alpaca-py 0.44.0 |
non più rilevante | Client scritto in casa (ADR 0003, 0004). | — |
Cosa cambia per il codice
- A4: passare sempre
feed=iexper i dati recenti. Ilsipsolo con unendvecchio di almeno 15 minuti. - A5:
sourceè un testo libero, non un valore fisso. - A9: non leggere i campi PDT. Il potere d'acquisto viene da
buying_power(enon_marginable_buying_powerper frazioni e crypto). - A10: la tassa CAT entra nel calcolo dei costi anche sugli acquisti.
- A11: il calendario sta dietro un'interfaccia, così si passa ai
/v3senza toccare il resto. Si parte con i/v2. - A14: il conto sarà a margine, quindi il divieto di leva (SPEC 9.1) lo impone Anubis. Compra solo fino alla liquidità propria, mai allo scoperto, anche se sopra i 2.000 $ Alpaca lo permetterebbe.
4.2 OKX Europe
| # | Fatto (SPEC 4.2) | Esito | Dettaglio | Fonte |
|---|---|---|---|---|
| O1 | OKX Europe Ltd, autorizzata MiCA (Malta) dal 27/01/2025, opera in Italia | confermato | Autorizzazione dell'autorità maltese (MFSA) del 27/01/2025, con passaporto nello Spazio economico europeo. | https://www.casptracker.eu/casp/OKX-Europe-Limited |
| O2 | REST https://eea.okx.com; WebSocket wss://wseea.okx.com/ws/v5/public, /private, /business |
confermato | Con un conto europeo, www.okx.com risponde con l'errore 50119. |
https://my.okx.com/docs-v5/en/ |
| O3 | Demo: stessa REST con x-simulated-trading: 1; WebSocket wss://wseeapap.okx.com/ws/v5/...; chiavi a parte che non scadono |
cambiato | Tutto confermato, ma la porta 8443 è chiusa dal 31/10/2026. I WebSocket vanno sulla 443, quindi senza porta nell'URL. | https://my.okx.com/docs-v5/log_en |
| O3b | Il demo europeo elenca 27 coppie in EUR e 29 in USDC | non verificabile | Senza chiave l'elenco demo mostra 28 EUR e 30 USDC, ma non è filtrato per l'Europa. Il 30/09/2026 sono state tolte alcune coppie (ICX, STORJ, ELF). | GET https://eea.okx.com/api/v5/public/instruments?instType=SPOT |
| O4 | Chiave, segreto e passphrase; fino a 20 IP; una chiave di trading senza IP scade dopo 14 giorni di inattività | confermato | La firma è Base64(HMAC-SHA256(timestamp + metodo + percorso + corpo)). Il timestamp REST è in formato ISO UTC con millisecondi; oltre 30 secondi di scarto arriva l'errore 50102. Il login WebSocket firma invece i secondi Unix + GET + /users/self/verify. |
https://my.okx.com/docs-v5/en/ |
| O5 | Commissioni spot dal 25/09/2026: 0,10% maker, 0,20% taker | confermato | Sulle coppie di stablecoin 0% maker e 0,05% taker. La pagina generale delle commissioni mostra ancora la tariffa vecchia. | https://www.okx.com/en-eu/help/important-notice-upcoming-spot-fee-adjustment-eea |
| O6 | Quotazioni in EUR e USDC; USDT non negoziabile | confermato | L'USDT depositato resta congelato. Anche USDG è ammesso. | https://www.okx.com/en-eu/learn/usdt-not-tradeable-okx-europe-stablecoin-guide |
| O7 | Liquidità buona su BTC, ETH e SOL in EUR, scarsa sulle altre coppie in EUR (spread 7–17 punti base) | non verificabile | La documentazione non ne parla. Volumi a 24 ore del 10/11/2026: BTC-EUR circa 5,1 M€, ETH-EUR circa 2,0 M€, SOL-EUR circa 0,45 M€ (meno di HYPE-EUR e XRP-EUR). La mediana delle 272 coppie EUR è circa 400 €. | GET https://eea.okx.com/api/v5/market/tickers?instType=SPOT |
| O8 | Ultime 1.440 candele da candles, le precedenti da history-candles; BTC-EUR da novembre 2023; 1D apre alle 16:00 UTC, 1Dutc alle 00:00 UTC |
confermato | Prima candela giornaliera di BTC-EUR: 21/11/2023. Gli orari di apertura sono stati controllati sui dati. Massimo 300 candele per chiamata. | chiamate pubbliche a eea.okx.com |
| O9 | public/instruments dà minSz, lotSz, tickSz |
confermato | Per lo spot sono espressi nella moneta base. Esempio BTC-EUR: minSz 0,0001, lotSz 0,00000001, tickSz 0,1. | GET https://eea.okx.com/api/v5/public/instruments?instType=SPOT |
| O10 | Ordini market, limit, post-only, FOK, IOC; ordini algoritmici con stop, OCO, trigger, trailing stop | confermato | Gli algoritmici vanno su POST /api/v5/trade/order-algo. Esistono anche optimal_limit_ioc (solo derivati) e rpi; elp è dismesso. |
https://my.okx.com/docs-v5/en/ |
| O11 | clOrdId: solo lettere e cifre, massimo 32 caratteri |
confermato | Distingue maiuscole e minuscole, niente trattini, unico tra gli ordini aperti. Il formato ANU + lettere e cifre (ADR 0001) va bene. |
https://my.okx.com/docs-v5/en/ |
| O12 | Dati dei derivati senza chiave: finanziamento, open interest, rapporto long/short | confermato | Finanziamento e open interest sono nella documentazione europea. Gli endpoint rubik del rapporto long/short non ci sono, ma rispondono su eea.okx.com (provato il 10/11/2026). |
https://my.okx.com/docs-v5/en/ · GET https://eea.okx.com/api/v5/rubik/stat/contracts/long-short-account-ratio?ccy=BTC&period=1D |
| O13 | ccxt myokx 4.5.85 e le sue commissioni predefinite |
non più rilevante | Client scritto in casa (ADR 0003). | — |
| O14 | La commissione può essere trattenuta nella moneta comprata | confermato | Ogni esecuzione ha fee, negativa quando è un costo, e feeCcy. Con l'impostazione di conto feeType = 1 si paga nella valuta di quotazione. |
https://my.okx.com/docs-v5/en/ · https://www.okx.com/en-eu/help/okx-to-introduce-spot-fee-payment-option-in-quote-currency |
| O15 | Limiti di frequenza (dato in più, utile all'adapter) | confermato | candles 40 ogni 2 s per IP; history-candles 20 ogni 2 s; invio ordine 60 ogni 2 s; instruments 20 ogni 2 s; fills 60 ogni 2 s. |
https://my.okx.com/docs-v5/en/ |
| O16 | Alternative, commissioni: Bitvavo 0,15%/0,25%; Kraken 0,40%/0,80% al livello base | confermato | Kraken applica questa tariffa dal 9/7/2026. | https://www.bitvavo.com/en/fees · https://blog.kraken.com/product/pro/new-kraken-pro-fee-tiers |
| O16b | Kraken: candele solo le ultime 720 | confermato | — | https://docs.kraken.com/api/docs/rest-api/get-ohlc-data |
| O16c | Bitvavo: libri in EUR più profondi, nessun ambiente di prova; Kraken: nessun ambiente di prova, solo validate=true |
non più rilevante | Conta solo se l'utente cambia exchange: si ricontrolla in quel momento. | — |
| O18 | Per le monete minori le coppie in USDC sono più profonde di quelle in EUR | confermato | Libri degli ordini pubblici del 10/11/2026, controvalore entro lo 0,5% dal prezzo medio. Su 12 monete su 12 (ADA, AVAX, DOGE, DOT, LINK, LTC, NEAR, ONDO, PEPE, SUI, XRP, ZEC) la coppia in USDC è più profonda; per esempio XRP circa 749.000 contro 195.000, DOT circa 11.600 contro 0. Lo spread in USDC è quasi sempre più stretto. | GET https://eea.okx.com/api/v5/market/books?instId=XRP-USDC&sz=400 |
| O17 | Binance non serve più i residenti italiani dal 1/7/2026; archivi pubblici con candele a 1 minuto dal 2017 | confermato | La chiusura risulta solo dalla stampa, non da una nota ufficiale di Binance. L'archivio BTCUSDT a 1 minuto va da agosto 2017 a ottobre 2026. | https://data.binance.vision/?prefix=data/spot/monthly/klines/BTCUSDT/1m/ |
Cosa cambia per il codice
- O3: gli URL WebSocket sono scritti senza porta, sia in produzione sia in demo.
- O3b, O6: chiamato senza chiave,
public/instrumentsrestituisce anche le coppie in USDT, TRY, BRL e altre valute. Ciò che si può davvero negoziare lo diceGET /api/v5/account/instruments, con la chiave. Fino ad allora vale un elenco fisso di coppie in EUR e USDC. - O4: si controlla lo scarto con
GET /api/v5/public/time, usando l'orologio iniettabile. Formati del timestamp diversi tra REST e WebSocket. - O8: per le giornaliere si usa
1Dutc, mai1D. Lo storico si scarica con un ritmo prudente (history-candlesha il limite più basso). - O12: i dati
rubiksono facoltativi; se smettono di rispondere, il bot va avanti senza. - O14: la contabilità legge
feeefeeCcyda ogni esecuzione e non ne deduce la valuta.
4.3 Altri broker (fasi opzionali)
| # | Fatto (SPEC 4.3) | Esito | Dettaglio | Fonte |
|---|---|---|---|---|
| B1 | eToro: chiavi distinte demo e reale | confermato | Cambia solo il percorso: trading/execution/demo contro trading/execution. |
https://builders.etoro.com/learn/authentication-and-api-keys.md |
| B1b | eToro: REST https://public-api.etoro.com e WebSocket |
confermato | Il WebSocket è documentato; il suo indirizzo wss:// non compare nella pagina letta. |
https://api-portal.etoro.com/core/websocket/overview.md |
| B1c | eToro: circa 60 letture e 20 scritture al minuto | confermato | Le pagine dei dati di mercato indicano invece 120 richieste al minuto: le due pagine non coincidono. Si progetta su 60. | https://api-portal.etoro.com/getting-started/rate-limits.md |
| B1d | eToro: candele da 1 minuto a 1 settimana, 1.000 per richiesta | confermato | — | https://api-portal.etoro.com/api-reference/market-data/get-instrument-candle-history.md |
| B1e | eToro: nessun ordine limite in attesa | confermato | Gli ordini nuovi (v2 da maggio, v3 da agosto 2026) accettano solo mkt, mit e limitIOC, e solo in apertura. |
https://api-portal.etoro.com/api-reference/trading--real/create-an-order.md |
| B1f | eToro: crypto 1% per lato | confermato | Sconti solo dai livelli Platinum in su. | https://www.etoro.com/trading/fees/ |
| B2 | Interactive Brokers: serve IB Gateway; secondo fattore manuale ogni settimana; dati a pagamento | confermato | Il flusso consolidato USA si paga; esiste un flusso gratuito non consolidato (Cboe One e IEX). Il sito risponde 403 ai programmi: letto dai risultati di ricerca. | https://www.interactivebrokers.com/docs/tws-api/doc/tws-settings/daily-weekly-reauthentication |
| B2b | Libreria ib_async |
non più rilevante | Esiste un client C# ufficiale (CSharpAPI.dll), con una licenza non commerciale e fuori da NuGet. Sarebbe un componente esterno da chiedere all'utente (ADR 0004). |
https://interactivebrokers.github.io/ |
| B3 | cTrader (IC Markets EU, Pepperstone EU): solo forex e CFD → escluso | confermato | Azioni e crypto ci sono solo come CFD con leva. | https://www.icmarkets.eu/en/range-of-markets · https://pepperstone.com/en-eu/platforms/ |
| B4 | OANDA: v20 non disponibile per l'entità europea → escluso | confermato | Esclusa l'entità polacca che serve l'Europa. | https://developer.oanda.com/rest-live-v20/introduction/ |
| B5 | MetaTrader 5: su Linux solo con Wine → escluso | confermato | Nessuna versione nativa. | https://www.metatrader5.com/en/terminal/help/start_advanced/install_linux.md |
4.4 Fonti gratuite
| # | Fatto (SPEC 4.4) | Esito | Dettaglio | Fonte |
|---|---|---|---|---|
| F1 | data.binance.vision: archivi giornalieri e mensili senza chiave |
confermato | Esiste anche l'intervallo da 1 secondo. Dal 1° gennaio 2025 i timestamp dei file spot sono in microsecondi, prima in millisecondi. | https://github.com/binance/binance-public-data |
| F2a | Cambio BCE, file XML giornaliero, nel pomeriggio | confermato | Di solito verso le 16:00 ora dell'Europa centrale. Ultimo valore letto: 9/11/2026, 1,1193. | https://www.ecb.europa.eu/stats/eurofxref/eurofxref-daily.xml |
| F2b | Frankfurter come alternativa | cambiato | La versione principale è la v2, che mescola più banche centrali (il 10/11 dava 1,1194 contro 1,1193 della BCE). La v1 è deprecata dal 18/05/2026, ma resta attiva. Il dato della sola BCE è su /v2/providers/ecb/rates. |
https://frankfurter.dev/ |
| F3a | Calendario economico ff_calendar_thisweek.json: settimana corrente, senza dato effettivo |
confermato | Campi title, country (la valuta), date, impact, forecast, previous. | https://nfs.faireconomy.media/ff_calendar_thisweek.json |
| F3b | Calendario economico: al massimo una richiesta ogni 5 minuti | non verificabile | Nessuna documentazione ufficiale; un post di forum parla di 2 richieste ogni 5 minuti. | https://www.forexfactory.com/thread/post/15159093 (risponde 403) |
| F4 | FRED release/dates: chiave gratuita e facoltativa, 120 richieste al minuto |
cambiato | Il parametro e il limite sono confermati, ma la chiave è obbligatoria: senza chiave l'API risponde 400. Resta facoltativa per Anubis: senza chiave la funzione si spegne, come la specifica già prevede. | https://fred.stlouisfed.org/docs/api/fred/release_dates.html |
| F5 | Storico VIX da cdn.cboe.com senza chiave |
cambiato | Funziona, dati dal 1990, ma risponde con un rinvio 307 a https://cdn-api.cboe.com/api/global/us_indices/daily_prices/VIX_History.csv. |
https://cdn.cboe.com/api/global/us_indices/daily_prices/VIX_History.csv |
| F6 | Finnhub gratuito: 60 chiamate al minuto; hour vale bmo o amc |
cambiato | In più c'è un tetto di 30 al secondo. hour può valere anche dmh (durante la seduta) o essere vuoto. Il piano gratuito dà solo 1 mese di storico delle trimestrali. |
https://finnhub.io/static/swagger.json |
| F7 | Fear & Greed crypto: giornaliero, con attribuzione | confermato | La fonte va citata in modo evidente accanto al dato. | https://alternative.me/crypto/fear-and-greed-index/ |
| F8 | SEC EDGAR: 10 richieste al secondo, User-Agent con nome e contatto | confermato | — | https://www.sec.gov/search-filings/edgar-search-assistance/accessing-edgar-data |
| F9 | I 14 feed RSS rispondono | confermato | Tutti e 14 rispondono con RSS valido. CoinDesk rinvia all'indirizzo senza la barra finale: si usa https://www.coindesk.com/arc/outboundfeeds/rss. |
elenco in SPEC 4.4 |
| F10a | CryptoPanic non ha più un piano gratuito | confermato | Piano gratuito chiuso dal 1° aprile 2026; il più economico costa 199 $ al mese. Dato da fonti secondarie: la pagina ufficiale non si legge senza JavaScript. | https://cryptopanic.com/developers/api/plans/ |
| F10b | yfinance, Stooq, GDELT, API di X e Reddit da non usare |
non più rilevante | Fonti escluse dalla specifica: Anubis non le usa, quindi non sono state ricontrollate. | — |
| F11 | Date FRED: orario predefinito 08:30 di New York, impatto alto | confermato | Le uscite principali del BLS escono alle 8:30 di New York: il CPI il 10/11 e il 10/12/2026, l'Employment Situation il 6/11 e il 4/12/2026. | https://www.bls.gov/schedule/news_release/cpi.htm · https://www.bls.gov/schedule/news_release/empsit.htm |
| F12 | Fed alle 14:00 di New York | confermato | Comunicato del 28/10/2026 "for release at 2:00 p.m.". Prossima riunione 8–9 dicembre 2026. | https://www.federalreserve.gov/newsevents/pressreleases/monetary20261028a.htm · https://www.federalreserve.gov/monetarypolicy/fomccalendars.htm |
| F13 | BCE alle 14:15, ora dell'Europa centrale | confermato | Comunicato alle 14:15, conferenza stampa alle 14:45. La BCE scrive "CET" anche con l'ora legale: in pratica è l'ora di Francoforte, quindi si usa il fuso Europe/Berlin. Prossima riunione 16–17 dicembre 2026. |
https://www.ecb.europa.eu/press/govcdec/mopo/html/index.en.html · https://www.ecb.europa.eu/press/press_conference/html/index.en.html |
Cosa cambia per il codice
- F1: l'importatore riconosce millisecondi e microsecondi.
- F2b: se si usa Frankfurter, solo
/v2/providers/ecb/rates. La fonte principale resta il file BCE. - F3b: una richiesta all'ora, come già scritto nella specifica. La pagina "Request Denied" si riconosce come errore.
- F5: il client HTTP segue i rinvii, oppure usa direttamente
cdn-api.cboe.com. - F6:
dmhe il campo vuoto sono gestiti; condmhla trimestrale cade in seduta.
4.5 Modelli per le notizie
| # | Fatto (SPEC 4.5) | Esito | Dettaglio | Fonte |
|---|---|---|---|---|
| M1 | mrm8488/distilroberta-finetuned-financial-news-sentiment-analysis, licenza Apache-2.0 |
confermato | — | https://huggingface.co/mrm8488/distilroberta-finetuned-financial-news-sentiment-analysis |
| M2 | Esportazione ONNX pronta nei repository Xenova/... |
confermato | Xenova/distilroberta-finetuned-financial-news-sentiment-analysis: onnx/model.onnx (circa 329 MB), onnx/model_quantized.onnx (circa 83 MB) e tokenizer.json. Revisione da fissare: e6953e30167c7fc3d1ad62f3df31617dd712fbc1. Il repository non dichiara una licenza: vale quella del modello originale (Apache-2.0), da annotare nell'ADR della Fase 7. |
https://huggingface.co/Xenova/distilroberta-finetuned-financial-news-sentiment-analysis |
| M3 | 10–20 ms per titolo su CPU | non verificabile | Si misura nella Fase 7, con ONNX Runtime per .NET. | — |
| M4 | Claude Haiku 5.5: 0,10 in ingresso e 0,50 in uscita per milione di token (fino a 100.000 token); batch a metà prezzo; non ancora nella panoramica dei modelli |
cambiato | Ora è nella panoramica, con identificativo claude-haiku-5-5. Prezzi confermati. Oltre i 100.000 token costa 0,50 e 2,50. |
https://platform.claude.com/docs/en/about-claude/models/overview · https://platform.claude.com/docs/en/about-claude/pricing |
| M5 | Claude Haiku 4.5: 1 e 5 |
confermato | Ora è un modello "legacy", ancora disponibile. | https://platform.claude.com/docs/en/about-claude/pricing |
L'identificativo del modello resta una voce di configurazione, mai una costante nel codice (SPEC 4.5).
4.6 Vincoli per un residente italiano
| # | Fatto (SPEC 4.6) | Esito | Dettaglio | Fonte |
|---|---|---|---|---|
| V1 | ETF domiciliati negli USA di norma non acquistabili dai privati europei (PRIIPs) | confermato | Senza il documento KID i broker europei ne bloccano l'acquisto; si possono tenere o vendere. Il filtro di Anubis resta attivo di base. | https://www.justetf.com/en/news/etf/us-domiciled-etfs.html |
| V2 | Non è verificato se Alpaca applichi il blocco ai residenti europei | non verificabile | Nessuna pagina pubblica ne parla. Il filtro di Anubis non dipende da questo. | — |
| V3 | Broker esteri, nessun sostituto d'imposta: serve l'esportazione delle operazioni in euro al cambio BCE | non verificabile | Non è consulenza fiscale e non si verifica su pagine tecniche. Il requisito dell'esportazione resta (SPEC 13.3). | — |
Fatti non verificabili e protezioni
Ogni fatto non verificabile resta dietro una protezione. I nomi delle impostazioni sono provvisori: si fissano nella fase indicata.
| Fatto | Protezione | Fase |
|---|---|---|
| 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 (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 |
| V3 fiscalità | Esportazione CSV delle operazioni con il cambio BCE. | 3 |
| Storia dei flag ETF e frazionabile | Gli universi passati usano i flag di oggi; il limite è scritto nel rapporto della prova storica. | 4 |
| Barre dei titoli tolti dalla borsa su Alpaca | Da controllare con le chiavi del conto di prova; fino ad allora gli universi passati vanno letti come ottimisti. | 2, 4 |
| Minuti senza scambi su OKX | Il buco si riscarica una volta, poi resta segnato come non recuperabile e non blocca nulla. | 2 |
Verifiche della Fase 2 (dati di mercato)
Fatti controllati scrivendo gli adapter dei dati, il 10/11/2026. Le risposte registrate stanno in tests/Anubis.Tests/Fixtures e i test le leggono senza rete.
| Fonte | Fatto | Come è stato verificato |
|---|---|---|
| OKX | history-candles con 1Dutc dà lo storico giornaliero intero di BTC-EUR, ETH-EUR e SOL-EUR dal 21/11/2023: 1.085 giorni ciascuna, senza buchi né anomalie. |
Prova reale RealHistoryProof (categoria LiveDemo) |
| OKX | Una candela con confirm = 0 è ancora aperta: lo storico la scarta e il flusso dal vivo la salva solo quando si chiude. |
Risposte registrate di candles e del WebSocket |
| OKX | Finanziamento e open interest di BTC-USDT-SWAP rispondono senza chiave su eea.okx.com. | Risposte registrate |
| Alpaca | Con il piano gratuito una richiesta feed=sip che arriva a meno di 15 minuti fa risponde {"code":42210000,"message":"subscription does not permit querying recent SIP data"}. |
Esempio della FAQ di Alpaca (errors.md nei fixture) |
| Alpaca | Le barre giornaliere hanno l'orario della mezzanotte di New York: il giorno della barra è la data di New York. adjustment=raw e adjustment=all si chiedono separatamente. |
Esempi della documentazione |
| Alpaca | Le chiavi si leggono solo da ALPACA_API_KEY_DEMO e ALPACA_API_SECRET_DEMO, quelle del conto di prova. Senza chiavi nessuna chiamata parte verso Alpaca. |
Test ServerCollectsWithoutAlpacaKeysAndSaysWhatIsOff |
| BCE | Lo storico completo è nello zip eurofxref-hist.zip (CSV dal più recente, virgola finale su ogni riga, N/A dove manca); poi basta il file a 90 giorni o quello giornaliero. |
Risposte registrate |
| Forex Factory | Se al posto del JSON arriva una pagina di blocco, la lettura fallisce e conta come errore della fonte; il calendario già salvato resta. | Test |
| Fed e BCE | Calendari 2026–2027 letti dalle pagine ufficiali; la Fed avverte che ogni data è provvisoria fino alla riunione precedente. Per questo l'elenco è un'impostazione modificabile in Impostazioni → Dati. | central-banks.md nei fixture |
| alternative.me | Valori giornalieri con timestamp Unix in secondi. Anubis chiede 400 giorni la prima volta e poi solo gli ultimi 2. | Risposte registrate |
| nasdaqtraded.txt | La colonna ETF non segna molti ETN e nessun fondo chiuso: Anubis legge anche il nome del titolo. I codici delle borse comprendono ora anche F (Texas Stock Exchange) e M (NYSE Texas). |
File del 10/11/2026 |
| Binance | Ogni zip mensile ha accanto un file .CHECKSUM con lo SHA-256; i timestamp passano dai millisecondi ai microsecondi da gennaio 2025. Il primo giorno di BTCUSDT è il 17/08/2017; il mese in corso non è ancora pubblicato. |
Prova reale: 3.363 giorni dal 17/08/2017 al 31/10/2026 |
Distorsioni che restano negli universi a una data passata
- I flag di oggi (frazionabile su Alpaca, ETF in
nasdaqtraded.txt) valgono anche per le date passate: le fonti gratuite non hanno la storia di questi flag. - Un titolo che ha cambiato simbolo è riconosciuto come fondo solo se il nome lo dice.
- Non è verificato che Alpaca dia le barre dei titoli tolti dalla borsa: se mancano, gli universi passati sono un po' troppo ottimisti (distorsione dei sopravvissuti). Si controlla con le chiavi del conto di prova.
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
AlpacaPaperConformanceeOkxDemoConformance(categoriaLiveDemo) 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
tradeQuoteCcyai conti europei, i caratteri ammessi inclient_order_idsu 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.
| Pacchetto | Versione | Licenza | In uso da | Fonte |
|---|---|---|---|---|
| .NET 10 runtime | 10.0.14 (LTS, supporto fino al 14/11/2028) | MIT | Fase 0 | https://dotnetcli.blob.core.windows.net/dotnet/release-metadata/10.0/releases.json |
| .NET 10 SDK | 10.0.403 (global.json chiede almeno 10.0.100) |
MIT | Fase 0 | come sopra |
MSTest.TestFramework, MSTest.TestAdapter |
4.5.2 | MIT | Fase 0 | https://www.nuget.org/packages/MSTest/4.5.2 |
Microsoft.NET.Test.Sdk |
18.11.0 | MIT | Fase 0 | https://www.nuget.org/packages/Microsoft.NET.Test.Sdk |
Microsoft.Data.Sqlite |
10.0.14 | MIT | Fase 1 | https://www.nuget.org/packages/Microsoft.Data.Sqlite/10.0.14 |
Npgsql |
10.0.3 | PostgreSQL License | Fase 1 | https://www.nuget.org/packages/Npgsql/10.0.3 |
System.Security.Cryptography.ProtectedData |
10.0.14 | MIT | Fase 1 (la custodia della chiave dei segreti su desktop nasce con lo strato di piattaforma) | https://www.nuget.org/packages/System.Security.Cryptography.ProtectedData/10.0.14 |
Microsoft.Web.WebView2 |
1.0.4314.35 | Licenza Microsoft di tipo BSD | Fase 10 | https://www.nuget.org/packages/Microsoft.Web.WebView2/1.0.4314.35 |
Microsoft.ML, Microsoft.ML.LightGbm, Microsoft.ML.FastTree |
5.0.1 | MIT | Fase 8 | https://www.nuget.org/packages/Microsoft.ML/5.0.1 |
Microsoft.ML.OnnxRuntime |
1.31.1 (librerie native per linux-x64 e win-x64) | MIT | Fase 7 | https://www.nuget.org/packages/Microsoft.ML.OnnxRuntime/1.31.1 |
Microsoft.ML.Tokenizers |
2.0.1 | MIT | Fase 7 | https://www.nuget.org/packages/Microsoft.ML.Tokenizers/2.0.1 |
Il metapacchetto MSTest porterebbe con sé l'estensione di copertura Microsoft.Testing.Extensions.CodeCoverage. Quell'estensione ha una licenza Microsoft separata da accettare e dipende da Mono.Cecil, di terze parti. Per questo si usano i suoi pacchetti di base (ADR 0006).
Dipendenze indirette
Oggi (Fase 0). I file di blocco contengono solo pacchetti Microsoft e MSTest. Oltre ai tre diretti (MSTest.TestFramework, MSTest.TestAdapter, Microsoft.NET.Test.Sdk), il progetto dei test si porta dietro:
| Pacchetto | Versione | Arriva con | Nota |
|---|---|---|---|
MSTest.Analyzers |
4.5.2 | MSTest.TestFramework | Analizzatori del codice dei test |
Microsoft.Testing.Platform, Microsoft.Testing.Platform.MSBuild |
2.5.2 | MSTest.TestAdapter | Piattaforma che esegue i test |
Microsoft.Testing.Extensions.TrxReport.Abstractions |
2.5.2 | MSTest.TestAdapter | Solo le interfacce del rapporto TRX |
Microsoft.Testing.Extensions.Telemetry |
2.5.2 | MSTest.TestAdapter | Telemetria della piattaforma: spenta con TESTINGPLATFORM_TELEMETRY_OPTOUT=1 in tasks e nella CI |
Microsoft.ApplicationInsights |
2.23.0 | Microsoft.Testing.Extensions.Telemetry | Libreria di telemetria (MIT), non usata con la telemetria spenta |
Microsoft.TestPlatform.ObjectModel, Microsoft.TestPlatform.TestHost |
18.11.0 | Microsoft.NET.Test.Sdk | Esecutore dotnet test |
Microsoft.CodeCoverage |
18.11.0 | Microsoft.NET.Test.Sdk | Raccoglitore di copertura classico (MIT, senza dipendenze di terze parti). Arriva sempre con Microsoft.NET.Test.Sdk; Anubis non lo attiva |
Tutti sono di Microsoft, con licenza MIT. Sono solo strumenti di sviluppo e non finiscono nell'immagine né nell'applicazione.
Di terze parti, in arrivo con le prossime fasi. I pacchetti autorizzati se ne portano dietro alcuni non pubblicati da Microsoft; l'ADR 0004 li accetta insieme al pacchetto che li richiede. Il test DependencyPolicyTests blocca:
- ogni pacchetto diretto fuori dall'elenco dell'ADR 0004, anche con un nome Microsoft;
- ogni pacchetto indiretto di terze parti che non sia nel suo elenco.
Quando la fase indicata aggiunge il pacchetto, il nome entra nell'elenco del test. Un altro test controlla che ogni nome di quell'elenco compaia in questa tabella.
| Dipendenza | Di chi, licenza | Arriva con | Fase | Nota |
|---|---|---|---|---|
SQLitePCLRaw.bundle_e_sqlite3, SQLitePCLRaw.core, SQLitePCLRaw.lib.e_sqlite3, SQLitePCLRaw.provider.e_sqlite3 2.1.13 |
Eric Sink, Apache-2.0 | Microsoft.Data.Sqlite |
1 (in uso) | Contengono la libreria nativa di SQLite e il suo caricatore. Sono nell'elenco del test dalla Fase 1. |
Newtonsoft.Json 13.0.3 |
James Newton-King, MIT | Microsoft.ML, LightGbm, FastTree |
8 | — |
LightGBM 4.6.0 |
progetto microsoft/LightGBM, pubblicato a nome di Guolin Ke, MIT | Microsoft.ML.LightGbm |
8 | Libreria nativa; in Docker serve libgomp1. |
Google.Protobuf 3.30.2 |
Google, BSD-3-Clause | Microsoft.ML.Tokenizers |
7 | — |
| Mono.Cecil 0.11.6 | Jb Evain, MIT | estensione di copertura del metapacchetto MSTest | — | Evitato: non si usa il metapacchetto. |
Immagini Docker
mcr.microsoft.com/dotnet/sdk:10.0(SDK 10.0.403) emcr.microsoft.com/dotnet/aspnet:10.0(runtime 10.0.14) esistono. Dal .NET 10 il tag10.0usa Ubuntu 24.04 "noble", non Debian. Non esiste un tag Debian stabile.libgomp1non è nelle immagini, ma si installa da Ubuntu "main" conapt-get install -y --no-install-recommends libgomp1. Si aggiunge nella Fase 8, insieme a LightGBM.- Fonti: https://mcr.microsoft.com/v2/dotnet/aspnet/tags/list · https://github.com/dotnet/dotnet-docker/blob/main/manifest.json · https://packages.ubuntu.com/noble/libgomp1
Carattere
- Instrument Sans, di Rodrigo Fuenzalida e Jordan Egstad, licenza SIL OFL 1.1 (ammesso dall'ADR 0004). Scaricato il 10/11/2026 con il permesso dell'utente, dalla raccolta ufficiale di Google Fonts.
- File:
InstrumentSans[wdth,wght].ttf, 194.336 byte, SHA-256b24f1812584816958afcf22e22d08e44318c5e51651e25d2438efdde389b33b1. È un solo file variabile con pesi da 400 a 700. Nel repository si chiamasrc/Anubis.Server/Assets/InstrumentSans.ttf. - La licenza è accanto al file, in
InstrumentSans-OFL.txt, e l'applicazione la serve su/assets/InstrumentSans-OFL.txt. - La versione corsiva non è inclusa: l'interfaccia quasi non la usa, e il browser la ricava dal carattere normale.
- Fonte: https://github.com/google/fonts/tree/main/ofl/instrumentsans