XBTFX MetaTrader 5® hesaplarıyla çalışır

XBTFX Trading API

Desteklenen XBTFX MetaTrader 5® hesaplarında REST ve WebSocket üzerinden programatik olarak işlem yapın, pozisyonları yönetin, hesap durumunu izleyin ve piyasa verilerini gerçek zamanlı akışla alın. Stratejileri otomatikleştirin, AI ajanlarını bağlayın veya hesabınızı kendi iş akışlarınıza entegre edin. Dokümantasyon, çalışan örnekler, AI yetenekleri veya XBTFX MCP Sunucusu ile başlayın. Geliştiricilere ve programlama veya AI kodlama asistanı deneyimi olan kullanıcılara yöneliktir.

  • Pro hesapları
  • Tam programatik erişim
  • Hedging & netting modları
  • AI ajan hazır (MCP)
terminal
# Send a trade to your XBTFX account
curl -X POST https://interface.xbtfx.com/v1/trade \
  -H "Authorization: Bearer xbtfx_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "EURUSD",
    "side":   "buy",
    "volume": 0.10,
    "sl":     1.08200,
    "tp":     1.09000
  }'

# Response
{
  "status":  "filled",
  "retcode": 10009,
  "deal":    184729,
  "price":   1.08650,
  "volume":  0.10
}
Protokol
REST
Akış
WebSocket
Ağırlık / Dakika
600
Yanıt formatı
JSON

XBTFX API ile Trading'inizi Otomatikleştirin

XBTFX Trading API, desteklenen XBTFX MetaTrader 5® hesaplarınıza emir göndermenize, pozisyon açmanıza, stopları ayarlamanıza, bakiyeleri izlemenize ve standart REST ile WebSocket çağrıları üzerinden gerçek zamanlı fiyatları akışla almanıza olanak tanır.

Otomatik Stratejiler

Hesabınıza otomatik olarak emir gönderen trading botları ve algoritmik stratejiler oluşturun. Sinyallere, portföy dengelemeye veya size özel risk kurallarına göre işlem yapın.

AI Ajanlarını Bağlayın

AI asistanlarını XBTFX Skills Hub veya MCP Sunucusu üzerinden hesabınıza bağlayın. Claude Code, Cursor, Windsurf veya diğer uyumlu istemciler aracılığıyla doğal dil komutları üzerinden işlem yapın.

Özel Entegrasyonlar

Özel panolar geliştirin, harici veri kaynaklarına bağlanın, başka platformlardan gelen sinyalleri yönlendirin veya hesap verilerini kendi raporlama ve analitik sistemlerinize entegre edin.

İşlem, Hesap ve Piyasa Verisi için API Uç Noktaları

Pozisyon açın ve kapatın, stop loss ile take profit ayarlayın, hesap bakiyelerini kontrol edin, işlem geçmişini sorgulayın, forex ve kripto fiyatlarını WebSocket üzerinden gerçek zamanlı akışla alın.

API Dokümanları

POSTEmir Yerleştirme

Hesabınıza stop loss ve take profit ile birlikte piyasa emirleri gönderin. Hem hedging hem de netting marjin modlarını destekler.

/v1/trade

POSTKapatma ve Değiştirme

Pozisyonları tamamen veya kısmen kapatın, açık pozisyonlarda SL/TP güncelleyin. Tümünü kapatın, sembol bazında kapatın veya karşı pozisyonları netleştirin.

/v1/close · /v1/modify · /v1/close-all

GETPozisyonlar ve Emirler

Tüm açık pozisyonları ve bekleyen emirleri gerçek zamanlı sorgulayın. Sembollere göre filtreleyin. Yanıtlar canlı push güncellemeleri ile birlikte cache'lenir.

/v1/positions · /v1/orders

GETHesap ve Bakiyeler

Bakiye, equity, marjin, serbest marjin, kayan P&L ve kaldıracın gerçek zamanlı görünümü. Tek bir çağrı tam tabloyu sunar.

/v1/account

GETSemboller ve Spesifikasyonlar

Bid/ask, spread, kontrat boyutu, min/maks/adım hacmi, ondalık basamak ve marjin gereksinimleriyle birlikte tam sembol listesi.

/v1/symbols · /v1/symbols/:symbol

WSWebSocket Akışı

5 seviyeye kadar piyasa derinliğiyle gerçek zamanlı fiyat akışı. Hesabınızda mevcut olan herhangi bir sembole abone olun.

