Configuratiereferentie

Volledige uitleg van configuratievelden

De ByNinja Trading Bot gebruikt meerdere configuratiemodules om de verantwoordelijkheden tussen handelsuitvoering, exchange-connectiviteit en Telegram-communicatie te scheiden.

Het configuratiesysteem is bewust lichtgewicht en bestandsgebaseerd, waardoor eenvoudige implementatie, snelle bewerking en voorspelbaar opstartgedrag mogelijk is.

Telegram Configuratie

De Telegram-configuratiemodule bevat alle parameters die nodig zijn voor Telegram Bot API-communicatie en TCP-integratie.

TELEGRAM_BOT_TOKEN

Code
TELEGRAM_BOT_TOKEN = "your_telegram_bot_token"

De Telegram-bot token die wordt gebruikt voor authenticatie met de Telegram Bot API.

Deze token wordt gegenereerd via BotFather in Telegram en identificeert de bot-instantie uniek.

Verantwoordelijkheden:

  • •Authenticeert API-verzoeken
  • •Maakt het verzenden van notificaties mogelijk
  • •Maakt het ontvangen van gebruikerscommando's mogelijk
  • •Verleent toegang tot Telegram-bot functies

Belangrijk:

  • •Stel de token nooit publiekelijk bloot
  • •Commit deze nooit in openbare repositories
  • •Behandel het als een privé-inloggegeven

TELEGRAM_CHAT_ID

Code
TELEGRAM_CHAT_ID = "your_private_telegram_chat_id"

Het privé Telegram-chat-ID waar notificaties en handelswaarschuwingen worden bezorgd.

De bot gebruikt dit ID om communicatie alleen tot de geautoriseerde eigenaar te beperken.

Verantwoordelijkheden:

  • •Rout waarschuwingen en notificaties
  • •Beperkt onbevoegde toegang
  • •Maakt uitvoering van privécommando's mogelijk

Typisch gebruik:

  • •Persoonlijke handelsnotificaties
  • •Extern botbeheer
  • •Monitoring van transactie-uitvoering

TCP_SERVER_PORT

Code
TCP_SERVER_PORT = 55110

Bepaalt de TCP-poort die wordt gebruikt voor communicatie tussen de Telegram-server en de handelsbot.

Beide applicaties moeten dezelfde poortwaarde gebruiken.

Verantwoordelijkheden:

  • •TCP-berichtentransport
  • •Routering van externe commando's
  • •Realtime doorsturen van logs

Belangrijk:

  • •De poort moet beschikbaar zijn op het systeem
  • •Firewallregels moeten mogelijk worden aangepast
  • •Beide processen moeten een identieke configuratie delen

Binance Configuratie

De Binance-configuratiemodule bevat de authenticatiegegevens voor de exchange en instellingen voor handelscommunicatie.

BINANCE_API_KEY

Code
BINANCE_API_KEY = "your_binance_api_key"

Openbare API-sleutel gegenereerd vanuit het Binance-account.

Wordt gebruikt om verzoeken aan Binance-services te authenticeren.

Verantwoordelijkheden:

  • •Toegang tot marktgegevens
  • •Rechten voor het plaatsen van orders
  • •Toegang tot accountinformatie

Veiligheidsaanbevelingen:

  • •Schakel indien mogelijk IP-beperkingen in
  • •Gebruik alleen handelsrechten
  • •Vermijd het inschakelen van opnamerechten

BINANCE_API_SECRET

Code
BINANCE_API_SECRET = "your_binance_api_secret"

Privé API-geheim gekoppeld aan de Binance API-sleutel.

Wordt gebruikt voor het ondertekenen van verzoeken en authenticatieverificatie.

Belangrijk:

  • •Moet strikt privé blijven
  • •Nooit publiekelijk blootgeven
  • •Nooit verzenden via logs of screenshots

TCP_SERVER_PORT

Code
TCP_SERVER_PORT = 55110

Bepaalt de TCP-communicatiepoort die wordt gebruikt door de TCP-client van de handelsbot.

Deze waarde moet overeenkomen met de configuratie van de Telegram-server.

Handelsconfiguratie

De handelsconfiguratiemodule definieert kapitaaltoewijzing, handelsparen, strategiegedrag en portefeuillerisicobeheer.

INITIAL_CAPITAL

Code
INITIAL_CAPITAL = 1000.0

Definieert het virtuele of bijgehouden startkapitaal voor het handelssysteem.

Gebruikt voor:

  • •Prestatieberekeningen
  • •Drawdown-berekeningen
  • •Tracking van portefeuilleblootstelling
  • •Statistieken voor risicobeheer

