@juliapupu/sensor-fx-frankfurter

A World2Agent sensor that watches foreign exchange rates from Frankfurter (free, ECB-based, no API key) and emits a market.quote.threshold_crossed signal whenever a configured pair crosses a target you've set.

Install (in a Claude Code session)

/world2agent:sensor-add @juliapupu/sensor-fx-frankfurter

That walks you through the Q&A defined in SETUP.md and writes both your sensor config and the per-user handler skill.

What it emits

| event.type | When | |---|---| | market.quote.threshold_crossed | A configured pair's rate crosses one of your targets between two ECB publishing windows. |

Each signal carries pair, base, quote, direction, target, current_rate, previous_rate, and timestamps. See src/transform.ts for the full JSON Schema.

Config shape

{
  "alerts": [
    { "pair": "USD/CNY", "direction": "above", "target": 7.30 },
    { "pair": "EUR/USD", "direction": "below", "target": 1.05 }
  ],
  "poll_interval_seconds": 3600
}

Limitations

• Frankfurter publishes once per business day after ~16:00 CET. Crossings that happen between two intraday quotes are not detected — this is daily-resolution, not intraday.
• Each crossing fires once; the rate has to leave the target band and re-cross to fire again.