wss://ws.xbtfx.com/v1/ws

Dakikalar İçinde İlk API Çağrınızı Yapın

Tercih ettiğiniz dilde birkaç satır. Standart HTTP — POST yapabilen herhangi bir dil işe yarar.

# Send a buy order to your XBTFX account
curl -X POST https://interface.xbtfx.com/v1/trade \
  -H "Authorization: Bearer $XBTFX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"EURUSD","side":"buy","volume":0.10,"sl":1.082,"tp":1.09}'

# Retrieve open positions
curl https://interface.xbtfx.com/v1/positions \
  -H "Authorization: Bearer $XBTFX_API_KEY"

interface.xbtfx.comShell

AI-Hazır

Doğal Dilde Emir Verme

XBTFX Trading API, AI ajanları ve büyük dil modelleri tarafından kullanılmak üzere tasarlandı — temiz JSON, okunabilir hata mesajları, öngörülebilir uç noktalar. XBTFX Skills Hub veya MCP Sunucusu üzerinden bağlanın; AI istemciniz konuşma komutlarıyla emir gönderebilir.

  • Konuşmaya dayalı komutlar — bağlamdan al, sat, kapat veya koşullu emirler
  • Araç bazlı çıkarım — her eylem yapılandırılmış sonuçlar döner
  • Herhangi bir istemci ile çalışır — Claude, Cursor, Windsurf, Codex

Daha az teknik bir versiyon mu istiyorsunuz? AI Ajan Trading sayfasına bakın

Örnek Konuşma

XBTFX Trading Agentonline · executing trades

Today · 13:25 GMT

If today's NFP prints above 200k, close all my open EURUSD and GBPUSD trades.

13:25 ✓✓

Got it. Watching the BLS release at 13:30 GMT. I'll close 4 positions if NFP > 200k.

13:25

tool · xbtfx_get_positions4 open · EURUSD ×2, GBPUSD ×2 · floating +$184.20

13:26

13:30 · NFP released: 247k (forecast 195k)

tool · xbtfx_close_all (filter: EURUSD, GBPUSD)Closed 4 positions in 38 ms · realized +$212.80

13:30

Yalnızca örnek amaçlı; koşullu akışlar yapılandırılmış ajana ve piyasa veri kaynaklarına bağlıdır.

Kullanım Senaryoları

AI ajanlar API ile ne yapıyor

XBTFX hesaplarındaki otomatik ve AI tabanlı iş akışlarında sıkça gördüğümüz dört kalıp.

Olay Bazlı Trading

AI haberleri ve ekonomik verileri gerçek zamanlı izler ve piyasayı etkileyen olaylar gerçekleştiğinde hesabınıza emirler gönderir.

Akıllı Risk Yönetimi

AI marjini, kayan P&L'yi ve maruziyeti izler. Sermayeyi korumak için stopları ayarlar, küçültür veya pozisyonları kapatır.

Portföy Dengeleme

Hedef ağırlıklar tanımlayın ve AI'nın bunu sürdürmesine izin verin: sapmalar eşiği aştığında dengeleyici emirler gönderilir.

Otomatik Analiz

AI'dan işlem geçmişinizi analiz etmesini, sembol bazında kazanma oranlarını hesaplamasını ve en iyi performans gösteren kurulumları tespit etmesini isteyin.

Mevcut XBTFX Hesabınız İçin Tasarlandı

Mevcut MetaTrader 5 Pro hesabınızı, mevcut baz para biriminizi ve mevcut marjin modunuzu kullanın. API zaten işlem yaptığınız hesaba bağlanır.

Teknik Özellikler

Üretim Sınıfı Uç Noktalar

Hedging ve Netting Modları
Her iki MT5 marjin modunda da çalışır. Mod, API anahtarınıza bağlıdır.
Idempotency Anahtarları
120 saniye içinde aynı anahtarı yeniden gönderin; cache'lenmiş yanıtı geri alırsınız. Yinelenen emir olmadan güvenli yeniden denemeler.
Ağırlığa Dayalı Hız Sınırı
Anahtar başına dakikada 600 ağırlık. Okuma ve işlem 1 ağırlık, toplu işlemler 10. Her yanıt kalan bütçenizi başlıkta gösterir.
Akış Limitleri
WebSocket bağlantısı başına en fazla 1.000 sembol aboneliği ve API anahtarı başına en fazla 10 bağlantı. Fiyatlar değiştikçe kotasyonlar akar.

