تحذير المخاطر: يحمل تداول منتجات العقود مقابل الفروقات (CFD) مستوى عالياً من المخاطر وقد لا يكون مناسباً لجميع المستثمرين.

XBTFX Trading API

متوافقة مع حسابات XBTFX MetaTrader 5®

تداول برمجيًا، أدر المراكز، راقب حالة الحساب، وادفق بيانات السوق المباشرة على حسابات XBTFX MetaTrader 5® المتوافقة عبر REST وWebSocket. ابنِ استراتيجيات مؤتمتة، اربط وكلاء ذكاء اصطناعي، وادمج حسابك في تدفقات مخصصة. ابدأ بالوثائق أو الأمثلة العملية أو AI skills أو خادم XBTFX MCP. مصممة للمطورين والمستخدمين ذوي الخبرة في البرمجة أو في مساعدي البرمجة بالذكاء الاصطناعي.

حسابات Edge وECN
وصول برمجي كامل
أوضاع Hedging وNetting
جاهزة لوكلاء الذكاء الاصطناعي (MCP)
إنشاء حساب API Console الوثائق
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 }
البروتوكول icon
REST
البروتوكول
تدفق icon
WebSocket
تدفق
Weight / دقيقة icon
600
Weight / دقيقة
صيغة الاستجابة icon
JSON
صيغة الاستجابة

أتمت تداولك مع XBTFX API

تتيح لك XBTFX Trading API إرسال التعليمات إلى حسابك المتوافق XBTFX MetaTrader 5®. افتح المراكز، عدّل أوامر الإيقاف، استعلم عن الأرصدة، وادفق العروض المباشرة عبر استدعاءات REST وWebSocket القياسية.

استراتيجيات مؤتمتة
ابنِ بوتات تداول واستراتيجيات خوارزمية ترسل صفقات تلقائيًا إلى حسابك. شغّل تنفيذًا مدفوعًا بالإشارات أو إعادة موازنة محفظة أو منطق إدارة مخاطر مخصص.
تكامل وكلاء الذكاء الاصطناعي
اربط مساعدي الذكاء الاصطناعي بحسابك عبر XBTFX Skills Hub أو خادم MCP. أعطِ أوامر التداول بلغة طبيعية عبر Claude Code أو Cursor أو Windsurf أو عملاء آخرين متوافقين.
تكاملات مخصصة
ابنِ لوحات تحكم، اتصل بمصادر بيانات خارجية، وجّه إشارات التداول من منصات أخرى، أو ادمج بيانات الحساب في أنظمة التقارير والتحليلات الخاصة بك.

نقاط طرفية للـ API للتداول والمراكز وبيانات السوق

افتح وأغلق المراكز، حدد وقف الخسارة وجني الأرباح، استعلم عن أرصدة الحساب، استرجع تاريخ الصفقات، وادفق عروض الفوركس والعملات المشفرة المباشرة عبر WebSocket.

POST إرسال الصفقات
أرسل أوامر السوق إلى حسابك مع وقف الخسارة وجني الأرباح. يدعم وضعي Hedging وNetting.
/v1/trade
POST الإغلاق والتعديل
أغلق المراكز كليًا أو جزئيًا. حدّث SL/TP على المراكز المفتوحة. أغلق الكل، أو حسب الرمز، أو نتّف المراكز المتعارضة.
/v1/close · /v1/modify · /v1/close-all
GET المراكز والأوامر
استرجع جميع المراكز المفتوحة والأوامر المعلقة في الوقت الفعلي. صفّ حسب الرمز. الردود مخدّمة من ذاكرة مؤقتة مع تحديثات push مباشرة.
/v1/positions · /v1/orders
GET الحساب والرصيد
الرصيد والإيكويتي وهامش الضمان والهامش الحر والربح والخسارة العائمة والرافعة في الوقت الفعلي. استدعاء واحد للحصول على لقطة كاملة.
/v1/account
GET الرموز والمواصفات
قائمة كاملة بالرموز مع bid/ask مباشر والسبريد وحجم العقد والحد الأدنى/الأعلى لخطوة الحجم والأرقام العشرية ومتطلبات الهامش.
/v1/symbols · /v1/symbols/:symbol
WS تدفق WebSocket
عروض دفق في الوقت الفعلي مع عمق سوق من 5 مستويات. اشترك في أي رموز متوفرة على حسابك.
wss://ws.xbtfx.com/v1/ws

