# Mappings und Instrumentenlisten

Die effektive Verwaltung Ihrer Instrumente ist entscheidend für ein reibungsloses **Trading-Erlebnis** in **AgenaTrader**. Der Bereich **Mappings und Instrumentenlisten** hilft Ihnen, Ihre **Instrumentendatenbank präzise und aktuell zu halten**, sodass Sie stets Zugriff auf die neuesten Marktdaten haben.

## Einführung <a href="#introduction" id="introduction"></a>

### Was sind Instrumenten-Mappings?

Instrumenten-Mappings ermöglichen es **AgenaTrader**, **finanzielle Instrumente korrekt zu interpretieren und mit verschiedenen Brokern sowie Datenfeeds abzugleichen**. Jeder Anbieter verwendet sein eigenes Symbolformat – **Mappings sorgen für eine nahtlose Integration**, indem sie die richtigen Symbole mit den passenden Instrumenten in der Plattform verknüpfen.

Dank dieser Zuordnung können Sie:\
✅ **Historische Daten abrufen**\
✅ **Trades platzieren**\
✅ **Märkte analysieren, ohne Datenfehler oder fehlende Kursinformationen**

### **Was Sie in diesem Abschnitt lernen werden:**

🔹 **Zugriff und Navigation im Instrumenteneditor**, um Ihre Instrumentendaten zu verwalten.\
🔹 **Import und Export von Symbol-Mappings**, um Ihre Handelsinstrumente mit verschiedenen Brokern und Datenfeeds abzugleichen.\
🔹 **Manuelle Verwaltung und Aktualisierung von Instrumentenlisten**, basierend auf Markt- und Asset-Klassen-Präferenzen.\
🔹 **Einfache und erweiterte Importoptionen nutzen**, um Ihre Handelsumgebung optimal anzupassen.

## **Automatische Mapping-Updates**

Um sicherzustellen, dass Ihre Instrumentendaten **immer aktuell und korrekt** sind, verfügt AgenaTrader über **ein automatisches Mapping-Update-System**.

📌 **Wie funktioniert es?**

* Sobald auf unserem Mapping-Server **eine Änderung erkannt wird**, startet das System **automatisch einen Import der aktualisierten Mappings**.
* **Ein Pop-up-Fenster erscheint**, das Sie über die Änderungen informiert und auffordert, das Update durchzuführen.

💡 **Warum ist das wichtig?**

* Durch dieses **automatisierte Verfahren** bleibt Ihre Mapping-Datenbank immer aktuell.
* So wird ein **reibungsloser Handel** gewährleistet.
* Wir empfehlen, das Update **immer durchzuführen** und es nicht abzubrechen, um Probleme mit **veralteten oder falschen Instrumenten-Mappings** zu vermeiden.

Mit **aktuellen Mappings** handeln Sie **zuverlässiger** und sind immer mit den neuesten Kursdaten Ihrer **Broker und Datenfeed-Anbieter** synchronisiert.

## Manual Mapping Update

#### **Manuelles Mapping-Update**

Falls Sie ein **automatisches Mapping-Update übersprungen haben** oder sicherstellen möchten, dass Ihre Mappings **auf dem neuesten Stand** sind, können Sie diese jederzeit **manuell aktualisieren**.

📌 **Vorteile eines manuellen Updates:**\
✅ **Stellt sicher, dass alle erforderlichen Mappings importiert wurden**\
✅ **Vermeidet potenzielle Probleme mit veralteten Marktdaten und Orderausführungen**

#### **So führen Sie ein manuelles Mapping-Update durch:**

1️⃣ Öffnen Sie das **Instrumente-Fenster**:

* **Navigieren Sie zu:**\
  **Tools → Einstellungen → Instrument Manager**
* Oder klicken Sie auf das <img src="https://docs.agenatrader.com/~gitbook/image?url=https%3A%2F%2F2805764894-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MKZSsJBtSP9L4sqIe_q-887967055%252Fuploads%252FzF1QgVHIg606KOmO6bMC%252Fimage.png%3Falt%3Dmedia%26token%3Da335861a-d3eb-46e3-95be-c1406fcd5225&#x26;width=46&#x26;dpr=4&#x26;quality=100&#x26;sign=3a187de1&#x26;sv=2" alt="" data-size="line">**Instrumenteneditor-Symbol** in der Toolbar.

2️⃣ Klicken Sie im **Instrumente-Fenster** auf die Schaltfläche **Import/Export**.

3️⃣ Wählen Sie **Markets+Mappings**, um die neuesten Symbol-Mappings **manuell zu importieren**.

<figure><img src="https://3144372521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa4XcirxfoT8EL500asEN%2Fuploads%2FTdyQQyVGkp2NOJCbHJ3C%2Fimage.png?alt=media&#x26;token=0e4314b0-0df8-4d6d-b355-9705b77d32f4" alt=""><figcaption></figcaption></figure>

✅ Durch regelmäßige **manuelle Updates** vermeiden Sie **Datenfehler** und stellen sicher, dass Ihr Trading **unter optimalen Bedingungen** abläuft.

### **Simple View** <a href="#simple_view" id="simple_view"></a>