Hesap Uyumluluğu

Pro Hesabınızla Çalışır

Pro Hesapları
Ham spread artı komisyon. API tüm Pro hesaplarına aynı şekilde davranır: aynı uç noktalar, aynı JSON, aynı kimlik doğrulama akışı.
PAMM, MAM ve Copy Master Hesapları
Yönetici hesapları, dağıtım, dengeleme ve emir yönlendirme için API üzerinden programatik olarak yönetilebilir. Kimlik bilgileri için hesap açma ekibimizle iletişime geçin.
Çoklu Para Birimiyle Mutabakat
Pro hesapları için XBTFX MT5'in desteklediği tüm baz para birimleri: USD, EUR, USDT, BTC, ETH, XRP, SOL, LTC, ZEC, XAU. Bakiyeler, equity, marjin ve PnL hesabın kendi para biriminde döner; sizin tarafınızda dönüştürme mantığına gerek yoktur.
Hedging ya da Netting
API, MT5 hesabınızda yapılandırdığınız marjin modunu doğrudan kullanır. İki kez yapılandırma yok.

Geliştirici Kaynakları

Kod örnekleri, AI yetenek dosyaları ve eksiksiz API dokümantasyonu — başlamak için ihtiyacınız olan her şey.

API Dokümantasyonu

İstek/yanıt örnekleri, kimlik doğrulama kılavuzları ve WebSocket entegrasyonu ile birlikte tam uç nokta referansı.

API Örnekleri

Python, JavaScript, curl ve daha fazlasında çalışan kod örnekleri. Kopyalayın ve çalıştırın.

AI Skills Hub

Desteklenen ajan çerçeveleri için trading, hesap, piyasa verisi ve WebSocket iş akışları için yetenek dosyaları.

MCP Sunucusu

Claude Code, Claude Desktop, OpenAI Codex, Cursor, Windsurf ve diğer MCP uyumlu istemciler için.

Üç Adımda Başlayın

Aynı yapı, iki başlangıç noktası — hesap durumunuza uyanı seçin.

  1. API Anahtarı Oluşturun

    XBTFX bilgilerinizle portal.xbtfx.com adresine giriş yapın, işlem hesabınızı seçin ve anahtarı üretin.

    Konsolu Aç
  2. Yetenek Yükleyin veya MCP Bağlayın

    Skills Hub'dan bir yetenek yükleyin veya MCP Sunucusunu Claude Code, Cursor, Windsurf ya da diğer uyumlu istemcilere bağlayın. Anahtarınız yerel kalır.

    MCP Dokümanları
  3. İşlem Yapın

    GET /v1/auth/status ile doğrulama yapın, ardından doğal dil komutları gönderin veya doğrudan REST/WebSocket uç noktalarını çağırın.

    Dokümanları Oku

Sıkça sorulan sorular