أرسل أول صفقة API خلال دقائق

بضعة أسطر برمجية باللغة التي تختارها. HTTP قياسي — تعمل أي لغة قادرة على إرسال طلب POST.

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-Ready

نفّذ الصفقات بلغة طبيعية

صُممت XBTFX Trading API لتُستهلك من قِبَل وكلاء الذكاء الاصطناعي والنماذج اللغوية الكبيرة — JSON نظيف وأخطاء مقروءة ونقاط طرفية متوقعة. اربط عبر XBTFX Skills Hub أو خادم MCP وسيتمكن عميلك الذكي من إرسال الصفقات عبر أوامر حوارية.

  • أوامر حوارية — شراء، بيع، إغلاق، وضع شروط على البيانات.
  • استدلال مرتكز على الأدوات — كل إجراء يعيد استجابة منظمة.
  • قابل للنقل بين العملاء — Claude، Cursor، Windsurf، Codex.
وثائق API MCP Server

أقل تقنية؟ راجع صفحة AI Agent Trading.

مثال محادثة →
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

مثال توضيحي. تعتمد التدفقات الشرطية على الوكيل وتغذيات بيانات السوق المُعدَّة.

حالات الاستخدام

ماذا يفعل وكلاء الذكاء الاصطناعي بالـ API

أربعة أنماط شائعة نراها في التدفقات المؤتمتة والمعتمدة على الذكاء الاصطناعي على حسابات XBTFX.

تداول مدفوع بالأحداث

يراقب الذكاء الاصطناعي الأخبار والبيانات الاقتصادية في الوقت الفعلي ويرسل صفقات إلى حسابك عند رصد أحداث محركة للسوق.

إدارة مخاطر ذكية

يتابع الذكاء الاصطناعي الهامش والربح والخسارة العائمة والتعرض، ويعدّل أوامر الإيقاف ويقلل الأحجام أو يغلق المراكز لحماية رأس المال.

إعادة موازنة المحفظة

حدد تخصيصات مستهدفة ودع الذكاء الاصطناعي يحافظ عليها بإرسال صفقات تعديل عند تجاوز الانحراف لحدودك.

تحليل ذاتي

اطلب من الذكاء الاصطناعي تحليل سجل صفقاتك وحساب نسب الربح بحسب الرمز وتحديد أفضل الإعدادات أداءً.

مبنية لحسابك الحالي على XBTFX

استخدم حسابك الحالي MetaTrader 5 من نوع Edge أو ECN، عملة الأساس الحالية، ووضع الهامش الحالي. تتصل الـ API بنفس الحساب الذي تتداول عليه فعلًا.

المواصفات التقنية

نقاط طرفية جاهزة للإنتاج

أوضاع Hedging وNetting

كلا وضعَي الهامش في MT5 مدعومان. يرتبط الوضع بمفتاح الـ API الخاص بك.

مفاتيح Idempotency

أرسل المفتاح نفسه خلال 120 ثانية ونعيد الاستجابة المخزّنة في الكاش. إعادة محاولة آمنة دون صفقات مكررة.

حدود وزن الطلبات

600 weight لكل دقيقة لكل مفتاح. تكلفة القراءات والصفقات 1، والعمليات الجماعية 10. تكشف الترويسات ميزانيتك المتبقية في كل استجابة.

FIX 4.4 المؤسسي

الوصول إلى FIX 4.4 عبر بنية xPro للوسطاء الأساسيين وصناديق التحوط وشركات التداول عالي التردد. تواصل مع المبيعات.
توافق الحساب

Edge أو ECN — نفس الحساب

حسابات Edge وECN

سبريدات أضيق مع عمولة لكل لوت. تتعامل الـ API مع كل حساب Edge / ECN بنفس الطريقة — نفس النقاط الطرفية، نفس JSON، نفس مسار المصادقة.

حسابات PAMM وMAM وCopy Master

يمكن قيادة حسابات المدير برمجيًا عبر الـ API للتخصيصات وإعادة الموازنة والتنفيذ. تواصل مع فريق الإعداد للحصول على بيانات الاعتماد.

تسوية متعددة العملات

كل عملة أساس تدعمها XBTFX MT5 لحسابات Edge وECN: USD، EUR، USDT، BTC، ETH، XRP، SOL، LTC، ZEC، XAU. تعود الأرصدة والإيكويتي والهامش والربح والخسارة بعملة الحساب الأصلية — دون منطق تحويل من جانبك.

