Add FXMacroData release calendar sample

[roberttidball]

Summary

• Adds FXMacroData Kotlin release-calendar sample for using FXMacroData's public release-calendar endpoint in backtesting or strategy-risk workflows.
• Keeps the integration self-contained and avoids API-key requirements by using the public USD calendar example.

Validation

• Ran Python syntax checks for all added Python examples where applicable.
• Ran git diff --check for this repository.
• Live FXMacroData calendar smoke tested with the July 2026 USD sample window from companion Python examples.

Note: Go, Rust, .NET, Maven, and TypeScript toolchains were not available in the local desktop environment for deeper build checks.

[jbaron]

Nice sample. But my question is how do you use it within roboquant (because it doesn't show that part)?

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[roberttidball]

Updated the sample to show how the FXMacroData release calendar feeds into an actual roboquant run: MacroBlackoutStrategy wraps a normal Strategy, suppresses signals on top-tier macro blackout dates, and is run via
un(feed, strategy) against a RandomWalk feed.\n\nLocal Maven validation could not run because this environment has no Java runtime / JAVA_HOME; git diff --check passed.

[jbaron]

Thanks, nice example and very useful!!!