Vai al contenuto
Pit Officer
Controllo del rischio pre-trade su infrastruttura propria

Verificare l'ordine. Mantenere il controllo dei passaggi successivi.

Connessioni integrate a broker e borse, prezzi di mercato automatici e controlli di rischio pre-trade. Gestione di conti e flussi di ordini da un pannello locale, un'API REST o strumenti MCP.

Provare Officer Leggi la documentazione
Consultare broker e flussi di prezzi

Codice aperto · Apache-2.0

Connessioni di negoziazione integrate
Interactive Brokers · Binance · Alpaca · eToro
Inviare ordini approvati e ricevere le esecuzioni tramite le connessioni abilitate.
Prezzi di mercato automatici
Attivare le sottoscrizioni ai dati degli strumenti. Officer riceve i prezzi dalle fonti collegate e li fornisce al motore di rischio.
Visualizzare il flusso

Connessioni

Collegare il broker. Ricevere i prezzi automaticamente.

Selezionare le connessioni necessarie nel pannello. Le connessioni di negoziazione inviano ordini; i flussi di dati di mercato forniscono i prezzi ai controlli di rischio.

Connessioni di negoziazione integrate

  • Interactive Brokers
  • Binance
  • Alpaca
  • eToro

Inviare ordini approvati e ricevere aggiornamenti sulle esecuzioni tramite la connessione abilitata.

Utilizzare il proprio conto presso il broker e le proprie credenziali. Gli strumenti disponibili e le modalità di prova o di negoziazione reale dipendono dal fornitore e dalle impostazioni della connessione.

Flussi di dati di mercato

  • Interactive Brokers
  • Binance
  • Kraken
  • Coinbase
  • Alpaca
  • OKX
  • Bybit
  • OANDA
  • Finnhub

Selezionare una fonte e sottoscrivere i dati degli strumenti. Officer riceve automaticamente i prezzi per i controlli di rischio. È possibile collegare anche un flusso personalizzato.

Le credenziali del fornitore, le autorizzazioni per i dati di mercato e le sottoscrizioni determinano i prezzi disponibili. Un flusso di prezzi da solo non abilita la negoziazione.

Avviare Officer e configurare le connessioni

Casi d'uso

Partire dall'attività da svolgere.

Per chi sviluppa flussi di ordini, gestisce il rischio e automatizza la negoziazione. Ogni percorso parte dai controlli che si gestiscono e dall'integrazione necessaria.

  • Desk di trading proprietario · team di rischio

    Mantenere i limiti dei conti al di fuori della strategia

    Gestire conti, gruppi e politiche di rischio da un unico pannello. Bloccare un conto o un gruppo per impedire nuove approvazioni di rischio senza modificare il codice della strategia.

    • Esaminare posizioni, decisioni delle politiche e modifiche ai conti tramite lo stesso piano di controllo.
    • Il blocco agisce sull'approvazione di rischio. Non comporta l'annullamento di tutti gli ordini, la liquidazione o lo storno di operazioni già eseguite.
    Leggi la documentazione
  • Ingegneri di broker e borse

    Aggiungere una decisione di rischio al flusso degli ordini

    Utilizzare REST per valutare gli ordini e comunicare le esecuzioni. In un'integrazione dedicata alla sola approvazione, il componente di esecuzione deve verificare un'accettazione firmata e vincolata all'ordine esatto prima di inviarlo.

    • Mantenere aggiornati le esecuzioni e lo stato dei conti con i report di esecuzione; la sola rendicontazione post-trade non può impedire un'operazione.
    • Utilizzare le connessioni di negoziazione integrate oppure mantenere il sistema di esecuzione esistente e integrare l'API di rischio.
    Leggi la documentazione
  • Sviluppatori di agenti · sviluppatori

    Fornire all'agente solo gli strumenti necessari

    Collegarsi tramite MCP con strumenti di sola lettura abilitati per impostazione predefinita. Un operatore sceglie quali strumenti di modifica abilitare. I permessi concessi restano parte del perimetro di rischio.

    • Il blocco e lo sblocco dei conti non sono strumenti MCP.
    • La verifica è separata dall'invio. Negoziare tramite una connessione abilitata richiede il percorso di negoziazione; un agente autonomo con proprie credenziali del broker può aggirare un controllo esterno.
    Leggi la documentazione
  • Team quantitativi · trader e sviluppatori indipendenti

    Valutare una strategia rispetto a regole di rischio esplicite

    Collegare una fonte di prezzi e attivare le sottoscrizioni ai dati dei propri strumenti dal pannello. Officer riceve automaticamente i prezzi di mercato. Configurare le politiche di rischio, esaminare le decisioni sugli ordini proposti e aggiungere una connessione di negoziazione integrata quando serve l'esecuzione.

    • OpenPit calcola il P&L realizzato dalle esecuzioni comunicate e utilizza i dati valutari configurati per la conversione nella valuta del conto.
    • Le barriere di P&L agiscono sullo stato e sui dati forniti al motore. Sono controlli, non una garanzia contro le perdite di negoziazione.
    Leggi la documentazione