XBTFX Trading API nedir?
XBTFX Trading API, desteklenen XBTFX MetaTrader 5® hesaplarınızda programatik trading, hesap izleme, piyasa verisi alma ve veri akışı için REST ve WebSocket erişimi sağlar. XBTFX tarafından geliştirildi — emir göndermek ve hesap verisi sorgulamak için temiz HTTP uç noktaları ve JSON yanıtlarıyla etkileşime geçersiniz.
API'yi Standard hesapla kullanabilir miyim?
Hayır. XBTFX Trading API yalnızca MetaTrader 5'teki Pro hesaplarla çalışır. Standard hesap için Mega1'in açık API'sini kullanın: Mega1'deki Standard hesaplarla çalışır ve anahtarlar Mega1 terminalinde oluşturulur.
Hangi programlama dilleri desteklenir?
HTTP istekleri yapabilen herhangi bir dil. Python, JavaScript, Go, Rust, C#, Java, Ruby, PHP — JSON gövdesiyle POST yapabilen her şey API üzerinden XBTFX hesabınıza emir gönderebilir.
Otomatik trading stratejileri geliştirebilir miyim?
Evet. XBTFX Trading API algoritmik trading ve otomasyon için tasarlandı. Sinyal tabanlı botlar, portföy dengeleyiciler, risk yönetim sistemleri veya hesabınıza emir gönderen başka herhangi bir mantık geliştirebilirsiniz.
Gerçek zamanlı fiyatlar için WebSocket akışı var mı?
Evet. XBTFX Trading API, hesabınızda mevcut olan semboller için gerçek zamanlı fiyat akışları sağlayan WebSocket uç noktaları sunar. Mevcut olduğunda fiyatlar 5 seviye piyasa derinliği içerir. Bağlantı başına en fazla 1.000 sembole abone olabilir ve 10 eşzamanlı bağlantı kurabilirsiniz.
Hedging ve netting modları arasındaki fark nedir?
Bunlar pozisyon davranışını yöneten marjin modlarıdır. Hedging, sembol başına birden fazla bağımsız pozisyona izin verir; bunlara karşı yönlü alış ve satışlar dahildir. Netting her şeyi sembol başına tek bir pozisyonda toplar. API anahtarları modunu hesabınızdan miras alır.
Hız sınırları nelerdir?
API anahtarı başına dakikada 600 ağırlık. Çoğu istek 1 ağırlık kullanır — dakikada 600 isteğe kadar. Toplu işlemler (örn. close-all gibi) 10 ağırlık kullanır. Her yanıt kalan bütçenizi gösteren başlıklar içerir.
API'yi kripto CFD ticareti için kullanabilir miyim?
Evet. XBTFX hesabınızda mevcut olan tüm semboller API üzerinden erişilebilirdir — kripto CFD'leri dahil. API'yi BTC, ETH, USDT veya XRP cinsinden tutulan hesaplarla da kullanabilirsiniz.
API kullanmak ücretsiz mi?
Evet. XBTFX Trading API, ek ücret olmadan tüm Pro hesaplarına dahildir. Normal işlem komisyonları ve spreadler dışında API ücreti, abonelik ücreti veya çağrı bazlı ücret yoktur.
API anahtarımı nasıl alabilirim?
Önce, henüz yoksa portal.xbtfx.com'da bir XBTFX Pro hesabı açın. Ardından XBTFX bilgilerinizle portal.xbtfx.com'daki API Konsoluna giriş yapın, Pro hesabınızı seçin ve anahtarınızı üretin. Emir vermeden önce GET /v1/auth/status ile çalıştığını doğrulayın.
Emir vermeden önce ne yapmalıyım?
Önce GET /v1/auth/status ile API anahtarınızı ve hesap durumunuzu doğrulayın. Anahtarınızın aktif olduğunu onaylar, izinleri ve marjin modunu gösterir ve emir göndermeden önce hesabınızın hazır olduğunu teyit eder.
Programlama deneyimi gerekli mi?
Doğrudan REST API kullanımı temel programlama bilgisi gerektirir, ancak AI yolları ile kod yazmanız gerekmez — XBTFX MCP Sunucusunu Claude Code veya Cursor'a bağlayın ya da Skills Hub'dan bir yetenek yükleyin ve doğal dil komutları kullanın. AI kodlama asistanlarına aşinalık yardımcı olur.
Hesabımda işlem yapmak için AI kullanabilir miyim?
Evet. Yetenek dosyalarını destekleyen ajan çerçeveleri için XBTFX Skills Hub'ı kullanın veya XBTFX MCP Sunucusunu Claude Code, Claude Desktop, OpenAI Codex, Cursor ya da Windsurf gibi MCP uyumlu istemcilere bağlayın. Her iki yol da XBTFX Trading API üzerinden doğal dil komutlarıyla emir göndermeyi mümkün kılar.
AI ajanlara hesap erişimi vermek güvenli mi?
API anahtarları genellikle ajanınızla aynı yerde yerel olarak tutulur ve üçüncü taraf sunuculara yüklenmez. Ajan API çağrılarını anahtarınızı kullanarak doğrudan XBTFX sunucularına gönderir. Anahtarları konsoldan istediğiniz an iptal edebilirsiniz.

Bugün geliştirmeye başlayın.
API kullanımı ücretsizdir.

XBTFX hesabınızı açın, portalda bir API anahtarı oluşturun ve ilk işleminizi gönderin.

Canlı Destek

Hafta sonları dahil destek ekibimizle sohbet edin.

Destek Merkezi

Hesabınız, fonlama ve platformlar hakkında kılavuzlar ve yanıtlar.

Destek Merkezine Git

Blog

Şirket haberleri, piyasa güncellemeleri ve işlem içgörüleri.

Blogu Oku

Risk Uyarısı: CFD ürünlerinin alım satımı yüksek düzeyde risk taşır ve tüm yatırımcılar için uygun olmayabilir.