Hedging أو Netting

أيًا كان وضع الهامش الذي تختاره على حساب MT5 هو ما تستخدمه الـ API. لا حاجة لإعادة تكوين.

موارد المطورين

أمثلة برمجية، ملفات AI skill، ووثائق API كاملة — كل ما تحتاجه للبدء.

وثائق API

مرجع كامل للنقاط الطرفية مع أمثلة طلب/استجابة، ودليل المصادقة، وتكامل WebSocket.
docs.xbtfx.com

أمثلة API

كود نموذجي بـ Python وJavaScript وcurl وغيرها. انسخ وشغّل.
GitHub

AI Skills Hub

ملفات skills لتدفقات التداول والحساب وبيانات السوق وWebSocket في أطر الوكلاء المتوافقة.
الوثائق GitHub

MCP Server

لـ Claude Code وClaude Desktop وOpenAI Codex وCursor وWindsurf وغيرها من العملاء المتوافقين مع MCP.
الوثائق GitHub

ابدأ في ثلاث خطوات

نفس الهيكل، نقطتا انطلاق — اختر التي تطابق حالة حسابك.

1
أنشئ مفتاح API
سجّل الدخول إلى console.xbtfx.com بمعلومات اعتماد XBTFX، اختر حساب التداول، وأنشئ مفتاحًا.
فتح Console
2
ثبّت Skill أو MCP
ثبّت skill من Skills Hub، أو اربط خادم MCP بـ Claude Code أو Cursor أو Windsurf أو عملاء آخرين متوافقين. تبقى المفاتيح محلية.
وثائق MCP
3
ابدأ التداول
تحقق عبر GET /v1/auth/status، ثم أصدر أوامر بلغة طبيعية أو استدعِ نقاط REST/WebSocket مباشرة.
قراءة الوثائق

