# Instrument Editor

## Instrument-Editor

#### Das InstrumentEditor-Fenster <a href="#das_instrumentescort-fenster" id="das_instrumentescort-fenster"></a>

Der Instrument-Editor ist das Werkzeug um Instrumente und Instrumentlisten zu verwalten. Um Daten für Instrumente empfangen bzw. um mit Instrumenten handeln zu können müssen sie im Instrument-Editor erfasst sein.

Der Instrument-Editor wird benötigt:

* zum Bearbeiten und auch
* zum Auswählen von Instrumenten und Instrumentlisten.

*Öffnen Sie das InstrumentEditor-Fenster wie folgt:*

1. Klicken Sie in der Hauptmenüleiste auf **Tools** und wählen dort **Instrument-Editor** aus oder
2. Klicken Sie mit der linken Maustaste auf das Symbol <img src="/files/akefocuVvnNKdu0Cimsl" alt="" data-size="line"> in dem Applikations-Toolbar.

*Der Instrument-Editor besteht aus folgenden Teilen:*

* **Symbol/Namen/ISIN Suche:**
  * Instrumente können nach ihrer Symbol-Bezeichnung (GOOG), nach ihrem Lang-Namen (Google Inc.) oder nach ihrer ISIN-Nummer (US38259P5089) gesucht werden
  * Mit einem Doppelklick in der Resultat-Liste erfolgt eine Auswahl des Wertes.
  * Unter "Typ" können Sie die gewünschte Asset-Klasse auswählen, unter "Börse" den gewünschten Handelsplatz.
* **AuswahlListen-Baum:**
  * Über den AuswahlListen-Baum können einzelne Werte bzw. Listen für weitere Verarbeitungen ausgewählt werden.
* **Details-Tab:**
  * Im Details-Tab können neue Instrumente erfasst bzw. bestehende verändert werden.
* **Instrument-Listen-Tab:**
  * Damit können Instrument-Listen angelegt bzw. verwaltet werden.

<figure><img src="/files/2Tt3iPWZWbZcrRyYF2fc" alt=""><figcaption></figcaption></figure>

**Hinweis:** Fraktale sind nur für Futures verfügbar. Die entsprechende Anzeige ist standardmäßig im rechten Bereich des InstrumentEditor-Fensters sichtbar, verschwindet jedoch, nachdem man ein Instrument einer anderen Assetklasse ausgewählt hat.

**Static Lists, Dynamic Lists und Screener Presets**

<figure><img src="/files/DeOzNVsk6KKj1y4GUR5V" alt=""><figcaption></figcaption></figure>

*Im Instrument-Editor gibt es drei Arten von Listen:*

