Tutoriály

Vytvoření a konfigurace obchodního robota

 

Nauč se, jak vytvořit obchodního bota pomocí Cryptohopper API a upravit konfiguraci svých obchodních botů. Ve 2 jednoduchých krocích vytvoříme nového obchodního bota a přidáme nastavení konfigurace k nově vytvořenému obchodnímu botovi.

Pro vytváření požadavků API budeš potřebovat vytvořit aplikaci a mít přístupový token. Pokud jsi ještě nevytvořil přístupový token, přečti si nejprve tutoriál Získat přístupový token pomocí Oauth2.

Krok 1: Vytvoř nového obchodního bota

Pro vytvoření nového obchodního bota pomocí API budeš muset provést volání POST na koncový bod hopper. Pomocí volání POST můžeš okamžitě posílat konfigurační hodnoty, ale v tomto příkladu pošleme pouze několik konfiguračních příkladů a obchodního bota nakonfigurujeme v dalším kroku. Níže najdeš koncový bod API a JSON, který budeš muset odeslat s požadavkem POST.

Koncový bod API:

https://api.cryptohopper.com/v1/hopper

JSON POST:

{
    "name": "Název tvého nově vytvořeného obchodního bota.",
    "enabled": 0
}

Když bude požadavek API úspěšný, obdržíš odpověď JSON s hodnotou: id. Toto id je jedinečný identifikátor tvého nově vytvořeného obchodního bota. Ulož si toto id, protože ho budeš potřebovat v dalším kroku k úpravě konfigurace obchodního bota.

Krok 2: Konfigurace obchodního bota

Nyní, když jsme vytvořili nového obchodního bota a máš id nově vytvořeného obchodního bota, je čas nakonfigurovat obchodního bota, aby se s ním dalo automaticky obchodovat. Všechny aktualizace tvého obchodního bota se provádějí přístupem ke koncovým bodům obchodního bota s tvým id, jako je /hopper/{id}. Pro aktualizaci konfigurace tvého obchodního bota budeš muset provést požadavek PATCH na tento koncový bod. Níže najdeš koncový bod, kam budeš muset odeslat svůj požadavek PATCH. Nahraď {id} id, které jsi obdržel v kroku 1.

Koncový bod API:

https://api.cryptohopper.com/v1/hopper/{id}

Budeš muset odeslat data JSON s aktualizacemi, které chceš provést. Pokud chceš například změnit název svého obchodního bota, budeš muset znovu odeslat klíč name. Pokud nechceš název změnit, stačí toto pole vynechat. Níže najdeš příklad požadavku JSON PATCH.

Příklad požadavku JSON PATCH:

{
    "name": "Nový název tvého nově vytvořeného obchodního bota.",
    "enabled": 0,
    "api_config": {
    "api_key": "API klíč tvého burzovního účtu.",
    "api_secret": "API tajný klíč tvého burzovního účtu."
    },
    "config": {
    "exchange": "binance",
        "collect_currency": "btc",
        .... A další možnosti konfigurace
    }
}

Pojďme si projít některé z možných možností konfigurace v požadavku JSON.

api_config
api_key Toto je API klíč, který jsi vytvořil na své burze.
api_secret Toto je API tajný klíč, který jsi vytvořil na své burze.
config
exchange Zadej klíč burzy, kterou chceš připojit. Chceš-li získat seznam všech burz a klíčů, přejdi na: https://api.cryptohopper.com/v1/exchange
collect_currency Toto je kvótovací měna tvého obchodního bota malými písmeny, například: btc, usd, eth.
allowed_coins Seznam polí mincí (velkými písmeny), které může automaticky nakupovat obchodní bot. Například: ["BTC", "LTC", "ETH"].
perc_buy_amount Procento tvého celkového majetku, které se použije k určení výše nákupu.
min_buy_amount Minimální výše nákupu automatických nákupů.
max_amount_allocated Maximální částka (v kvótovací měně) přidělená tvému obchodnímu botovi.
strategy Strategie, kterou chceš konfigurovat. Například: no_strategy, multiple_ta. Chceš-li konfigurovat vlastní strategii, budeš potřebovat id strategie a nakonfiguruješ ji jako: user_{id}, například: user_1.
num_targets_per_buy Počet cílů, které se nakoupí, pokud tvá strategie najde více cílů.
max_open_time_buy Počet minut, po které mohou zůstat otevřené nákupní objednávky, než se automaticky zruší.
max_open_time Počet minut, po které mohou zůstat otevřené prodejní objednávky, než se automaticky zruší.
set_percentage Procentuální zisk, který chceš konfigurovat, například: 1.5.

Samozřejmě existuje mnoho dalších možností konfigurace. Podívej se na referenci API pro více informací o objektu config.

Když jsi úspěšně aktualizoval konfiguraci svého obchodního bota, obdržíš odpověď 200 se vráceným kompletním objektem config. Pokud se požadavek nezdařil, obdržíš stav 400 se zprávou o chybě vysvětlující chybu.

Doufám, že se ti po přečtení tohoto tutoriálu podařilo vytvořit a nakonfigurovat svého obchodního bota. Nyní budeš moci upravit konfiguraci svého obchodního bota a přidat do svého účtu nové obchodní boty.