Voer een simpele koop- en verkooporder uit op de exchange met je trading bot door de order API endpoint aan te roepen.

Om API-verzoeken te kunnen doen, moet je een app aanmaken en een access token hebben. Als je nog geen access token hebt aangemaakt, volg dan eerst de tutorial Get an access token with Oauth2.

Een kooporder plaatsen

Met de API kun je simpele of meer geavanceerde kooporders plaatsen met je trading bot. In dit voorbeeld richten we ons alleen op een simpele kooporder. Een simpel koop commando naar de API heeft alleen een coin/currency nodig, omdat de meeste van de andere benodigde details al zijn geconfigureerd in de trading bot zelf, bijvoorbeeld: het bedrag dat je wilt kopen. Een kooporder kan worden geplaatst door een POST-call uit te voeren naar de /hopper/{id}/order endpoint, waarbij {id} de id van je hopper is.

API endpoint:

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

JSON POST voorbeeld:

{
  "order_type": "buy",
  "coin": "De crypto currency om te kopen.",
  "amount": 0,
  "price": 0
}

De JSON-waarden amount en price zijn optioneel, alleen order_type en coin zijn vereist. Als je een trading bot hebt met USD als quote currency en je wilt een simpele kooporder voor BTC plaatsen, dan hoef je alleen de volgende JSON naar de API te POSTEN.

{
  "order_type": "buy",
  "coin": "BTC"
}

Als het lukt, ontvang je een 200-status response met de melding dat je kooporder op de exchange wordt geplaatst. Controleer nu je trading bot en kijk of de kooporder is doorgekomen.

Een verkooporder plaatsen

Je kunt ook verkooporders plaatsen, maar omdat Cryptohopper met posities werkt, worden posities van de gegeven coin/currency verkocht. Bijvoorbeeld: als je een commando zou sturen om BTC te verkopen, worden al je BTC-posities verkocht (indien niet in hold etc.).

API endpoint:

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

JSON POST voorbeeld:

{
  "order_type": "sell",
  "coin": "De crypto currency om te verkopen."
}

Dezelfde API endpoint wordt gebruikt, maar in dit geval zetten we order_type op sell. Als je een trading bot hebt met USD als quote currency en je wilt alle BTC-posities verkopen, dan hoef je alleen de volgende JSON naar de API te POSTEN.

{
  "order_type": "sell",
  "coin": "BTC"
}

Als het lukt, ontvang je een 200 status response met de melding dat je verkooporder(s) op de exchange worden geplaatst. Controleer nu je trading bot en kijk of je posities zijn verkocht.

Hopelijk is het gelukt om koop- en verkooporders met de API te plaatsen na het afronden van deze tutorial. Als je meer info nodig hebt over de order endpoint of meer geavanceerde orders wilt plaatsen, bekijk dan de API reference voor meer info.