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)
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 .cppInstallation
Setup guide
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.
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.
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.
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.
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) | USD | Calendars the study may load. Without an API key only USD is loaded. |
| FXMacroData API key | empty | Optional. Sent in the X-API-Key request header, never in the URL or the Message Log. |
| Minutes before release | 10 | Start of the blackout window. |
| Minutes after release | 10 | End of the blackout window. |
| Importance | High | High: top-tier releases. Medium: adds second-tier releases. All: every timed release. |
| Refresh minutes | 60 | How often the calendar is reloaded. Minimum 5. |
| Draw release markers | Yes | Vertical line and label at each release. |
| Draw blackout shading | Yes | Shaded region across each window. |
| Show next-release text | Yes | Status block with the next release in UTC and chart time, and whether a window is open now. |
| Alert at T-minus minutes (0 = off) | 0 | Adds an Alerts Log line and plays the chosen sound this many minutes before the next release, once per release. |
| Alert sound number | 1 | Sierra Chart alert sound 1 to 150, or 0 for silent. |
| Use chart symbol currencies | Yes | Narrows 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.