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

मुद्रा की मैक्रो स्थिति को स्कैन करने का मतलब प्रत्येक संकेतक के लिए एक अलग एपीआई कॉल मुद्रास्फीति के लिए, बेरोजगारी के लिए और नीति दर के लिए चलाया जाता था। आज से, आप एक ही प्रमाणित अनुरोध में प्रत्येक संकेत के लिए नवीनतम मूल्य, पिछले प्रिंट और अवधि-दर-अवधि प्रतिशत परिवर्तन प्राप्त कर सकते हैं। समान एक-कॉल पैटर्न अब सीओटी पोजिशनिंग और कमोडिटी की कीमतों के लिए उपलब्ध है।

क्या नया है

तीन नए /latest कुल समापन बिंदु FXMacroData एपीआई में लाइव हैंः

हर उत्तर में शीर्ष स्तर का एक उत्तर शामिल है। as_of प्रत्येक सूचक प्रविष्टि एक सुसंगत आकार का अनुसरण करती हैः

• सूचक घोषणाओं के अंत बिंदु से मेल खाने वाला कैनोनिक स्लग
• इकाई और आवृत्ति डेटा कैटलॉग से, ताकि आप दूसरे खोज के बिना सही ढंग से मानों को स्वरूपित कर सकें
• नवीनतम date, val, और announcement_datetime नवीनतम छपाई का
• पूर्ववर्ती एक ही क्षेत्र में पिछले अवलोकन
• pct_diff_prev पूर्व-गणित प्रतिशत परिवर्तन पिछले से नवीनतम तक, दो दशमलव स्थानों तक गोल

सीओटी डेटा के लिए, pct_diff_prev स्केलर के बजाय एक नक्शा है संख्यात्मक स्थिति क्षेत्र (खुले ब्याज, गैर-वाणिज्यिक लंबी और छोटी, शुद्ध पदों, आदि) के प्रति एक प्रतिशत परिवर्तन क्योंकि पूर्ण सीओटी स्नैपशॉट बहुआयामी है।

व्यापारियों के लिए यह क्यों मायने रखता है

यदि आपका सिस्टम सात मुद्राओं की निगरानी करता है कुछ USD, EUR, GBP, AUD, JPY, CAD, और CHF प्रत्येक के साथ दस से पंद्रह संकेतक, एक भोले पोलिंग लूप में डैशबोर्ड को अपडेट करने या मॉडल को फ़ीड करने के लिए सौ से अधिक व्यक्तिगत एपीआई कॉल की आवश्यकता हो सकती है। नेटवर्क ओवरहेड के अलावा, उस दृष्टिकोण का मतलब आंशिक स्थिति की प्रक्रिया भी हैः आपका USD मुद्रास्फीति मूल्य आपके USD बेरोजगारी मूल्य से दो सेकंड पुराना हो सकता है, यह इस बात पर निर्भर करता है कि प्रत्येक अनुरोध कब पूरा हुआ।

/latest फायरस्टोर घोषणा स्टोर से पढ़े गए अंत बिंदु वही डेटा जो पूर्ण ऐतिहासिक श्रृंखला का समर्थन करता है इसलिए कुल कॉल द्वारा कोई अलग कैश या लेग नहीं है। आपको जो डेटा मिलता है वह प्रत्येक संकेतक को व्यक्तिगत रूप से पूछने के समान है।

व्यावहारिक उदाहरणः यूएसडी मैक्रो स्नैपशॉट

आप न्यूयॉर्क ओपन से पहले अमेरिका की व्यापक तस्वीर की निगरानी कर रहे हैं। /latest अंत बिंदु प्रत्येक ट्रैक किए गए संकेतक की वर्तमान स्थिति, प्रत्येक के साथ अपने पिछले प्रिंट और उनके बीच परिवर्तन देता हैः

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 स्कैन

सीएफटीसी की ट्रेडर्स की प्रतिबद्धता रिपोर्ट साप्ताहिक रूप से प्रकाशित होती है। /latest endpoint पिछले सप्ताह के स्नैपशॉट के साथ सबसे हाल का पूर्ण स्नैपट, प्रति फ़ील्ड प्रतिशत परिवर्तन के साथ लौटाता है। EUR के लिए कॉल में पारंपरिक 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
  }
}

एक प्रतिक्रिया में, एक पोजिशनिंग सिस्टम देख सकता है कि यूआर के सट्टा लंबे सप्ताह-दर-सप्ताह 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)

स्क्रिप्ट एक एकल एपीआई कॉल करता है चाहे कितने भी कमोडिटी संकेतक ट्रैक किए जाते हैं। अपनी रणनीति के अनुरूप कमोडीटी अलर्ट नियम बनाने के लिए सीमा को स्वैप करें या फ़िल्टर स्थितियों का विस्तार करें।

यह पूर्ण घोषणाओं के अंत बिंदु के साथ कैसे फिट बैठता है

/latest अंत बिंदुओं को स्थिति-जागरूकता के लिए डिज़ाइन किया गया है, इतिहास के लिए नहीं। जब आपको समय श्रृंखला बैकटेस्टिंग, चलती औसत का निर्माण, साल-दर-साल तुलना की गणना या चार्ट तैयार करने की आवश्यकता होती है पूर्ण का उपयोग करें घोषणाएं अंत बिंदु जब आप एक मुद्रा की वर्तमान मैक्रो स्थिति अभी पता करने की जरूरत है, का उपयोग करें /latest. .

/latest एंडपॉइंट इवेंट-ड्राइव वर्कफ़्लो में अच्छी तरह से काम करता हैः रिलीज कैलेंडर में पोल करें ताकि यह पता चल सके कि प्रिंट कब होना है, फिर कॉल करें /latest यदि आपको मुद्रित सूचक के लिए गहरा संदर्भ चाहिए रुझान, मौसमी तुलना, संशोधन इतिहास उस विशिष्ट सूचक पर लक्षित पूर्ण श्रृंखला कॉल के साथ अनुवर्ती कार्रवाई करें।

इससे कुल अनुरोध मात्रा आपके सूचक सूची के आकार के अनुरूप नहीं बल्कि किसी दिए गए सत्र में वास्तव में कितने मुद्राओं में डेटा प्रकाशित होता है, उसके अनुपात में रहती है।

शुरू करो

अमरीकी डालर की घोषणाएँ सार्वजनिक होती हैं. अन्य सभी मुद्रा घोषणाओं, सीओटी डेटा और वस्तुओं के मूल्य के लिए एक प्रमाणित एपीआई कुंजी की आवश्यकता होती है जो ?api_key= क्वेरी पैरामीटर.