Introducing the Currency Latest Endpoint: One Call for the Full Macro Snapshot

Scanning the macro state of a currency used to mean firing a separate API call for each indicator — one for inflation, one for unemployment, one for the policy rate, and so on. Starting today, you can retrieve the latest value, the preceding print, and the period-over-period percent change for every indicator in a single authenticated request. The same one-call pattern is now available for COT positioning and commodity prices.

ニュースは?

Three new /latest 総結末点はFXMacroData APIで起動しています:

回答には最高レベルの 回答が含まれています as_of 単一の行を解析せずに常にデータ通貨を知ることができます.各指標エントリは一貫した形をとります:

• 指標 発表のエンドポイントに一致する定例スラグ
• ユニット ほら 頻度 データカタログから,二度目検索なしで値を正しくフォーマットできます
• 最新 dateほら valほら announcement_datetime 最新版の
• 前回 同じ分野での前述の観察
• pct_diff_prev について 前回から最近までの前回数値から前回数の数値まで丸める %の変化

COTデータについては, pct_diff_prev is a map rather than a scalar — one percentage change per numeric positioning field (open interest, non-commercial long and short, net positions, and so on) — because the full COT snapshot is multi-dimensional.

商人 に とっ て 重要 な 理由

If your system monitors seven currencies — something like USD, EUR, GBP, AUD, JPY, CAD, and CHF — with ten to fifteen indicators each, a naive polling loop can require over a hundred individual API calls to update a dashboard or feed a model. Beyond network overhead, that approach also means processing partial state: your USD inflation value might be two seconds older than your USD unemployment value, depending on when each request completed.

ほら /latest ファイアストア広告ストアから読み取れるエンドポイントは,完全な歴史的シリーズをバックアップするデータと同じで,総呼び出しによって独立したキャッシュや遅延が導入されない.返ってくるデータは,各指標を個別にクエリする 것과同じです.

実践例:USDマクロスナップショット

ニューヨークオープン前はアメリカ経済を監視している /latest endpoint は,それぞれが前のプリントと,その間の変化を表示した,すべての追跡指標の現在の状態を返します:

curl "https://fxmacrodata.com/api/v1/announcements/usd/latest?api_key=YOUR_API_KEY"

代表的な応答 (三つの指標に切り離):

{
  "currency": "USD",
  "source": "store",
  "as_of": "2026-03-31",
  "count": 14,
  "data": [
    {
      "indicator": "inflation",
      "unit": "%",
      "frequency": "Monthly",
      "has_official_forecast": false,
      "latest": {
        "date": "2026-02-28",
        "val": 2.8,
        "announcement_datetime": 1772433000
      },
      "previous": {
        "date": "2026-01-31",
        "val": 2.9,
        "announcement_datetime": 1769754600
      },
      "pct_diff_prev": -3.45
    },
    {
      "indicator": "non_farm_payrolls",
      "unit": "Persons",
      "frequency": "Monthly",
      "has_official_forecast": false,
      "latest": {
        "date": "2026-03-31",
        "val": 228000,
        "announcement_datetime": 1774857000
      },
      "previous": {
        "date": "2026-02-28",
        "val": 151000,
        "announcement_datetime": 1772256600
      },
      "pct_diff_prev": 50.99
    },
    {
      "indicator": "unemployment",
      "unit": "%",
      "frequency": "Monthly",
      "has_official_forecast": false,
      "latest": {
        "date": "2026-03-31",
        "val": 4.1,
        "announcement_datetime": 1774857000
      },
      "previous": {
        "date": "2026-02-28",
        "val": 4.1,
        "announcement_datetime": 1772256600
      },
      "pct_diff_prev": 0.0
    }
  ]
}

取引先やモデルがすぐに見ることができる ドルインフレ 農地以外の賃金は前月よりも著しく上昇した. 失業率 held flat. That combination — stronger employment against softer inflation — is enough to shape a view on the near-term Fed path without opening a second request.

実践例: EUR/USD COT スキャン

取引者のコミットメントは毎週公表されます. /latest endpoint は,フィールドごとにパーセント変化を表示した,前週のスナップショットと並べて,最新の完全なスナプショットを返します. fx_overlay グラフの重複のためのペア:

curl "https://fxmacrodata.com/api/v1/cot/eur/latest?api_key=YOUR_API_KEY"

代表者の回答は

{
  "currency": "EUR",
  "instrument": "EURO FX - CHICAGO MERCANTILE EXCHANGE",
  "fx_overlay": { "pair": "EUR/USD" },
  "source": "store",
  "latest": {
    "date": "2026-03-25",
    "announcement_datetime": 1774478400,
    "open_interest": 612380,
    "noncommercial_long": 198450,
    "noncommercial_short": 108900,
    "noncommercial_net": 89550
  },
  "previous": {
    "date": "2026-03-18",
    "announcement_datetime": 1773873600,
    "open_interest": 598200,
    "noncommercial_long": 184200,
    "noncommercial_short": 112100,
    "noncommercial_net": 72100
  },
  "pct_diff_prev": {
    "open_interest": 2.37,
    "noncommercial_long": 7.74,
    "noncommercial_short": -2.86,
    "noncommercial_net": 24.2
  }
}

ある回答では,ポジショニングシステムでは,EURの投機的なロングは週比で7.74%増加し,ショートは2.86%収縮し,純ロングポジションは24%以上拡大したことが確認されています.非商業的なネットポジショনিংのこの変化は,顧客側からの算術なしですぐに実行できます.

実践例: Python での商品状態

商品をそれぞれ独立して 収集する代わりに /latest endpoint returns all supported commodity indicators in a single call. Here is a minimal Python example that fetches the full snapshot and flags any commodity that has moved more than 2% since its prior print:

import requests

FXMD_API_KEY = "YOUR_API_KEY"
BASE_URL = "https://fxmacrodata.com/api/v1"

def commodities_movers(threshold_pct: float = 2.0):
    resp = requests.get(
        f"{BASE_URL}/commodities/latest",
        params={"api_key": FXMD_API_KEY},
        timeout=10,
    )
    resp.raise_for_status()
    payload = resp.json()

    movers = [
        entry for entry in payload["data"]
        if entry.get("pct_diff_prev") is not None
        and abs(entry["pct_diff_prev"]) >= threshold_pct
    ]

    print(f"Commodities snapshot as of {payload['as_of']}")
    for m in movers:
        direction = "▲" if m["pct_diff_prev"] > 0 else "▼"
        print(
            f"  {m['indicator']:20s}"
            f"  latest={m['latest']['val']} {m['unit']}"
            f"  {direction} {abs(m['pct_diff_prev']):.2f}% vs prior"
        )

commodities_movers(threshold_pct=2.0)

スクリプトは,どの商品指標が追跡されているかにかかわらず,単一のAPIコールを行います. 戦略に適した商品アラートルールを構築するために,スローシュールを変更またはフィルター条件を拡張します.

完全 発表 の 終点 と 調和 する 方法

ほら /latest タイムシーンの必要性があるとき 逆テスト,ローリング・平均値の構築,年比の計算,チャートを描く 発表 終了点 通貨のマクロ状態を把握するには, /latestほら

ほら /latest 公開予定のタイミングを把握するためにリリースカレンダーに投票して,電話をかけてください /latest 印刷された指標の詳細な文脈が必要なら 傾向,季節比較,修正履歴 その特定の指標への全シリーズをターゲットに呼び出す.

総リクエスト量は,データ公開の通貨数と比例するので, 指示者のインベントリサイズとは関係ありません.

始めよう

通貨の発表,COTデータ,商品価格など,すべての発表には, ?api_key= 検索パラメータ