Migliorato README.md

main
Uriel Fanelli 2025-09-28 13:40:21 +02:00
parent 718df84770
commit 1dbdcfefcd
1 changed files with 32 additions and 12 deletions

View File

@ -4,7 +4,7 @@
--- ---
## Cosa fa ## Cosa fa
1. **Scarica** gli ultimi *kline* da Binance per il pair ETH/USDT (fino a ~300 giorni). 1. **Scarica** gli ultimi *kline* da Binance per il pair ETH/USDT (fino a ~300 giorni).
2. **Costruisce un dataset** di log-return e feature derivate. 2. **Costruisce un dataset** di log-return e feature derivate.
@ -22,7 +22,7 @@
--- ---
## 🧠 Modello / Pipeline ML ## Modello / Pipeline ML
* **RNN:** LSTM a **64 unità** su finestre temporali (sequenze) dei log-return. * **RNN:** LSTM a **64 unità** su finestre temporali (sequenze) dei log-return.
* **Target:** variazione percentuale del prezzo *close* del giorno successivo. * **Target:** variazione percentuale del prezzo *close* del giorno successivo.
@ -34,7 +34,7 @@
--- ---
## 🔎 Logica decisionale (semplificata) ## Logica decisionale (semplificata)
1. **Predizione** `pred_rel_move` (es. +0.8%). 1. **Predizione** `pred_rel_move` (es. +0.8%).
2. **Quote THORNode****fee_totale** (bp o valore assoluto) per importi di riferimento. 2. **Quote THORNode****fee_totale** (bp o valore assoluto) per importi di riferimento.
@ -54,7 +54,7 @@
--- ---
## 🧩 Perché Matrix ## Perché Matrix
Il demone **non esegue ordini**: invia **notifiche su Matrix** con la decisione, i numeri (predizione, fee, edge) e le **istruzioni manuali** per lo swap. In questo modo: Il demone **non esegue ordini**: invia **notifiche su Matrix** con la decisione, i numeri (predizione, fee, edge) e le **istruzioni manuali** per lo swap. In questo modo:
@ -74,7 +74,7 @@ Istruzioni: eseguire swap su THORChain con slip <= 1%, poi aggiornare balance.js
--- ---
## 🛠️ Installazione ## Installazione
### Requisiti ### Requisiti
@ -98,7 +98,7 @@ docker run --rm -d \
--- ---
## ⚙️ Variabili dambiente ## Variabili dambiente
> Tutte opzionali salvo dove indicato. > Tutte opzionali salvo dove indicato.
@ -122,16 +122,16 @@ docker run --rm -d \
* `RUN_AT_START` * `RUN_AT_START`
Se `true`, esegue subito un ciclo allavvio oltre alla schedule. Default: `true`. Se `true`, esegue subito un ciclo allavvio oltre alla schedule. Default: `true`.
* `RUN_HOUR` * `RUN_HOUR`
Ora locale (023) per il giro giornaliero. Default: `7`. Ora locale (023) per il giro giornaliero. Default: `24`.
* `TZ` * `TZ`
Timezone (es. `Europe/Berlin`). Default: sistema/container. Timezone (es. `Europe/Berlin`). Default: quello del sistema/container.
### THORNode / Fee ### THORNode / Fee
* `THORNODE_URL` **(richiesto)** * `THORNODE_URL` **(richiesto)**
Endpoint THORNode per quote (es. `https://thornode.ninerealms.com`). Endpoint THORNode per quote (es. `https://thornode.ninerealms.com`).
* `REF_FROM` * `REF_FROM`
**Importo di riferimento in asset A (ETH)** per stimare fee. Default: `5.0`. **Importo di riferimento in asset A (ETH)** per stimare fee. Default: `5.0`. Serve per avere la quotazione dello swap da THORNet.
* `REF_TO` * `REF_TO`
**Importo di riferimento in asset B (USDT)** per stima inversa. Default: `10000`. **Importo di riferimento in asset B (USDT)** per stima inversa. Default: `10000`.
* `MAX_SLIP_BPS` * `MAX_SLIP_BPS`
@ -230,6 +230,28 @@ state/
2025/09/28 07:00:13 instructions: eseguire swap ETH→USDT su THORChain, slip<=1.0%, size≈ref 2025/09/28 07:00:13 instructions: eseguire swap ETH→USDT su THORChain, slip<=1.0%, size≈ref
``` ```
## Esempi di output su matrix
HOLD
```
consiglio: azione=HOLD expectedBps=18.602 feeBps=26.000 netBps=-7.398 confOK=true motivo=Previsione rialzista ma non abbastanza sopra fee+margine o confidenza bassa
Suggerimento: nessuna azione (HOLD). Motivo=Previsione rialzista ma non abbastanza sopra fee+margine o confidenza bassa
Suggerimento valido sino a: 2025-09-28 12:58:03 CEST
La quotazione dei costi è valida sino a 2025-09-28 12:58:03 CEST (≈ 14m 59s restanti). Non fare lo swap dopo questa data.
```
SWAP
```
consiglio: azione=ETH -> USDT expectedBps=-63.477 feeBps=8.000 netBps=45.477 confOK=true motivo=Previsione ribassista per asset from, confidenza valida, guadagno oltre fee+margine
ISTRUZIONI MANUALI: esegui swap ETH.ETH->ETH.USDT amount=0.10000000; procedi solo se feeTotali<=53.477 bps (stima THOR=8.000 bps) e costo<=~0.00053477 ETH.ETH | motivo=Previsione ribassista per asset from, confidenza valida, guadagno oltre fee+margine
Suggerimento valido sino a: 2025-09-28 12:58:03 CEST
La quotazione dei costi è valida sino a 2025-09-28 12:58:03 CEST (≈ 14m 59s restanti). Dopo questa data, verifica i costi di swap
```
--- ---
## Troubleshooting ## Troubleshooting
@ -255,7 +277,7 @@ state/
## 📄 Licenza ## 📄 Licenza
MIT (o specificare). VEDI file LICENSE (o specificare).
--- ---
@ -267,6 +289,4 @@ MIT (o specificare).
* [ ] Monta `data/`, `models/`, `state/`. * [ ] Monta `data/`, `models/`, `state/`.
* [ ] Avvia container e verifica i log. * [ ] Avvia container e verifica i log.
---
Se vuoi, posso aggiungere un **esempio di `.env`** o le **istruzioni Docker Compose** già pronte.