ONTWIKKELAARSLeer hoe je een trading bot kunt creëren met de Cryptohopper API en de configuratie van je trading bot(s) kunt bewerken. In 2 simpele stappen creëren we een nieuwe trading bot en voegen we configuratie-instellingen toe aan de nieuw gecreëerde trading bot.
Om API-verzoeken te kunnen doen, moet je een app maken en een toegangstoken hebben. Als je nog geen toegangstoken hebt gemaakt, volg dan eerst de tutorial Get an access token with Oauth2.
Stap 1: Creëer een nieuwe trading bot
Om een nieuwe trading bot te creëren met de API, moet je een POST-aanroep maken naar de hopper endpoint. Met de POST-aanroep kun je direct configuratiewaarden meesturen, maar in dit voorbeeld sturen we slechts een paar configuratievoorbeelden en configureren we de trading bot in de volgende stap. Hieronder vind je het API-endpoint en de JSON die je moet versturen met de POST-verzoek.
API-endpoint:
https://api.cryptohopper.com/v1/hopper
JSON POST:
{
"name": "De naam van je nieuw gemaakte trading bot.",
"enabled": 0
}
Wanneer het API-verzoek succesvol is, ontvang je een JSON-respons met de waarde: id. Deze id is de unieke identifier van je nieuw gecreëerde trading bot. Sla de id op, want we hebben deze nodig in de volgende stap om de configuratie van de trading bot aan te passen.
Stap 2: Configureer je trading bot
Nu we een nieuwe trading bot hebben gecreëerd en je de id hebt van de nieuw gemaakte trading bot, is het tijd om de trading bot te configureren, zodat je er automatisch mee kunt gaan traden. Alle updates voor je trading bot worden gedaan door de trading bot endpoints te benaderen met je id, zoals /hopper/{id}. Om de configuratie van je trading bot bij te werken, moet je een PATCH-verzoek maken naar dit endpoint. Hieronder vind je het endpoint waarnaar je je PATCH-verzoek moet sturen. Vervang {id} met de id die je in stap 1 hebt ontvangen.
API-endpoint:
https://api.cryptohopper.com/v1/hopper/{id}
Je moet JSON-data meesturen met de updates die je wilt maken. Als je bijvoorbeeld de naam van je trading bot wilt wijzigen, moet je de naam key opnieuw versturen. Als je de naam niet wilt wijzigen, laat je dit veld gewoon weg. Hieronder vind je een voorbeeld van een JSON PATCH-verzoek.
Voorbeeld JSON PATCH-verzoek:
{
"name": "Een nieuwe naam voor je nieuw gemaakte trading bot.",
"enabled": 0,
"api_config": {
"api_key": "De API key van je exchange account.",
"api_secret": "De API secret van je exchange account."
},
"config": {
"exchange": "binance",
"collect_currency": "btc",
.... En meer configuratie opties
}
}
Laten we een aantal van de mogelijke configuratieopties in het JSON-verzoek bekijken.
| api_config | |
| api_key | Dit is de API key die je hebt aangemaakt op je exchange. |
| api_secret | Dit is de API secret die je hebt aangemaakt op je exchange. |
| config | |
| exchange | Voer de exchange key in van de exchange die je wilt koppelen. Ga naar: https://api.cryptohopper.com/v1/exchange voor een lijst met alle exchanges en keys. |
| collect_currency | Dit is de quote currency van je trading bot in kleine letters, bijvoorbeeld: btc, usd, eth. |
| allowed_coins | Een array lijst van coins (hoofdletters) die de trading bot automatisch mag kopen. Bijvoorbeeld: ["BTC", "LTC", "ETH"]. |
| perc_buy_amount | Het percentage van je totale assets dat wordt gebruikt om het buy-bedrag te bepalen. |
| min_buy_amount | Het minimale buy-bedrag van automatische buys. |
| max_amount_allocated | Het maximale bedrag (in quote currency) dat aan je trading bot is toegewezen. |
| strategy | De strategie die je wilt configureren. Bijvoorbeeld: no_strategy, multiple_ta. Als je een op maat gemaakte strategie wilt configureren, heb je de id van de strategie nodig en configureer je deze als: user_{id}, bijvoorbeeld: user_1. |
| num_targets_per_buy | Het aantal targets dat wordt gekocht als er meerdere targets door je strategie worden gevonden. |
| max_open_time_buy | Het aantal minuten dat buy-orders open kunnen blijven staan voordat ze automatisch worden geannuleerd. |
| max_open_time | Het aantal minuten dat sell-orders open kunnen blijven staan voordat ze automatisch worden geannuleerd. |
| set_percentage | Het take profit percentage dat je wilt configureren, bijvoorbeeld: 1.5. |
Natuurlijk zijn er nog veel meer configuratieopties. Bekijk de API reference voor meer info over het config object.
Wanneer je de configuratie van je trading bot succesvol hebt bijgewerkt, ontvang je een 200-response met je complete config object terug. Als het verzoek mislukt, ontvang je een 400-status met een foutmelding die de fout uitlegt.
Hopelijk ben je erin geslaagd om je trading bot te creëren en te configureren na het lezen van deze tutorial. Je kunt nu de configuratie van je trading bot aanpassen en nieuwe trading bots aan je account toevoegen.