MetaTrader API — مرکزِ معاونت
جوابات کے لیے تلاش کریں یا سائیڈ میں دی گئی اقسام دیکھیں۔ ہر سوال کا اپنا قابلِ اشتراک ربط ہے۔
جوابات کے لیے تلاش کریں یا سائیڈ میں دی گئی اقسام دیکھیں۔ ہر سوال کا اپنا قابلِ اشتراک ربط ہے۔
MetaTrader API ایک ہوسٹ شدہ REST API سروس ہے جو آپ کو MT4 اور MT5 ٹریڈنگ اکاؤنٹس کے ساتھ پروگرام کے ذریعے کام کرنے دیتی ہے — آپ کے کمپیوٹر پر MetaTrader چلانے کی ضرورت کے بغیر۔
آپ اپنا ٹریڈنگ اکاؤنٹ ایک بار جوڑتے ہیں، اور اس کے بعد معیاری HTTP درخواستوں کے ذریعے کسی بھی پروگرامنگ زبان سے سودے کر سکتے ہیں، اکاؤنٹ ڈیٹا پڑھ سکتے ہیں اور مارکیٹ کی قیمتیں حاصل کر سکتے ہیں۔
مکمل تکنیکی تفصیلات کے لیے سرکاری دستاویزات دیکھیں۔
آغاز میں 30 منٹ سے بھی کم وقت لگتا ہے:
POST /v1/seats یا /ConnectEx)۔مرحلہ وار ہدایت نامہ تصدیق کی دستاویزات میں ہے۔
ہر وہ زبان جو HTTP درخواستیں بھیج سکتی ہے، MetaTrader API کے ساتھ کام کرتی ہے۔ چونکہ یہ HTTPS پر ایک سادہ REST API ہے، آپ Python، JavaScript/Node.js، Go، C#، Java، Ruby، PHP یا کوئی بھی دوسری زبان استعمال کر سکتے ہیں۔
یہ Postman، Make (Integromat)، n8n، Zapier جیسے نو-کوڈ ٹولز کے ساتھ بھی چلتا ہے — اور ہر اُس ٹول کے ساتھ جو HTTP اینڈ پوائنٹ کال کر سکے۔
جی ہاں۔ یہ API MetaTrader 4 (MT4) اور MetaTrader 5 (MT5) دونوں کے اکاؤنٹس کو سپورٹ کرتا ہے۔ آپ دونوں پلیٹ فارمز کے اکاؤنٹس بیک وقت جوڑ اور منظم کر سکتے ہیں۔
بلنگ فی سیٹ ہوتی ہے: ہر سیٹ ایک MT4 یا ایک MT5 اکاؤنٹ جوڑتی ہے، اور ایک ہی سبسکرپشن میں MT4 اور MT5 سیٹیں ملا کر استعمال کی جا سکتی ہیں۔
MT4 اور MT5 پر اینڈ پوائنٹس ایک جیسے ہیں، بشمول /PendingOrderHistory اور /HistoryDealsByPositionId؛ فرق صرف یہ ہے کہ MT4 پر اسٹاپ لمٹ آرڈرز (BuyStopLimit/SellStopLimit) دستیاب نہیں۔ ہر پلیٹ فارم کا مکمل حوالہ دستاویزات میں ہے۔
نہیں۔ اسی ضرورت کو ختم کرنا اس سروس کا بنیادی مقصد ہے۔ MetaTrader API مکمل طور پر سرور کی طرف چلتا ہے۔ آپ بروکر کی اسناد ایک بار درج کرتے ہیں، اور API آپ کی جانب سے بروکر سے کنکشن برقرار رکھتا ہے۔
آپ کو MetaTrader انسٹال کرنے، کوئی ڈیسک ٹاپ ایپ چلتی رکھنے یا MQL میں Expert Advisors لکھنے کی ضرورت نہیں۔
اپنی API کلید x-api-key ہیڈر میں بھیجیں، اور اکاؤنٹ کا UUID id (یا accountId) کوئری پیرامیٹر میں دیں:
curl -X GET "https://api.metatraderapi.net/AccountSummary?id=YOUR_ACCOUNT_UUID" \
-H "x-api-key: YOUR_API_KEY"API کلید ڈیش بورڈ میں اکاؤنٹ کے کارڈ پر Generate key سے بنائی جاتی ہے؛ یہ صرف ایک بار دکھائی دیتی ہے۔ ترتیبات میں موجود مینجمنٹ کلید پروویژننگ کے لیے ہے، x-api-key ہیڈر کے لیے نہیں۔
کسی اکاؤنٹ کی API کلید app.metatraderapi.net پر ڈیش بورڈ میں اسی اکاؤنٹ کے کارڈ پر بنائی جاتی ہے: Generate key پر کلک کریں۔ یہ صرف ایک بار دکھائی دیتی ہے، اس لیے اسے فوراً محفوظ کر لیں۔ /ConnectEx اور POST /v1/seats بھی جوڑے گئے اکاؤنٹ کے لیے ایک نئی کلید واپس کرتے ہیں۔ ترتیبات ٹیب میں آپ کی مینجمنٹ کلید ہوتی ہے، جو پروویژننگ (سیٹ بنانے اور ہٹانے) کے لیے ہے، ٹریڈنگ کالز کے لیے نہیں۔
بہتر طریقہ: اسے ایک انوائرنمنٹ ویری ایبل (environment variable، مثلاً MTAPI_KEY) میں رکھیں اور چلانے کے وقت داخل کریں۔
اکاؤنٹس دو طریقوں سے جوڑے جا سکتے ہیں:
app.metatraderapi.net پر لاگ اِن کریں، اکاؤنٹس سیکشن میں جائیں اور اپنی MT4/MT5 اسناد شامل کریں (لاگ اِن نمبر، پاس ورڈ، بروکر کے سرور کا نام)۔ جُڑنے کے بعد آپ کو اُس اکاؤنٹ کے لیے ایک منفرد UUID ملے گا۔
بیک اینڈ سے JSON باڈی اور اپنی مینجمنٹ کلید کے ساتھ POST /v1/seats استعمال کریں۔ متبادل کے طور پر، مینجمنٹ کلید یا ایسی API کلید سے /ConnectEx?user=&password=&server=&platform=MT5&wait=60 کال کریں جو نہ تو صرف پڑھنے والی (read-only) ہو اور نہ کسی ایک اکاؤنٹ تک محدود۔ دونوں اکاؤنٹ کی id اور اس کے لیے ایک نئی apiKey واپس کرتے ہیں۔ درست پیرامیٹرز اور جواب کی ساخت API دستاویزات میں ہے۔
BrokerName-Live یا BrokerName-Demo جیسا ہوتا ہے۔/CheckConnect?id= استعمال کریں۔ اس کا جواب true یا false ہوتا ہے: اکاؤنٹ اس وقت اپنے بروکر سے جُڑا ہے یا نہیں۔ ٹوٹے ہوئے کنکشن سروس خود بحال کرتی ہے۔ /ConnectState?id= حالت اور اس کا statusReason دکھاتا ہے، اور /Reconnect?id= دوبارہ کنکشن پر مجبور کرتا ہے۔
درخواست کی ساخت اور جوابی اقدار کی تفصیل دستاویزات میں دیکھیں۔
جُڑے ہوئے ٹریڈنگ اکاؤنٹ کا کنکشن توڑنے اور اسے ہٹانے کے لیے /Disconnect?id= (یا مینجمنٹ کلید کے ساتھ DELETE /v1/seats/{id}) استعمال کریں۔ اس وقت جُڑے تمام اکاؤنٹس کی فہرست id کے بغیر /ConnectState (یا GET /v1/seats) سے دیکھی جا سکتی ہے۔
کنکشن ہٹانے سے اکاؤنٹ کی سیٹ خالی ہو جاتی ہے۔ وہ بلنگ مہینے کے اختتام تک ادا شدہ رہتی ہے، اور اگلا جوڑا گیا اکاؤنٹ اسے بغیر اضافی لاگت کے استعمال کرتا ہے۔
درخواست کے پیرامیٹرز API دستاویزات میں ہیں۔
جتنی آپ کی سیٹیں ہیں، اتنے اکاؤنٹس۔ بلنگ فی سیٹ ہوتی ہے: ایک سیٹ = ایک وقت میں ایک جُڑا اکاؤنٹ۔ جب بھی ضرورت ہو سیٹیں شامل کریں (سیٹ 1 تا 4 کے لیے فی سیٹ ماہانہ $14، سیٹ 5 تا 19 کے لیے $13 اور 20ویں سیٹ سے $12، پیشگی وصولی)۔
ہر صارف زیادہ سے زیادہ 50 سیٹیں لے سکتا ہے؛ مزید درخواست پر — سپورٹ سے رابطہ کریں۔
یہ API ٹریڈنگ کے پورے چکر کا احاطہ کرتا ہے:
/OrderClose)، یا کسی مخالف پوزیشن کے مقابل (/OrderCloseBy)اینڈ پوائنٹس، پیرامیٹرز اور جوابی ساخت کی مکمل تفصیل API دستاویزات میں ہے۔
/OrderSend اینڈ پوائنٹ استعمال کریں۔ ہر کلاسک اینڈ پوائنٹ کی طرح یہ کوئری پیرامیٹرز والی ایک GET درخواست ہے: سمبل، آپریشن (Buy، Sell، BuyLimit وغیرہ)، لاٹ میں والیوم، اور اختیاری طور پر اسٹاپ لاس، ٹیک پرافٹ، ایک تبصرہ اور ایک 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"MT4 اور MT5 پر پیرامیٹرز ایک جیسے ہیں۔ اسٹاپ لمٹ آرڈرز (stopLimitPrice) صرف MT5 پر ہیں۔ زیرِ التوا آرڈرز اختیاری expiration لیتے ہیں؛ MT5 پر expirationType نظرانداز کر دیا جاتا ہے۔
/OrderHistory یا /OrderHistoryPagination اینڈ پوائنٹس استعمال کریں۔ دونوں صرف تاریخ کی حد سے فلٹر کرتے ہیں (from اور to، ISO-8601 یا Unix سیکنڈ)؛ /OrderHistoryPagination نتیجے کو صفحات میں تقسیم کرتا ہے (ordersPerPage، pageNumber)۔ ٹکٹ کے لحاظ سے فلٹر یا ترتیب اپنے کوڈ میں کریں۔ مزید تفصیلی کوئریز کے لیے MT4 اور MT5 دونوں پر /PendingOrderHistory اور /HistoryDealsByPositionId بھی دستیاب ہیں۔
پیرامیٹرز کا مکمل حوالہ دستاویزات میں ہے۔
جی ہاں۔ یہ API حقیقی وقت کی ااسٹریمنگ کے لیے WebSocket (ایونٹس) کنکشن فراہم کرتا ہے۔ یوں آپ REST اینڈ پوائنٹس کو بار بار پول کرنے کے بجائے تازہ کاریاں براہِ راست حاصل کرتے ہیں۔
WebSocket اسٹریم (wss://api.metatraderapi.net/v1/stream?id=، x-api-key ہیڈر سے تصدیق شدہ) کے ذریعے آپ کو سبسکرائب کیے گئے سمبلز کی لائیو قیمتیں اور کینڈلز، لائیو منافع کے ساتھ آپ کی کھلی پوزیشنز، زیرِ التوا آرڈرز اور ہر مکمل ہونے والی ٹریڈ ملتی ہے، نیز ہر 10 سیکنڈ میں ایک ہارٹ بیٹ۔ فی اکاؤنٹ زیادہ سے زیادہ 25 اسٹریمز بیک وقت کھلی رہ سکتی ہیں۔
لائیو bid/ask قیمتوں کے لیے آپ REST اینڈ پوائنٹ /GetQuote (کئی سمبلز کے لیے /GetQuoteMany) استعمال کر سکتے ہیں، یا مسلسل حقیقی وقت کی تازہ کاریوں کے لیے WebSocket اسٹریم سے کوٹس سبسکرائب کر سکتے ہیں۔
/GetQuote اکاؤنٹ کا id اور ایک symbol لیتا ہے۔ جوابات فی اکاؤنٹ اور سمبل 250 ms تک کیش رہتے ہیں؛ کیش کو بائی پاس کرنے کے لیے cached=0 شامل کریں۔
تاریخی OHLC کینڈلز کے لیے MT4 اور MT5 دونوں پر /PriceHistory استعمال کریں (/QuoteHistory اسی کا متبادل نام ہے) — ٹائم فریم کے اختیارات اور پیرامیٹرز کے لیے دستاویزات دیکھیں۔
صرف ایک پلان ہے: آپ فی سیٹ ادائیگی کرتے ہیں، اور ہر سیٹ میں مکمل API شامل ہے — REST، WebSocket اسٹریمنگ اور MT4 و MT5 دونوں کی سپورٹ۔ قیمتیں بغیر ٹیکس:
ہر سیٹ ایک وقت میں ایک جُڑا MT4 یا MT5 اکاؤنٹ رکھتی ہے اور پورے بلنگ مہینے کے لیے پیشگی وصول کی جاتی ہے۔ مثال: 10 سیٹیں = 4 × $14 + 6 × $13 = ماہانہ $134۔ تمام قیمتیں قیمتوں کے صفحے پر تصدیق شدہ ہیں۔
نہیں۔ فی الحال ہم مفت ٹرائل پیش نہیں کرتے۔ API کے جائزے کے بارے میں سوالات ہوں تو ہمیں Telegram پر یا support@metatraderapi.net پر لکھیں۔
آپ $14 میں ایک سیٹ سے آغاز کر سکتے ہیں اور انٹیگریشن چلنے کے بعد مزید سیٹیں شامل کر سکتے ہیں۔
جی ہاں۔ فی سیٹ پلان کا بل فی سیٹ بنتا ہے، اور ہر سیٹ ایک وقت میں ایک جڑا ہوا اکاؤنٹ رکھتی ہے۔ جب آپ کی تمام سیٹیں استعمال میں ہوں تو ایک اور اکاؤنٹ جوڑنے سے ماہانہ $14 (سیٹ 5–19 کے لیے $13، 20ویں سیٹ سے $12) میں ایک سیٹ شامل ہو جاتی ہے، جس کی فیس شامل کرتے وقت پیشگی لی جاتی ہے۔ کسی اکاؤنٹ کو منقطع کرنے سے اس کی سیٹ اگلے اکاؤنٹ کے لیے بلا معاوضہ خالی ہو جاتی ہے، اور غیر استعمال شدہ سیٹیں آپ ڈیش بورڈ سے چھوڑ سکتے ہیں۔ ہر صارف زیادہ سے زیادہ 50 سیٹیں لے سکتا ہے؛ مزید درخواست پر — سپورٹ سے رابطہ کریں۔
ادائیگی Stripe کے ذریعے کریڈٹ یا ڈیبٹ کارڈ سے ہوتی ہے، ایک سبسکرپشن کے طور پر جس کا بل ہر مہینے بنتا ہے۔ ہم کرپٹو یا بینک ٹرانسفر قبول نہیں کرتے۔
آرڈر دینے سے آپ Stripe سروسز معاہدے کو بھی قبول کرتے ہیں۔
جی ہاں، آپ کسی بھی وقت منسوخ کر سکتے ہیں۔ تنسیخ جاری بلنگ مہینے کے اختتام پر مؤثر ہوتی ہے — غیر استعمال شدہ دنوں کی جزوی واپسی نہیں ہوتی۔
یہ سروس Apex Vanguard Dynamics LLC چلاتی ہے، جو ریاستہائے متحدہ امریکہ میں رجسٹرڈ ایک محدود ذمہ داری کمپنی (LLC) ہے؛ اس کا رجسٹرڈ پتہ 30 N Gould St Ste R, Sheridan, WY 82801, امریکہ ہے۔
رابطہ ای میل: support@metatraderapi.net · فون: +1 (929) 333-6422
مکمل قانونی تفصیلات کے لیے قانونی معلومات دیکھیں۔
شرائط و ضوابط پر امریکہ کی ریاست وائیومنگ کا قانون لاگو ہوتا ہے۔ کوئی بھی تنازع وائیومنگ کی عدالتوں کے خصوصی دائرہ اختیار میں آتا ہے، اور دونوں فریق پہلے نیک نیتی سے بات چیت کے ذریعے حل کی کوشش پر متفق ہیں۔
آپ ویب سائٹ پر مکمل شرائط و ضوابط پڑھ سکتے ہیں۔
نہیں۔ شرائطِ خدمات واضح طور پر تقاضا کرتی ہیں کہ آپ اپنی لاگ اِن اسناد اور API کلیدیں راز میں رکھیں اور MetaTrader API کی پیشگی تحریری اجازت کے بغیر انہیں کسی تیسرے فریق کے ساتھ شیئر نہ کریں۔
اگر آپ اس API پر کوئی پروڈکٹ یا سروس بنا رہے ہیں (مثلاً اپنے گاہکوں کے لیے)، تو اپنی الگ تصدیقی پرت بنائیں اور MetaTrader API کی کلید صرف سرور پر رکھیں — اسے حتمی صارفین کے سامنے کبھی ظاہر نہ کریں۔
نہیں۔ شرائطِ خدمات MetaTrader API کی واضح تحریری اجازت کے بغیر سروس کے ڈیٹا کو سکریپ کرنے یا دوبارہ بیچنے سے منع کرتی ہیں۔ سبسکرپشنز بھی منتقل نہیں کی جا سکتیں۔
اگر آپ کا کوئی مخصوص کاروباری معاملہ ہے تو support@metatraderapi.net پر لکھیں۔
جی ہاں۔ درخواست پر NDA دستیاب ہیں اور ان پر دونوں فریقوں کی تحریری رضامندی لازم ہے۔ جب تک باہمی طور پر کچھ اور طے نہ ہو، معیاری NDA شرائط لاگو ہوتی ہیں۔
درخواست کے لیے support@metatraderapi.net پر لکھیں۔
MetaTrader API منسلک اکاؤنٹس کو ان اقدامات سے محفوظ رکھتا ہے:
سیکیورٹی اقدامات، ذیلی پروسیسرز اور ناپا گیا اپ ٹائم ٹرسٹ سینٹر میں درج ہیں؛ ڈیٹا کے استعمال کی تفصیل پرائیویسی پالیسی میں ہے۔
MetaTrader API کو ایک امریکی کمپنی چلاتی ہے (دیکھیں MetaTrader API کو کون چلاتا ہے؟) اور وہ قابلِ اطلاق ڈیٹا تحفظ قوانین کی تعمیل کا اعلان کرتی ہے، بشمول GDPR جہاں یہ EU/EEA صارفین پر لاگو ہو۔
کون سا ذاتی ڈیٹا جمع ہوتا ہے: اکاؤنٹ کی معلومات (نام، ای میل، بلنگ تفصیلات)، استعمال کا ڈیٹا (API لاگز، IP پتہ، براؤزر اور آپریٹنگ سسٹم) اور Stripe کے ذریعے پروسیس ہونے والی ادائیگی کی معلومات۔
ہم ذاتی ڈیٹا فروخت نہیں کرتے۔ یہ صرف اُن سروس فراہم کنندگان کے ساتھ شیئر کیا جاتا ہے جو ہماری جانب سے اسے پروسیس کرتے ہیں (جیسے ہوسٹنگ، ادائیگیاں اور ای میل بھیجنا)، اور کسٹمرز کے لیے ڈیٹا پروسیسنگ معاہدے (DPA) دستیاب ہے۔ مکمل تفصیلات پرائیویسی پالیسی اور ٹرسٹ سینٹر میں ہیں۔
پرائیویسی پالیسی کے مطابق درج ذیل ڈیٹا جمع ہو سکتا ہے:
منسلک ٹریڈنگ اکاؤنٹس کے لیے بروکر کی لاگ اِن تفصیلات بھی محفوظ کی جاتی ہیں (AES-256-GCM سے انکرپٹ شدہ)، اور API جو ٹریڈنگ ڈیٹا حاصل کرتا ہے وہ آپ کی جانب سے پروسیس ہوتا ہے۔ کسٹمر ڈیٹا اور API سرورز EU (فن لینڈ اور جرمنی) میں ہیں۔ پرائیویٹ ہوسٹنگ والی سیٹس آپ کے منتخب کردہ خطے میں چلتی ہیں۔
مکمل معلومات کے لیے پرائیویسی پالیسی پڑھیں۔
کنکشن ناکام ہونے کی سب سے عام وجوہات:
ICMarkets-Live02)۔ اسے MetaTrader میں File → Open an Account کے تحت دیکھیں۔موجودہ کنکشن کی حالت /CheckConnect اینڈ پوائنٹ سے جانچیں۔ مسئلہ برقرار رہے تو support@metatraderapi.net پر لکھیں۔
تصدیق کی خرابیاں عام طور پر ظاہر کرتی ہیں کہ API کلید موجود نہیں، غلط ہے یا غلط ساخت میں بھیجی جا رہی ہے۔ درج ذیل جانچیں:
x-api-key ہیڈر استعمال کر رہے ہیں — Authorization: Bearer نہیں۔درست ساخت تصدیق کی دستاویزات میں ہے۔
MetaTrader API ناپا گیا اپ ٹائم ایک عوامی اسٹیٹس پیج پر شائع کرتا ہے، جس میں REST API، WebSocket ااسٹریمنگ اور ڈیش بورڈ کا لائیو اسٹیٹس اور اپ ٹائم کی تاریخ شامل ہے۔ کوئی SLA یا دستیابی کی ضمانت نہیں ہے؛ سروس کیسے چلائی جاتی ہے، یہ ٹرسٹ سینٹر میں دیکھیں۔
یاد رکھیں کہ شرائطِ خدمات کے مطابق سروس «جیسی ہے» اور «جیسی دستیاب ہے» کی بنیاد پر دی جاتی ہے — بلا تعطل یا بلا خرابی کارکردگی کی معاہدے میں ضمانت نہیں۔ پروڈکشن سسٹمز کے لیے اپنی طرف سے دوبارہ کوشش کی منطق اور خرابی کا انتظام ضرور نافذ کریں۔
آرڈر کا مسترد ہونا بروکر کے ٹریڈنگ سرور کی طرف سے ہوتا ہے، MetaTrader API کی طرف سے نہیں۔ عام وجوہات:
EURUSD بمقابلہ EURUSDm)۔بروکر کا انکار کوئی HTTP خرابی نہیں ہے: API HTTP 200 اور آرڈر آبجیکٹ کے ساتھ جواب دیتا ہے، اور اس کے state فیلڈ میں بروکر کا نتیجہ کوڈ ہوتا ہے۔ 10009 کا مطلب ہے مکمل؛ کوئی بھی دوسری قدر انکار کی وجہ ہے (مثلاً 10016 غلط اسٹاپس، 10018 مارکیٹ بند، 10019 ناکافی رقم؛ MT4 پر MT4 کا ایرر نمبر)۔