Frequently
Asked Questions

  • ما هي XBTFX Trading API؟

    توفر XBTFX Trading API وصولًا عبر REST وWebSocket للتداول البرمجي ومراقبة الحسابات واسترجاع بيانات السوق وتدفقها على حسابات XBTFX MetaTrader 5® المتوافقة. مبنية بواسطة XBTFX — تتفاعل مع نقاط HTTP نظيفة واستجابات JSON لإرسال الصفقات واسترجاع بيانات الحساب.

  • ما لغات البرمجة التي يمكنني استخدامها؟

    أي لغة تستطيع إرسال طلبات HTTP. Python وJavaScript وGo وRust وC# وJava وRuby وPHP — إن كانت تستطيع إرسال POST بجسم JSON، فبإمكانها إرسال صفقات إلى حسابك على XBTFX عبر الـ API.

  • هل يمكنني بناء استراتيجيات تداول مؤتمتة؟

    نعم. صُممت XBTFX Trading API للتداول الخوارزمي والمؤتمت. يمكنك بناء بوتات مدفوعة بالإشارات أو معيدات توازن للمحفظة أو أنظمة لإدارة المخاطر أو أي منطق مخصص يرسل صفقات إلى حسابك.

  • هل هناك تغذية WebSocket لأسعار اللحظة؟

    نعم. توفر XBTFX Trading API نقطة WebSocket لتدفق العروض في الوقت الفعلي للرموز المتاحة على حسابك. تتضمن العروض عمق سوق من 5 مستويات عند توافره. حتى 1000 اشتراك رمزي لكل اتصال وحتى 10 اتصالات متزامنة.

  • ما الفرق بين وضعَي Hedging وNetting؟

    هما وضعا الهامش اللذان يحددان كيفية تصرف المراكز. يسمح Hedging بمراكز مستقلة متعددة لكل رمز بما فيها الشراء والبيع المتعارضة. أما Netting فيجمع كل شيء في مركز واحد لكل رمز. يرث مفتاح الـ API الوضع من حسابك.

  • ما هي حدود معدل الطلبات؟

    600 weight في الدقيقة لكل مفتاح API. تكلفة معظم الطلبات 1 weight — حتى 600 استدعاء في الدقيقة. تكلفة العمليات الجماعية مثل close-all هي 10 weight. تتضمن كل استجابة ترويسات تظهر ميزانيتك المتبقية.

  • هل يمكنني تداول CFDs العملات المشفرة عبر الـ API؟

    نعم. كل رمز متوفر على حسابك في XBTFX يمكن الوصول إليه عبر الـ API — بما في ذلك CFDs العملات المشفرة. يمكنك أيضًا استخدام الـ API مع حسابات مقومة بـ BTC أو ETH أو USDT أو XRP.

  • هل الـ API مجانية الاستخدام؟

    نعم. تأتي XBTFX Trading API مع كل حساب تداول دون أي تكلفة إضافية. لا رسوم API أو اشتراكات أو تكاليف لكل استدعاء أعلى من عمولاتك وسبريداتك المعتادة.

  • كيف أحصل على مفتاح API؟

    أنشئ أولًا حساب تداول XBTFX على my.xbtfx.com إن لم يكن لديك. ثم سجّل الدخول إلى API Console على console.xbtfx.com بمعلومات اعتماد XBTFX، اختر حساب التداول، وأنشئ مفتاحًا. تحقق من عمله بإرسال GET /v1/auth/status قبل وضع الصفقات.

  • هل يمكنني استخدام الـ API مع حساب تجريبي؟

    نعم. تعمل مفاتيح API مع الحسابات الحقيقية والتجريبية. هذا يتيح لك اختبار التكامل والتحقق من الكود قبل الانتقال للحسابات الحقيقية — على نفس الـ API ونفس النقاط الطرفية.

  • ما الذي عليّ فعله قبل وضع الصفقات؟

    تحقق أولًا من حالة مفتاح الـ API والحساب بإرسال GET /v1/auth/status. يؤكد ذلك صلاحية المفتاح، ويعرض صلاحياتك ووضع الهامش، ويضمن أن حسابك جاهز قبل إرسال أي طلبات تداول.

  • هل أحتاج خبرة برمجية؟

    استخدام REST API مباشرة يتطلب معرفة برمجية أساسية. ومع ذلك، عبر مسارات تكامل الذكاء الاصطناعي لست مضطرًا لكتابة الكود — اربط خادم XBTFX MCP بـ Claude Code أو Cursor، أو ثبّت ملف skill من Skills Hub، وأصدر أوامر بلغة طبيعية. يُستحسن الإلمام بمساعدي البرمجة بالذكاء الاصطناعي.

  • هل يمكنني استخدام الذكاء الاصطناعي لتداول حسابي؟

    نعم. استخدم XBTFX Skills Hub لأطر الوكلاء التي تدعم ملفات skill، أو اربط خادم XBTFX MCP بعملاء متوافقين مع MCP مثل Claude Code وClaude Desktop وOpenAI Codex وCursor أو Windsurf. كلا المسارين يتيحان أوامر تداول بلغة طبيعية عبر XBTFX Trading API.

  • هل من الآمن منح وكيل ذكاء اصطناعي وصولًا لحسابي؟

    تُحفظ مفاتيح API عادةً محليًا لدى الوكيل على جهازك ولا تُرفع إلى خوادم خارجية. يرسل الوكيل استدعاءات الـ API مباشرة إلى خوادم XBTFX باستخدام مفتاحك. يمكنك إلغاء المفتاح فورًا من Console في أي وقت. نوصي بالبدء بحساب تجريبي لاختبار الإعداد قبل التشغيل الفعلي.

ابدأ البناء اليوم مع

Chat

24/7 Chat Support

Need help with the API? Our team is available around the clock.

Chat Now →
FAQ

API Documentation

Full endpoint reference, authentication guide, and examples.

View Docs →
Blog

GitHub Repos

API examples, AI skills, and sample code ready to use.

View on GitHub →

هذه الصفحة مملوكة ومُدارة من قبل شركات XBTFX، بما في ذلك:

XBTFX LLC مسجلة في أنتيغوا وباربودا برقم تسجيل ILLC001 وعنوان مسجل Hodges Bay, P.O. Box 1348, St. John's, Antigua.