De waarde wordt uitgedrukt in USDT.

TRADING_PAIRS

Code
TRADING_PAIRS = [
    "AVAXUSDT",
    "LINKUSDT",
    "DOTUSDT",
    "XRPUSDT",
    "ATOMUSDT"
]

Lijst van cryptovaluta-symbolen die door het systeem worden gevolgd en verhandeld.

Elk symbool moet ook bestaan in het TRADING_PARAMETERS woordenboek.

Verantwoordelijkheden:

  • •Definieert actieve handelsmarkten
  • •Beheert symbool-abonnementen
  • •Maakt symbool-specifieke strategie-uitvoering mogelijk

Pro Tip: Gebruik een Code-editor

Voor een veel betere ervaring bij het bewerken van configuratiebestanden, raden we aan een professionele code-editor zoals Visual Studio Code te gebruiken.

Download VS Code ↗

Referentie voor handelsparameters

Elk handelspaar bevat een onafhankelijk configuratieprofiel voor de strategie.

Dit ontwerp stelt elke markt in staat om aangepaste volatiliteits-, trend- en risicoparameters te gebruiken.

lot_size

Code
"lot_size": 0.5

Minimale orderhoeveelheid voor het handelspaar.

De waarde moet voldoen aan de lotgroottevereisten van de Binance-exchange.

Doel:

  • •Voorkomt ongeldige ordergroottes
  • •Zorgt voor compatibiliteit met de exchange
  • •Beheerst de minimale handelsprecisie

position_size

Code
"position_size": 18.0

Maximale kapitaaltoewijzing in USDT voor een enkele transactie-inleg.

Doel:

  • •Beheerst de positiestootstelling
  • •Beperkt het risico per transactie
  • •Voorkomt overtoewijzing

Hogere waarden verhogen:

  • •Potentiële winst
  • •Potentieel verlies
  • •Portefeuilleblootstelling

take_profit_percent

Code
"take_profit_percent": 2.81

Doelwinstpercentage ten opzichte van de instapprijs.

Wanneer de markt dit niveau bereikt, sluit de bot de positie met winst.

Doel:

  • •Sluit winsten vast
  • •Definieert het beloningsdoel
  • •Standaardiseert exits

Voorbeeld:

  • •Instap op 100 USDT
  • •Take profit op 2,81%
  • •Exitdoel = 102,81 USDT

stop_loss_percent

Code
"stop_loss_percent": 1.41

Maximaal toegestaan verliespercentage onder de instapprijs.

De positie wordt automatisch gesloten als de markt zich tegen de transactie keert.

Doel:

  • •Beperkt het neerwaartse risico
  • •Beschermt handelskapitaal
  • •Voorkomt grote drawdowns

Voorbeeld:

  • •Instap op 100 USDT
  • •Stop loss op 1,41%
  • •Exit op 98,59 USDT

trail_activation_percent

Code
"trail_activation_percent": 1.3

Winstdrempel die moet worden bereikt voordat het trailing stop-systeem wordt geactiveerd.

Voor activering:

  • •Standaard stop loss wordt gebruikt

Na activering:

  • •Dynamische trailing-bescherming begint

Doel:

  • •Beschermt winstgevende transacties
  • •Staat winst toe om door te lopen
  • •Vermindert voortijdige exits

trail_distance_percent

Code
"trail_distance_percent": 0.8

Afstand tussen het huidige markthoogtepunt en het trailing stop-niveau.

Doel:

  • •Beschermt ongerealiseerde winsten
  • •Staat natuurlijke marktbeweging toe
  • •Creëert dynamische exits

Kleinere waarden:

  • •Strakkere bescherming
  • •Snellere exits
  • •Gevoeliger gedrag

Grotere waarden:

  • •Meer flexibiliteit
  • •Langere transactieduur
  • •Verhoogde tolerantie voor terugval

trail_tight_distance_percent

Code
"trail_tight_distance_percent": 0.5

Een strakkere trailing stop-afstand die wordt gebruikt bij sterkere weerstand of ommekeercondities.

Doel:

  • •Agressieve winstbescherming
  • •Snellere transactie-exits bij weerstand
  • •Verminderde winstteruggave

min_ema200_3m_slope

Code
"min_ema200_3m_slope": -0.008

Minimaal toegestane helling van de 3-minuten EMA200-indicator.

Gebruikt als een trendfilter voor een hogere tijdframe.

Doel:

  • •Vermijdt handelen tijdens sterke neerwaartse trends
  • •Filtert zwakke marktstructuren
  • •Verbetert de trenduitlijning

min_ema20_1m_slope

Code
"min_ema20_1m_slope": 0.01

