SVILUPPATORIScopri come creare un bot di trading con l'API di Cryptohopper e modificare la configurazione dei tuoi bot di trading. In 2 semplici passaggi creeremo un nuovo bot di trading e aggiungeremo le impostazioni di configurazione al bot di trading appena creato.
Per effettuare richieste API, dovrai creare un'app e avere un token di accesso. Se non hai ancora creato un token di accesso, segui innanzitutto il tutorial Ottieni un token di accesso con Oauth2.
Passaggio 1: crea un nuovo bot di trading
Per creare un nuovo bot di trading con l'API, dovrai effettuare una chiamata POST all'endpoint hopper. Con la chiamata POST puoi inviare immediatamente i valori di configurazione, ma in questo esempio invieremo solo alcuni esempi di configurazione e configureremo il bot di trading nel passaggio successivo. Di seguito troverai l'endpoint API e il JSON che dovrai inviare con la richiesta POST.
Endpoint API:
https://api.cryptohopper.com/v1/hopper
JSON POST:
{
"name": "Il nome del tuo bot di trading appena creato.",
"enabled": 0
}
Quando la richiesta API avrà successo, riceverai una risposta JSON con il valore: id. Questo id è l'identificatore univoco del tuo bot di trading appena creato. Salva l'id, perché ci servirà nel passaggio successivo per regolare la configurazione del bot di trading.
Passaggio 2: configura il tuo bot di trading
Ora che abbiamo creato un nuovo bot di trading e hai l'id del bot di trading appena creato, è il momento di configurare il bot di trading in modo da poter iniziare a fare trading automaticamente con esso. Tutti gli aggiornamenti al tuo bot di trading verranno eseguiti accedendo agli endpoint del bot di trading con il tuo id, come /hopper/{id}. Per aggiornare la configurazione del tuo bot di trading, dovrai effettuare una richiesta PATCH a questo endpoint. Di seguito troverai l'endpoint a cui dovrai inviare la tua richiesta PATCH. Sostituisci {id} con l'id che hai ricevuto nel passaggio 1.
Endpoint API:
https://api.cryptohopper.com/v1/hopper/{id}
Dovrai inviare i dati JSON degli aggiornamenti che desideri apportare. Se, ad esempio, vuoi cambiare il nome del tuo bot di trading, dovrai inviare di nuovo il nome key. Se non vuoi cambiare il nome, ometti semplicemente questo campo. Di seguito troverai un esempio di richiesta JSON PATCH.
Esempio di richiesta JSON PATCH:
{
"name": "Un nuovo nome del tuo bot di trading appena creato.",
"enabled": 0,
"api_config": {
"api_key": "La chiave API del tuo account di exchange.",
"api_secret": "Il segreto API del tuo account di exchange."
},
"config": {
"exchange": "binance",
"collect_currency": "btc",
.... E più opzioni di configurazione
}
}
Rivediamo alcune delle possibili opzioni di configurazione nella richiesta JSON.
| api_config | |
| api_key | Questa è la chiave API che hai creato sul tuo exchange. |
| api_secret | Questo è il segreto API che hai creato sul tuo exchange. |
| config | |
| exchange | Inserisci la chiave di exchange dello exchange a cui vuoi connetterti. Per ottenere un elenco di tutti gli exchange e le chiavi, vai su: https://api.cryptohopper.com/v1/exchange |
| collect_currency | Questa è la valuta quotata del tuo bot di trading in caratteri minuscoli, ad esempio: btc, usd, eth. |
| allowed_coins | Un elenco di array di monete (maiuscole) che il bot di trading può acquistare automaticamente. Ad esempio: ["BTC", "LTC", "ETH"]. |
| perc_buy_amount | La percentuale del tuo totale in asset che verrà utilizzata per determinare l'importo di acquisto. |
| min_buy_amount | L'importo minimo di acquisto degli acquisti automatici. |
| max_amount_allocated | L'importo massimo (in valuta quotata) allocato al tuo bot di trading. |
| strategy | La strategia che vuoi configurare. Ad esempio: no_strategy, multiple_ta. Se vuoi configurare una strategia su misura, dovrai avere l'id della strategia e configurarla come: user_{id}, ad esempio: user_1. |
| num_targets_per_buy | Il numero di target che verranno acquistati se la tua strategia trova più target. |
| max_open_time_buy | Il numero di minuti in cui gli ordini di acquisto possono rimanere aperti prima che vengano automaticamente annullati. |
| max_open_time | Il numero di minuti in cui gli ordini di vendita possono rimanere aperti prima che vengano automaticamente annullati. |
| set_percentage | La percentuale di take profit che vuoi configurare, ad esempio: 1.5. |
Ovviamente ci sono molte altre opzioni di configurazione. Controlla il riferimento API per maggiori informazioni sull'oggetto config.
Quando avrai aggiornato correttamente la configurazione del tuo bot di trading, riceverai una risposta 200 con il tuo oggetto config completo restituito. Se la richiesta non va a buon fine, riceverai uno stato 400 con un messaggio di errore che spiega l'errore.
Speriamo che tu sia riuscito a creare e configurare il tuo bot di trading dopo aver letto questo tutorial. Ora sarai in grado di adattare la configurazione del tuo bot di trading e aggiungere nuovi bot di trading al tuo account.