MetaTrader API — Helpcentrum
Zoek of blader door de categorieën om antwoorden te vinden. Elke vraag heeft een eigen deelbare URL.
Zoek of blader door de categorieën om antwoorden te vinden. Elke vraag heeft een eigen deelbare URL.
MetaTrader API is een gehoste REST-API-dienst waarmee je programmatisch met MT4- en MT5-handelsaccounts werkt – zonder zelf MetaTrader op je computer te laten draaien.
Je verbindt je handelsaccount één keer en kunt vanaf dat moment orders uitvoeren, accountgegevens opvragen en marktprijzen lezen vanuit elke programmeertaal met standaard HTTP-requests.
Alle technische details staan in de officiële documentatie.
Beginnen kost minder dan 30 minuten:
POST /v1/seats of /ConnectEx).De stapsgewijze handleiding staat in de documentatie over authenticatie.
Elke taal die HTTP-requests kan doen werkt met MetaTrader API. Omdat het een gewone REST-API over HTTPS is, kun je Python, JavaScript/Node.js, Go, C#, Java, Ruby, PHP of elke andere taal gebruiken.
Het werkt ook met no-codetools zoals Postman, Make (Integromat), n8n, Zapier of alles wat een HTTP-endpoint kan aanroepen.
Ja. De API ondersteunt accounts van MetaTrader 4 (MT4) en MetaTrader 5 (MT5). Je kunt accounts van beide platforms tegelijk verbinden en beheren.
Facturering gaat per seat: elke seat verbindt één MT4- of één MT5-account, en je kunt MT4- en MT5-seats combineren binnen hetzelfde abonnement.
MT4 en MT5 bieden dezelfde endpoints; het enige verschil is dat stop-limitorders alleen op MT5 bestaan. De volledige endpointreferentie per platform staat in de documentatie.
Nee. Dat is precies het doel van deze dienst. MetaTrader API draait volledig server-side. Je geeft de inloggegevens van je broker één keer op en de API houdt de verbinding met de broker namens jou in stand.
Je hoeft MetaTrader niet te installeren, geen desktopapplicatie te laten draaien en geen Expert Advisors in MQL te schrijven.
Geef je API-sleutel mee in de header x-api-key en de account-UUID als queryparameter id (of accountId):
curl -X GET "https://api.metatraderapi.net/AccountSummary?id=YOUR_ACCOUNT_UUID" \
-H "x-api-key: YOUR_API_KEY"De API-sleutel maak je op de kaart van het account in het dashboard met Generate key; hij wordt maar één keer getoond. De beheersleutel onder Settings (Instellingen) is voor provisioning, niet voor de x-api-key-header.
De API-sleutel van een account maak je op de kaart van dat account in het dashboard op app.metatraderapi.net: klik op Generate key. Hij wordt maar één keer getoond, dus bewaar hem meteen. Ook /ConnectEx en POST /v1/seats geven een nieuwe sleutel terug voor het account dat ze verbinden. Op het tabblad Settings (Instellingen) staat je beheersleutel; die is voor provisioning (seats aanmaken en verwijderen), niet voor handelsaanroepen.
Aanbevolen: bewaar hem als omgevingsvariabele (bijvoorbeeld MTAPI_KEY) en laad hem tijdens runtime in.
Dat kan op twee manieren:
Log in op app.metatraderapi.net, ga naar het onderdeel Accounts en voeg je MT4/MT5-gegevens toe (loginnummer, wachtwoord, servernaam van de broker). Na het verbinden krijg je een unieke UUID voor dat account.
Vanuit een backend gebruik je POST /v1/seats met een JSON-body en je beheersleutel. Je kunt ook /ConnectEx?user=&password=&server=&platform=MT5&wait=60 aanroepen met een beheersleutel of een API-sleutel die niet alleen-lezen is en niet tot één account beperkt is. Beide geven de account-id en een nieuwe apiKey daarvoor terug. De exacte parameters en het responseformaat staan in de API-documentatie.
BrokerName-Live of BrokerName-Demo.Gebruik /CheckConnect?id=. Het antwoord is true of false: of het account op dit moment met zijn broker verbonden is. Weggevallen verbindingen herstelt de dienst automatisch. /ConnectState?id= toont de status en de statusReason, en /Reconnect?id= forceert een nieuwe verbinding.
Details over het requestformaat en de responsewaarden staan in de documentatie.
Gebruik /Disconnect?id= (of DELETE /v1/seats/{id} met een beheersleutel) om een verbonden handelsaccount te ontkoppelen en te verwijderen. Alle momenteel verbonden accounts vraag je op met /ConnectState zonder id (of met GET /v1/seats).
Ontkoppelen maakt de seat van het account vrij. Die blijft betaald tot het einde van de factuurmaand, en het volgende account dat je verbindt gebruikt hem zonder extra kosten.
De requestparameters staan in de API-documentatie.
Zoveel als je seats hebt. Facturering gaat per seat: één seat = één verbonden account tegelijk. Voeg seats toe wanneer je ze nodig hebt ($ 14 per seat per maand voor seats 1–4, $ 13 voor seats 5–19 en $ 12 vanaf de 20e seat, vooraf gefactureerd).
Elke klant kan maximaal 50 seats hebben; meer op aanvraag – neem contact op met support.
De API dekt de volledige handelscyclus:
/OrderClose), of tegen een tegengestelde positie (/OrderCloseBy)Alle endpoints, parameters en responseformaten staan in de API-documentatie.
Gebruik het endpoint /OrderSend. Zoals elk klassiek endpoint is het een GET-request met queryparameters: symbool, operatie (Buy, Sell, BuyLimit, ...), volume in lots en optioneel stop loss, take profit, een opmerking en een clientOrderId:
curl -H "x-api-key: YOUR_API_KEY" \
"https://api.metatraderapi.net/OrderSend?id=YOUR_ACCOUNT_UUID&symbol=EURUSD&operation=Buy&volume=0.01&clientOrderId=order-1"De parameters zijn op MT4 en MT5 gelijk. Stop-limitorders (stopLimitPrice) bestaan alleen op MT5. Pending orders accepteren een optionele expiration; expirationType wordt op MT5 genegeerd.
Gebruik de endpoints /OrderHistory of /OrderHistoryPagination. Beide filteren alleen op periode (from en to, ISO-8601 of Unix-seconden); /OrderHistoryPagination verdeelt het resultaat in pagina's (ordersPerPage, pageNumber). Filteren op ticket of sorteren doe je in je eigen code. Voor gedetailleerdere queries zijn er op MT4 en MT5 daarnaast /PendingOrderHistory en /HistoryDealsByPositionId.
De volledige parameterreferentie staat in de documentatie.
Ja. De API biedt een WebSocket-verbinding (events) voor realtime streaming. Zo ontvang je updates direct in plaats van REST-endpoints herhaaldelijk te pollen.
Via de WebSocket-stream (wss://api.metatraderapi.net/v1/stream?id=, geauthenticeerd met de header x-api-key) ontvang je live koersen en candles van de symbolen waarop je bent geabonneerd, je open posities met live winst, pending orders en elke uitgevoerde trade, plus elke 10 seconden een heartbeat. Per account kunnen maximaal 25 streams tegelijk open zijn.
Voor live bied-/laatkoersen kun je het REST-endpoint /GetQuote gebruiken (of /GetQuoteMany voor meerdere symbolen), of je abonneert je op de koersen via de WebSocket-stream voor continue realtime updates.
/GetQuote verwacht de account-id en een symbol. Antwoorden worden per account en symbool 250 ms gecachet; voeg cached=0 toe om de cache te omzeilen.
Voor historische OHLC-candles gebruik je /PriceHistory op MT4 en MT5 (/QuoteHistory is daar een alias van) – zie de documentatie voor timeframes en parameters.
Er is één plan: je betaalt per seat, en elke seat bevat de volledige API – REST, WebSocket-streaming en ondersteuning voor zowel MT4 als MT5. Prijzen excl. btw:
Elke seat houdt één verbonden MT4- of MT5-account tegelijk en wordt vooraf gefactureerd voor een volledige factuurmaand. Voorbeeld: 10 seats kosten 4 × $ 14 + 6 × $ 13 = $ 134 per maand. Alle prijzen worden bevestigd op de prijzenpagina.
Nee. We bieden momenteel geen gratis proefperiode. Heb je vragen over het evalueren van de API, neem dan contact op via Telegram of e-mail support@metatraderapi.net.
Je kunt starten met één seat voor $ 14 en meer toevoegen zodra je integratie werkt.
Ja. Het plan per seat wordt per seat gefactureerd, en elke seat bevat één verbonden account tegelijk. Zijn al je seats in gebruik, dan voegt het verbinden van nog een account een seat toe voor $ 14 per maand ($ 13 voor seats 5–19, $ 12 vanaf de 20e seat), vooraf in rekening gebracht bij het toevoegen. Als je een account loskoppelt, komt de seat zonder kosten vrij voor het volgende account, en ongebruikte seats geef je vrij in je dashboard. Elke klant kan maximaal 50 seats hebben; meer op aanvraag – neem contact op met support.
Betaling gaat per creditcard of debitcard via Stripe, als abonnement dat maandelijks wordt gefactureerd. Crypto en bankoverschrijving accepteren we niet.
Door een bestelling te plaatsen accepteer je ook de Stripe-serviceovereenkomst.
Ja, je kunt op elk moment opzeggen. De opzegging gaat in aan het einde van de huidige factuurmaand – er is geen gedeeltelijke terugbetaling voor ongebruikte dagen.
De dienst wordt beheerd door Apex Vanguard Dynamics LLC, een vennootschap met beperkte aansprakelijkheid (LLC) geregistreerd in de Verenigde Staten, met geregistreerd adres 30 N Gould St Ste R, Sheridan, WY 82801, Verenigde Staten.
Contact: support@metatraderapi.net · Telefoon: +1 (929) 333-6422
De volledige juridische gegevens staan in de juridische informatie.
De servicevoorwaarden worden beheerst door het recht van de staat Wyoming, Verenigde Staten. Geschillen vallen onder de exclusieve bevoegdheid van de rechtbanken in Wyoming, en beide partijen komen overeen eerst te proberen het geschil in goed vertrouwen te schikken.
Je kunt de volledige servicevoorwaarden op de website lezen.
Nee. De servicevoorwaarden vereisen uitdrukkelijk dat je je inloggegevens en API-sleutels vertrouwelijk houdt en niet met derden deelt zonder voorafgaande schriftelijke toestemming van MetaTrader API.
Bouw je een product of dienst op de API (bijvoorbeeld voor je eigen klanten), dan moet je een eigen authenticatielaag bouwen en de MetaTrader API-sleutel uitsluitend server-side houden – stel hem nooit bloot aan eindgebruikers.
Nee. De servicevoorwaarden verbieden het scrapen of doorverkopen van data van de dienst zonder uitdrukkelijke schriftelijke toestemming van MetaTrader API. Abonnementen zijn daarnaast niet overdraagbaar.
Heb je een specifieke businesscase, mail dan support@metatraderapi.net.
Ja. NDA's zijn op aanvraag beschikbaar en moeten door beide partijen schriftelijk worden overeengekomen. De standaard NDA-voorwaarden gelden, tenzij anders onderhandeld.
Mail support@metatraderapi.net om er een aan te vragen.
MetaTrader API beveiligt gekoppelde accounts met de volgende maatregelen:
Beveiligingsmaatregelen, subverwerkers en gemeten uptime staan in het Trust Center; hoe we met gegevens omgaan staat in het privacybeleid.
MetaTrader API wordt beheerd door een Amerikaans bedrijf (zie Wie beheert MetaTrader API?) en verklaart te voldoen aan de toepasselijke gegevensbeschermingswetgeving, waaronder de AVG waar die geldt voor gebruikers in de EU/EER.
Welke persoonsgegevens worden verzameld: accountgegevens (naam, e-mailadres, factuurgegevens), gebruiksgegevens (API-logs, IP-adres, browser en besturingssysteem) en betaalgegevens die via Stripe worden verwerkt.
Wij verkopen geen persoonsgegevens. Ze worden alleen gedeeld met dienstverleners die ze namens ons verwerken (zoals hosting, betalingen en e-mailverzending), en voor klanten is een verwerkersovereenkomst beschikbaar. Alle details staan in het privacybeleid en het Trust Center.
Volgens het privacybeleid kunnen de volgende gegevens worden verzameld:
Voor gekoppelde handelsaccounts worden ook de broker-inloggegevens opgeslagen (in rust versleuteld met AES-256-GCM), en de handelsdata die de API ophaalt wordt namens jou verwerkt. Klantgegevens en API-servers staan in de EU (Finland en Duitsland). Seats met privéhosting draaien in de regio die je kiest.
Lees het volledige privacybeleid voor alle informatie.
De meest voorkomende oorzaken van een mislukte verbinding:
ICMarkets-Live02). Je vindt hem in MetaTrader onder Bestand → Een account openen.Controleer de huidige verbindingsstatus met /CheckConnect. Blijft het probleem bestaan, mail dan support@metatraderapi.net.
Authenticatiefouten betekenen meestal dat de API-sleutel ontbreekt, verkeerd is of in het verkeerde formaat wordt verstuurd. Controleer het volgende:
x-api-key gebruikt – niet Authorization: Bearer.Het juiste formaat staat in de documentatie over authenticatie.
MetaTrader API publiceert de gemeten uptime op een openbare statuspagina, met de live status en uptimegeschiedenis van de REST API, WebSocket-streaming en het dashboard. Er is geen SLA of beschikbaarheidstoezegging; in het Trust Center lees je hoe de dienst wordt beheerd.
Let op: volgens de servicevoorwaarden wordt de dienst geleverd “zoals ze is” en “zoals beschikbaar” (“as is” / “as available”) – ononderbroken of foutloze werking wordt contractueel niet gegarandeerd. Implementeer voor productiesystemen altijd zelf retry-logica en foutafhandeling.
Orderweigeringen komen van de handelsserver van de broker, niet van MetaTrader API. Veelvoorkomende oorzaken:
EURUSD of EURUSDm).Een weigering door de broker is geen HTTP-fout: de API antwoordt met HTTP 200 en het orderobject, waarvan het veld state de resultaatcode van de broker bevat. 10009 betekent uitgevoerd; elke andere waarde is de reden (bijvoorbeeld 10016 ongeldige stops, 10018 markt gesloten, 10019 onvoldoende saldo; op MT4 het MT4-foutnummer).