Come funziona

Un motore. Tre modalità di utilizzo.

Il pannello, REST e MCP condividono il piano di controllo di Officer. Valutazione degli ordini, esecuzione e rendicontazione sono operazioni distinte.

  1. 01 Valuta

    Motore OpenPit

    Valuta un ordine rispetto alle politiche configurate, allo stato del conto e ai dati di mercato necessari. Restituisce un'accettazione o un rifiuto con una motivazione.

    Il determinismo richiede gli stessi input completi e lo stesso stato, inclusi posizioni, riserve e dati di mercato.

  2. 02 Coordina

    Piano di controllo Pit Officer

    Memorizza conti, gruppi, politiche, ordini e registrazioni di audit nel database locale. Ripristina lo stato del motore all'avvio.

    Le connessioni di negoziazione integrate inviano gli ordini approvati e riportano le esecuzioni in Officer. Le sottoscrizioni ai dati di mercato forniscono automaticamente i prezzi al motore.

  3. 03 Gestisce

    Pannello operatore

    Esaminare conti, posizioni e ordini, gestire politiche e permessi MCP, configurare fonti di dati e consultare la cronologia di audit.

    Utilizzare lo stesso piano di controllo tramite REST o MCP. L'accesso agli endpoint e gli strumenti abilitati fanno parte del perimetro di accesso dell'installazione.

Da una richiesta di ordine a una decisione di rischio

Un'integrazione dedicata alla sola approvazione restituisce la decisione al sistema di esecuzione. Con la firma abilitata, verificare un'accettazione firmata e i parametri esatti dell'ordine prima dell'esecuzione. L'invio utilizza una connessione abilitata alla sede di negoziazione selezionata. Officer invia dati alle destinazioni di negoziazione e di dati di mercato configurate.

Dati di mercato e connessioni di negoziazione

Flussi di dati di mercato
prezzi di mercato
Lo stesso Pit Officer
ordini approvati
aggiornamenti sulle esecuzioni
Broker / borsa

Dentro il pannello

I controlli, in un unico posto.

Utilizzare il pannello locale per ispezionare e gestire lo stesso stato esposto tramite l'API. Partire dalla pagina che risponde alla prossima domanda.

