MetaTrader API — Yardım Merkezi
Aramayı kullanın veya soldaki kategorilere göz atın. Her sorunun paylaşılabilir kendi adresi vardır.
Aramayı kullanın veya soldaki kategorilere göz atın. Her sorunun paylaşılabilir kendi adresi vardır.
MetaTrader API, MT4 ve MT5 işlem hesaplarıyla programatik olarak çalışmanızı sağlayan, barındırılan bir REST API hizmetidir — bilgisayarınızda MetaTrader çalıştırmanız gerekmez.
İşlem hesabınızı bir kez bağlarsınız; o andan itibaren standart HTTP istekleriyle, herhangi bir programlama dilinden emir yürütebilir, hesap verilerini okuyabilir ve piyasa fiyatlarını alabilirsiniz.
Tüm teknik ayrıntılar için resmi dokümantasyona bakın.
Başlamak 30 dakikadan kısa sürer:
POST /v1/seats veya /ConnectEx).Adım adım kılavuz kimlik doğrulama dokümantasyonunda yer alıyor.
HTTP isteği yapabilen her dil MetaTrader API ile çalışır. HTTPS üzerinden düz bir REST API olduğu için Python, JavaScript/Node.js, Go, C#, Java, Ruby, PHP veya başka herhangi bir dili kullanabilirsiniz.
Postman, Make (Integromat), n8n, Zapier gibi kod gerektirmeyen araçlarla ya da bir HTTP uç noktasını çağırabilen her şeyle de çalışır.
Evet. API, MetaTrader 4 (MT4) ve MetaTrader 5 (MT5) hesaplarını destekler. İki platformdaki hesapları aynı anda bağlayıp yönetebilirsiniz.
Faturalama koltuk başınadır: her koltuk bir MT4 veya bir MT5 hesabı bağlar ve MT4 ile MT5 koltuklarını aynı abonelikte birlikte kullanabilirsiniz.
MT4 ve MT5 aynı uç noktaları sunar; tek fark, stop-limit emirlerinin yalnızca MT5'te bulunmasıdır. Platform başına tam uç nokta referansı dokümantasyonda yer alır.
Hayır. Bu hizmetin temel amacı da tam olarak budur. MetaTrader API tamamen sunucu tarafında çalışır. Aracı kurum bilgilerinizi bir kez girersiniz, API bağlantıyı sizin adınıza sürdürür.
MetaTrader kurmanız, herhangi bir masaüstü uygulamasını çalışır durumda tutmanız veya MQL ile Expert Advisor yazmanız gerekmez.
API anahtarınızı x-api-key başlığında, hesap UUID'sini ise id (veya accountId) sorgu parametresinde gönderin:
curl -X GET "https://api.metatraderapi.net/AccountSummary?id=YOUR_ACCOUNT_UUID" \
-H "x-api-key: YOUR_API_KEY"API anahtarını kontrol panelinde hesabın kartında Generate key ile oluşturursunuz; yalnızca bir kez gösterilir. Settings (Ayarlar) sekmesindeki yönetim anahtarı hesap tahsisi içindir, x-api-key başlığı için değil.
Bir hesabın API anahtarı, app.metatraderapi.net adresindeki kontrol panelinde o hesabın kartında oluşturulur: Generate key düğmesine tıklayın. Yalnızca bir kez gösterilir, hemen saklayın. /ConnectEx ve POST /v1/seats de bağladıkları hesap için yeni bir anahtar döndürür. Settings (Ayarlar) sekmesinde yönetim anahtarınız bulunur; bu anahtar işlem çağrıları için değil, tahsis (koltuk oluşturma ve kaldırma) içindir.
Önerilen yöntem: bir ortam değişkeninde saklayın (örneğin MTAPI_KEY) ve çalışma zamanında enjekte edin.
Hesapları iki şekilde bağlayabilirsiniz:
app.metatraderapi.net adresinde oturum açın, Accounts (Hesaplar) bölümüne gidin ve MT4/MT5 bilgilerinizi ekleyin (giriş numarası, şifre, aracı kurumun sunucu adı). Bağlandıktan sonra o hesap için benzersiz bir UUID alırsınız.
Bir backend’den, JSON gövdesi ve yönetim anahtarınızla POST /v1/seats kullanın. Alternatif olarak /ConnectEx?user=&password=&server=&platform=MT5&wait=60 çağrısını bir yönetim anahtarıyla veya salt okunur ya da tek hesapla sınırlı olmayan bir API anahtarıyla yapın. İkisi de hesabın id değerini ve onun için yeni bir apiKey döndürür. Tam parametreler ve yanıt biçimi API dokümantasyonunda yer alır.
BrokerName-Live veya BrokerName-Demo biçimindedir./CheckConnect?id= kullanın. Yanıt true veya false olur: hesap şu anda aracı kurumuna bağlı mı. Kopan bağlantıları hizmet otomatik olarak yeniden kurar. /ConnectState?id= durumu ve statusReason değerini gösterir, /Reconnect?id= ise yeniden bağlanmayı zorlar.
İstek biçimi ve yanıt değerlerine ilişkin ayrıntılar için dokümantasyona bakın.
Bağlı bir işlem hesabının bağlantısını kesip silmek için /Disconnect?id= (veya yönetim anahtarıyla DELETE /v1/seats/{id}) kullanın. Şu anda bağlı tüm hesapları id olmadan /ConnectState ile (veya GET /v1/seats ile) listeleyebilirsiniz.
Bağlantıyı kesmek hesabın koltuğunu boşaltır. Koltuk faturalama ayının sonuna kadar ödenmiş kalır ve bağladığınız bir sonraki hesap onu ek ücret olmadan kullanır.
İstek parametreleri için API dokümantasyonuna bakın.
Koltuk sayınız kadar. Faturalama koltuk başınadır: bir koltuk = aynı anda bağlı bir hesap. İhtiyaç duyduğunuzda koltuk ekleyin (1–4. koltuklar için koltuk başına aylık 14 $, 5–19. koltuklar için 13 $ ve 20. koltuktan itibaren 12 $, peşin tahsil edilir).
Her müşteri en fazla 50 koltuk kullanabilir; daha fazlası talep üzerine — desteğe yazın.
API, işlem döngüsünün tamamını kapsar:
/OrderClose) ya da karşıt bir pozisyonla (/OrderCloseBy)Uç noktalar, parametreler ve yanıt biçimlerinin tamamı API dokümantasyonunda yer alır.
/OrderSend uç noktasını kullanın. Tüm klasik uç noktalar gibi bu da sorgu parametreli bir GET isteğidir: sembol, işlem (Buy, Sell, BuyLimit, ...), lot cinsinden hacim ve isteğe bağlı olarak stop loss, take profit, yorum ve bir 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"Parametreler MT4 ve MT5'te aynıdır. Stop-limit emirleri (stopLimitPrice) yalnızca MT5'te vardır. Bekleyen emirler isteğe bağlı bir expiration alır; expirationType MT5'te yok sayılır.
/OrderHistory veya /OrderHistoryPagination uç noktalarını kullanın. İkisi de yalnızca tarih aralığına göre filtreler (from ve to, ISO-8601 veya Unix saniyesi); /OrderHistoryPagination sonucu sayfalara böler (ordersPerPage, pageNumber). Tikete göre filtreleme veya sıralamayı kendi kodunuzda yapın. Daha ayrıntılı sorgular için MT4 ve MT5 ayrıca /PendingOrderHistory ve /HistoryDealsByPositionId sunar.
Tam parametre referansı dokümantasyondadır.
Evet. API, gerçek zamanlı akış için bir WebSocket (olay) bağlantısı sunar. Böylece REST uç noktalarını sürekli sorgulamak yerine güncellemeleri doğrudan alırsınız.
WebSocket akışı (wss://api.metatraderapi.net/v1/stream?id=, x-api-key başlığıyla kimlik doğrulamalı) üzerinden abone olduğunuz sembollerin canlı fiyatlarını ve mumlarını, canlı kârıyla açık pozisyonlarınızı, bekleyen emirleri ve gerçekleşen her işlemi, ayrıca 10 saniyede bir heartbeat alırsınız. Hesap başına en fazla 25 akış açık olabilir.
Canlı alış/satış fiyatları için /GetQuote REST uç noktasını (birden fazla sembol için /GetQuoteMany) kullanabilir ya da sürekli gerçek zamanlı güncellemeler için WebSocket akışından kotasyonlara abone olabilirsiniz.
/GetQuote hesap id değerini ve bir symbol alır. Yanıtlar hesap ve sembol başına 250 ms önbelleğe alınır; önbelleği atlamak için cached=0 ekleyin.
Geçmiş OHLC mumları için MT4 ve MT5'te /PriceHistory kullanın (/QuoteHistory bunun bir takma adıdır) — zaman dilimi seçenekleri ve parametreler için dokümantasyona bakın.
Tek bir plan vardır: koltuk başına ödeme yaparsınız ve her koltuk API'nin tamamını içerir — REST, WebSocket akışı ve hem MT4 hem MT5 desteği. Fiyatlar KDV hariçtir:
Her koltuk aynı anda bağlı bir MT4 veya MT5 hesabı barındırır ve tam bir faturalama ayı için peşin tahsil edilir. Örnek: 10 koltuk ayda 4 × 14 $ + 6 × 13 $ = 134 $ tutar. Tüm fiyatlar fiyatlar sayfasında doğrulanır.
Hayır. Şu anda ücretsiz deneme sunmuyoruz. API'yi değerlendirmeyle ilgili sorularınız varsa Telegram üzerinden veya support@metatraderapi.net adresinden bize ulaşın.
14 $ karşılığında tek bir koltukla başlayabilir, entegrasyonunuz çalıştığında daha fazlasını ekleyebilirsiniz.
Evet. Koltuk başı plan koltuk başına faturalandırılır ve her koltuk aynı anda bir bağlı hesap tutar. Tüm koltuklarınız doluysa yeni bir hesap bağlamak aylık 14 $ karşılığında bir koltuk ekler (5–19. koltuklar 13 $, 20. koltuktan itibaren 12 $); ücret eklendiği anda peşin alınır. Bir hesabın bağlantısını kestiğinizde o hesabın koltuğu bir sonraki hesap için ücretsiz olarak boşalır; kullanılmayan koltukları kontrol panelinizden bırakabilirsiniz. Her müşteri en fazla 50 koltuk kullanabilir; daha fazlası talep üzerine — desteğe yazın.
Ödeme, Stripe üzerinden kredi veya banka kartıyla, aylık faturalandırılan bir abonelik olarak yapılır. Kripto para ve banka havalesi kabul etmiyoruz.
Sipariş vererek Stripe Hizmet Sözleşmesi'ni de kabul etmiş olursunuz.
Evet, dilediğiniz zaman iptal edebilirsiniz. İptal, içinde bulunduğunuz faturalama ayının sonunda geçerli olur — kullanılmayan günler için kısmi geri ödeme yapılmaz.
Hizmet, Amerika Birleşik Devletleri'nde kayıtlı bir limited şirket (LLC) olan Apex Vanguard Dynamics LLC tarafından işletilmektedir; kayıtlı adresi 30 N Gould St Ste R, Sheridan, WY 82801, ABD'dir.
İletişim: support@metatraderapi.net · Telefon: +1 (929) 333-6422
Tam yasal bilgiler için künyeye bakın.
Şartlar ve Koşullar, ABD'nin Wyoming eyaleti hukukuna tabidir. Uyuşmazlıklar Wyoming mahkemelerinin münhasır yargı yetkisindedir ve taraflar öncelikle iyi niyetli müzakereyle çözüm aramayı kabul eder.
Tam Şartlar ve Koşullar'ı web sitesinde okuyabilirsiniz.
Hayır. Hizmet Şartları, giriş bilgilerinizi ve API anahtarlarınızı gizli tutmanızı ve MetaTrader API'nin önceden yazılı onayı olmadan üçüncü taraflarla paylaşmamanızı açıkça gerektirir.
API üzerine bir ürün veya hizmet inşa ediyorsanız (örneğin kendi müşterileriniz için), kendi kimlik doğrulama katmanınızı kurmalı ve MetaTrader API anahtarını yalnızca sunucu tarafında tutmalısınız — son kullanıcılara asla açmayın.
Hayır. Hizmet Şartları, MetaTrader API'nin açık yazılı izni olmadan hizmet verilerinin kazınmasını (scraping) veya yeniden satılmasını yasaklar. Abonelikler de devredilemez.
Belirli bir iş senaryonuz varsa support@metatraderapi.net adresine yazın.
Evet. NDA'lar talep üzerine sunulur ve her iki tarafça yazılı olarak kabul edilmesi gerekir. Aksi kararlaştırılmadıkça standart NDA koşulları geçerlidir.
Talep için support@metatraderapi.net adresine yazın.
MetaTrader API, bağlı hesapları şu önlemlerle korur:
Güvenlik önlemleri, alt işleyenler ve ölçülen çalışma süresi Güven Merkezi sayfasında belgelenmiştir; veri işleme ise Gizlilik Politikası'nda açıklanır.
MetaTrader API bir ABD şirketi tarafından işletilmektedir (bkz. MetaTrader API'yi kim işletiyor?) ve geçerli veri koruma mevzuatına, AB/AEA kullanıcıları için uygulandığı ölçüde GDPR dahil olmak üzere, uyumlu olduğunu belirtir.
Toplanan kişisel veriler: hesap bilgileri (ad, e-posta adresi, faturalama bilgileri), kullanım verileri (API günlükleri, IP adresi, tarayıcı ve işletim sistemi) ve Stripe üzerinden işlenen ödeme bilgileri.
Kişisel verileri satmayız. Veriler yalnızca bizim adımıza işleyen hizmet sağlayıcılarla (barındırma, ödeme ve e-posta gönderimi gibi) paylaşılır ve müşteriler için bir veri işleme sözleşmesi (DPA) mevcuttur. Tüm ayrıntılar Gizlilik Politikası'nda ve Güven Merkezi sayfasındadır.
Gizlilik Politikası'na göre aşağıdaki veriler toplanabilir:
Bağlı işlem hesapları için aracı kurum giriş bilgileri de saklanır (depolanırken AES-256-GCM ile şifreli) ve API'nin aldığı işlem verileri sizin adınıza işlenir. Müşteri verileri ve API sunucuları AB'de bulunur (Finlandiya ve Almanya). Özel barındırmalı koltuklar seçtiğiniz bölgede çalışır.
Tüm bilgiler için Gizlilik Politikası'nın tamamını okuyun.
Bağlantının başarısız olmasının en yaygın nedenleri:
ICMarkets-Live02). MetaTrader'da Dosya → Hesap aç altında bulabilirsiniz.Mevcut bağlantı durumunu /CheckConnect ile doğrulayın. Sorun sürerse support@metatraderapi.net adresine yazın.
Kimlik doğrulama hataları genellikle API anahtarının eksik, hatalı veya yanlış biçimde gönderildiğini gösterir. Şunları kontrol edin:
x-api-key başlığını kullandığınızdan emin olun — Authorization: Bearer değil.Doğru biçim kimlik doğrulama dokümantasyonunda yer alır.
MetaTrader API, ölçülen çalışma süresini herkese açık bir durum sayfasında yayınlar: REST API, WebSocket akışı ve panel için canlı durum ve çalışma süresi geçmişi. SLA veya çalışma süresi taahhüdü yoktur; hizmetin nasıl işletildiği Güven Merkezi sayfasında açıklanır.
Hizmet Şartları'na göre hizmetin “olduğu gibi” ve “mevcut olduğu şekilde” sunulduğunu unutmayın — kesintisiz veya hatasız çalışma sözleşmeyle garanti edilmez. Üretim sistemleri için kendi tarafınızda daima yeniden deneme mantığı ve hata yönetimi uygulayın.
Emir reddi MetaTrader API'den değil, aracı kurumun işlem sunucusundan gelir. Yaygın nedenler:
EURUSD veya EURUSDm).Aracı kurumun reddi bir HTTP hatası değildir: API HTTP 200 ve emir nesnesiyle yanıt verir; nesnenin state alanı aracı kurumun sonuç kodunu içerir. 10009 gerçekleşti demektir; diğer her değer red nedenidir (örneğin 10016 geçersiz stoplar, 10018 piyasa kapalı, 10019 yetersiz bakiye; MT4'te MT4 hata numarası).