* Static Lists: das sind Listen welche vom Benutzer selbst erstellt werden. Im **Allgemeine Einstellungen** kann man festlegen ob man die [Chartgruppen mit der stat. Instrumenten Liste verlinken](https://docs.agenatrader.com/v/german/menue-erklaerungen-and-inhalt/tool-menue/konfigurations-escort#chart) möchte. Dh. ändern Sie einen Wert in der LCG/TCG ändert sich auch automatisch Ihre Static List und umgekehrt.
* Dynamic Lists: das sind vordefinierte Listen, deren Inhalt automatisch (bei bestehender Internetanbindung) aktualisiert wird.
* Screener Presets: das sind Listen, welche aufgrund eines Scan-Vorgangs (ebenfalls bei bestehender Internetanbindung) automatisch aktualisiert werden. Diese Listen werden durch den **Aktien EOD Screener** erstellt.

*Das Kontextmenü im AuswahlListen-Baum bietet folgende Optionen:*

* Checkboxes zurücksetzen: löscht alle Checkbox-Markierungen.
* Neu laden: macht einen Reload des **Instrument-Editors** das ist z.B. notwendig, wenn man gerade ein neues Instrument eingefügt hat.

<figure><img src="/files/vFGwthJunHE4qAxsrcOl" alt=""><figcaption></figcaption></figure>

### **Vom Chart zum Instrument-Editor**

Durch einen links Klick auf den Instrumenten-Namen öffnet sich der **Instrument-Editor**.

<figure><img src="/files/WXTrD5hnYYzqP3Hq4YYi" alt=""><figcaption></figcaption></figure>

**Im Chart ein neues Instrument aufrufen**

*Um ein neues Instrument im Chart aufrufen, folgen Sie die folgenden Schritte:*

1. "Aktivieren" Sie den Chart, indem Sie einen Links-Klick in den Chart tätigen.
2. Danach können Sie einfach beginnen einen Buchstaben über Ihre Tastatur eingeben, wodurch sich das Instrumente-Suchfenster öffnet.
3. Durch anwählen und **Enter**-drücken (oder durch Doppel-klicken) des gesuchten Wertes wird der Chart angezeigt.

<figure><img src="/files/vOSVmtAiX1NkLP6cOuzL" alt=""><figcaption></figcaption></figure>

### **Auswahl von Instrumenten/Instrument-Listen**

Wird der **Instrument-Editor** zur Auswahl von Instrumenten/Listen geöffnet (TickAufzeichnung, ForexPad u.a.) so erscheint nur der Bereich Auswahl-Liste. Über den **Auswahl-Button bzw. mit Doppelklick** kann man einzelne Instrumente bzw. ganze Listen auswählen.

<figure><img src="/files/Uoycjv17brpU9g5FFmmb" alt=""><figcaption></figcaption></figure>

## Import- und Export-Funktionen <a href="#import-und-export-funktionen" id="import-und-export-funktionen"></a>

Über den **Import/Export**-Button können folgende Aktionen ausgeführt werden:

<figure><img src="/files/FLske9YizAGZgXtqR6lb" alt=""><figcaption></figcaption></figure>

*Beschreibung der Funktionen:*

Märkte+Mappings ausw.: siehe mehr dazu in [Instrumente: Märkte und Mappings](https://docs.agenatrader.com/v/german/menue-erklaerungen-and-inhalt/tool-menue/instrumente-maerkte-und-mappings)

* Aus Datei import.: Import von Instrumenten aus einer CSV-Datei.
* Aus Dialog import.: hier können Symbole mit gleichen Kriterien eingefügt werden.

<figure><img src="/files/fV4k8MqCHvgOUo3mrtGt" alt=""><figcaption></figcaption></figure>

* Mappings import.: Import von Mappings aus einer CSV-Datei.
* Instrumentlisten importieren: Import von Instrumenten Listen aus einer CSV-Datei

Der Name des \*.csv-Files wird als Instrumentlisten-Name vorgeschlagen. Ein Import über schreibt keine bestehende Listen, sondern fügt nur Instrumente ein, die im \*.csv-File vorhanden sind, nicht jedoch in der Instrumentliste. Ein Import überschreibt jedoch bestehende Instrumente (Details werden aktualisiert).

* Import aus Instruments DB XML Export Snapshot: erzeugt ein Backup-File von Instrumenten. Siehe mehr dazu in: [Instrument-Editor: Sicherung der Instrument-Datenbank](https://docs.agenatrader.com/v/german/menue-erklaerungen-and-inhalt/tool-menue/instrument-escort/sicherung-der-instrument-datenbank).
* Instrument-Export in eine XML-Datei.

### Import-Formate-Instrument & Mapping <a href="#import-formate-instrument-and-mapping" id="import-formate-instrument-and-mapping"></a>

Hier werden die Formate aufgelistet um den Import von Instrumenten & Mappings aus einer CSV-Datei durchführen zu können.

### Instrumente aus einer CSV-Datei <a href="#instrumente-aus-einer-csv-datei" id="instrumente-aus-einer-csv-datei"></a>

Jedes Instrument welches in AgenaTrader analysiert bzw. gehandelt werden soll muss in AgenaTrader registriert werden. Momentan befinden sich ca. 7000 Instrumente aller Instrumenttypen (Stocks, Futures usw.) in der Datenbank.

#### Instrumente aus einer CSV-Datei <a href="#instrumente-aus-einer-csv-datei" id="instrumente-aus-einer-csv-datei"></a>

Jedes Instrument welches in AgenaTrader analysiert bzw. gehandelt werden soll muss in AgenaTrader registriert werden. Momentan befinden sich ca. 7000 Instrumente aller Instrumenttypen (Stocks, Futures usw.) in der Datenbank.

**Folgende Attribute können in AgenaTrader importiert werden:**&#x20;

\- \<Symbol> - Börsen Ticker Symbol \
\- \<Name> - Name des Instruments \
\- \<Margin> - falls geleveraged so kann hier eine %-Margin eingetragen werden (siehe unten) \
\- \<PointValue> - Wert pro Punkt \
\- \<TickSize> - Tickgröße \
\- \<MainSector> - Sector (bei Aktien) \
\- \<DetailSector> - Industrie (bei Aktien) \
\- \<InstrumentType> - Siehe Auswahlliste von Instrumenten im Details-Tab \
\- \<Exchange> - Siehe Auswahlliste von Börden im Details-Tab \
\- \<ETF> - Exchange Traded Fund: true / false \
\- \<Currency> - siehe Auswahlliste von Währungen im Details-Tab \
\- \<Expiry> - Ablauf des Instruments (bei Futures) - Format: "06.2014" (MM.JJJJ) \
\- \<ISIN> - tbd \
\- \<DefaultOrdersize> - tbd

{% hint style="info" %}

#### **Wichtig!**

Der Wert für **\<TickSize>** wird **nicht überschrieben**, wenn der **native Tick** im **Instrumenten-Manager** bereits auf **„Fixed“** gesetzt wurde.
{% endhint %}

falls die Margin bei unterschiedlichen Broker anders ausfällt, so kann man dass in der **Symbol-Mapping Tabelle** am **Details-Tab** eingeben.

<figure><img src="/files/VtZtlSsIhqxN2bKjbuHC" alt=""><figcaption></figcaption></figure>

*Die Liste bedarf folgender Formatierung (CSV File):*

1. In der ersten Zeile muss der Tag **\<Import Instrumens>** stehen
2. danach gibt es **\<Attributes>** und **\<Instruments>** Zeilen.
3. Die **\<Attributes>** Zeilen bewirken eine Änderung der Attribute für die nachfolgenden **\<Instrument>** Zeilen.
4. Jedoch auch die **\<Instrument>** Zeilen können Attribute beinhalten.

Musterdatei:

|                       |                      |                        |                        |                    |                    |                  |                |                  |
| --------------------- | -------------------- | ---------------------- | ---------------------- | ------------------ | ------------------ | ---------------- | -------------- | ---------------- |
| \<Import instruments> |                      |                        |                        |                    |                    |                  |                |                  |
|                       |                      |                        |                        |                    |                    |                  |                |                  |
| \<Attributes>         | \<Exchange>Nasdaq    | \<Instrumenttype>Stock | \<ETF>false            | \<PointValue>1     | \<TickSize>0,01    | \<Currency>USD   |                |                  |
| \<Instrument>         | \<Symbol>AA          | \<Name>AA Name         | \<Margin>25            | \<MainSector>AAS   | \<DetailSector>ADS | \<Expiry>03.2012 |                |                  |
| \<Instrument>         | \<Symbol>BB          | \<Name>BB Name         | \<Margin>20            | \<MainSector>BBS   | \<DetailSector>BDS | \<Expiry>04.2012 |                |                  |
| ...                   |                      |                        |                        |                    |                    |                  |                |                  |
| \<Attributes>         | \<Exchange>FromYahoo | \<Name>FromYahoo       | \<Instrumenttype>Stock | \<ETF>false        | \<PointValue>1     | \<TickSize>0,01  | \<Currency>USD | \<Expiry>06.2014 |
| \<Instrument>         | \<Symbol>CC          | \<Margin>25            | \<MainSector>CCS       | \<DetailSector>CDS |                    |                  |                |                  |
| \<Instrument>         | \<Symbol>DD          | \<Margin>15            | \<MainSector>DDS       | \<DetailSector>DDS |                    |                  |                |                  |
| ...                   |                      |                        |                        |                    |                    |                  |                |                  |

Beispiel Instruments zum Downloaden finden Sie [hier](https://b2c.agenatrader.com/support-informations/ExportMappings.zip).

**Wenn Sie "FromYahoo" verwenden**: Sehr oft hat man InstrumentListen und weiß deren Basiswährung, InstrumentTypen usw. aber man weiß meist nicht die Haupthandelsbörse bzw. den Namen des Symbols. Dafür gibt es die Möglichkeit, diese Informationen aus dem Internet zu holen: Trägt man bei \<Name>FromYahoo bzw. bei der \<Exchange>FromYahoo ein, so werden diese Informationen über Yahoo geholt.

**ACHTUNG!** Möchte man viele Werte importieren so kann das ziemlich lange dauern: a' 1000 Instrumente ca. 10 Min.

### Instrumenten Listen aus einer CSV-Datei <a href="#instrumenten-listen-aus-einer-csv-datei" id="instrumenten-listen-aus-einer-csv-datei"></a>

Es ist zwischen dem Import von Instrumenten und InstrumentList zu unterscheiden. Instrumentlisten sind Listen von Symbolen die für einen bestimmten Zweck zusammengstellt werden: z.B. LongLists/ShortLists usw. **Wenn so eine Liste importiert wird so müssen die Symbole bereits in AgenaTrader registriert sein.**

*Der Aufbau so einer Liste muss folgendermaßen aussehen:*

1. die erste Zeile benötigt den Tag **\<Import Instrument list>**
2. danach sind alle Symbole gelistet die zu dieser Liste gehören.

Musterdatei:

| \<Import Instrumentlist> |
| ------------------------ |
| А                        |
| АА                       |
| AAPL                     |
| ABC                      |
| 2323                     |
| 3343                     |

Werden Symbole nicht erkannt, so werden diese nach erfolgtem Import in einem Popup ausgegeben:

<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-MPE3XYPZiq_RM5wlkeu%252F-MPEAbuThHswdVQC1__7%252FInstrument_escort_cannotimport.png%3Falt%3Dmedia%26token%3D610fee8f-e4c0-497a-8e94-471412f578ca&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=6e623349&#x26;sv=1" alt=""><figcaption></figcaption></figure>

Beispiel InstrumentList zum Downloaden finden Sie [hier](https://agenatrader.com/support-informations/ExportMappings.zip).

Zu diesem Thema gibt es auch einen hilfreichen [Post im Forum](https://tradersyard.com/forums).

### Mappings aus einer CSV-Datei <a href="#mappings-aus-einer-csv-datei" id="mappings-aus-einer-csv-datei"></a>

Ein Beispiel des Formats für den Import von Mappings aus einer CSV-Datei sieht folgendermaßen aus:

| \<InstrumentMapping>  |               |                 |                           |
| --------------------- | ------------- | --------------- | ------------------------- |
| \<Provider>BarChart   |               |                 |                           |
| \<mappedSymbol>AUDCAD | \<Name>AUDCAD | \<Symbol>AUDCAD | \<Instrumenttype>Currency |
| \<mappedSymbol>AUDCHF | \<Name>AUDCHF | \<Symbol>AUDCHF | \<Instrumenttype>Currency |
| \<mappedSymbol>AUDJPY | \<Name>AUDJPY | \<Symbol>AUDJPY | \<Instrumenttype>Currency |

Beispiel Mappings zum Downloaden finden Sie [hier](https://agenatrader.com/support-informations/ExportMappings.zip)

## Neuanlage und Bearbeitung von Instrumenten <a href="#neuanlage-und-bearbeitung-von-instrumenten" id="neuanlage-und-bearbeitung-von-instrumenten"></a>

AgenaTrader wird mit einer großen Anzahl von bereits erfassten Instrumenten ausgeliefert. Sollten Instrumente fehlen, so können sie folgendermaßen angelegt werden.

Wählen Sie ein Instrument des selben Instrumenttyps (Stock, Future usw.).

<figure><img src="/files/5fhsyotSaeWm5yfQMYoE" alt=""><figcaption></figcaption></figure>

Meist genügt dann:

1. Das Eintragen des **Symbol**s, des **Namens** des Instruments oder ihrer **ISIN-Nummer**.
2. Auswahl der **Börse**:
   1. Die richtige Börse ist sehr wichtig, da aufgrund der Börse die Handelszeiten des Marktplatzes festgestellt werden (**Marktplatz-Escort** und Reiter[ **Handelszeiten**](https://docs.agenatrader.com/v/german/menue-erklaerungen-and-inhalt/tool-menue/konfigurations-escort#Handelszeiten)) und danach die Charts ausgerichtet werden.
3. **Def. Ordersize** anpassen (ein Wert größer 0 ersetzt die Einstellungen der Default Ordersize im [**Allgemeine Einstellungen**](https://docs.agenatrader.com/v/german/menue-erklaerungen-and-inhalt/tool-menue/konfigurations-escort/at-plus-plus#order-rundung)).
4. Anpassen der Mappings, unter **MappedSymbol**, für das neue Instrument

<figure><img src="/files/GjCIKrVv9nkoUzDeRUvI" alt=""><figcaption></figcaption></figure>

Weitere Felder:

* **InstrumentTyp**: ermöglichst ein InstrumentTyp aus der Liste auswählen:

<figure><img src="/files/gwKJfpNikjdVDZXQOCJY" alt=""><figcaption></figcaption></figure>

* **Währung**: dabei handelt es sich um die Währung in welcher das Instrument gehandelt wird. Diese Währung wird als Basis für Währungsumrechnungen Instrument/Konto bzw. Instrument/P\&L-Display verwendet.

<figure><img src="/files/CS6OAJDi1TqlRl2O2kyH" alt=""><figcaption></figcaption></figure>

* **Marge** (Sicherheit.%): Dieser Wert muss bei gehebelten Produkten eingegeben werden und gibt die allgemeine Marge für dieses Instrument an. Ist die Marge jedoch von Broker zu Broker unterschiedlich, so wird dies in der Broker-Spezifika Liste (in dem **InstrumentEditor-Fenster** und **Details-Reiter**).
* **Tickgröße** und **Punktwert**: sind für diverse Berechnungen notwendig z.b. StopBerechnung, P\&L-Berechnung usw.
* Wird ein **Haupt Sector** bzw. eine **Ind. Sparte** eingegeben, so wird das Instrument bei Auswahl eines Sektors oder einer Sparte im **Instrument-Editor** Auswahllistenbaum mitangezeigt.

Über **Hinzufügen/Speichern** wird das Instrument im System registriert bzw. ein registriertes verändert. **Hinzufügen/Speichern** mit unverändertem Symbol ändert die Werte des bestehendes Symbols.

### Brokerspezifische Informationen <a href="#brokerspezifische-informationen" id="brokerspezifische-informationen"></a>

Unterschiedliche Broker bzw. DatenFeed-Anbieter haben teils unterschiedliche Symbolbezeichnungen, können aber z.B. bei gehebelten Instrumenten auch unterschiedliche Margen zur Verfügung stellen.

Solche Broker/Datafeed Spezifika werden in der Liste unter den Details eingetragen.

<figure><img src="/files/1sGCxdAhgmAgxP7aWZBR" alt=""><figcaption></figcaption></figure>

| Name                  | Meaning                                                                                                                                                 |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Anbieter              | Name des Broker- oder Daten-Feed-Anbieters                                                                                                              |
| Symbol                | Mapping für jedes Daten-Feed oder Broker-Symbol                                                                                                         |
| Contr.                | Kontrakt für das Future-Symbol des Brokers                                                                                                              |
| Komm.                 | Kommission                                                                                                                                              |
| Margin                | Broker's Margin zum Kauf von Wertpapieren                                                                                                               |
| Min Quantität         | Minimum Ordergröße. Aktiv, wenn AT diese Information nicht von der Broker-API erhält.                                                                   |
| Max Quantität         | Maximum Ordergröße. Aktiv, wenn AT diese Information nicht von der Broker-API erhält.                                                                   |
| Min Quantitätsschritt | Minimum Ordergröße in Schritten. Meint, wie oft der Trader die Ordergröße ändern kann. Aktiv, wenn AT diese Information nicht von der Broker-API erhält |
| Stop-Distanz          | Mindest-Abstand zu Stop-Orders, die erreicht werden sollen                                                                                              |
| Punktwert             | Broker-abhängiger Punktwert                                                                                                                             |
| Price Multiplier      | Einige Broker-Plattformen nutzen diesen Multiplikator, um den Preis eines Symbols zu berechnen.                                                         |

D.h. die Symbolbezeichnung die in den Details eingetragen ist, ist vorerst eine AgenaTrader interne Bezeichnung. Sie kann aber auch die Bezeichnung des einen oder anderen Brokers sein, sodass diese Zuordnung nicht stattfinden muss. Z.b. wird die Bezeichnung AAPL (Aktie von Apple Inc.) von den meisten Brokern genau so verwendet und benötigt daher keine zusätzliche Zuordnung in dieser Liste. Unterschiedliche Bezeichnungen existieren hauptsächlich im Bereich Forex und Futures.

<figure><img src="/files/hPnyHvBc3ta4bsmOz243" alt=""><figcaption></figcaption></figure>

### Beispiel <a href="#beispiel" id="beispiel"></a>

#### IB <a href="#ib" id="ib"></a>

*Anpassung der Tickgröße für CFDs entsprechend dem aktuellen Preis*

Bitte beachten Sie, dass Interactive Brokers verschiedene TickGrößen nach einer bestimmten PreisRange verwendet. Es könnte passieren, dass beim Handel von einigen europäischen CFDs der Benutzer die folgenden Fehlermeldungen bekommt: 1. "The price does not conform to the minimum price variation for the contract". 2. "Instrument Tick-Size is not calculated or delivered yet".

In so einem Fall ist es erforderlich, die Tick-Größe für das Instrument manuell einzustellen. Durch die Eingabe eines Ticker-Namen auf der [IB's website](https://www.interactivebrokers.com/en/?f=/en/general/contact/tipsContractsDatabaseSearch.php?ib_entity=llc) ist es möglich, die Preisparameter für das gewählte Instrument zu sehen.

<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-MPE3XYPZiq_RM5wlkeu%252F-MPEBNn-rl12kq3gFYT4%252FZurn%2520IB.png%3Falt%3Dmedia%26token%3D9849ce3a-0900-4155-992c-3deadce312a9&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=9b5041a7&#x26;sv=1" alt=""><figcaption></figcaption></figure>

Bitte geben Sie die richtige Tick-Größe in das Instruments-Fenster laut dem aktuellen Preis ein und markieren Sie die Pin Tick Größe-Checkbox wie auf dem Bild unten dargestellt:

<figure><img src="/files/BGNJwDbtetsgCzguMoAq" alt=""><figcaption></figcaption></figure>

## Neuanlage und Verwaltung von Instrumentlisten

### Instrumentlist anlegen <a href="#instrumentlist-anlegen" id="instrumentlist-anlegen"></a>

Über den **Instrument-Editor** im Reiter **Instrument Listen** kann man eine neue Instrumentliste anlegen oder verwalten.

*Um eine neue Instrumentliste anzulegen, beachten Sie folgende Schritte:*

1. Geben Sie einen Namen für die Instrumentliste ein.
2. Erstellen Sie die neue Liste mit einer der Methoden:

* **manuelle Eingabe im "Symbol-Feld"**

<figure><img src="/files/rsLCi7P0N7s410iPXW3e" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Hinweis**. Sie können auch keine Symbole/Instrumente in die Liste einfügen um eine leere Liste zu erzeugen. Eine leere Liste können Sie jedoch nur als LCG (ListChartGruppe) verwenden.
{% endhint %}

* **Drag and Drop:**
  * aus der Instrumenten-Suche bzw.
  * aus dem Listenauswahl-Baum:
    * Einzelwerte
    * Instrumentlisten.

Hier können mit einem Einfach- bzw. Doppelklick in die jeweilige Checkbox Instrumente oder Instrumentlisten ausgewählt werden und mit einem Zug in die neue Instrumentliste gezogen werden

<figure><img src="/files/1sFLKIaEIAWIgKPJyQ7A" alt=""><figcaption></figcaption></figure>

3\. **Speichern** fügt die neue Liste in den Listenauswahl-Baum ein. Ab diesem Zeitpunkt steht diese Liste für weitere Verarbeitungen unter den statischen Listen (Static Lists) in AgenaTrader zur Verfügung.

<figure><img src="/files/3JzqwFjxOl5V1u3UjqXq" alt=""><figcaption></figcaption></figure>

Möchte man eine neue Liste erstellen (z.b. aus dem [Scanner](https://docs.agenatrader.com/v/german/menue-erklaerungen-and-inhalt/hauptmenue/realtime-scanner)), so ist der InstrumentList-Name mit \<New List> vorinitialilsiert bzw. leer. In diesen beiden Zuständen kann die Instrumentliste nicht gespeichert werden. Wird ein bestehender Name ausgewählt, so wird diese Instrumentliste überschrieben.

Weitere Funktionen:

<figure><img src="/files/uiaJu0IzkNpuiFypTZLS" alt=""><figcaption></figcaption></figure>

* Delete All: löscht entweder alle ausgewählten Instrumente oder alle Listen und die darin enthaltenen Instrumente komplett aus dem Instrument-Editor. Mit Klick auf den Pfeil neben "Delete All" öffnet sich ein Dropdownmenü, in dem Sie zwischen "Instrumente" und "InstrumentListen" wählen können. Sie müssen diesen Befehl anschließend in einem Popup-Fenster bestätigen bzw. können ihn zurücknehmen.
* Liste löschen: löscht nur die Liste
* Exp. Instr. Liste: exportiert die Symbol-Titel in eine CSV-Datei
* Exp. Instrumente: exportiert die Symbol-Titel mit allen dazugehörigen Details in eine CSV-Datei

<figure><img src="/files/gmYllAg4DFWLFHVvymGl" alt=""><figcaption></figcaption></figure>

* Speichern: speichert eine Instrumenten Liste
* Entfernen: entfernt ein oder mehrere markierte Instrumente aus der Liste. Dies kann auch über die **Entfernen**-Taste erfolgen
* Synchronisieren: dient dazu, allen Werten einer Liste den gleichen Wert für ein bestimmtes Attribut zuzuweisen
* Entleeren: entfernt alle Instrumente aus der Liste

### Änderungen außerhalb des Instrument-Editors <a href="#anderungen-ausserhalb-des-instrument-editors" id="anderungen-ausserhalb-des-instrument-editors"></a>

Intrumentlisten können über folgende Funktionalitäten außerhalb des Instrument-Editors verändert werden:

* Im [ActionBar](https://docs.agenatrader.com/v/german/menue-erklaerungen-and-inhalt/hauptmenue/actionbar) können über die Instrumentlist-Buttons Änderungen vorgenommen werden. Ist ein Button rot, so befindet sich das Instrument des aktuellen Charts in der jeweiligen Liste. Durch einen Klick auf die Buttons kann ein Instrument in die jeweilige Liste aufgenommen oder daraus gelöscht werden.

<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-MPA2Up_kL4jcNCs4R-c%252F-MPA4GUEeIb4kIZx8KvH%252Fact-bar4.png%3Falt%3Dmedia%26token%3D79dc87c5-3789-42d9-83d7-5b1cc329a478&#x26;width=300&#x26;dpr=4&#x26;quality=100&#x26;sign=2c4d18b8&#x26;sv=1" alt=""><figcaption></figcaption></figure>

* Der ChartToolBar bietet das <img src="/files/93rkfzHTWOg5c9drBVFh" alt="" data-size="line"> ("Zu Instrumentliste hinzufügen") Icon.

<figure><img src="/files/gh14GdR4WCUze7fgx6xF" alt=""><figcaption></figcaption></figure>

* Der Scanner verfügt über eine Multiselekt-Möglichkeit, mit der mehrere Instrumente auf einmal einer Liste zugewiesen werden können.

<figure><img src="/files/nLxbrAwBMwPFeXKZTnnq" alt=""><figcaption></figcaption></figure>

### Fav. Instrument List <a href="#fav.-instrument-list" id="fav.-instrument-list"></a>

Durch aktivieren des **Fav.** Kästchen können Sie Ihre **Favoriten Instrument List** bestimmen. Die ausgewählte Liste wird beim nächsten Anlegen einer LCG/TCG als erste Auswahlmöglichkeit angeführt.

<figure><img src="/files/ikkfo2YYtgW3BWEh9Nsj" alt=""><figcaption></figcaption></figure>

## Futures Kontrakt Rollover

### Ablaufdatum eines Futures-Kontraktes <a href="#ablaufdatum-eines-futures-kontraktes" id="ablaufdatum-eines-futures-kontraktes"></a>

*Ändern Sie das Ablaufdatum eines Futures-Kontraktes wie folgt:*

1. Öffnen Sie den [**Instrument-Editor**](https://docs.agenatrader.com/v/german/menue-erklaerungen-and-inhalt/tool-menue/instrument-escort) direkt für das jeweilige Instrument vom Chart, mittels einem Klick auf das Symbol, oder klicken Sie in der Hauptmenüleiste auf **Tools -> Instrument Editor**.
2. Suchen Sie das gewünschte Instrument über das Suchfeld links oben.
3. Ändern Sie anschließend die Zeile **Ablauf**, im **Details-Tab,** entsprechend ab.

<figure><img src="/files/OUpSsWRmDy18TYfYQ354" alt=""><figcaption></figcaption></figure>

In addition user have possibility to change contract date in Future Calendar. Just Right Mouse click on a Contract field opposite interested symbol:

<figure><img src="/files/JV73wUyOzAuWUinimeAE" alt=""><figcaption></figcaption></figure>

Sie können das Ablaufsdatum für jeden Futures-Kontrakt neben einem Instrumentsname im Chart-Funktionsleiste überprüfen.

<figure><img src="/files/WvSJExqzQOo3m7FSjuhf" alt=""><figcaption></figcaption></figure>

#### Zusätzliche Optionen verfügbar für Datenfeed TeleTrader <a href="#zusatzliche-optionen-verfugbar-fur-datenfeed-teletrader" id="zusatzliche-optionen-verfugbar-fur-datenfeed-teletrader"></a>

Continuous Contract ist voreingestellt, sollte einer der drei weiteren Optionen laut Screenshot gewählt werden, wird dem MappedSymbol die jeweile Zahl 1 bis 3 angehängt.

<figure><img src="/files/TgEKXg8xfJPNk92Ujb4h" alt=""><figcaption></figcaption></figure>

Zusätzlich können Sie den Futures Rollover Alarm nutzen. Mehr dazu finden Sie in [Allgemeine Einstellungen: Diskretionäres Handeln](https://docs.agenatrader.com/v/german/menue-erklaerungen-and-inhalt/tool-menue/konfigurations-escort#diskretionaeres-handeln).

**Begriffserklärungen zu den Kontrakten:**&#x20;

Continuous CC = Fortlaufender Kontrakt FrontMonth \
FM = Nur der aktuelle Kontrakt laut Kalender \
Next = Der nächste Kontrakt laut Kalender \
NextOn = Der übernächste Kontrakt laut Kalender

Die Einstellungmöglichkeiten sind für Teletrader sowie Taipan sehr ähnlich oder gleich.

Wie im [Connection Guide zu Taipan](https://youtu.be/QksaiHbCcHE?list=PLLftyBhQjHrXaoAyy3_S6SBhd_CqXXMjd\&t=66) beschrieben, lässt sich hier bereits in der Kontoverbindung auswählen ob "CC oder FM". Je nachdem was dort gewählt wurde, gilt im Weiteren als Standard.

### Von einem Kontrakt zum Nächsten wechseln <a href="#von-einem-kontrakt-zum-nachsten-wechseln" id="von-einem-kontrakt-zum-nachsten-wechseln"></a>

#### **Ablaufdatum/Verfall/Kontakt umstellen** <a href="#ablaufdatum-verfall-kontakt-umstellen" id="ablaufdatum-verfall-kontakt-umstellen"></a>

Wollen Sie z.B. das FDAX-Instrument von einem Ablaufdatum auf das nächste Ablaufdatum umstellen, so müssen Sie **zuerst alle Daten/Brokerverbindungen lösen**. Dann können Sie die Expiry umstellen und mit dem nächsten Reconnect sehen Sie die Daten des neuesten Futures-Contract.

#### **Das gleiche Instrument mit unterschiedlichen Ablauf/Verfall/Kontrakt** <a href="#das-gleiche-instrument-mit-unterschiedlichen-ablauf-verfall-kontrakt" id="das-gleiche-instrument-mit-unterschiedlichen-ablauf-verfall-kontrakt"></a>

*Vorgehensweise:*

1. Suchen Sie sich im **Instrument-Editor** Ihren gewünschten Future aus.
2. Wenn Sie z.B. den FDAX 09.JJJJ und den FDAX 12.JJJJ sehen wollen, müssen Sie im ausgewählten Instrument nur den Namen ändern (z.B. in "FDAX-NEXT") und den Ablauf auf 12.JJJJ stellen, und dann auf **Speichern** drücken.

Somit haben Sie den FDAX mit Ablauf 09.JJJJ, und den FDAX-NEXT mit Ablauf 12.JJJJ kreiert, welcher jetzt in den Instrumenten zu finden ist.

#### **Volumen-basierte Rollover** <a href="#volumen-basierte-rollover" id="volumen-basierte-rollover"></a>

Bei CME Instrumenten wird das Ablaufdatum mit dem meisten Volume-Settlement **gelb** markiert (für den Fall, dass Sie das nicht bereits für das ausgewählte Instrument getan haben). Mit diesen Daten können Sie ganz einfach zum beliebtesten Ablaufdatum wechseln.

<figure><img src="/files/AdkQs9YQPSRTAqQ67ash" alt=""><figcaption></figcaption></figure>

Bevor Sie diese Einstellung verwalten können, **importieren Sie bitte zuerst die Mappings für den CME Manager**.

<figure><img src="/files/1Yut3xA7wNnB5ZLengRe" alt=""><figcaption></figcaption></figure>

## Sicherung der Instrument-Datenbank

Wenn Sie Ihre Instrument-Datenbank sichern möchten, so können sie dies im [Instrument-Editor](https://docs.agenatrader.com/v/german/menue-erklaerungen-and-inhalt/tool-menue/instrument-escort) machen.

Drücken Sie auf **Import/Export** und anschließend **Export Instruments DB to XML Snapshot**. Nach dem Auswählen eines Verzeichnisses, wird die Sicherungs-Datei im XML-Format geschrieben. Mit einem Klick auf **Import from Instruments DB XML Snapshot** werden nach dem Auswählen der XML-Datei die Instrumente wieder importiert.

*Beim Import gilt folgendes:*

* Existierende Instrumente werden aktualisiert.
* Instrumente, die sich im **Instrument-Editor** befinden, aber nicht in der XML-Datei, bleiben unberührt.
* Instrumente, die sich nicht im **Instrument-Editor** befinden, aber in der XML-Datei, werden hinzugefügt.
* Alle Mappings und Instrument-Listen aus dem Instrument-Editor werden gelöscht und mit denen aus der XML-Datei ersetzt.

{% hint style="info" %}
**ACHTUNG**. Je nach Größe der Instrument-Datenbank kann der Import/Export einige Zeit in Anspruch nehmen.
{% endhint %}

<figure><img src="/files/PJ8TfLuOPDqFXY1UH07U" alt=""><figcaption></figcaption></figure>

## Erstellen Sie Ihre Instrumente

AgenaTrader enthält bereits eine große Anzahl an **vorkonfigurierten Instrumenten**. Falls jedoch ein Instrument fehlt, können Sie es wie folgt **manuell hinzufügen**:

1️⃣ **Die richtige Börse auswählen:**

* Die korrekte Börsenauswahl ist entscheidend, da sich die **Handelszeiten** nach der **gewählten Börse** richten (Marketplace Escort / Handelszeiten).
* Auch die **Chart-Darstellung** orientiert sich an diesen Vorgaben.

2️⃣ **Standard-Ordergröße anpassen:**

* Falls ein **Wert größer als 0** eingegeben wird, ersetzt dies die **Standard-Ordergröße aus der globalen Konfiguration**.

<figure><img src="/files/yGGCkoDzHzmUgBTx12s1" alt=""><figcaption></figcaption></figure>

3️⃣ **Mappings für das neue Instrument festlegen:**

* Die richtige **Mapping-Zuordnung** für Ihr Instrument finden Sie:\
  ✔ Auf der **Referenzplattform Ihres Brokers oder Datenfeed-Anbieters**.\
  ✔ Durch direkte **Kontaktaufnahme mit Ihrem Broker oder Datenanbieter**.\
  ✔ Über die **„Feedback“-Schaltfläche**, um eine **Mapping-Anfrage** zu senden.\
  ✔ Durch **regelmäßigen Import aktualisierter Mappings** von Ihrem Broker und Datenanbieter.

### Praktische Beispiele

**IB – Beispiel 1: Tick-Größe für CFDs anpassen**

🔹 **Wichtiger Hinweis:**\
Interactive Brokers verwendet für einige europäische CFDs **unterschiedliche Tick-Größen basierend auf der aktuellen Preisrange**. Dies kann zu folgenden Fehlermeldungen führen:

1. **"The price does not conform to the minimum price variation for the contract."**
2. **"Instrument Tick-Size is not yet calculated or delivered."**

📌 **Lösung:**

* Rufen Sie die **IB-Website auf**, geben Sie den **Tickernamen in das Suchfeld** ein und überprüfen Sie die Preisparameter des Instruments.
* Öffnen Sie das **Instrumente-Fenster** in AgenaTrader.
* Geben Sie die **Tick-Größe basierend auf dem aktuellen Preis** ein.
* Aktivieren Sie das **„Pin Tick Size“-Häkchen**, um die Tick-Größe festzusetzen.

<figure><img src="https://docs.agenatrader.com/~gitbook/image?url=https%3A%2F%2F2805764894-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-legacy-files%2Fo%2Fassets%252F-MKZSsJBtSP9L4sqIe_q%252F-MQCAh-14xmgX2eJrdUw%252F-MQCEOXqhu9AhgzcFdrW%252FZurn%2520IB%2520%281%29.png%3Falt%3Dmedia%26token%3D96b41511-52a3-4365-865e-216562ad99ec&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=d6ea8534&#x26;sv=1" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/67TWZaif6k1NIGn2Ji14" alt=""><figcaption></figcaption></figure>

**IB – Beispiel 2: Symbol-Mapping für FMCE überprüfen**

Dieses Beispiel ist etwas kniffliger, da die **Symbolnamen in AgenaTrader und IB unterschiedlich sein können**.

📌 **Lösung:**

1️⃣ **IB-Website aufrufen**\
2️⃣ **Erweiterten Tab auswählen** → Symbolnamen aus dem **Instrumenteneditor** in das **Suchfeld „Beschreibung/Name“** eingeben und **Suchen klicken**.\
3️⃣ **Im Dialog auf „Details“ klicken**.\
4️⃣ **Das Symbol kopieren** und im **Instrumenteneditor** unter **IB-Datenfeed** einfügen.

<figure><img src="https://docs.agenatrader.com/~gitbook/image?url=https%3A%2F%2F2805764894-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-legacy-files%2Fo%2Fassets%252F-MKZSsJBtSP9L4sqIe_q%252F-MQCAh-14xmgX2eJrdUw%252F-MQCEYPzSvJLVvr_WkfK%252FIB%282%29.jpg%3Falt%3Dmedia%26token%3Daa582168-8b3c-4082-9346-7e08afdfa9ac&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=163fd2a4&#x26;sv=1" alt=""><figcaption></figcaption></figure>

<figure><img src="https://docs.agenatrader.com/~gitbook/image?url=https%3A%2F%2F2805764894-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-legacy-files%2Fo%2Fassets%252F-MKZSsJBtSP9L4sqIe_q%252F-MQCAh-14xmgX2eJrdUw%252F-MQCEc53umu17hR9SbA2%252FIB%283%29.jpg%3Falt%3Dmedia%26token%3D33624eed-a339-4494-8f07-69bc8a3b567c&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=7fcf7e0e&#x26;sv=1" alt=""><figcaption></figcaption></figure>

<figure><img src="https://docs.agenatrader.com/~gitbook/image?url=https%3A%2F%2F2805764894-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-legacy-files%2Fo%2Fassets%252F-MKZSsJBtSP9L4sqIe_q%252F-MQCAh-14xmgX2eJrdUw%252F-MQCEfZVYF_ni_MWFmxy%252FIB%284%29.jpg%3Falt%3Dmedia%26token%3Db08374f4-a023-4e95-a969-e8a7d8531b5f&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=8635729a&#x26;sv=1" alt=""><figcaption></figcaption></figure>

<figure><img src="https://docs.agenatrader.com/~gitbook/image?url=https%3A%2F%2F2805764894-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-legacy-files%2Fo%2Fassets%252F-MKZSsJBtSP9L4sqIe_q%252F-MQCAh-14xmgX2eJrdUw%252F-MQCEkTrUBtegX_dzUWj%252FIB%285%29.jpg%3Falt%3Dmedia%26token%3D70301288-6dff-4104-8ea0-4641d477be86&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=4893142d&#x26;sv=1" alt=""><figcaption></figcaption></figure>

## Fehlermeldung: "No security definition found" <a href="#no_security_definition_found" id="no_security_definition_found"></a>

**Problem:**

* Beim **Platzieren oder Schließen einer Order** erscheint die Meldung **„NO DEFINITION FOUND“**.
* Die Order wird **nicht an den Broker gesendet** oder **nicht geschlossen**.
* Nach der **ersten Verbindung zum Broker** wurde **automatisch eine Position eröffnet**, ohne dass der Nutzer etwas getan hat.

**Ursache:**

* **Das Instrument fehlt in AgenaTrader.**
* **Das Symbol-Mapping für Broker und Datenfeed wurde nicht importiert.**
* **Trades, die direkt auf der Broker-Plattform durchgeführt wurden, erscheinen erst nach Verbindungsherstellung in AgenaTrader.**

### **Mögliche Lösungen**

**1️⃣ Instrumente selbst erstellen oder konfigurieren**

* Öffnen Sie den **Instrumenteneditor** und füllen Sie **alle Felder sorgfältig aus**.
* Handelszeiten werden von der **Börse des Instruments** übernommen.
* Datenfeeds wie **TaiPan** können genutzt werden (ein Konto beim Anbieter ist erforderlich, kann jedoch zusätzliche Kosten verursachen).
* Falls weitere **Brokersysteme oder Datenfeeds** (z. B. CapTrader, XTB, Dukascopy, FXCM) angeschlossen sind, müssen **weitere Mappings für jeden Broker/Datenanbieter hinterlegt** werden.

📌 **Fragen Sie Ihren Broker oder Datenanbieter nach den korrekten Mappings für Ihr Instrument!**

✅ **Speichern der Änderungen nicht vergessen!**\
✅ **Die Verbindung zum Broker oder Datenfeed muss neu hergestellt werden, damit die Änderungen übernommen werden.**

<figure><img src="/files/nUNycitS8MFjFE8yIrAS" alt=""><figcaption></figcaption></figure>

**2️⃣ Instrumente oder Mappings anfordern**

* Mit der Schaltfläche **„Korrigiertes Mapping übermitteln“** können Sie eine **Mapping-Anfrage** direkt an unser Team senden.

📌 **So funktioniert’s:**

1. **Instrumenteneditor öffnen**
2. **Instrument eingeben**
3. **Auf „Korrigiertes Mapping übermitteln“ klicken**
4. **Kurz das Problem beschreiben** und auf **„Senden“ klicken**

💡 **Unser Mapping-Team kümmert sich zeitnah um Ihre Anfrage.**\
✔ Nach kurzer Zeit erhalten Sie eine Antwort.\
✔ Importieren Sie die **Mappings und Instrumentenlisten erneut**, um die aktualisierten Mappings zu verwenden.

<figure><img src="/files/PAEWMSzeBYK8z1HXI1Ge" alt=""><figcaption></figcaption></figure>

#### **Instrumentenlisten und Mappings importieren**

📌 **So importieren Sie Mappings:**

1. **Tools → Einstellungen → Instrumente: Märkte und Mappings** aufrufen.
2. **Im Reiter „Mappings“ Ihren Datenfeed oder Broker auswählen**.
3. **Import-Schaltfläche unten anklicken**, um die Mappings zu aktualisieren.
4. **Erst nach erfolgreichem Mapping-Import können Instrumentenlisten (allgemein oder broker-spezifisch) importiert werden.**

✅ Falls **Mappings oder Instrumentenlisten versehentlich gelöscht** wurden, kann der Import jederzeit wiederholt werden.

<figure><img src="/files/ahLG9S3bo3pBzIgPaJly" alt=""><figcaption></figcaption></figure>

#### **Weitere Informationsquellen**

📌 **YouTube-Webinar:**\
Auf unserem **YouTube-Kanal** gibt es ein **detailliertes Webinar** zum Thema **Instrumente und Listen**.

➡ Schauen Sie sich das Video an, um eine **umfassende Erklärung zur Verwaltung von Instrumenten in AgenaTrader** zu erhalten! 🚀

{% embed url="<https://www.youtube.com/watch?index=24&list=PLLftyBhQjHrX0Qpi--gcLZEh3YojWGZ53&v=Nf2XgjroreM>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.agenatrader.com/german/tools/instrument-editor.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.