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

كان مسح حالة العملة الكلية يعني إطلاق مكالمة API منفصلة لكل مؤشر واحدة للتضخم ، واحدة للبطالة ، واحدة لسعر الفائدة ، وهلم جرا. بدءًا من اليوم ، يمكنك استرداد أحدث قيمة ، والطباعة السابقة ، والتغير في النسبة المئوية على الفترة لكل مؤشرات في طلب موثوق واحد. نفس نمط المكالمة الواحدة متاح الآن لموقع COT وأسعار السلع.

ما الجديد

ثلاثة جدد /latest يتم تشغيل نقاط النهاية المجمعة في FXMacroData API:

كل رد يتضمن مستوى عال as_of يتم استخلاص تاريخ من أحدث مؤشر في مجموعة البيانات، بحيث تعرف دائما عملة البيانة دون تحليل الصفوف الفردية. يتبع كل إدخال مؤشر شكل متسق:

• مؤشر القشرة القانونية التي تتطابق مع نقطة النهاية للإعلانات
• الوحدة و التردد من كتالوج البيانات، حتى تتمكن من تنسيق القيم بشكل صحيح دون البحث الثاني
• أحدث date- لا valو announcement_datetime من أحدث طبعة
• السابقة الملاحظة السابقة في نفس المجالات
• pct_diff_prev التغير المئوي المحسوب مسبقاً من السابق إلى الأخير، مقربة إلى مكانين عشريين

بالنسبة لبيانات COT، pct_diff_prev هي خريطة بدلا من مقياسية تغيير واحد في المئة لكل حقل تحديد المواقع الرقمية (المصلحة المفتوحة، غير التجارية طويلة وقصيرة، المراكز الصافية، وهلم جرا) لأن اللقطة الكاملة COT متعددة الأبعاد.

لماذا يهم ذلك التجار

إذا كان نظامك يراقب سبع عملات مثل USD، EUR، GBP، AUD، JPY، CAD، وCHF مع عشرة إلى خمسة عشر مؤشرا لكل منها، فإن حلقة استطلاع سرية قد تتطلب أكثر من مائة مكالمة API فردية لتحديث لوحة التحكم أو تغذية نموذج. بالإضافة إلى تكاليف الشبكة، فإن هذا النهج يعني أيضًا معالجة الحالة الجزئية: قد تكون قيمة التضخم بالدولار أكبر بسنتين من قيمة البطالة بالدولار، اعتمادًا على وقت استكمال كل طلب.

- ... /latest النقاط النهائية التي يتم قراءتها من متجر إعلانات Firestore نفس البيانات التي تدعم السلسلة التاريخية الكاملة لذلك لا يوجد ذاكرة تخزين متخلفة منفصلة أو تأخير يتم إدخالها من قبل المكالمة المجمعة. البيانة التي تحصل عليها هي نفسها عند استفسار كل مؤشر بشكل فردي.

مثال عملي: USD ماكرو صورة فورية

أنت تراقب الصورة الكلية للولايات المتحدة قبل افتتاح نيويورك /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

يتم نشر تقارير التزام التجار من قبل CFTC أسبوعيا. /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
  }
}

في إحدى الردود، يمكن لنظام التوجه أن يرى أن المراتب الطويلة المضاربة لـ EUR ارتفعت بنسبة 7.74٪ في الأسبوع على أسبوع بينما انخفضت المراتبة القصيرة بنسبة 2.86٪، مما يوسع الصافي من الموقف الطويل بأكثر من 24٪. هذا التحول في التوجيهيات الصافية غير التجارية يمكن تنفيذه على الفور دون أي حسابات من جانب العميل.

مثال عملي: حالة السلع في Python

بدلا من إجراء استطلاع على كل سلعة بشكل مستقل على جدول زمني، /latest تعيد نقطة النهاية جميع مؤشرات السلع المدعومة في مكالمة واحدة. هنا مثال Python الحد الأدنى الذي يحصل على اللقطة الكاملة ويشير إلى أي سلعة تحركت أكثر من 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 مرة واحدة لتجديد صورة حالتك الحالية. إذا كنت بحاجة إلى سياق أعمق للمؤشر المطبوع الاتجاه، المقارنة الموسمية، تاريخ التحديث متابعة مع مكالمة مستهدفة كاملة لسلسلة إلى هذا المؤشر المحدد.

هذا يبقي حجم الطلبات الإجمالي متناسبًا مع عدد العملات التي تنشر بالفعل البيانات في جلسة معينة وليس بحجم مخزون المؤشرات الخاص بك.

ابدأ

إعلانات الدولار الأمريكي عامة. جميع إعلامات العملات الأخرى، بيانات COT، وأسعار السلع تتطلب مفتاح API مصادق عليه يتم توفيره عبر ?api_key= معيار الاستفسار