Dashboard
Conteggi delle entità, la superficie di comandi abilitata per l'agente, lo stato di salute dei dati di mercato e l'attività recente dall'audit log.
Politiche
Barriere di politica di rischio applicate al motore per conto e per asset. Ogni riga è un vincolo sul flusso di ordini.
Conti
Conti e gruppi in un unico posto. Bloccare un conto o un gruppo per impedire nuove approvazioni di rischio, quindi sbloccarlo quando opportuno.
Ordini
Registrare un'esecuzione con il proprio id ordine esterno, e confermare o annullare gli ordini in attesa di una persona.
Audit
Esaminare le azioni registrate e la loro origine. L'API di audit non modifica le singole registrazioni; il ripristino da backup e il ripristino dei dati allo stato iniziale sono operazioni distinte.
Accesso MCP
Scegliere quali comandi un agente AI può richiamare, poi collegarlo via MCP. I comandi protetti richiedono un'abilitazione esplicita.
Chiavi di firma
Configurare la firma delle approvazioni. Un sistema di esecuzione esterno deve verificare un'accettazione firmata e i parametri dell'ordine vincolati prima di inviare l'ordine.
Dati di mercato
Collegare una fonte di prezzi e attivare le sottoscrizioni ai dati degli strumenti. Officer riceve automaticamente le quotazioni, le fornisce al motore di rischio e mostra timestamp e diagnostica dei flussi.
Leggi la documentazione

Codice aperto

Esaminare i controlli da cui si dipende.

Codice sorgente, configurazione e contratto API sono disponibili per una valutazione autonoma.

  • Apache-2.0

    Officer e OpenPit sono a codice aperto. Esaminare l'implementazione, compilare la propria copia e verificarne il comportamento rispetto ai requisiti di integrazione.

  • Cronologia di audit

    Le azioni del piano di controllo aggiungono registrazioni di audit. L'API di audit ordinaria non modifica le singole registrazioni. Il ripristino da backup e il ripristino dei dati del servizio allo stato iniziale possono sostituire o rimuovere la cronologia memorizzata; non si tratta di un archivio esterno immutabile.

  • Il proprio processo e database

    Eseguire Officer su un'infrastruttura sotto il proprio controllo. Le fonti di dati di mercato e le connessioni di negoziazione abilitate contattano le destinazioni configurate. Verificare un ordine non lo invia a una sede di negoziazione.

Esaminare il motore

OpenPit valuta l'ordine utilizzando politiche, stato del conto, posizioni, riserve e dati di mercato. Riprodurre una decisione richiede tutti questi input, non soltanto un ordine e un valore limite.

Esplorare OpenPit

Avvio rapido

Avviare Officer con un comando.

Installare Docker una sola volta. Quindi incollare un comando e aprire Officer nel browser. Non sono necessarie competenze di programmazione.

Docker non è ancora installato? Installare Docker

Avviare Officer

Avviare Docker Desktop. Aprire PowerShell su Windows o Terminal su macOS/Linux, incollare questo comando e premere Enter. 

docker run -d --name pit-officer --restart unless-stopped -p 127.0.0.1:8787:8787 -v pit-officer-data:/data ghcr.io/openpitkit/officer

Docker scarica Officer e lo esegue in background. I dati rimangono sul computer quando il contenitore viene riavviato.

Aprire il pannello. Tornare allo stesso indirizzo.

Attendere il primo avvio, quindi aprire il collegamento seguente. Salvarlo tra i preferiti per tornare ai propri conti e alle impostazioni.

Aprire il pannello
http://127.0.0.1:8787
Comandi per aprire il pannello o riavviare Officer
Windows · PowerShell 
Start-Process http://127.0.0.1:8787
macOS 
open http://127.0.0.1:8787
Linux 
xdg-open http://127.0.0.1:8787

Se Officer è stato arrestato, avviare il contenitore esistente con il comando seguente. Non ripetere il comando di prima installazione e non eliminare i propri dati. 

docker start pit-officer

Nel pannello, aggiungere un conto, uno strumento, una fonte di prezzi e i limiti di rischio. Generare o importare una chiave di firma per le decisioni, quindi aggiungere una connessione di negoziazione quando si è pronti a inviare ordini.

Guida per l'agente IA (in inglese) Riferimento per la configurazione

Primi passi

Rendere visibile la prima decisione.

Eseguire Officer localmente, configurare una politica e ispezionare un ordine accettato o rifiutato con la relativa registrazione di audit. Scegliere poi come il sistema di esecuzione utilizzerà questa decisione.

