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

화폐의 거시 상태를 스캔하는 것은 각 지표에 대해 별도의 API 호출을 발사하는 것을 의미했습니다. 인플레이션, 실업, 정책율 등에 대한 하나. 오늘부터, 당신은 최신 값, 이전 인쇄 및 한 인증 요청에서 각 지표를위한 기간-대 기간 비율 변화를 검색 할 수 있습니다. 동일한 한 통화 패턴은 이제 COT 위치 및 상품 가격에 사용할 수 있습니다

무슨 일이야?

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
    }
  ]
}

이 단 하나의 응답에서 거래자나 모델은 즉시 그 제목을 읽을 수 있습니다. 미국 달러 인플레이션 월간 경미하게 감소했으며 비농업 임금은 전달보다 크게 증가했습니다. 실업률 이 조합은 낮은 인플레이션에 비해 더 강한 고용은 두 번째 요청을 열지 않고도

실제 예제: EUR/USD COT 스캔

CFTC의 거래자 의약품 보고서는 매주 발표됩니다. /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% 이상 확대되었습니다. 비상업적 순 위치화의 변화는 고객 측의 수학 없이 즉시 실행 가능합니다.

실용적인 예제: 파이썬에서 상품 상태

각 상품을 일정으로 독립적으로 조사하는 대신, 상품은 /latest 엔드포인트 (endpoint) 는 하나의 호출에서 지원되는 모든 상품 지표를 반환합니다. 여기 전체 스냅샷을 가져와 이전 인쇄 이후 2% 이상 이동한 모든 상품을 표시하는 최소한의 파이썬 예가 있습니다:

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 현재 상태를 갱신하기 위해 한 번. 인쇄된 지표의 더 깊은 맥락을 필요로 하는 경우 트렌드, 계절 비교, 수정 역사 해당 특정 지표에 대한 전체 시리즈를 대상으로 호출하십시오.

이렇게 하면 전체 요청 양이 특정 세션에서 실제로 얼마나 많은 통화가 데이터를 공개하는지 비례하게 유지됩니다. 지표 재고의 크기에 비례하지 않습니다.

시작 하십시오

USD 발표는 공개됩니다. 다른 모든 통화 발표, COT 데이터, 그리고 상품 가격에는 ?api_key= 쿼리 매개 변수