fxmacrodata-calendar

1# FXMacroData Calendar
2 
3Retrieve official-source macro release-calendar events from FXMacroData. Use
4this skill when a trade plan needs event timing, confirmed release dates, or a
5top-tier macro risk check.
6 
7## Workflow
8 
91. Run the calendar script:
10 
11   ```bash
12   python3 skills/fxmacrodata-calendar/scripts/fetch_calendar.py --currency usd --min-tier 1
13   ```
14 
152. Review `events[]` for top-tier releases.
16 
17   Treat a nonzero exit as an unverified event-risk state, never as an empty
18   calendar. Only a successful response containing `events: []` establishes
19   that no matching events were returned. The client accepts results only when
20   the response currency matches the request and `data_quality` confirms an
21   official, current, non-proxy, non-fallback, timestamp-complete,
22   point-in-time-safe source. Each event must include an announcement timestamp
23   and a non-empty release identifier.
24 
253. Fold the event timing into the trade plan:
26   - pause new entries around high-impact releases;
27   - reduce leverage or position size;
28   - schedule follow-up review after the actual value is available;
29   - explain which event and timestamp drove the adjustment.
30 
31## Authentication
32 
33Set `FXMACRODATA_API_KEY` for authenticated FXMacroData endpoints. Public USD
34calendar rows can be fetched without a key. The client uses the canonical
35`https://api.fxmacrodata.com/v1` endpoint and accepts `--min-tier` values 1,
362, or 3 only. Live calendar responses currently include `market_tier`; the
37…