Migliorato README.md
parent
718df84770
commit
1dbdcfefcd
44
README.md
44
README.md
|
@ -4,7 +4,7 @@
|
|||
|
||||
---
|
||||
|
||||
## ✨ Cosa fa
|
||||
## Cosa fa
|
||||
|
||||
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.
|
||||
|
@ -22,7 +22,7 @@
|
|||
|
||||
---
|
||||
|
||||
## 🧠 Modello / Pipeline ML
|
||||
## Modello / Pipeline ML
|
||||
|
||||
* **RNN:** LSTM a **64 unità** su finestre temporali (sequenze) dei log-return.
|
||||
* **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%).
|
||||
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:
|
||||
|
||||
|
@ -74,7 +74,7 @@ Istruzioni: eseguire swap su THORChain con slip <= 1%, poi aggiornare balance.js
|
|||
|
||||
---
|
||||
|
||||
## 🛠️ Installazione
|
||||
## Installazione
|
||||
|
||||
### Requisiti
|
||||
|
||||
|
@ -98,7 +98,7 @@ docker run --rm -d \
|
|||
|
||||
---
|
||||
|
||||
## ⚙️ Variabili d’ambiente
|
||||
## Variabili d’ambiente
|
||||
|
||||
> Tutte opzionali salvo dove indicato.
|
||||
|
||||
|
@ -122,16 +122,16 @@ docker run --rm -d \
|
|||
* `RUN_AT_START`
|
||||
Se `true`, esegue subito un ciclo all’avvio oltre alla schedule. Default: `true`.
|
||||
* `RUN_HOUR`
|
||||
Ora locale (0–23) per il giro giornaliero. Default: `7`.
|
||||
Ora locale (0–23) per il giro giornaliero. Default: `24`.
|
||||
* `TZ`
|
||||
Timezone (es. `Europe/Berlin`). Default: sistema/container.
|
||||
Timezone (es. `Europe/Berlin`). Default: quello del sistema/container.
|
||||
|
||||
### THORNode / Fee
|
||||
|
||||
* `THORNODE_URL` **(richiesto)**
|
||||
Endpoint THORNode per quote (es. `https://thornode.ninerealms.com`).
|
||||
* `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`
|
||||
**Importo di riferimento in asset B (USDT)** per stima inversa. Default: `10000`.
|
||||
* `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
|
||||
```
|
||||
|
||||
## 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
|
||||
|
@ -255,7 +277,7 @@ state/
|
|||
|
||||
## 📄 Licenza
|
||||
|
||||
MIT (o specificare).
|
||||
VEDI file LICENSE (o specificare).
|
||||
|
||||
---
|
||||
|
||||
|
@ -267,6 +289,4 @@ MIT (o specificare).
|
|||
* [ ] Monta `data/`, `models/`, `state/`.
|
||||
* [ ] Avvia container e verifica i log.
|
||||
|
||||
---
|
||||
|
||||
Se vuoi, posso aggiungere un **esempio di `.env`** o le **istruzioni Docker Compose** già pronte.
|
||||
|
|
Loading…
Reference in New Issue