Die einfache Ansicht dieses Dialogs erlaubt es einen Broker und Datenfeed zu selektieren und alle zu Verfügung gestellten Finanzmarkt Symbole und Mappings zu importieren. Die durchschnittliche Wartezeit beträgt ca. 30 Sekunden, die der Import pro Broker und Datenfeed in Anspruch nimmt. Wie lange benötigen Sie mit Ihrer 3rd Party Trading Software, um z.B. eine Russel 2000 Liste zu erstellen und alle Instrument Daten einzupflegen? Mit AgenaTrader können Sie sofort nach dem Import Daten anzeigen lassen und Trades übermitteln. Und das in weniger als einer Minute.

<figure><img src="https://3144372521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa4XcirxfoT8EL500asEN%2Fuploads%2FznMkdBvxLAi04aA2phKd%2F%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%BD%D1%8F.png?alt=media&#x26;token=3d627673-118e-4bae-b72f-1a879b097d29" alt=""><figcaption></figcaption></figure>

### **Advanced View** <a href="#advanced_view" id="advanced_view"></a>

Advanced Mode es zu, nur spezifische Daten zu importieren. Filtern Sie zwischen Type: Currency, Future, Stock und Index und im Weiteren nach der Börse: Nasdaq, Nyse, Xetra und vielen weiteren. Damit müssen Sie immer nur jene Daten speichern die Sie wirklich benötigen.

<figure><img src="https://3144372521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa4XcirxfoT8EL500asEN%2Fuploads%2Fe5N1hydoeNMPoo5ti16o%2F%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%BD%D1%8F.png?alt=media&#x26;token=69551367-6ebc-42f2-b0f4-f9eab3b71d60" alt=""><figcaption></figcaption></figure>

**Verbindungen hinzufügen:** Erlaubt das hinzufügen oder bearbeiten. Details der Seite Kontoverbindungen: Verbindung erstellen oder ändern.

**Kategorie:** Nur für TaiPan verfügbar. Erlaubt das Importieren von Mappings von verschiedenen Quellen.

**Generate Instrument Lists:** Die Funktion Instrument Listen genieren erlaubt es, gleichzeitig mit dem Import von Daten, Listen zu genieren, welche per Asset Klasse (Type) und Börse angelegt werden.

**Beispiel:** Wenn Sie Mappings für Instrument Daten von der Börse Xetra and Eurex importieren und "Per Instrument Type generieren" auswählen, dann erhalten Sie Instrument Listen welche nach Asset Klassen aufgeteilt werden für alle Xetra Werte die zum Import zu Verfügung stehen. Die zweite Funktion "Nach Type & Börse" teilt alle Werte zusätzlich auf unterschiedliche Börsen auf, sofern mehr als eine Börse für den Import gewählt wurde."

## **Instrumentenlisten**

📌 **Funktionen:**\
✔ **Umfangreiche, vorgefertigte statische Listen** – sowohl **allgemeine als auch broker-spezifische Listen**.\
✔ **Automatische Aktualisierung über den AgenaTrader-Server**.\
✔ **Option zur Deaktivierung der automatischen Updates** in den **Einstellungen (Preferences)**.

<figure><img src="https://3144372521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa4XcirxfoT8EL500asEN%2Fuploads%2Fsdbk8LUP6sD5B2SUTptI%2F%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%BD%D1%8F.png?alt=media&#x26;token=f12f22cb-67cd-4dcd-be36-9be62c71b518" alt=""><figcaption></figcaption></figure>

📌 **Instrumentenlisten (Broker)**

* Zeigt **broker-spezifische Instrumentenlisten** an.

<figure><img src="https://3144372521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa4XcirxfoT8EL500asEN%2Fuploads%2FP7BUxn5sE0BHMaZE4AQF%2Fimage.png?alt=media&#x26;token=7157cf4b-eba7-4286-b513-d249754f17cd" alt=""><figcaption></figcaption></figure>

📌 **Hinweis:**

* Ein **Instrument erscheint erst in den Listen**, wenn **alle erforderlichen Mappings importiert wurden**.
* Falls **Mappings fehlen**, wird ein **Pop-up mit der Liste der nicht importierten Symbole** angezeigt.

Diese Funktionen helfen Ihnen, Ihre **Instrumentendaten effizient zu verwalten** und **optimale Handelsbedingungen** sicherzustellen. 🚀

**Sie können erst Instrumenten Listen importieren wenn Sie zuvor die notwendigen Mappings importiert haben.** Sonst erhalten Sie diesen Fehler:

<figure><img src="https://docs.agenatrader.com/~gitbook/image?url=https%3A%2F%2F1347375179-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-legacy-files%2Fo%2Fassets%252F-MKZSsJBtSP9L4sqIe_q%252F-MPEfeztlpcHzJaMeRin%252F-MPEkCZ_7xxi9I-B53Ez%252FInstrument_escort_coundnot_import.png%3Falt%3Dmedia%26token%3Dc99d928e-a013-4a5e-aa16-a1e49badc851&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=374db342&#x26;sv=1" alt=""><figcaption></figcaption></figure>

Zusätzlich steht Ihnen ein **Löschen**-Button zu Verfügung, welcher das Löschen von ganzen Märkten ermöglicht. Sie können wählen ob Sie nur das Mapping zu dem jeweiligen Broker löschen wollen oder auch gleich die enthaltenen Instrumente. Wenn Sie den Markt gelöscht haben, wird die Schrift wieder „regulär“ dargestellt. Dies gilt auch für die InstrumentListen.