XBTFX (SC) Ltd. مسجلة في سيشل برقم تسجيل 8434947-1 وعنوان عمل Office 1, Block 2, 1st Floor, Sai-fu Building, Zone 20, Providence, Mahe, Seychelles بترخيص رقم SD169.
تتم معالجة المدفوعات بواسطة CLEARAY LTD، شركة ذات مسؤولية محدودة مسجلة حسب الأصول بموجب قانون الشركات، الفصل 113 من جمهورية قبرص، برقم تسجيل HE 462275 ومكتب مسجل في Archiepiskopou Makariou ΙΙΙ, 160, 1st Floor, 3026, Limassol, Cyprus. XBTFX هي مزود لعقود الفروقات (CFDs) عبر مجموعة متنوعة من الأصول، وتقدم خدماتها على أساس الرافعة المالية. يرجى ملاحظة أن قيمة استثماراتك تخضع لتقلبات السوق وقد ترتفع أو تنخفض. وبالتالي، فإن رأس مالك المُستثمر معرض للمخاطر. الأصول المشفرة، وهي على وجه الخصوص غير منظمة ومتقلبة بشكل كبير، لا تتمتع بحماية المستهلك. بالإضافة إلى ذلك، قد تخضع أي أرباح من استثماراتك للضرائب. لا تقدم XBTFX خدماتها للأفراد المقيمين في بعض الولايات القضائية، بما في ذلك على سبيل المثال لا الحصر: الولايات المتحدة الأمريكية، كيبيك (كندا)، بلجيكا، روسيا البيضاء، روسيا، إيران، كوريا الشمالية، السودان، اليمن، أو أي مناطق أخرى تكون فيها الخدمات المقدمة من XBTFX مخالفة للقوانين أو اللوائح المحلية السائدة. هذه القائمة ليست شاملة وتخضع للتحديثات حسب الضرورة. XBTFX لا تستهدف بنشاط عملاء الاتحاد الأوروبي/المنطقة الاقتصادية الأوروبية. نحث العملاء المحتملين بشدة على فهم لوائح الصرف الأجنبي المعمول بها في بلدانهم قبل الاستفادة من خدمات XBTFX. تنبيه استثمار عالي المخاطر: عقود الفروقات (CFDs) هي أدوات مالية معقدة تنطوي على مخاطر كبيرة بسبب طبيعتها ذات الرافعة المالية. الخسارة المالية السريعة نتيجة محتملة للتعامل مع هذه الأدوات. من الضروري إجراء تقييم دقيق لفهمك لكيفية عمل عقود الفروقات وتحديد مدى ملاءمة تداولها لوضعك الخاص. يُنصح بشدة بعدم استثمار أموال لا يمكنك تحمل خسارتها. قد لا تكون المنتجات ذات الرافعة المالية مناسبة لجميع الأفراد وقد تؤدي إلى استنفاد كامل لرأس مالك. يرجى قراءة ‘إشعار الإفصاح عن المخاطر’. التداول مع XBTFX باتباع و/أو نسخ أو تكرار صفقات متداولين آخرين ينطوي على مستوى عالٍ من المخاطر، حتى عند اتباع/نسخ/تكرار أفضل المتداولين أداءً. تشمل هذه المخاطر احتمال متابعة/نسخ قرارات تداول لمتداولين قد يكونون عديمي الخبرة/غير محترفين، أو متداولين يختلف غرضهم النهائي أو نيتهم أو وضعهم المالي عن وضعك. الأداء السابق ليس مؤشراً على الأداء المستقبلي. المحتوى على منصة XBTFX للتداول الاجتماعي يتم إنشاؤه من قبل أعضاء مجتمعها ولا يحتوي على نصائح أو توصيات من XBTFX أو نيابة عنها. تنبيه الحماية من الاحتيال: XBTFX تقدم فقط خدمات الوساطة للعملاء. بالإضافة إلى ذلك، XBTFX تعمل فقط من خلال الرابط xbtfx.com ويجب على العملاء التأكد من الوصول إلى خدماتنا فقط عبر ذلك الرابط. XBTFX لن تطلب منك كلمة المرور الخاصة بك ولن تتصل بك عبر الرسائل النصية/الهاتف لطلب ذلك. المحتوى الوارد هنا مُقدم فقط لأغراض إعلامية وتسويقية. لا يشكل، ولا ينبغي تفسيره على أنه، نصيحة مالية أو استثمارية أو أي نصيحة مهنية أخرى أو توصية. كذلك لا يمثل عرضاً أو طلباً لشراء أو بيع أو الانخراط في أي أداة مالية أو معاملة. يجب على العملاء طلب رأي مستشارين ماليين مرخصين لضمان امتلاكهم للقدرة على تحمل المخاطر والخبرة والمعرفة ذات الصلة قبل التداول. تمت ترجمة هذه الصفحة لراحتك. النسخة الإنجليزية من جميع الشروط والاتفاقيات والمستندات القانونية وشروط التداول هي السائدة في حالة وجود أي تعارض.
2026 XBTFX LLC. All Rights Reserved.