Bookmap Knowledge Base

Bookmap Knowledge Base

  • User Guide
  • Add-ons
  • Java API

›Bookmap Add-ons

Bookmap Add-ons

  • Absorption Indicator
  • Breakeven Point Indicator
  • Cross BBO
  • DOM Pro
  • Execution Pro
  • Footprint Indicator
  • HIRO
  • Instrument Copy
  • Liquidation Indicator
  • Liquidity Marker
  • Liquidity Tracker
  • Market Pulse Volume Pressure
  • Multibook Customizer
  • Outside Liquidity
  • Price Levels Indicator
  • Python API
  • Stops & Icebergs Sub-Chart Indicator
  • Stops & Icebergs On-Chart Indicator
  • Sweeps Indicator
  • Tradermap Pro

Instrument Copy

What Is Instrument Copy?

Instrument Copy is an add-on that allows you to create copies of subscribed instruments. You can apply any setting to a copied instrument. Therefore, the aim of this add-on is to allow you to see the same chart but with different settings.

screenshot

The Instrument Copy add-on is included in Bookmap packages from Digital Plus and above.

Download link : https://bookmap.com/addons/instrument-copy

Watch The Walkthough

Configuration

There are two ways to create a copy of an instrument. The first way is to go to the instrument tab and open the Instrument Copy configuration panel. Input the symbol name into the corresponding field and click the “Create” button.

You’ll see a new tab of the copied instrument in Bookmap.

screenshot

Note that after creating a copy, you can immediately create a new one without editing the name. This is possible because after creating a copy, the name of the next one is automatically incremented.

screenshot

The second way of creating a copy is to use the traditional method of subscribing to symbols. When you subscribe to a symbol for the second time and if the Instrument Copy add-on is activated, it will suggest that you create a copy of that instrument.

screenshot

screenshot

Whatever method you use to make a copy, the add-on will automatically add an “@Copy” ending to the instrument name, in order to distinguish it from the original instrument.

The add-on allows you to create multiple copies of the same instrument, but each copy must have its own unique name. Note that you cannot create a copy of copy.

To unsubscribe from an instrument copy, just close its tab or click the “Unsubscribe” button in the Instrument Copy configuration panel.

screenshot

Constraints

Maximum Number of Copies

When you reach the limit of the number of copies, you will see a corresponding message and you will not be able to create new copies.

screenshot

Historical Data

As soon as you create a new copy, it starts getting all real-time events from the original instrument. Also it gets all backfilled data from the original instrument available at the moment. There are two important things here:

  1. Backfilled data from the original instrument is aggregated on copy and does not contain MBO events. This means that add-ons that rely on MBO data, such as SI On-Chart and SI Sub-Chart, will not show anything on copy backfill data, but will work properly on the data received after the moment when copy was created. This also means that add-ons that group events by time, such as Absorption and Sweeps indicators, on backfilled data may show results that differ from the original instrument.
  2. If historical data is loaded to the original instrument after a copy of it was created, the copy will not get that data automatically. If you want the copy to receive that data, you need to unsubscribe from the copy and subscribe back.

Important Notes

The minimum compatible version of Bookmap is 7.3.0.40

Feedback

Survey link: https://bookmap.com/addons/instrument-copy/survey

After one hour of using the add-on, you will see the feedback panel in the add-on configuration panel.

screenshot

Answer options:

  • I have already provided feedback: This panel will no longer appear.
  • I don’t want to give feedback: This panel will no longer appear.

Instrument Copy FAQ

Why do the add-ons show incorrect information on the Instrument Copy chart?

  • Aggregation is applied to the historical data of the copy, which reduces accuracy and makes it impossible to use some add-ons.
  • The latest versions of Absorption and Sweeps indicators have a bug that does not allow them to work properly on aggregated data. We are working on a solution to the issue.

I have a question about Instrument Copy, who can I ask?

Feel free to ask any questions in the Discord channel or contact support@bookmap.com

I closed the original instrument, why do the copies close as well?

All the copies get their data directly from the original instrument and cannot exist separately. If you close the original, there is no data to display and all copies will be automatically closed.

Why can't Instrument Copy be used in replay mode?

Replay mode does not support the custom instruments subscription, we will improve it in future. For now it is possible to use Instrument Copy in live data (sim or live trading) mode only.

Installation

Disclaimer

This add-on is supplied on an AS IS basis. This version of the add-on has known bugs and issues:

  • Chart settings reset / inherit / save / load or same manipulation with all charts settings will crash the Bookmap - will be fixed in future Bookmap versions.
  • Old Advanced Heatmap and Heatmap Pro add-ons are broken, we stopped supporting both of them. Please do not use them. The usage together with Instrument Copy add-on will result a crash.
  • If you enable/disable the add-on very quickly, or on the add-on restart you may get the "There is no temporary file for..." error. Temporary workaround:
  1. Press the continue button (it is not necessary to report this error)
  2. Disable the add-on
  3. Remove all the Instrument Copy instruments manually
  4. Enable the add-on

screenshot

In order to install and use the Instrument Copy add-on, you will need to be subscribed to a Bookmap Digital Plus package or higher.

To install Instrument Copy, follow these steps:

  1. Download Instrument Copy: https://bookmap.com/addons/instrument-copy
  2. Launch Bookmap version 7.3.0 b40 (https://bookmap.com/current/production) or newer and subscribe to at least one instrument.
  3. Click the add-ons icon to open the add-ons configuration panel (or Settings → API plugins configuration).

screenshot

  1. In the API plugins configuration, click the “Add” button and then select the instrument-copy-x.xx.jar from the “Select add-on file...” dialog window, click “Open” and then “Load”.

screenshot

  1. Instrument Copy will appear in the list of available plugins. Click on it to see its settings, and then click on the checkbox to the left of the name to activate/deactivate this add-on for all instruments.

screenshot

← HIROLiquidation Indicator →
  • What Is Instrument Copy?
    • Watch The Walkthough
  • Configuration
  • Constraints
    • Maximum Number of Copies
    • Historical Data
  • Important Notes
  • Feedback
  • Instrument Copy FAQ
    • Why do the add-ons show incorrect information on the Instrument Copy chart?
    • I have a question about Instrument Copy, who can I ask?
    • I closed the original instrument, why do the copies close as well?
    • Why can't Instrument Copy be used in replay mode?
  • Installation
    • Disclaimer
Bookmap Knowledge Base
RESOURCES
Main PageForumBlog
Tutorials
Video TutorialsWebinar Recordings
Social
Bookmap Knowledge BaseBookmap Knowledge BaseBookmap Knowledge BaseBookmap Knowledge BaseBookmap Knowledge BaseBookmap Knowledge Base
Copyright © 2023 Bookmap Ltd