Files
Anubis/docs/API-NOTES.md
T
Alby96andClaude Opus 5.5 60d5ebbc05 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>
2026-11-10 21:24:38 +01:00

41 KiB
Raw Blame History

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=iex per i dati recenti. Il sip solo con un end vecchio 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 (e non_marginable_buying_power per 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 /v3 senza 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/instruments restituisce anche le coppie in USDT, TRY, BRL e altre valute. Ciò che si può davvero negoziare lo dice GET /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, mai 1D. Lo storico si scarica con un ritmo prudente (history-candles ha il limite più basso).
  • O12: i dati rubik sono facoltativi; se smettono di rispondere, il bot va avanti senza.
  • O14: la contabilità legge fee e feeCcy da 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: dmh e il campo vuoto sono gestiti; con dmh la 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 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.

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

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-256 b24f1812584816958afcf22e22d08e44318c5e51651e25d2438efdde389b33b1. È un solo file variabile con pesi da 400 a 700. Nel repository si chiama src/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