Een reguliere signal bot starten of stoppen via een TradingView alert

Je hoeft een signal bot niet om te bouwen tot webhook bot om hem automatisch te starten en stoppen. Een reguliere signal bot, dus eentje die draait op de signalen van Altrady’s Crypto Base Scanner in plaats van je eigen webhooks, heeft een eigen kleine API waarmee je hem aan- en uitzet. De meest voorkomende reden om dit te gebruiken: de bot stoppen zodra de marktomstandigheden ongunstig worden, en hem later weer starten op een nieuw signaal of handmatig zodra de rust terugkeert.

Wat deze API wel en niet kan

Deze API is bewust beperkt. De API van de reguliere bot start of stopt de bot, meer niet. Ze opent, sizet of beheert geen posities. De eigen Crypto Base Scanner signalen van de bot blijven verantwoordelijk voor het daadwerkelijke traden, de API bepaalt alleen of de bot aan het luisteren is.

Wil je dat een signaal zelf posities opent en beheert, dan heb je een ander tool nodig: bouw in dat geval een webhook bot, zoals beschreven in How to Connect TradingView Alerts to Altrady with Webhooks.

De API-key van de bot inschakelen

🔍 Click the image to see a larger version

Elke signal bot heeft een eigen sleutelpaar, dat standaard uitstaat totdat je het inschakelt:

1. Open het tabblad Instellingen van de signal bot en zoek de sectie Bot control API.
2. Zet de sectie aan. Er verschijnen nu een API key en een Secret, elk met een Kopiëren-knop.
3. Kopieer beide meteen en bewaar ze op een veilige plek. De secret kun je later niet meer opnieuw kopiëren, al kun je altijd een nieuw paar aanmaken via Regenereren.
4. Sla de bot op.

De request

Stuur een POST naar:

https://api.altrady.com/v2/signal_bot/start_stop

met deze body:

{
  "api_key": "YOUR_BOT_API_KEY",
  "api_secret": "YOUR_BOT_API_SECRET",
  "active": true
}

Het veld active doet het werk: true start de bot, false stopt hem. Dat is de hele request. Er zijn geen andere velden, want dit endpoint doet verder niets.

De key en secret moeten die van deze specifieke bot zijn: ze identificeren de bot, dus er is geen botnaam of id nodig in de request.

Verzenden vanuit een TradingView alert

TradingView alerts kunnen die JSON voor je versturen zodra aan een voorwaarde wordt voldaan, op precies dezelfde manier als bij webhook bots:

1. Maak de alert aan op de voorwaarde waarop je wilt reageren (een prijsniveau, een indicator, of een strategie).
2. Zet bij de meldingen van de alert de Webhook URL aan en plak daar het start/stop-endpoint hierboven in.
3. Plak de JSON body in het berichtveld van de alert, met active op true of false afhankelijk van wat deze alert moet doen.
4. Sla de alert op.

De meeste mensen eindigen met twee alerts: eentje die de bot stopt, en eentje die hem weer start.

Nog steeds vastgelopen?

Als de bot niet van status wisselt zodra je alert afgaat, controleer dan drie dingen: de sectie Bot control API staat aan in de instellingen van de bot, de alert stuurt naar /v2/signal_bot/start_stop en niet naar het position-endpoint, en de berichttekst bevat active in plaats van een action. Werkt het dan nog niet, neem dan contact op via de supportchat met de naam van de bot en de exacte JSON die je alert verstuurt (verwijder eerst de api_key en api_secret).