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).
|
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 d’ambiente
|
## Variabili d’ambiente
|
||||||
|
|
||||||
> 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 all’avvio oltre alla schedule. Default: `true`.
|
Se `true`, esegue subito un ciclo all’avvio oltre alla schedule. Default: `true`.
|
||||||
* `RUN_HOUR`
|
* `RUN_HOUR`
|
||||||
Ora locale (0–23) per il giro giornaliero. Default: `7`.
|
Ora locale (0–23) 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.
|
|
||||||
|
|
Loading…
Reference in New Issue