Provare Officer

Apache-2.0 · su infrastruttura propria · codice sorgente disponibile

Domande frequenti

Conoscere i confini prima dell'integrazione.

Esecuzione, permessi, dati di mercato e distribuzione fanno parte del contratto di integrazione.

Dove risiedono i miei dati?
Conti, politiche, ordini e registrazioni di audit risiedono nel database SQLite locale. Gli adattatori di dati di mercato configurati e le connessioni di negoziazione abilitate comunicano con i rispettivi fornitori. La verifica di un ordine, da sola, non lo invia a una sede di negoziazione.
Quali mercati e connessioni posso utilizzare?
Le connessioni di negoziazione integrate comprendono Interactive Brokers (TWS / IB Gateway), Binance, Alpaca ed eToro. Gli adattatori delle fonti di prezzi comprendono Interactive Brokers, Binance, Kraken, Coinbase, Alpaca, OKX, Bybit, OANDA e Finnhub, oltre a una fonte personalizzata. Verificare gli strumenti supportati, i diritti di accesso ai dati e le modalità paper o live di ciascuna connessione. Un adattatore di fonte di prezzi non fornisce, da solo, l'esecuzione degli ordini.
Officer può ottenere automaticamente i prezzi di mercato?
Sì. Configurare una fonte e attivare le sottoscrizioni ai dati degli strumenti nel pannello. Officer riceve automaticamente i prezzi e li fornisce a OpenPit per i controlli di rischio. Esaminare dal pannello i timestamp delle quotazioni, lo stato delle fonti e la diagnostica. Le credenziali del fornitore, i diritti di accesso ai dati e le sottoscrizioni configurate determinano quali prezzi sono disponibili.
Officer invia ordini?
Sì. Officer invia gli ordini approvati tramite le connessioni di negoziazione integrate abilitate e recepisce gli aggiornamenti delle esecuzioni nella propria contabilità. Fornitore, credenziali e destinazione vengono configurati dall'operatore. È inoltre possibile utilizzare Officer soltanto per le decisioni di rischio e mantenere l'esecuzione nel proprio sistema; valutare un ordine e inviarlo sono azioni separate.
Qual è il rapporto con OpenPit?
OpenPit è il motore di rischio. Officer aggiunge il database locale, il pannello operatore, l'API REST e l'interfaccia MCP. Una valutazione riproducibile richiede gli stessi input completi e lo stesso stato del motore, inclusi dati di mercato e riserve.
Un agente IA può aggirare i miei limiti?
L'interfaccia MCP predefinita è di sola lettura; gli strumenti di modifica richiedono l'abilitazione esplicita dell'operatore. Il blocco e lo sblocco dei conti non sono esposti tramite MCP. Un sistema di esecuzione esterno deve imporre la verifica delle accettazioni firmate di Officer e, affinché il controllo sia obbligatorio, l'agente non deve avere un percorso alternativo verso il broker. I permessi degli strumenti non proteggono da ogni abuso dell'accesso concesso.
Come iniziare, e posso esporre il servizio in rete?
Installare Docker, avviare Officer con l'unico comando dell'avvio rapido e aprire http://127.0.0.1:8787. REST, HTTP MCP e la documentazione di riferimento dell'API utilizzano lo stesso servizio. Gli endpoint non dispongono di autenticazione integrata; mantenere il servizio locale, a meno che non si fornisca un perimetro di accesso.
Che cosa garantisce una firma di approvazione?
Con la firma abilitata, le decisioni pre-trade di accettazione e rifiuto includono una firma Ed25519. È disponibile anche una modalità senza firma; la firma non è garantita per ogni errore API. Il sistema di esecuzione deve verificare la firma, la decisione di accettazione e i parametri dell'ordine vincolati. Le riserve non vengono liberate da un timer; il loro ciclo di vita si conclude tramite il flusso applicabile di conferma, report di esecuzione o annullamento.