Pillinger Works

MetaTrader 5

Szinkronizálása a Pillinger Kereskedőnaplóval

A Pillinger MT5 Sync Agent segítségével összekapcsolhatod a MetaTrader 5 kereskedési számládat a Pillinger Kereskedőnaplóval. A kapcsolat létrehozása után az Expert Advisor automatikusan szinkronizálja a támogatott kereskedési adatokat a naplóddal, így nem kell minden ügyletet kézzel rögzítened.

Az útmutató végigvezet a telepítésen, a kapcsolati kulcs beállításán és a szinkronizáció ellenőrzésén.

1. Töltsd le a Pillinger MT5 Sync Agentet

  1. Jelentkezz be a Pillinger Works felületére.
  2. Nyisd meg a Kereskedőnapló → Beállítások menüpontot.
  3. Keresd meg az Adatimport / Szinkronizáció részt.
  4. Válaszd ki adatforrásként a MetaTrader 5 — API lehetőséget, majd válaszd ki a megfelelő Pillinger-számlát.
  5. Az MT5 beállítás → MT5 Expert Advisor letöltése résznél töltsd le a Pillinger_MT5_Sync_Agent.mq5 fájlt.

Erre a fájlra a további telepítési lépésekhez szükséged lesz.

2. Telepítsd az Expert Advisort a MetaTrader 5-be

  1. Indítsd el a MetaTrader 5 alkalmazást, és jelentkezz be arra a kereskedési számlára, amelyet szinkronizálni szeretnél.
  2. A MetaTrader 5-ben nyisd meg a File → Open Data Folder menüpontot. A menüpont neve a felület nyelvétől függően eltérhet.
  3. A megnyíló adatkönyvtárban nyisd meg az MQL5, majd azon belül az Experts mappát.
  4. Másold a letöltött Pillinger_MT5_Sync_Agent.mq5 fájlt az Experts mappába.
  5. Térj vissza a MetaTrader 5-be, és nyisd meg a MetaEditort az F4 billentyűvel. Ha a billentyűparancs nem működik, használd a megfelelő menüpontot.
  6. A MetaEditor bal oldalán, a Navigator panelen keresd meg az MQL5 → Experts mappát, majd nyisd meg a Pillinger_MT5_Sync_Agent.mq5 fájlt.
  7. Nyomd meg az F7 billentyűt a fordításhoz (Compile).
  8. Ellenőrizd, hogy a fordítás hibamentesen befejeződött-e. A sikeres fordítás létrehozza a használathoz szükséges .ex5 fájlt.

Fontos: a .mq5 fájl a forráskód, amelyet a MetaEditor fordít le. Nem elegendő pusztán letölteni vagy bemásolni a fájlt: a kapcsolati kulcs beállítása után ismét le kell fordítani.

Windows és macOS alatt is a MetaTrader 5 saját adatkönyvtárát használd. macOS-en a MetaTrader 5 a Wine-alapú környezetén keresztül működhet, ezért a fájlok helye eltérhet a megszokott macOS-mappáktól. Ne egy tetszőleges MQL5mappába másolj: mindig az alkalmazásból megnyitott adatkönyvtárat használd.

Ha nehézségekbe ütköztél MacOS használóként a szükséges fájlmappa megtalálásánál: 

Nyisd meg a megfelelő mappát

  1. Nyisd meg a Findert
  2. Nyomd meg ezt a billentyűkombinációt ⌘ Command + ⇧ Shift + G
  3. Megjelenik az általad keresett útvonalbeíró mező: „Ugrás a mappához”
  4. Másold be ezt az útvonalat a MetaTrader 5 – MQL5 Experts mappához:

    ~/Library/Application Support/net.metaquotes.wine.metatrader5/drive_c/Program Files/MetaTrader 5/MQL5/Experts/

Ez egy gyakori MT5-útvonal macOS-en, de a telepítés módjától és a brókered MT5-változatától függően eltérhet. Ide kell bemásolni az .mt5 fájlt

3. Engedélyezd a WebRequest-kapcsolatot

A szinkronizációhoz engedélyezned kell, hogy az Expert Advisor kapcsolatot létesíthessen a Pillinger szerverével.

  1. A MetaTrader 5-ben nyisd meg a Tools → Options → Expert Advisors menüpontot.
  2. Kapcsold be az Allow WebRequest for listed URL beállítást.
  3. Add hozzá az alábbi címet az engedélyezett URL-ek listájához:https://pillingerworks.com
  4. Mentsd a beállításokat az OK gombbal.

Ügyelj arra, hogy a cím pontosan így szerepeljen a listában. A WebRequest engedélyezése nélkül az Expert Advisor nem tud kommunikálni a Pillinger szerverével.

4. Generáld le a kapcsolati kulcsot

  1. Térj vissza a Pillinger Kereskedőnapló Beállítások → Adatimport / Szinkronizáció részéhez.
  2. Ellenőrizd, hogy a megfelelő Pillinger-számla van kiválasztva.
  3. Kattints az MT5 kapcsolati kulcs generálása gombra.
  4. Másold ki a megjelenő kapcsolati kulcsot.

A kulcs a kiválasztott Pillinger-számlához tartozik. Ha új kulcsot generálsz, a korábbi kulcs azonnal érvénytelenné válik.

5. Illeszd be a kapcsolati kulcsot a forráskódba

