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.

XBTFX Trading API

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

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.

Edge & ECN 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 { "ticket": 184729, "status": "filled", "price": 1.08650, "retcode": 10009 }
Protokol icon
REST
Protokol
Akış icon
WebSocket
Akış
Ağırlık / Dakika icon
600
Ağırlık / Dakika
Yanıt formatı icon
JSON
Yanıt formatı

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.

POST Emir 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
POST Kapatma 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
GET Pozisyonlar 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
GET Hesap 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
GET Semboller 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
WS WebSocket 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.

XBTFX Trading API · examples
# 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"
import requests API_KEY = "xbtfx_live_your_key_here" BASE = "https://interface.xbtfx.com" HEADERS = {"Authorization": f"Bearer {API_KEY}"} # Send a trade to your account r = requests.post(f"{BASE}/v1/trade", json={ "symbol": "EURUSD", "side": "buy", "volume": 0.10 }, headers=HEADERS) print(r.json()) # {"status": "filled", "retcode": 10009}
const ws = new WebSocket("wss://ws.xbtfx.com/v1/ws"); ws.onopen = () => { ws.send(JSON.stringify({ type: "auth", api_key: "xbtfx_live_..." })); ws.send(JSON.stringify({ type: "subscribe", symbols: ["EURUSD", "BTCUSD"] })); }; ws.onmessage = (e) => { const q = JSON.parse(e.data); console.log(q.symbol, q.bid, q.ask); };
main 0 errors Shell UTF-8 LF interface.xbtfx.com
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 Agent
online · 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 Edge veya ECN 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.

Kurumsal Sınıf FIX 4.4

Prime broker, hedge fon ve HFT firmaları için xPro altyapısı üzerinden FIX 4.4 erişimi mevcuttur. Satış ekibimizle iletişime geçin
Hesap Uyumluluğu

Edge ya da ECN — Aynı Hesap

Edge ve ECN Hesapları

Lot başına komisyonla daha dar spreadler. API, Edge / ECN hesaplarına eşit 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

Edge ve ECN 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ızın baz 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 console.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

Frequently
Asked Questions

  • 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.

  • 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 trading 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 my.xbtfx.com'da bir XBTFX işlem hesabı oluşturun. Ardından XBTFX bilgilerinizle console.xbtfx.com'daki API Konsoluna giriş yapın, işlem hesabınızı seçin ve anahtarınızı üretin. Emir vermeden önce GET /v1/auth/status ile çalıştığını doğrulayın.

  • API'yi demo hesabıyla kullanabilir miyim?

    Evet. API anahtarları hem canlı hem demo hesaplarda çalışır, böylece bağlantınızı doğrulayabilir ve canlı sermaye taahhüt etmeden önce kodu inceleyebilirsiniz — aynı API ve aynı uç noktalar üzerinden.

  • 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. Canlı sermaye taahhüt etmeden önce kurulumu test etmek için demo hesabıyla başlamanızı öneririz.