Minimale vereiste helling voor de 1-minuten EMA20-indicator.

Gebruikt voor bevestiging van momentum op korte termijn.

Doel:

  • •Detecteert opwaartse versnelling
  • •Bevestigt bullish momentum
  • •Filtert vlakke marktomstandigheden

min_ema50_1m_slope

Code
"min_ema50_1m_slope": 0.005

Minimale vereiste helling voor de 1-minuten EMA50-indicator.

Dient als extra trendbevestiging.

Doel:

  • •Bevestigt de richting op middellange termijn
  • •Vermindert valse signalen
  • •Verbetert de kwaliteit van de entry

volume_spike_coeff

Code
"volume_spike_coeff": 1.2

Vereiste volumemultiplier ten opzichte van het gemiddelde volume.

De bot gaat alleen transacties aan als het huidige volume de geconfigureerde drempel overschrijdt.

Doel:

  • •Detecteert sterke marktparticipatie
  • •Vermijdt entries met lage liquiditeit
  • •Bevestigt de sterkte van de uitbraak

Voorbeeld:

  • •Gemiddeld volume = 1000
  • •Coëfficiënt = 1,2
  • •Vereist volume = 1200+

max_candle_size

Code
"max_candle_size": 0.8

Maximaal toegestaan candle-groottepercentage voordat een entry wordt geblokkeerd.

Doel:

  • •Vermijdt instappen na te grote candles
  • •Voorkomt het najagen van overstrekte bewegingen
  • •Vermindert FOMO-entries

min_ema50_ema200_distance

Code
"min_ema50_ema200_distance": 0.06

Minimaal vereiste procentuele afstand tussen EMA50 en EMA200.

Doel:

  • •Bevestigt scheiding van markttrends
  • •Filtert zwakke trends
  • •Valideert de trendstructuur

Hogere afstandswaarden duiden over het algemeen op sterkere trends.

min_ema20_ema50_distance

Code
"min_ema20_ema50_distance": 0.10

Minimale vereiste afstand tussen EMA20 en EMA50-indicatoren.

Doel:

  • •Bevestigt de sterkte van het momentum op korte termijn
  • •Filtert zwakke entries
  • •Verbetert de signaalkwaliteit

Referentie voor Risicoparameters

Het risicobeheersysteem beschermt zowel individuele symbolen als de gehele portefeuille.

max_portfolio_exposure

Code
"max_portfolio_exposure": 90.0

Maximaal percentage van het portefeuillekapitaal dat tegelijkertijd aan open posities kan worden toegewezen.

Doel:

  • •Voorkomt overmatige blootstelling
  • •Handhaaft reserve-liquiditeit
  • •Vermindert systemisch risico

max_consecutive_losses

Code
"max_consecutive_losses": 10

Maximaal aantal opeenvolgende verliezende transacties toegestaan voordat de handel voor het symbool wordt gepauzeerd.

Doel:

  • •Detecteert instabiele marktomstandigheden
  • •Voorkomt emotionele overhandelingslogica
  • •Beperkt periodes van strategieverval

max_daily_drawdown_per_symbol

Code
"max_daily_drawdown_per_symbol": 3.0

Maximaal dagelijks verliespercentage toegestaan voor een individueel handelspaar.

Indien overschreden:

  • •Handel voor het symbool wordt tijdelijk stopgezet

Doel:

  • •Beperkt symbool-specifieke schade
  • •Voorkomt herhaalde verliezen in instabiele markten

max_total_drawdown_per_symbol

Code
"max_total_drawdown_per_symbol": 6.0

Maximaal cumulatief verliespercentage toegestaan voor een handelspaar over alle sessies heen.

Doel:

  • •Detecteert consequent slecht presterende symbolen
  • •Voorkomt langdurige kapitaaluitholling

max_daily_drawdown

Code
"max_daily_drawdown": 5.0

Maximaal toegestaan dagelijks portefeuilleverliespercentage.

Indien overschreden:

  • •Alle handelsactiviteiten worden gepauzeerd

Doel:

  • •Beschermt de portefeuille tijdens extreme marktomstandigheden
  • •Beperkt catastrofale dagelijkse verliezen

max_total_drawdown

Code
"max_total_drawdown": 10.0

Maximale cumulatieve portefeuille-drawdown gedurende de hele handelscyclus.

Doel:

  • •Dient als een ultiem kapitaalbeschermingsmechanisme
  • •Voorkomt volledig strategiefalen
  • •Handhaaft lange termijn risicodiscipline

Eenmaal bereikt:

  • •Handelsactiviteiten moeten uitgeschakeld blijven totdat handmatige beoordeling is uitgevoerd.