Ez a telepítés egyik legfontosabb lépése. A kapcsolati kulcsot nem külön fájlként kell importálnod: a MetaEditorban kell beillesztened az Expert Advisor forráskódjába.

  1. A MetaEditorban nyisd meg a Pillinger_MT5_Sync_Agent.mq5 fájlt.
  2. Keresd meg az alábbi sort:input string InpSyncKey = "Ide kerül a kulcs";
  3. Töröld az idézőjelek között található helyőrző szöveget.
  4. Illeszd be a Pillinger felületén generált kulcsot az idézőjelek közé. A sor formája például:input string InpSyncKey = "A_SAJÁT_KAPCSOLATI_KULCSOD";
  5. Ügyelj arra, hogy a kulcs az idézőjelek között maradjon, és ne töröld le az idézőjeleket vagy a sor végén található pontosvesszőt.
  6. Mentsd el a fájlt.
  7. Nyomd meg az F7 billentyűt, és fordítsd le újra a forráskódot.
  8. Ellenőrizd, hogy a fordítás sikeres volt-e.

Biztonság: a kapcsolati kulcsot kezeld bizalmas adatként. Ne oszd meg másokkal, és ne publikáld a forrásfájlt a saját kulcsoddal együtt. Ha új kulcsot generálsz a Pillingerben, az új kulcsot a forráskódban is cserélned kell, majd újra kell fordítanod a fájlt.

6. Indítsd el az Expert Advisort

  1. Térj vissza a MetaTrader 5 főablakába.
  2. A Navigator panelen keresd meg az Expert Advisors részt.
  3. Ha a Pillinger MT5 Sync Agent nem látható, frissítsd a listát, vagy indítsd újra a MetaTrader 5-öt.
  4. Húzd a Pillinger_MT5_Sync_Agent Expert Advisort arra a grafikonra, amelyen futtatni szeretnéd.
  5. Ellenőrizd a megjelenő beállításokat, majd engedélyezd az Expert Advisor futását, ha a terminál ezt kéri.
  6. Győződj meg arról, hogy a MetaTrader 5-ben az Expert Advisorok futtatása engedélyezett.

A szinkronizációhoz nem szükséges új ügyletet nyitnod. Az Expert Advisor a támogatott kereskedési adatokat olvassa és továbbítja; nem kereskedési robot, és nem az a feladata, hogy megbízásokat nyisson vagy zárjon.

7. Ellenőrizd a szinkronizációt

Miután az Expert Advisor elindult:

  • Hagyd futni a MetaTrader 5 alkalmazást, és biztosíts aktív internetkapcsolatot.
  • A MetaTrader 5-ben ellenőrizd az Experts és Journal naplókat, ha hibát vagy figyelmeztetést látsz.
  • Nyisd meg a Pillinger Kereskedőnaplót, és ellenőrizd az utolsó sikeres szinkronizálás időpontját.
  • Nézd meg, hogy a szinkronizált kereskedési adatok megjelennek-e a megfelelő naplóban.

A szinkronizáció beállított időközönként fut. Az alapértelmezett időköz 300 másodperc, vagyis 5 perc. Emiatt az új adatok megjelenése nem feltétlenül azonnali.

8. Fontos tudnivalók

A MetaTrader 5-nek futnia kell. Ha bezárod a terminált vagy a számítógép alvó állapotba kerül, a helyben futó Expert Advisor nem tud tovább szinkronizálni.

A megfelelő számlát válaszd ki. Ellenőrizd a MetaTrader 5-ben aktív kereskedési számlát, valamint a Pillingerben kiválasztott számlát is.

A WebRequest engedélyezése kötelező. Ha a kapcsolat nem működik, ellenőrizd, hogy a https://pillingerworks.comcím szerepel-e az engedélyezett URL-ek között.

A kapcsolati kulcs számlához kötött. A kulcs újragenerálása érvényteleníti a korábbit. Ilyenkor frissítsd a forráskódot, mentsd el, majd fordítsd le újra.

A szinkronizáció nem feltétlenül azonnali. Várd meg a következő szinkronizációs ciklust, és ellenőrizd az utolsó sikeres szinkronizálás időpontját.

A szinkronizáció olvasási célú. Az Expert Advisor a támogatott számlaadatokat, ügyletelőzményeket és pozíciókat kezeli. Nem nyit és nem zár kereskedési megbízásokat.

9. Hibaelhárítás

Nem jelenik meg az Expert Advisor a Navigatorban

  • Ellenőrizd, hogy a fájl a megfelelő MQL5/Experts mappába került-e.
  • Nyisd meg a MetaEditorban, és ellenőrizd a fordítás eredményét.
  • Frissítsd az Expert Advisors listát, vagy indítsd újra a terminált.

A fordítás hibát jelez

  • Ellenőrizd, hogy a megfelelő Pillinger_MT5_Sync_Agent.mq5 fájlt szerkeszted-e.
  • Ellenőrizd, hogy a kapcsolati kulcsot az idézőjelek közé illesztetted-e be.
  • Ne módosítsd a kód más részeit, ha erre nincs szükség.

Az Expert Advisor fut, de nem történik szinkronizáció

  • Ellenőrizd az internetkapcsolatot.
  • Ellenőrizd a WebRequest engedélyezését.
  • Ellenőrizd, hogy a kapcsolati kulcs érvényes-e, és a megfelelő Pillinger-számlához tartozik-e.
  • Nézd meg az MT5 Experts és Journal naplóit.
  • Ellenőrizd a Pillinger Kereskedőnaplóban az utolsó sikeres szinkronizálás időpontját.

Ha a probléma továbbra is fennáll, jegyezd fel a hibaüzenetet és a használt MetaTrader 5-verziót, majd fordulj a Pillinger Works támogatásához.

KÉRJÜK MÁST AZ .mt5 FÁJLBAN NE ÍRJ ÁT, CSAK A GENERÁLT KULCSODAT ÍRD BE A MEGFELELŐ HELYRE, KÜLÖNBEN NEM TUDJUK GARANTÁLNI A MEGFELELŐ MŰKÖDÉST.