MetaTrader API — מרכז העזרה
השתמשו בחיפוש או עברו בין הקטגוריות כדי למצוא תשובות. לכל שאלה יש כתובת URL משלה לשיתוף.
השתמשו בחיפוש או עברו בין הקטגוריות כדי למצוא תשובות. לכל שאלה יש כתובת URL משלה לשיתוף.
MetaTrader API הוא שירות REST API מנוהל שמאפשר לעבוד עם חשבונות מסחר של MT4 ו‑MT5 באופן תוכנתי — בלי להריץ MetaTrader במחשב שלכם.
מחברים את חשבון המסחר פעם אחת, ומאותו רגע אפשר לבצע עסקאות, לקרוא נתוני חשבון ולקבל מחירי שוק מכל שפת תכנות באמצעות בקשות HTTP רגילות.
לפרטים טכניים מלאים ראו את התיעוד הרשמי.
ההתחלה לוקחת פחות מ‑30 דקות:
POST /v1/seats או /ConnectEx).המדריך שלב‑אחר‑שלב נמצא בתיעוד האימות.
כל שפה שמסוגלת לשלוח בקשות HTTP עובדת עם MetaTrader API. מכיוון שזה REST API רגיל מעל HTTPS, אפשר להשתמש ב‑Python, JavaScript/Node.js, Go, C#, Java, Ruby, PHP או כל שפה אחרת.
זה עובד גם עם כלי no‑code כמו Postman, Make (Integromat), n8n, Zapier — ועם כל כלי שיכול לקרוא לנקודת קצה HTTP.
כן. ה‑API תומך בחשבונות MetaTrader 4 (MT4) ו‑MetaTrader 5 (MT5), וניתן לחבר ולנהל חשבונות משתי הפלטפורמות במקביל.
החיוב הוא לפי מושב: כל מושב מחבר חשבון MT4 אחד או חשבון MT5 אחד, ואפשר לשלב מושבי MT4 ו‑MT5 באותו מנוי.
שתי הפלטפורמות חושפות את אותן נקודות קצה, כולל /PendingOrderHistory ו‑/HistoryDealsByPositionId. ההבדל היחיד: ב‑MT4 אין פקודות Stop-Limit (BuyStopLimit/SellStopLimit). המדריך המלא נמצא בתיעוד.
לא. זו בדיוק המטרה המרכזית של השירות. MetaTrader API פועל כולו בצד השרת. מזינים את פרטי הברוקר פעם אחת, וה‑API שומר את החיבור לברוקר בשמכם.
אין צורך להתקין MetaTrader, להשאיר אפליקציית דסקטופ פועלת או לכתוב Expert Advisors ב‑MQL.
שלחו את מפתח ה‑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 מחזירים מפתח חדש לחשבון שהם מחברים. בלשונית הגדרות נמצא מפתח הניהול, שמיועד להקצאה (יצירה והסרה של מושבים) ולא לקריאות מסחר.
המלצה: שמרו אותו כמשתנה סביבה (למשל MTAPI_KEY) וטענו אותו בזמן ריצה.
יש שתי דרכים:
התחברו ל‑app.metatraderapi.net, עברו לאזור חשבונות והוסיפו את פרטי ה‑MT4/MT5 (מספר התחברות, סיסמה, שם השרת של הברוקר). לאחר החיבור תקבלו UUID ייחודי לחשבון.
מצד השרת, השתמשו ב‑POST /v1/seats עם גוף JSON ומפתח הניהול. לחלופין, קראו ל‑/ConnectEx?user=&password=&server=&platform=MT5&wait=60 עם מפתח ניהול או מפתח API שאינו לקריאה בלבד ואינו מוגבל לחשבון אחד. שתי הדרכים מחזירות את ה‑id של החשבון ו‑apiKey חדש עבורו. הפרמטרים המדויקים ומבנה התשובה נמצאים בתיעוד ה‑API.
BrokerName-Live או BrokerName-Demo.השתמשו ב‑/CheckConnect?id=. התשובה היא true או false: האם החשבון מחובר כרגע לברוקר שלו. חיבורים שנפלו משוחזרים אוטומטית על ידי השירות. /ConnectState?id= מציג את המצב ואת ה‑statusReason, ו‑/Reconnect?id= מאלץ חיבור מחדש.
פרטים על מבנה הבקשה וערכי התשובה נמצאים בתיעוד.
השתמשו ב‑/Disconnect?id= (או ב‑DELETE /v1/seats/{id} עם מפתח ניהול) כדי לנתק ולמחוק חשבון מסחר מחובר. את כל החשבונות המחוברים כרגע ניתן להציג באמצעות /ConnectState ללא id (או באמצעות GET /v1/seats).
הניתוק משחרר את המושב של החשבון. המושב נשאר משולם עד סוף חודש החיוב, והחשבון הבא שתחברו ישתמש בו ללא עלות נוספת.
פרמטרי הבקשה נמצאים בתיעוד ה‑API.
כמספר המושבים שלכם. החיוב הוא לפי מושב: מושב אחד = חשבון מחובר אחד בכל רגע. הוסיפו מושבים בכל עת שתצטרכו ($14 למושב לחודש עבור מושבים 1–4, $13 עבור מושבים 5–19 ו‑$12 החל מהמושב ה‑20, בתשלום מראש).
כל לקוח יכול להחזיק עד 50 מושבים; יותר לפי בקשה — פנו לתמיכה.
ה‑API מכסה את מחזור המסחר כולו:
/OrderClose), או מול פוזיציה נגדית (/OrderCloseBy)פרטי נקודות הקצה, הפרמטרים ומבני התשובה נמצאים בתיעוד ה‑API.
השתמשו בנקודת הקצה /OrderSend. כמו כל נקודת קצה קלאסית, זו בקשת GET עם פרמטרים בשאילתה: סימול, סוג פעולה (Buy, Sell, BuyLimit וכו'), נפח בלוטים, ובאופן אופציונלי stop loss, take profit, הערה ו‑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. פקודות Stop-Limit (stopLimitPrice) קיימות רק ב‑MT5. פקודות ממתינות מקבלות expiration אופציונלי; ב‑MT5 המערכת מתעלמת מ‑expirationType.
השתמשו ב‑/OrderHistory או ב‑/OrderHistoryPagination. שניהם מסננים לפי טווח תאריכים בלבד (from ו‑to, ISO-8601 או שניות Unix); /OrderHistoryPagination מחלק את התוצאה לעמודים (ordersPerPage, pageNumber). סינון לפי טיקט או מיון עושים בקוד שלכם. בשתי הפלטפורמות יש גם /PendingOrderHistory ו‑/HistoryDealsByPositionId לשאילתות מפורטות יותר.
מדריך הפרמטרים המלא נמצא בתיעוד.
כן. ה‑API מספק חיבור WebSocket (אירועים) להזרמה בזמן אמת. כך מקבלים עדכונים ישירות, במקום לתשאל נקודות קצה של REST שוב ושוב.
דרך זרם ה‑WebSocket (wss://api.metatraderapi.net/v1/stream?id=, באימות עם הכותרת x-api-key) מקבלים מחירים ונרות בזמן אמת לסימולים שנרשמתם אליהם, את הפוזיציות הפתוחות עם רווח בזמן אמת, פקודות ממתינות וכל עסקה שבוצעה, וגם heartbeat כל 10 שניות. לכל חשבון אפשר לפתוח עד 25 זרמים בו־זמנית.
למחירי bid/ask בזמן אמת אפשר להשתמש בנקודת ה‑REST /GetQuote (או /GetQuoteMany לכמה סימולים), או להירשם לשערים דרך ה‑WebSocket לקבלת עדכונים רציפים.
/GetQuote מקבל את ה‑id של החשבון ו‑symbol. התשובות נשמרות במטמון ל‑250 ms לכל חשבון וסימול; הוסיפו cached=0 כדי לעקוף את המטמון.
לנרות OHLC היסטוריים השתמשו ב‑/PriceHistory ב‑MT4 וב‑MT5 (/QuoteHistory הוא כינוי שלו) — אפשרויות טווחי זמן ופרמטרים בתיעוד.
יש תוכנית אחת: משלמים לפי מושב, וכל מושב כולל את ה‑API המלא — REST, הזרמת WebSocket ותמיכה גם ב‑MT4 וגם ב‑MT5. המחירים ללא מע״מ:
כל מושב מחזיק חשבון MT4 או MT5 מחובר אחד בכל רגע, ומחויב על חודש חיוב מלא, מראש. לדוגמה: 10 מושבים = 4 × $14 + 6 × $13 = $134 לחודש. כל המחירים מאושרים בעמוד המחירים.
לא. איננו מציעים כרגע תקופת ניסיון חינם. לשאלות על בחינת ה‑API פנו אלינו ב‑Telegram או בדוא״ל support@metatraderapi.net.
אפשר להתחיל עם מושב אחד ב‑$14 ולהוסיף מושבים כשהאינטגרציה עובדת.
כן. התוכנית לפי מושב מחויבת לכל מושב, וכל מושב מחזיק חשבון מחובר אחד בכל פעם. כשכל המושבים בשימוש, חיבור חשבון נוסף מוסיף מושב ב‑$14 לחודש ($13 למושבים 5–19, $12 מהמושב ה‑20), בחיוב מראש ברגע ההוספה. ניתוק חשבון משחרר את המושב שלו לחשבון הבא ללא עלות, ואת המושבים שאינם בשימוש אפשר לשחרר מלוח הבקרה. כל לקוח יכול להחזיק עד 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 בצד השרת בלבד — אל תחשפו אותו למשתמשי הקצה.
לא. תנאי השימוש אוסרים גריפה (scraping) או מכירה מחדש של נתוני השירות ללא אישור מפורש בכתב מ‑MetaTrader API. גם המנויים אינם ניתנים להעברה.
אם יש לכם מקרה עסקי ספציפי, כתבו ל‑support@metatraderapi.net.
כן. הסכמי סודיות זמינים לפי בקשה ודורשים הסכמה הדדית בכתב. בהיעדר משא ומתן אחר חלים תנאי NDA סטנדרטיים.
לבקשה כתבו ל‑support@metatraderapi.net.
MetaTrader API מגן על חשבונות מחוברים באמצעות האמצעים הבאים:
אמצעי האבטחה, מעבדי המשנה והזמינות הנמדדת מתועדים במרכז האמון; אופן הטיפול בנתונים מתואר במדיניות הפרטיות.
MetaTrader API מופעל על ידי חברה אמריקאית (ראו מי מפעיל את MetaTrader API?), שמצהירה שהיא עומדת בדיני הגנת הנתונים החלים, כולל ה‑GDPR במקומות שבהם הוא חל על משתמשים באיחוד האירופי / EEA.
אילו נתונים אישיים נאספים: פרטי חשבון (שם, דוא״ל, פרטי חיוב), נתוני שימוש (יומני API, כתובת IP, דפדפן ומערכת הפעלה) ופרטי תשלום המעובדים דרך Stripe.
איננו מוכרים מידע אישי. הוא משותף רק עם ספקי שירות שמעבדים אותו בשמנו (כגון אירוח, תשלומים ושליחת דוא״ל), ולרשות הלקוחות עומד הסכם עיבוד נתונים (DPA). כל הפרטים במדיניות הפרטיות ובמרכז האמון.
לפי מדיניות הפרטיות, ייתכן שייאספו הנתונים הבאים:
עבור חשבונות מסחר מחוברים נשמרים גם פרטי הגישה לברוקר (מוצפנים במנוחה באמצעות AES-256-GCM), ונתוני המסחר שה‑API מאחזר מעובדים בשמכם. נתוני הלקוחות ושרתי ה‑API ממוקמים באיחוד האירופי (פינלנד וגרמניה). מושבים באירוח פרטי פועלים באזור שתבחרו.
למידע המלא קראו את מדיניות הפרטיות.
הסיבות הנפוצות לכשל בחיבור:
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).