Skip to content
Live Data Sierra Chart ACSIL / C++ Free Study

Sierra Chart Integration

FXMacroData Release Guard is a free ACSIL study that puts the scheduled economic release calendar on your Sierra Chart charts. It draws a marker and label at every timed release for the chart's currencies, shades a blackout window around each one, shows the next release in the corner, can alert you ahead of it, and publishes a Blackout subgraph that Spreadsheet Systems, Alert Conditions and ACSIL studies can read to stay flat around releases. One C++ file, built with Sierra Chart's own Remote Build.

Language

ACSIL (C++17)

Outputs

Blackout, Minutes to next release

Authentication

X-API-Key header (optional)

The USD release calendar works without an API key. Add an Individual or Business key to load the calendars of all 22 currencies. Get an API key

Files

Download

The study is a single, self-contained C++ source file with full source. Sierra Chart compiles it into a custom studies DLL on its own build servers, so no compiler is needed on your computer.

FXMacroDataReleaseGuard.cpp

FXMacroData Release Guard study

Release markers, blackout shading, a next-release status block, a T-minus alert and the Blackout and Minutes to next release subgraphs. Copy it into the ACS_Source folder and Remote Build it as shown below.

Download .cpp

Installation

Setup guide

1

Copy the file into ACS_Source

Save FXMacroDataReleaseGuard.cpp into the ACS_Source folder inside your Sierra Chart installation folder, for example C:\SierraChart\ACS_Source.

2

Select it for building

In Sierra Chart select Analysis › Build Custom Studies DLL. In the build window select File › Select Files, choose FXMacroDataReleaseGuard.cpp and press Open.

3

Remote Build

Select Build › Remote Build. Sierra Chart compiles the file on its servers and writes FXMacroDataReleaseGuard_64.dll to your Data Files Folder. The Output frame reports the result.

4

Add the study to a chart

Open a chart, select Analysis › Studies › Add Custom Study, expand FXMacroData Release Guard, add the study and press OK. On an FX pair or a supported futures contract the study picks the currencies from the chart symbol automatically.

5

Set the currencies and key

In the study's Settings › Inputs set Currencies, for example USD,EUR,GBP,JPY, and paste your API key for any currency other than USD.

To update later, download the new file, copy it over the old one and repeat steps 2 and 3. Sierra Chart reloads the DLL automatically. To share a build with another computer, copy FXMacroDataReleaseGuard_64.dll into that installation's Data Files Folder, shown under Global Settings › General Settings › Paths.

Study settings

Inputs

The study loads the calendar from GET https://fxmacrodata.com/api/v1/calendar/{currency} for yesterday through seven days ahead, then reloads it on the refresh interval.

Input Default Description
Currencies (comma separated)USDCalendars the study may load. Without an API key only USD is loaded.
FXMacroData API keyemptyOptional. Sent in the X-API-Key request header, never in the URL or the Message Log.
Minutes before release10Start of the blackout window.
Minutes after release10End of the blackout window.
ImportanceHighHigh: top-tier releases. Medium: adds second-tier releases. All: every timed release.
Refresh minutes60How often the calendar is reloaded. Minimum 5.
Draw release markersYesVertical line and label at each release.
Draw blackout shadingYesShaded region across each window.
Show next-release textYesStatus block with the next release in UTC and chart time, and whether a window is open now.
Alert at T-minus minutes (0 = off)0Adds an Alerts Log line and plays the chosen sound this many minutes before the next release, once per release.
Alert sound number1Sierra Chart alert sound 1 to 150, or 0 for silent.
Use chart symbol currenciesYesNarrows Currencies to those of the chart symbol: FX pairs such as EURUSD, metals, indices, and futures such as ESZ26, 6E, FDAX or NKD.

Marker and shading colours are the Primary Color of the Marker colour: top tier, Marker colour: other and Blackout shading colour subgraphs in the study's Subgraphs tab. Releases whose publisher has confirmed the date but not yet the time are left off the chart until the exact time is published.

Subgraphs

Use it in a trading system

The study publishes two ordinary subgraphs: Blackout (1 inside a release window, otherwise 0) and Minutes to next release. Anything in Sierra Chart that can reference a study subgraph can read them.

Spreadsheet System

Add the study before the spreadsheet study so its columns appear in the sheet. If Blackout lands in column K, gate a buy entry with =AND(<signal>, K3=0), or stay flat until a release is over an hour away with =AND(<signal>, L3>60).

Alert Condition studies

In any study that takes a Study Subgraph reference, such as Trading System Based on Alert Condition, pick FXMacroData Release Guard and subgraph Blackout, then test = 0 for trading allowed.

// Inside your own ACSIL trading study
SCFloatArray blackout;
sc.GetStudyArrayUsingID(ReleaseGuardStudyID, 0, blackout);

if (blackout[sc.Index] != 0)
    return;  // a scheduled release window is open, skip entries

On the current bar the values follow the computer clock in UTC. On earlier bars they are built from bar times, so a bar that overlaps any part of a window reads 1. Chart placement uses the chart's own time zone setting.

Keys

Authentication

Without a key

  • USD release calendar
  • Markers, shading, alerts and subgraphs for USD releases

With an Individual or Business key

  • Release calendars for all 22 currencies
  • Plan rate limits in place of the evaluation cap

Create a key at fxmacrodata.com/subscribe and manage it in API Management. The study sends it in the X-API-Key header. Keep it out of shared chartbooks and study collections.

Help

Troubleshooting

The study is not in the Add Custom Study list

Check the Output frame of the build window for errors and confirm FXMacroDataReleaseGuard_64.dll is in the Data Files Folder shown under Global Settings › General Settings › Paths. A DLL copied anywhere else is not loaded.

Only USD releases appear

Other currencies need an API key. Paste it into FXMacroData API key, check it for extra spaces, and confirm it is active in API Management. With Use chart symbol currencies on, a currency also has to belong to the chart symbol and be listed in Currencies.

The status text says the calendar is stale

Two refreshes in a row failed, so the study is running on the last calendar it loaded. Check Window › Message Log for the request error and make sure your firewall allows outbound HTTPS from Sierra Chart to fxmacrodata.com.

Inputs did not change after rebuilding

When a new version adds or renames inputs, remove the study from the chart and add it again so Sierra Chart reads the new defaults.

Still stuck? Open a ticket at fxmacrodata.com/support or email info@fxmacrodata.com.

AI Answer-Ready

Key Facts

Page
Sierra Chart
Section
Documentation
Canonical URL
https://fxmacrodata.com/documentation/sierra-chart
Source
FXMacroData editorial and official publisher references
Last Updated
See page metadata

Provenance And Trust

Cite the canonical URL and source field above. Where available, this page maps to official publisher releases and timestamped updates.

Quick Q&A

What is this page about? This page explains Sierra Chart with directly usable context for trading, research, and API workflows.

What source should be cited? Use the canonical URL and the listed source field; cite official publisher references when available.

How fresh is this content? The last updated value above reflects the page metadata or latest available data timestamp.

Can this be used in AI assistants? Yes. This section is intentionally structured for retrieval and citation in chat assistants.

Prompt Packs

Use these in ChatGPT, Claude, Gemini, Mistral, Perplexity, or Grok for consistent source-aware outputs.

Share page X LinkedIn Email