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

XBTFX Trading API

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

  • حسابات Pro
  • وصول برمجي كامل
  • أوضاع Hedging وNetting
  • جاهزة لوكلاء الذكاء الاصطناعي (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
}
البروتوكول
REST
تدفق
WebSocket
Weight / دقيقة
600
صيغة الاستجابة
JSON

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

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

استراتيجيات مؤتمتة

ابنِ بوتات تداول واستراتيجيات خوارزمية ترسل صفقات تلقائيًا إلى حسابك. شغّل تنفيذًا مدفوعًا بالإشارات أو إعادة موازنة محفظة أو منطق إدارة مخاطر مخصص.

تكامل وكلاء الذكاء الاصطناعي

اربط مساعدي الذكاء الاصطناعي بحسابك عبر XBTFX Skills Hub أو خادم MCP. أعطِ أوامر التداول بلغة طبيعية عبر Claude Code أو Cursor أو Windsurf أو عملاء آخرين متوافقين.

تكاملات مخصصة

ابنِ لوحات تحكم، اتصل بمصادر بيانات خارجية، وجّه إشارات التداول من منصات أخرى، أو ادمج بيانات الحساب في أنظمة التقارير والتحليلات الخاصة بك.

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

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

وثائق API

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.

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

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

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

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

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

مثال محادثة

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

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

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

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

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

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

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

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

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

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

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

تحليل ذاتي

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

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

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

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

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

أوضاع Hedging وNetting
كلا وضعَي الهامش في MT5 مدعومان. يرتبط الوضع بمفتاح الـ API الخاص بك.
مفاتيح Idempotency
أرسل المفتاح نفسه خلال 120 ثانية ونعيد الاستجابة المخزّنة في الكاش. إعادة محاولة آمنة دون صفقات مكررة.
حدود وزن الطلبات
600 weight لكل دقيقة لكل مفتاح. تكلفة القراءات والصفقات 1، والعمليات الجماعية 10. تكشف الترويسات ميزانيتك المتبقية في كل استجابة.
حدود البث
حتى 1000 اشتراك رمزي لكل اتصال WebSocket وحتى 10 اتصالات لكل مفتاح API. تُبث الأسعار فور تغيّرها.

توافق الحساب

تعمل مع حساب Pro الخاص بك

حسابات Pro
سبريد خام مع عمولة منفصلة. تتعامل الـ API مع كل حساب Pro بالطريقة نفسها: نفس النقاط الطرفية، ونفس JSON، ونفس مسار المصادقة.
حسابات PAMM وMAM وCopy Master
يمكن قيادة حسابات المدير برمجيًا عبر الـ API للتخصيصات وإعادة الموازنة والتنفيذ. تواصل مع فريق الإعداد للحصول على بيانات الاعتماد.
تسوية متعددة العملات
كل عملة أساس تدعمها XBTFX MT5 لحسابات Pro: USD، EUR، USDT، BTC، ETH، XRP، SOL، LTC، ZEC، XAU. تعود الأرصدة والإيكويتي والهامش والربح والخسارة بعملة الحساب نفسها، فلا حاجة إلى منطق تحويل من جانبك.
Hedging أو Netting
أيًا كان وضع الهامش الذي تختاره على حساب MT5 هو ما تستخدمه الـ API. لا حاجة لإعادة تكوين.

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

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

وثائق API

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

أمثلة API

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

AI Skills Hub

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

MCP Server

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

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

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

  1. أنشئ مفتاح API

    سجّل الدخول إلى portal.xbtfx.com بمعلومات اعتماد XBTFX، اختر حساب التداول، وأنشئ مفتاحًا.

    فتح Console
  2. ثبّت Skill أو MCP

    ثبّت skill من Skills Hub، أو اربط خادم MCP بـ Claude Code أو Cursor أو Windsurf أو عملاء آخرين متوافقين. تبقى المفاتيح محلية.

    وثائق MCP
  3. ابدأ التداول

    تحقق عبر GET /v1/auth/status، ثم أصدر أوامر بلغة طبيعية أو استدعِ نقاط REST/WebSocket مباشرة.

    قراءة الوثائق

الأسئلة الشائعة

ما هي XBTFX Trading API؟
توفر XBTFX Trading API وصولًا عبر REST وWebSocket للتداول البرمجي ومراقبة الحسابات واسترجاع بيانات السوق وتدفقها على حسابات XBTFX MetaTrader 5® المتوافقة. مبنية بواسطة XBTFX — تتفاعل مع نقاط HTTP نظيفة واستجابات JSON لإرسال الصفقات واسترجاع بيانات الحساب.
هل يمكنني استخدام الـ API مع حساب Standard؟
لا. تعمل XBTFX Trading API مع حسابات Pro على MetaTrader 5 فقط. مع حساب Standard، استخدم الـ API المفتوحة من Mega1: فهي تعمل مع حسابات Standard على Mega1، بمفاتيح تُنشأ داخل منصة Mega1.
ما لغات البرمجة التي يمكنني استخدامها؟
أي لغة تستطيع إرسال طلبات 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 مع كل حساب Pro دون أي تكلفة إضافية. لا رسوم API أو اشتراكات أو تكاليف لكل استدعاء أعلى من عمولاتك وسبريداتك المعتادة.
كيف أحصل على مفتاح API؟
افتح أولًا حساب XBTFX Pro على portal.xbtfx.com إن لم يكن لديك. ثم سجّل الدخول إلى API Console على portal.xbtfx.com بمعلومات اعتماد XBTFX، اختر حساب Pro، وأنشئ مفتاحًا. تحقق من عمله بإرسال GET /v1/auth/status قبل وضع الصفقات.
ما الذي عليّ فعله قبل وضع الصفقات؟
تحقق أولًا من حالة مفتاح الـ 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 في أي وقت.

ابدأ البناء اليوم.
استخدام الـ API مجاني.

افتح حسابك في XBTFX، وأنشئ مفتاح API في البوابة، وأرسل أول صفقة لك.

الدعم المباشر

تحدّث مع فريق الدعم لدينا عبر الدردشة، حتى في عطلات نهاية الأسبوع.

موقع الدعم

أدلة وإجابات تخص حسابك والتمويل والمنصات.

تصفّح موقع الدعم

المدونة

أخبار الشركة وتحديثات الأسواق ورؤى التداول.

اقرأ المدونة

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