accueil / serveurs / Finance & Paiement / io.github.fxmacrodata/fxmacrodata
io.github.fxmacrodata/fxmacrodata
serveur MCP (Model Context Protocol) · FX Macrodata API 2.3.0
Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur.
Est-ce que io.github.fxmacrodata/fxmacrodata est sûr ?
Au dernier audit MCP Hub, le serveur MCP « io.github.fxmacrodata/fxmacrodata » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.
Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.
Les 54 outils
- announcement_changes≈ 472 tokens
Poll recently ingested macro announcement changes with a resumable cursor. This is the bounded, MCP-safe counterpart to the release-event stream: the returned next_cursor is accepted as `since` on a later call, so polling resumes without holding a streaming invocation open. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
Paramètres, retour & exemple (5)
Paramètreslimit· integer · optionnel
Maximum matching change events to return.since· ? · optionnel
Optional previous next_cursor, ISO 8601 timestamp, or Unix epoch seconds.payload· string · optionnel
Event payload shape: compact trigger rows or full announcement rows.currencies· ? · optionnel
Optional comma-separated currency codes, `g10`, or `all`. Without subscriber access, results are limited to the public scope.indicators· ? · optionnel
Optional comma-separated announcement indicator slugs.
Exemple d'appel{"name": "announcement_changes", "arguments": {"limit": 1, "since": "texte", "payload": "texte", "currencies": "texte", "indicators": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - calendar_archive_coverage≈ 228 tokens
Inspect persisted official-calendar captures, parser outcomes, configured sources and coverage limitations for a currency. Successful capture does not prove complete historical calendar or speech coverage. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (1)
Paramètrescurrency· string · requis
3-letter ISO currency code, case-insensitive.
Exemple d'appel{"name": "calendar_archive_coverage", "arguments": {"currency": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - calendar_event_versions≈ 412 tokens
Return immutable schedule and importance versions for a stable archive event ID, including explicit publisher cancellations and source capture evidence. Capture, acceptance and documentary publisher clocks remain distinct. Checkpoint and cursor pin subsequent history pages. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (5)
Paramètreslimit· integer · optionnel
Maximum schedule transitions per page, default 250.cursor· ? · optionnel
Opaque next_cursor returned by the previous page.currency· string · requis
3-letter ISO currency code, case-insensitive.checkpoint· ? · optionnel
Checkpoint returned by the first page.archive_event_id· string · requis
Stable archive event_id returned in historical schedule evidence.
Exemple d'appel{"name": "calendar_event_versions", "arguments": {"currency": "texte", "archive_event_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - calendar_snapshot≈ 684 tokens
Return persisted economic-event schedules, importance and cancellation states at an explicit historical cutoff. Accepted mode requires actual capture and parser acceptance by the cutoff. Reconstruction additionally admits qualified official notices recovered later; it does not establish historical service availability. Scheduled-date and event filters apply after version selection. Checkpoint and cursor pin subsequent export pages. Empty results do not establish that no events were scheduled. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (10)
Paramètresas_of· string · requis
Required ISO 8601 knowledge cutoff with UTC offset or Z.limit· integer · optionnel
Maximum events per page, default 250.cursor· ? · optionnel
Opaque next_cursor returned by the previous page.currency· string · requis
3-letter ISO currency code, case-insensitive.end_date· ? · optionnel
Inclusive scheduled-date upper bound, YYYY-MM-DD.checkpoint· ? · optionnel
Checkpoint returned by the first page.event_kind· ? · optionnel
Scheduled event kind filter.importance· ? · optionnel
Frozen event importance filter.start_date· ? · optionnel
Inclusive scheduled-date lower bound, YYYY-MM-DD.knowledge_mode· string · optionnel · accepted | reconstruction
Archive acceptance replay, or qualified documentary reconstruction.
Exemple d'appel{"name": "calendar_snapshot", "arguments": {"as_of": "texte", "currency": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - commodities≈ 453 tokens
Get historical price series for supported commodity indicators using the exact slugs advertised by this schema. Requires an API key. Supported indicators: crude_oil_inventories, gold, natural_gas, natural_gas_storage, oil_brent, oil_wti, platinum, silver. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (4)
Paramètressymbol· ? · optionnel
Backward-compatible alias for `indicator`, which supersedes it in new calls.end_date· ? · optionnel
Inclusive upper bound, YYYY-MM-DD.indicator· ? · optionnel
Commodity indicator slug. Supported: crude_oil_inventories, gold, natural_gas, natural_gas_storage, oil_brent, oil_wti, platinum, silver.start_date· ? · optionnel
Inclusive lower bound, YYYY-MM-DD.
Exemple d'appel{"name": "commodities", "arguments": {"symbol": "texte", "end_date": "texte", "indicator": "texte", "start_date": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - commodities_visual_artifact≈ 311 tokens
Returns commodity price history with MCP Apps chart metadata so compatible clients render an interactive commodity chart inline. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (3)
Paramètresend_date· ? · optionnel
Inclusive upper bound, YYYY-MM-DD.indicator· string · requis
Commodity indicator slug. Supported: crude_oil_inventories, gold, natural_gas, natural_gas_storage, oil_brent, oil_wti, platinum, silver.start_date· ? · optionnel
Inclusive lower bound, YYYY-MM-DD.
Exemple d'appel{"name": "commodities_visual_artifact", "arguments": {"indicator": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - cot_data≈ 578 tokens
Get weekly CFTC Commitment of Traders (COT) positioning data for a currency's FX futures contract on the CME, covering speculator positioning, non-commercial longs vs shorts, hedge-fund FX positioning, and sentiment extremes. Returns weekly snapshots with long/short open interest by trader category. Updated every Friday at 15:30 ET reflecting the Tuesday cutoff. USD (the USD Index contract) is available without an API key for the most recent 90 days on a 15-minute release delay; every other currency and the full history need an API key. Supported currencies: AUD, CAD, CHF, EUR, GBP, JPY, NZD, USD, XAU. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
Paramètres, retour & exemple (4)
Paramètresreport· ? · optionnel
CFTC report type. Omit for the Legacy futures-only report (commercial / non-commercial / non-reportable). One of: legacy_futures, legacy_combined, tff_futures, tff_combined, disaggregated_futures. TFF reports return dealer, asset manager, leveraged funds and other reportable positions for FX contracts and the dollar index; disaggregated_futures is published for XAU (COMEX gold) only.currency· string · requis
3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, JPY, NZD, USD, XAU.end_date· ? · optionnel
Inclusive upper bound, YYYY-MM-DD.start_date· ? · optionnel
Inclusive lower bound, YYYY-MM-DD.
Exemple d'appel{"name": "cot_data", "arguments": {"currency": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - cot_visual_artifact≈ 478 tokens
Returns weekly CFTC COT positioning data with MCP Apps chart metadata. By default it charts noncommercial net positioning; the `metric` parameter selects another COT field. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
Paramètres, retour & exemple (5)
Paramètresmetric· ? · optionnel
Field to plot from each COT row. Typical values: noncommercial_net, noncommercial_net_zscore, noncommercial_long, noncommercial_short, open_interest.report· ? · optionnel
CFTC report type; omit for the Legacy futures-only report. One of: legacy_futures, legacy_combined, tff_futures, tff_combined, disaggregated_futures. With a TFF report, plot a TFF metric such as leveraged_funds_net or asset_manager_net.currency· string · requis
3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, JPY, NZD, USD, XAU.end_date· ? · optionnel
Inclusive upper bound, YYYY-MM-DD.start_date· ? · optionnel
Inclusive lower bound, YYYY-MM-DD.
Exemple d'appel{"name": "cot_visual_artifact", "arguments": {"currency": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - data_catalogue≈ 558 tokens
List every macroeconomic indicator FXMacroData publishes for a currency, with units, frequency, and coverage/freshness metadata. Returns the exact `indicator` slug strings used across FXMacroData indicator, calendar, and prediction endpoints. Rows whose `coverage` is stale, partial, or unavailable are not suitable for real-time carry or inflation analysis. Supported currencies (lowercase 3-letter codes): AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. Access: free for every currency, no API key required.
Paramètres, retour & exemple (4)
Paramètrescurrency· string · requis
3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.indicator· ? · optionnel
Optional indicator slug that narrows the result to that one catalogue entry and its coverage row, for example `core_inflation`. Useful when the candidate series is already known; omit it to list every indicator.include_coverage· boolean · optionnel
Include coverage/freshness rows with latest_available_date, coverage_quality, has_recent_data, and recent_observation_count. These rows show whether an indicator series is current enough for analysis.include_capabilities· boolean · optionnel
Include machine-readable indicator capabilities when the API supports them, such as supported transformations, history availability, and release-calendar linkage.
Exemple d'appel{"name": "data_catalogue", "arguments": {"currency": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - event_impact_replay_task≈ 1108 tokens
Replay verified publication events against measured 1, 5 and 20-observation FX reference returns. Daily windows exclude the publication-day fixing; changes from previous actuals are not consensus surprises. Returns analysis in the tool response. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
Paramètres, retour & exemple (7)
Paramètresbase· ? · optionnel
FX base currency for market context, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.quote· ? · optionnel
FX quote currency for market context, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.currency· string · requis
Currency for macro event series, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.end_date· ? · optionnel
Optional inclusive upper bound, YYYY-MM-DD.indicator· string · requis
Indicator slug for event replay. Supported examples: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.start_date· ? · optionnel
Optional inclusive lower bound, YYYY-MM-DD.lookback_events· ? · optionnel
Maximum number of recent events to include in replay.
Exemple d'appel{"name": "event_impact_replay_task", "arguments": {"currency": "texte", "indicator": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - event_predictions≈ 1829 tokens
Return stored forecasts, consensus-style predictions, central-bank projections, survey forecasts, IMF forecasts, nowcasts, or FXMacroData blended predictions for macro announcements, for actual-vs-consensus, prior-vs-forecast, or event-surprise context. Rows are keyed by announcement_id/date/indicator and include prediction source metadata. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. The `indicator` parameter lists the accepted indicator slugs. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (20)
Paramètrespage· ? · optionnel
One-based page number. When supplied, overrides offset.as_of· ? · optionnel
Historical publication cutoff with explicit timezone, or YYYY-MM-DD at UTC midnight. Later forecasts are excluded.basis· ? · optionnel
Real or nominal selector, matching the announcement series.limit· integer · optionnel
Maximum prediction groups to return. Defaults to 20; maximum 100.offset· integer · optionnel
Zero-based prediction-group offset.currency· string · requis
3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.end_date· ? · optionnel
Optional inclusive upper bound by reference-period date, YYYY-MM-DD.frequency· ? · optionnel
Returned change basis selector, matching the announcement series.indicator· string · requis
Required indicator slug. Currency-wide prediction reads are not supported. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.start_date· ? · optionnel
Optional inclusive lower bound by reference-period date, YYYY-MM-DD.before_date· ? · optionnel
Exclusive period-date cursor for event-linked groups; use the prior response's next_cursor.seasonality· ? · optionnel
Seasonal adjustment selector, matching the announcement series.annualization· ? · optionnel
Annualization selector, matching the announcement series.official_limit· integer · optionnel
Maximum native-period official forecasts; 0 omits this section. Inspect official_forecasts_truncated.prediction_type· ? · optionnel
Optional legacy forecast-type filter, kept for existing clients. Superseded by prediction_class: compiled_consensus, forecaster_survey, expectations_survey, market_implied, model_nowcast, central_bank_projection, institutional_projection or fxmacrodata.pre_release_only· boolean · optionnel
Require event-linked forecasts to have been generated before the announcement.prediction_class· ? · optionnel
Forecast production class: compiled_consensus, forecaster_survey, expectations_survey, market_implied, model_nowcast, central_bank_projection, institutional_projection or fxmacrodata.prediction_source· ? · optionnel
Optional source slug filter, for example ecb_spf or philly_fed_spf.period_aggregation· ? · optionnel
Period aggregation selector, matching the announcement series.event_compatible_only· boolean · optionnel
Restrict event-linked data to verified matching target periods, units and economic concepts. Native official_forecasts remain a separate section.
Exemple d'appel{"name": "event_predictions", "arguments": {"currency": "texte", "indicator": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - financial_prices≈ 384 tokens
Read persisted official financial price observations: government yield curves, individual securities, overnight benchmarks and reference prices. Preserves issuer, instrument, maturity, curve type and source precision. Requires an API key; an empty result means no stored observations for the selection. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (9)
Paramètreslimit· integer · optionnelissuer· ? · optionneloffset· integer · optionnelsource· ? · optionnelmeasure· ? · optionnelcurrency· string · requisend_date· ? · optionnelstart_date· ? · optionnelinstrument_id· ? · optionnel
Exemple d'appel{"name": "financial_prices", "arguments": {"currency": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - forex≈ 705 tokens
Get raw historical FX spot-rate rows for a currency pair (e.g. EUR/USD, USD/JPY) as a plain-text table, raw rows, exact values, or JSON-like data, with optional technical-indicator series (SMA, EMA, RSI, MACD, Bollinger Bands, etc.) computed from spot. Returns data only, without chart metadata. Daily granularity from official central-bank reference rates with full multi-year history. Supported currencies (lowercase 3-letter codes): AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. The optional `indicators` parameter accepts a comma-separated list of technical indicator slugs to attach to each row. Supported indicator values: adx_14, atr_14, bollinger_bands, cci_20, donchian_20, ema_12, ema_20, ema_200, ema_26, ema_50, macd, macd_histogram, macd_signal, rsi_14, sma_20, sma_200, sma_50, stochastic_14_3, williams_r_14, all. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (5)
Paramètresbase· string · requis
Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.quote· string · requis
Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.end_date· ? · optionnel
Inclusive upper bound, YYYY-MM-DD. Defaults to today.indicators· ? · optionnel
Comma-separated technical-indicator slugs to attach to each row. Supported: adx_14, atr_14, bollinger_bands, cci_20, donchian_20, ema_12, ema_20, ema_200, ema_26, ema_50, macd, macd_histogram, macd_signal, rsi_14, sma_20, sma_200, sma_50, stochastic_14_3, williams_r_14, all.start_date· ? · optionnel
Inclusive lower bound, YYYY-MM-DD. Defaults to ~5 years ago.
Exemple d'appel{"name": "forex", "arguments": {"base": "texte", "quote": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - forex_visual_artifact≈ 505 tokens
Returns FX spot-rate history for a currency pair with MCP Apps chart metadata so compatible clients render an interactive spot-rate chart inline. Suited to FX pair time-series and trend requests such as 'show me AUD/USD', 'the last 30 days', or 'how has EUR/USD moved recently'. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (5)
Paramètresbase· string · requis
Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.quote· string · requis
Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.end_date· ? · optionnel
Inclusive upper bound, YYYY-MM-DD.indicators· ? · optionnel
Optional technical indicators to include in the raw payload. Supported: adx_14, atr_14, bollinger_bands, cci_20, donchian_20, ema_12, ema_20, ema_200, ema_26, ema_50, macd, macd_histogram, macd_signal, rsi_14, sma_20, sma_200, sma_50, stochastic_14_3, williams_r_14, all.start_date· ? · optionnel
Inclusive lower bound, YYYY-MM-DD.
Exemple d'appel{"name": "forex_visual_artifact", "arguments": {"base": "texte", "quote": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - fx_backtest_task≈ 727 tokens
Run a spot-only FX backtest using historical policy-rate-differential and/or lagged momentum signals. Downloads complete histories, verifies vintages and price coverage, and charges opening, rebalancing and closing costs. The carry signal does not include funding income or broker rollover. Returns analysis in the tool response. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (10)
Paramètresbase· string · requis
Base currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.quote· string · requis
Quote currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.end_date· ? · optionnel
Inclusive upper bound, YYYY-MM-DD.strategy· ? · optionnel
Signal mode: carry, momentum, or carry_momentum.start_date· ? · optionnel
Inclusive lower bound, YYYY-MM-DD.event_gated· ? · optionnel
When true, allow positions only after verified historical policy publications for either currency. This does not use future calendars or trade before a release.initial_capital· ? · optionnel
Starting capital for equity-curve calculations.event_window_days· ? · optionnel
Additional calendar days after the first UTC decision following publication; 0 permits that first day only.momentum_lookback· ? · optionnel
Momentum lookback in observations for the momentum signal.transaction_cost_bps· ? · optionnel
Per-side transaction cost in basis points applied on position changes.
Exemple d'appel{"name": "fx_backtest_task", "arguments": {"base": "texte", "quote": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - fx_intraday_reference_rates≈ 343 tokens
Return subscriber intraday official FX reference-rate observations for one pair. Coverage is limited to the pairs and sources in the FX reference pair universe. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (4)
Paramètresbase· string · requis
Base currency code.quote· string · requis
Quote currency code.end_time· ? · optionnel
Optional inclusive RFC 3339 source timestamp.start_time· ? · optionnel
Optional inclusive RFC 3339 source timestamp.
Exemple d'appel{"name": "fx_intraday_reference_rates", "arguments": {"base": "texte", "quote": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - fx_reference_sources≈ 169 tokens
List public official FX reference-rate sources and the source policy that governs pair-specific intraday reference-rate series. Access: free for every currency, no API key required.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "fx_reference_sources", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - fx_reference_universe≈ 262 tokens
List the public FX reference-rate pair universe, optionally filtered by currency or source id, showing which pairs and sources have intraday reference-rate series. Access: free for every currency, no API key required.
Paramètres, retour & exemple (2)
Paramètressource· ? · optionnel
Optional official source id filter.currency· ? · optionnel
Optional 3-letter currency filter.
Exemple d'appel{"name": "fx_reference_universe", "arguments": {"source": "texte", "currency": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - fx_trade_setup_task≈ 362 tokens
Build a trader-oriented FX pair setup using spot context, macro differentials, upcoming catalyst risk, and optional COT positioning. Returns analysis in the tool response. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (4)
Paramètresbase· string · requis
Base currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.quote· string · requis
Quote currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.include_cot· ? · optionnel
When true, attempt to include COT positioning context for both legs.horizon_events· ? · optionnel
Maximum upcoming catalysts per leg to rank.
Exemple d'appel{"name": "fx_trade_setup_task", "arguments": {"base": "texte", "quote": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - indicator_intel_task≈ 874 tokens
Build an intelligence pack for one indicator by combining chart-ready series data, derived analytics, and nearest release timing context. Returns analysis in the tool response. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
Paramètres, retour & exemple (4)
Paramètrescurrency· string · requis
3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.end_date· ? · optionnel
Inclusive upper bound, YYYY-MM-DD.indicator· string · requis
Indicator slug for the given currency. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.start_date· ? · optionnel
Inclusive lower bound, YYYY-MM-DD.
Exemple d'appel{"name": "indicator_intel_task", "arguments": {"currency": "texte", "indicator": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - indicator_query≈ 1850 tokens
Get a paginated historical time series of a single macroeconomic indicator for a currency, sourced directly from the official central bank or statistical agency. Covers CPI/inflation, GDP, unemployment, policy rates, bond yields, payrolls, retail sales, PCE, PPI, trade balance, current account, money supply, and similar series. Each row returns `date` (economic reference period), `val` (numeric), and separate publication evidence. The `as_of` parameter restricts results to historically eligible values; current values can include later revisions. Returns raw rows without chart metadata. Each call returns one page, newest first: 100 rows when `start_date` is set, otherwise 20 (`limit` overrides, maximum 100). A page is not the full history. When `pagination.has_more` is true the result has a `partial_page` object: `partial_page.next_call` holds the exact arguments for the next page and `partial_page.pages_remaining` gives the number of pages left. Responses default to official-source rows only; prohibited private aggregator rows are always removed. USD indicators are free; non-USD requires an API key. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. The `indicator` parameter lists the accepted indicator slugs. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
Paramètres, retour & exemple (15)
Paramètrespage· ? · optionnel
One-based page number. When supplied, the REST endpoint derives offset as `(page - 1) * limit`.slug· ? · optionnel
Optional compound `"<currency>:<indicator>"` slug (e.g. `"usd:cpi"`, `"jpy:policy_rate"`). Many small / open tool-calling models concatenate the two parts anyway. When supplied, overrides `currency` and `indicator`.as_of· ? · optionnel
Historical decision cutoff with explicit timezone, or YYYY-MM-DD at UTC midnight; verifies vintages before returning rows.limit· ? · optionnel
Rows per page, newest first, maximum 100. Unset means 100 when `start_date` is set, otherwise 20.offset· integer · optionnel
Zero-based row offset after most-recent-first ordering. Take it from `partial_page.next_call`.currency· ? · optionnel
3-letter ISO currency code (case-insensitive). Optional if `slug` is provided as a `"usd:cpi"`-style compound. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.end_date· ? · optionnel
Inclusive upper bound, YYYY-MM-DD.indicator· ? · optionnel
Indicator slug for the given currency. Optional if `slug` is provided as a `"usd:cpi"`-style compound. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.revisions· ? · optionnel
Revision view: latest, first, final or all. Historical replay uses latest among vintages eligible at as_of.start_date· ? · optionnel
Inclusive lower bound, YYYY-MM-DD.value_mode· ? · optionnel
Value mode: normalized or source. Historical replay defaults to unchanged source values and requires raw series mode.series_mode· ? · optionnel
Series mode: canonical or raw. Historical replay defaults to raw.availability· string · optionnel
Replay clock: public or captured. Used with as_of.official_only· boolean · optionnel
When true, return only official-source rows and remove explicit fallback observations. Prohibited private aggregator rows are always removed.dataset_version· ? · optionnel
Optional content version; use the first page's version on subsequent pages to reject changed data.
Exemple d'appel{"name": "indicator_query", "arguments": {"page": "texte", "slug": "texte", "as_of": "texte", "limit": "texte", "offset": 1, "currency": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - indicator_visual_artifact≈ 1125 tokens
Returns an indicator time series with MCP Apps metadata so compatible clients (Claude Desktop, ChatGPT, Codex, etc.) render an interactive line chart instead of a JSON dump. Suited to indicator time-series requests to show, tell, explain, compare, inspect a trend, or review a recent window. Broad histories page through the `limit`, `offset`, and `page` controls, with `pagination.next_offset` giving the next page. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. The `indicator` parameter lists the accepted indicator slugs. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
Paramètres, retour & exemple (7)
Paramètrespage· ? · optionnel
One-based page number. When supplied, the REST endpoint derives offset as `(page - 1) * limit`.limit· integer · optionnel
Maximum rows to render from the existing REST pagination path. Defaults to 20; maximum 100.offset· integer · optionnel
Zero-based row offset after most-recent-first ordering.currency· string · requis
3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.end_date· ? · optionnel
Inclusive upper bound, YYYY-MM-DD.indicator· string · requis
Indicator slug. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.start_date· ? · optionnel
Inclusive lower bound, YYYY-MM-DD.
Exemple d'appel{"name": "indicator_visual_artifact", "arguments": {"currency": "texte", "indicator": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - known_at_time_task≈ 1034 tokens
Return the slice of a macro series that would have been known at a specific timestamp, selecting verified value vintages before pagination. Returns analysis in the tool response. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
Paramètres, retour & exemple (7)
Paramètresas_of· string · requis
UTC ISO-8601 timestamp or YYYY-MM-DD cutoff (start of UTC day). Only verified value vintages eligible on the selected availability clock are returned.currency· string · requis
3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.end_date· ? · optionnel
Optional inclusive upper bound, YYYY-MM-DD.indicator· string · requis
Indicator slug for the given currency. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.start_date· ? · optionnel
Optional inclusive lower bound, YYYY-MM-DD.availability· string · optionnel
Historical availability clock: public source-publication evidence or captured per-value observation evidence.dataset_version· ? · optionnel
Optional content version returned by a previous replay; a changed dataset returns an error.
Exemple d'appel{"name": "known_at_time_task", "arguments": {"as_of": "texte", "currency": "texte", "indicator": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - latest_announcements≈ 286 tokens
Return the latest stored macroeconomic value for every available indicator in one currency, as a compact current macro snapshot. An unverified announcement_datetime has unproven origin; it is neither a verified scheduled time nor observed actual publication. Report absent schedule, publication and ingestion evidence as unknown, and latency as not measured. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
Paramètres, retour & exemple (1)
Paramètrescurrency· string · requis
3-letter ISO currency code (case-insensitive).
Exemple d'appel{"name": "latest_announcements", "arguments": {"currency": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - latest_commodities≈ 187 tokens
Return the latest stored value for every available commodity indicator in one response, as a batch snapshot of the subscriber commodity series. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "latest_commodities", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - macro_briefing_task≈ 230 tokens
Build a compact macro briefing for a currency by combining catalogue, key macro series, release-calendar, prediction, news, risk-sentiment, COT, seasonality, and FX technical context. Returns analysis in the tool response. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
Paramètres, retour & exemple (1)
Paramètrescurrency· string · requis
3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.
Exemple d'appel{"name": "macro_briefing_task", "arguments": {"currency": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - macro_factor≈ 458 tokens
Return a precomputed macro factor for one currency, with optional stored component scores and source references. The factor is a documented summary value and does not replace the underlying macro releases. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
Paramètres, retour & exemple (8)
Paramètreslimit· integer · optionnel
Maximum rows to return.factor· string · requis
Factor slug, for example monetary_stance.offset· integer · optionnel
Zero-based row offset.currency· string · requis
3-letter ISO currency code (case-insensitive).end_date· ? · optionnel
Optional inclusive end date, YYYY-MM-DD.start_date· ? · optionnel
Optional inclusive start date, YYYY-MM-DD.include_sources· boolean · optionnel
Include public source endpoint references when available.include_components· boolean · optionnel
Include stored component scores when available.
Exemple d'appel{"name": "macro_factor", "arguments": {"factor": "texte", "currency": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - macro_heatmap_task≈ 885 tokens
Build a cross-currency macro heatmap from indicator time series and return a matrix with latest values, recent changes, and z-scores. Returns analysis in the tool response.
Paramètres, retour & exemple (4)
Paramètresend_date· ? · optionnel
Optional inclusive upper bound, YYYY-MM-DD.currencies· ? · optionnel
Comma-separated 3-letter currency codes (lowercase preferred). Supported values include: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.indicators· ? · optionnel
Comma-separated indicator slugs to include in the matrix. Supported values include: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.start_date· ? · optionnel
Optional inclusive lower bound, YYYY-MM-DD.
Exemple d'appel{"name": "macro_heatmap_task", "arguments": {"end_date": "texte", "currencies": "texte", "indicators": "texte", "start_date": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - macro_news≈ 433 tokens
Return recent official central-bank news and press-release headlines for a currency, covering central-bank policy, inflation, employment, GDP, trade, fiscal, energy, and commodity narratives. Rows are official-source headlines with lightweight keyword-derived affected_indicators and sentiment fields when a headline is classifiable. Supported currencies: AUD, BRL, CAD, CHF, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, USD. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
Paramètres, retour & exemple (4)
Paramètreslimit· integer · optionnel
Maximum number of headline rows to request.offset· integer · optionnel
Zero-based headline offset.currency· string · requis
3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, USD.lookback_days· integer · optionnel
Maximum age of returned headlines in calendar days when headline timestamps are available.
Exemple d'appel{"name": "macro_news", "arguments": {"currency": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - macro_regime_classifier_task≈ 322 tokens
Classify a currency's macro regime using policy rate, inflation, GDP, and unemployment context, with explicit assumptions and confidence notes. Returns analysis in the tool response. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
Paramètres, retour & exemple (3)
Paramètrescurrency· string · requis
3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.end_date· ? · optionnel
Optional inclusive upper bound, YYYY-MM-DD.start_date· ? · optionnel
Optional inclusive lower bound, YYYY-MM-DD.
Exemple d'appel{"name": "macro_regime_classifier_task", "arguments": {"currency": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - macro_research_pack_task≈ 952 tokens
Bundles catalogue, indicator history, next release timing, and optional FX pair context into one persistent-host-friendly research payload. Returns analysis in the tool response. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
Paramètres, retour & exemple (6)
Paramètresbase· ? · optionnel
Optional FX base currency for pair context.quote· ? · optionnel
Optional FX quote currency for pair context.currency· string · requis
3-letter ISO currency code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.end_date· ? · optionnel
Optional inclusive upper bound, YYYY-MM-DD.indicator· string · requis
Indicator slug. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.start_date· ? · optionnel
Optional inclusive lower bound, YYYY-MM-DD.
Exemple d'appel{"name": "macro_research_pack_task", "arguments": {"currency": "texte", "indicator": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - macro_war_room_task≈ 1064 tokens
Build a multi-panel macro market cockpit that combines FX sessions, upcoming release queue, pair context, and generated risk alerts. Returns analysis in the tool response. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
Paramètres, retour & exemple (6)
Paramètresbase· ? · optionnel
Base currency for pair context, 3-letter ISO code (case-insensitive). Defaults to the release currency when omitted. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.quote· ? · optionnel
Quote currency for pair context, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.currency· ? · optionnel
Release currency used for queue and spotlight indicator. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.end_date· ? · optionnel
Optional inclusive upper bound, YYYY-MM-DD.indicator· ? · optionnel
Spotlight indicator slug for release context. Supported examples: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.start_date· ? · optionnel
Optional inclusive lower bound, YYYY-MM-DD.
Exemple d'appel{"name": "macro_war_room_task", "arguments": {"base": "texte", "quote": "texte", "currency": "texte", "end_date": "texte", "indicator": "texte", "start_date": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - market_sessions≈ 287 tokens
Returns which FX trading sessions are currently open (Sydney, Tokyo, London, New York) and when the next session opens or closes, for questions such as 'is the market open?', 'when does London open?', or 'which sessions overlap right now?'. An ISO-8601 UTC timestamp in `at` returns the snapshot for a specific moment instead of now. Accounts for weekends and major banking holidays. Access: free, no API key required.
Paramètres, retour & exemple (1)
Paramètresat· ? · optionnel
Optional ISO-8601 UTC timestamp; defaults to now. Use to snapshot session state at a specific moment.
Exemple d'appel{"name": "market_sessions", "arguments": {"at": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - mcp_auth_guide≈ 134 tokens
Explains which authentication mode suits FXMacroData MCP across major clients and platforms: OAuth, an API key, or a bearer token, for ChatGPT/OpenAI Apps, Claude/Anthropic, Microsoft/VS Code/Copilot-style clients, AstrBot, Cursor, Codex, local scripts, and CI.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "mcp_auth_guide", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - mcp_capabilities≈ 162 tokens
Explains what the FXMacroData MCP server can do: which tools render MCP Apps, which return plain rows, what is public versus subscriber-only, and how tool selection differs across ChatGPT, Claude, Cursor, Codex, and plain MCP clients. Suited to questions about what is available, why visuals are not showing, or how to get the same result in a different interface.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "mcp_capabilities", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - official_dataset_family≈ 559 tokens
Get metadata-first official dataset payloads grouped by API endpoint type. `endpoint_type` selects the API taxonomy group and `dataset` selects the specific series family. Supported endpoint types: monetary_policy, fiscal_policy, international_trade, statistics_releases. Supported datasets: auction_metrics, bop, capital_flows, cb_liquidity, credit_conditions, external_debt, fx_intervention, iip, services_trade, treasury_cash, wage_settlements. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (4)
Paramètresdataset· string · requis
Dataset slug within the selected endpoint_type. Supported: auction_metrics, bop, capital_flows, cb_liquidity, credit_conditions, external_debt, fx_intervention, iip, services_trade, treasury_cash, wage_settlements.currency· string · requis
3-letter ISO currency code (case-insensitive).component· ? · optionnel
Required only when dataset='bop'. Supported bop components: goods_balance, services_balance, primary_income, secondary_income, current_account, capital_account, financial_account.endpoint_type· string · requis
Endpoint taxonomy group from the API structure. Supported: monetary_policy, fiscal_policy, international_trade, statistics_releases.
Exemple d'appel{"name": "official_dataset_family", "arguments": {"dataset": "texte", "currency": "texte", "endpoint_type": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - pair_intel_task≈ 370 tokens
Build an intelligence pack for an FX pair by combining policy-rate spread context, spot-rate context, and release-timing metadata. Returns analysis in the tool response. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (4)
Paramètresbase· string · requis
Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.quote· string · requis
Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.end_date· ? · optionnel
Inclusive upper bound, YYYY-MM-DD.start_date· ? · optionnel
Inclusive lower bound, YYYY-MM-DD.
Exemple d'appel{"name": "pair_intel_task", "arguments": {"base": "texte", "quote": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - ping≈ 131 tokens
Health check that confirms the FXMacroData API and MCP server are reachable. Returns the API health response.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "ping", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - plot_visual_artifact≈ 2049 tokens
Build a generic MCP Apps chart from one or more FXMacroData endpoint families: arbitrary plots, multi-series charts, and actual-vs-consensus views that combine announcements with predictions. Supported series sources are announcements, predictions, forex, commodities, and cot. For example, USD policy-rate midpoint actuals against market consensus use one announcements series for `usd/policy_rate_midpoint` and one predictions series for `usd/policy_rate_midpoint` with `prediction_class=forecaster_survey`. The tool does not fetch arbitrary URLs or run custom chart code; it only composes approved FXMacroData API surfaces into the comparison chart app. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
Paramètres, retour & exemple (19)
Paramètresbase· ? · optionnel
Base currency for single-series forex plots. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.page· ? · optionnel
One-based page number per source.limit· integer · optionnel
Maximum rows per source. Defaults to 20; maximum 100.query· ? · optionnel
Optional natural-language request to preserve in the payload title/context.quote· ? · optionnel
Quote currency for single-series forex plots. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.title· ? · optionnel
Optional chart title. Defaults to query or an auto-generated title.y_key· ? · optionnel
Single-series metric field. Defaults by source: val for announcements and commodities, predicted_value for predictions, rate for forex, noncommercial_net for COT.offset· integer · optionnel
Zero-based row offset per source.series· ? · optionnel
Optional list of series specs. Each spec supports `source` (announcements, predictions, forex, commodities, cot), `currency`, `indicator`, `base`, `quote`, `label`, `y_key`, `metric`, `prediction_class`, `prediction_source`, `start_date`, `end_date`, `limit`, `offset`, and `page`.source· ? · optionnel
Single-series source when `series` is omitted. Supported values: announcements, predictions, forex, commodities, cot.x_axis· string · optionnel
Field to use as the shared x-axis. Supported: date, announcement_datetime, announcement_datetime_local, generated_at, observation_datetime.y_label· ? · optionnel
Optional y-axis label for the chart.currency· ? · optionnel
Single-series currency for announcements, predictions, or COT. Supported macro currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. Supported COT currencies: AUD, CAD, CHF, EUR, GBP, JPY, NZD, USD, XAU.end_date· ? · optionnel
Inclusive upper bound, YYYY-MM-DD.indicator· ? · optionnel
Single-series indicator for announcements, predictions, or commodities. Supported macro indicators: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages. Supported commodity indicators: crude_oil_inventories, gold, natural_gas, natural_gas_storage, oil_brent, oil_wti, platinum, silver.chart_kind· string · optionnel
Initial chart view. Supported: line, area, bar, dot, step.start_date· ? · optionnel
Inclusive lower bound, YYYY-MM-DD.prediction_type· ? · optionnel
Optional legacy prediction-type filter for prediction series. Superseded by prediction_class.prediction_source· ? · optionnel
Optional prediction source filter for prediction series.
Exemple d'appel{"name": "plot_visual_artifact", "arguments": {"base": "texte", "page": "texte", "limit": 1, "query": "texte", "quote": "texte", "title": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - policy_rate_differential_visual_artifact≈ 380 tokens
Build a two-series chart comparing base and quote policy-rate history to visualize the rate differential setup for an FX pair. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (4)
Paramètresbase· string · requis
Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.quote· string · requis
Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.end_date· ? · optionnel
Inclusive upper bound, YYYY-MM-DD.start_date· ? · optionnel
Inclusive lower bound, YYYY-MM-DD.
Exemple d'appel{"name": "policy_rate_differential_visual_artifact", "arguments": {"base": "texte", "quote": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - policy_scenario_modeler_task≈ 600 tokens
Run a policy-rate spread what-if scenario for an FX pair and estimate directional spot impact using an explicit heuristic elasticity assumption. Returns analysis in the tool response. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (8)
Paramètresbase· string · requis
Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.quote· string · requis
Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.end_date· ? · optionnel
Optional inclusive upper bound, YYYY-MM-DD.shock_bps· ? · optionnel
Policy shock size in basis points (100 bps = 1.00 percentage point).shock_leg· ? · optionnel
Which leg receives the policy shock: base or quote.start_date· ? · optionnel
Optional inclusive lower bound, YYYY-MM-DD.policy_shock_bps· ? · optionnel
Optional alias for shock_bps for compatibility with host-side app payloads.elasticity_per_100bps· ? · optionnel
Heuristic percent change in FX spot for a 100 bps spread change. Used as a scenario assumption, not a forecast guarantee.
Exemple d'appel{"name": "policy_scenario_modeler_task", "arguments": {"base": "texte", "quote": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - portfolio_risk_engine_task≈ 343 tokens
Analyze a multi-position FX book for concentration, stress exposure, and event-driven catalyst risk. Returns analysis in the tool response. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (3)
Paramètreshorizon_events· ? · optionnel
Maximum release events to consider per currency leg.positions_json· string · requis
JSON array of FX positions. Each item should include base, quote, side (long/short), and notional. Example: [{"base":"eur","quote":"usd","side":"long","notional":100000}]stress_shock_pct· ? · optionnel
Stress shock in percent applied to each pair.
Exemple d'appel{"name": "portfolio_risk_engine_task", "arguments": {"positions_json": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - prediction_coverage≈ 418 tokens
List which publishers produce pre-release forecasts for a currency's indicators, what class of forecast each one is (compiled consensus, forecaster survey, market implied, model nowcast, central-bank projection), whether any of them is a genuine consensus, and how far the verified archive runs. Suited to questions about whether a consensus, forecast or estimate exists for a release, such as 'do you have the consensus for US CPI' or 'what forecast do you have for payrolls'. It needs no API key and works for every served currency. It returns no forecast values: those require a subscription. Its answer distinguishes two cases: no publisher produces this forecast for anybody (no subscription adds it), versus the data exists and is behind the paywall. A pair listed here exists in the verified archive. Access: free for every currency, no API key required. It returns coverage metadata only; forecast values need a subscription.
Paramètres, retour & exemple (1)
Paramètrescurrency· ? · optionnel
Optional 3-letter currency code. Omit for the cross-currency summary; pass one for per-indicator detail.
Exemple d'appel{"name": "prediction_coverage", "arguments": {"currency": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - press_releases≈ 286 tokens
Return the public central-bank press-release archive for a currency as the original official release rows, without derived sentiment or indicator classifications. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
Paramètres, retour & exemple (3)
Paramètreslimit· integer · optionnel
Maximum rows to return.offset· integer · optionnel
Zero-based row offset.currency· string · requis
3-letter ISO currency code (case-insensitive).
Exemple d'appel{"name": "press_releases", "arguments": {"currency": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - quant_scenario_lab_task≈ 618 tokens
Run an expanded quant-style policy scenario for an FX pair with deterministic projection, stress percentiles, and horizon assumptions. Returns analysis in the tool response. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (9)
Paramètresbase· string · requis
Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.quote· string · requis
Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.end_date· ? · optionnel
Optional inclusive upper bound, YYYY-MM-DD.shock_bps· ? · optionnel
Policy shock size in basis points (100 bps = 1.00 percentage point).shock_leg· ? · optionnel
Which leg receives the policy shock: base or quote.start_date· ? · optionnel
Optional inclusive lower bound, YYYY-MM-DD.horizon_days· ? · optionnel
Scenario horizon in calendar days.elasticity_per_100bps· ? · optionnel
Heuristic percent FX move per 100 bps spread change.annualized_volatility_pct· ? · optionnel
Annualized volatility assumption (percent) for stress-band construction.
Exemple d'appel{"name": "quant_scenario_lab_task", "arguments": {"base": "texte", "quote": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - rate_curve≈ 380 tokens
Return official government-nominal curve nodes, slopes, or derived forward segments for one currency. This is a subscriber data tool and preserves the endpoint's requested view and method metadata. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (6)
Paramètresdate· ? · optionnel
Optional target date, YYYY-MM-DD.view· string · optionnel
Curve view: nodes, slopes, or forwards.method· string · optionnel
Forward derivation method when view is forwards.metric· string · optionnel
Curve metric.currency· string · requis
3-letter currency code.curve_family· string · optionnel
Official curve family.
Exemple d'appel{"name": "rate_curve", "arguments": {"currency": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - rate_differentials≈ 531 tokens
Return the stored or derived rate differential for one FX pair, with the measure, rate type, curve family, and tenor metadata that define it. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (11)
Paramètresbase· string · requis
Base currency code.limit· integer · optionnel
Maximum rows to return.quote· string · requis
Quote currency code.offset· integer · optionnel
Zero-based row offset.measure· string · optionnel
Shared rate measure to compare across the pair.end_date· ? · optionnel
Optional inclusive end date, YYYY-MM-DD.rate_type· string · optionnel
Differential type: spot or forward.start_date· ? · optionnel
Optional inclusive start date, YYYY-MM-DD.curve_family· string · optionnel
Curve family when rate_type is forward.end_tenor_years· number · optionnel
End tenor in years for forward differentials.start_tenor_years· number · optionnel
Start tenor in years for forward differentials.
Exemple d'appel{"name": "rate_differentials", "arguments": {"base": "texte", "quote": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - release_calendar≈ 1114 tokens
Get upcoming scheduled macroeconomic release timestamps for a currency, for questions such as when the next CPI, GDP, payrolls, or policy decision is due. Returns ISO-8601 announcement_datetime values in UTC plus market-local timestamps, a markdown agenda, and Release Calendar App metadata. The optional `timezone` adds an `announcement_datetime_requested_timezone` field. Each row has a `release` string with the indicator name and a `currency` code. Unbounded calls return future releases only. The optional `indicator` filter narrows to a single series, and optional `start_date` and `end_date` bounds select a month, week, day, or explicit date range. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, COMM, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. The `indicator` parameter lists the accepted indicator slugs. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
Paramètres, retour & exemple (5)
Paramètrescurrency· string · requis
3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, COMM, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.end_date· ? · optionnel
Optional inclusive upper bound, YYYY-MM-DD.timezone· ? · optionnel
Optional IANA timezone for an additional converted timestamp, for example America/Sao_Paulo.indicator· ? · optionnel
Optional indicator slug to narrow results. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.start_date· ? · optionnel
Optional inclusive lower bound, YYYY-MM-DD.
Exemple d'appel{"name": "release_calendar", "arguments": {"currency": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - release_calendar_visual_artifact≈ 1077 tokens
Returns the release calendar payload with MCP Apps metadata so compatible clients render the interactive Release Calendar App inline. Suited to requests to show, display, visualize, or render a macro release calendar, such as 'show me the AUD release calendar'. Optional `indicator`, `start_date`, and `end_date` filters narrow the calendar to a series, month, week, day, or date range; `timezone` adds local times for a specific city or region. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, COMM, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. The `indicator` parameter lists the accepted indicator slugs. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
Paramètres, retour & exemple (5)
Paramètrescurrency· string · requis
3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, COMM, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.end_date· ? · optionnel
Optional inclusive upper bound, YYYY-MM-DD.timezone· ? · optionnel
Optional IANA timezone for an additional converted timestamp, for example America/Sao_Paulo.indicator· ? · optionnel
Optional indicator slug to narrow results. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.start_date· ? · optionnel
Optional inclusive lower bound, YYYY-MM-DD.
Exemple d'appel{"name": "release_calendar_visual_artifact", "arguments": {"currency": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - release_risk_score_task≈ 312 tokens
Score upcoming releases for a currency pair using release-calendar proximity and indicator-level heuristics. Returns analysis in the tool response. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (3)
Paramètresbase· string · requis
Base currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.quote· string · requis
Quote currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.horizon_events· ? · optionnel
Maximum release events per currency to score.
Exemple d'appel{"name": "release_risk_score_task", "arguments": {"base": "texte", "quote": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - risk_sentiment≈ 295 tokens
Return the global risk-on/risk-off sentiment series used for FX regime analysis. The result includes a derived composite score, regime label, component contributions, pagination, and data_quality metadata. Suited to cross-asset regime context for high-beta, safe-haven, commodity, or USD-defensive FX conditions. Access: free, no API key required.
Paramètres, retour & exemple (2)
Paramètresend_date· ? · optionnel
Optional inclusive end date in YYYY-MM-DD format.start_date· ? · optionnel
Optional inclusive start date in YYYY-MM-DD format.
Exemple d'appel{"name": "risk_sentiment", "arguments": {"end_date": "texte", "start_date": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - risk_sentiment_changes≈ 302 tokens
Poll retained risk-sentiment additions, score revisions, and input-metadata changes. Pass pagination.next_after_sequence as after_sequence on the next page or poll. Recording timestamps describe when FXMacroData stored each change; earlier untracked revisions and publisher publication times are unavailable. Access: free, no API key required.
Paramètres, retour & exemple (2)
Paramètreslimit· integer · optionnel
Maximum retained changes per page. Defaults to 20; maximum 100.after_sequence· integer · optionnel
Return recorded changes after this sequence, exclusively.
Exemple d'appel{"name": "risk_sentiment_changes", "arguments": {"limit": 1, "after_sequence": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - seasonality≈ 421 tokens
Get monthly return seasonality for an FX pair or XAU/USD, covering seasonal patterns, month-of-year tendency, historical monthly win rate, and XAUUSD/gold seasonality. Returns monthly average return, median return, win rate, sample size, dispersion, and per-year monthly returns from stored FX or gold series. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Paramètres, retour & exemple (4)
Paramètresmonth· ? · optionnel
Optional month filter, 1-12 or name such as July.end_date· ? · optionnel
Inclusive upper bound, YYYY-MM-DD. Defaults to today.instrument· string · requis
Six-letter pair such as EURUSD, AUDUSD, USDJPY, or XAUUSD. Slashes and separators are accepted by the REST endpoint only when passed as a single string.lookback_years· ? · optionnel
Number of years to include, 2-30. Defaults to 10.
Exemple d'appel{"name": "seasonality", "arguments": {"instrument": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - subscribe_for_mcp_access≈ 113 tokens
Returns FXMacroData subscription options and a direct checkout path for unlocking MCP app visuals, charts, and advanced analytical tools.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "subscribe_for_mcp_access", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]}
C'est votre serveur ?
Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».