Memperkenalkan Mata Uang Akhir Terbaru: Satu Panggilan untuk Potret Makro Lengkap

Pemindaian keadaan makro mata uang digunakan untuk berarti menembakkan panggilan API terpisah untuk setiap indikator satu untuk inflasi, satu untuk pengangguran, satu bagi suku bunga kebijakan, dan sebagainya. Mulai hari ini, Anda dapat mengambil nilai terbaru, cetakan sebelumnya, dan perubahan persentase periode-over-periode untuk setiap indicator dalam satu permintaan yang disahkan. Pola panggilan satu kali yang sama sekarang tersedia untuk posisi COT dan harga komoditas.

Apa yang baru?

Tiga yang baru. /latest titik akhir agregat hidup di FXMacroData API:

Setiap jawaban termasuk tingkat atas as_of Setiap entri indikator mengikuti bentuk yang konsisten:

• indikator slug kanonik yang cocok dengan titik akhir pengumuman
• Unit Dan frekuensi dari katalog data, sehingga Anda dapat memformat nilai dengan benar tanpa pencarian kedua
• Terbaru dateAku akan pergi. val, dan announcement_datetime dari cetakan terbaru
• sebelumnya pengamatan sebelumnya di bidang yang sama
• pct_diff_prev perubahan persentase yang dihitung sebelumnya dari sebelumnya ke terakhir, dibulatkan ke dua tempat desimal

Untuk data COT, pct_diff_prev adalah peta bukan skalar satu persentase perubahan per bidang posisi numerik (keuntungan terbuka, non-komersial panjang dan pendek, posisi bersih, dan sebagainya) karena snapshot COT penuh adalah multidimensi.

Mengapa Hal Ini Penting bagi Pedagang

Jika sistem Anda memantau tujuh mata uang seperti USD, EUR, GBP, AUD, JPY, CAD, dan CHF dengan sepuluh sampai lima belas indikator masing-masing, loop jajak pendapat yang naif dapat membutuhkan lebih dari seratus panggilan API individu untuk memperbarui dasbor atau memberi makan model.

- Apa? /latest Endpoint yang dibaca dari toko pengumuman Firestore data yang sama yang mendukung seri historis penuh sehingga tidak ada cache terpisah atau lag yang diperkenalkan oleh panggilan agregat.

Contoh Praktis: USD Macro Snapshot

Anda sedang memantau gambaran makro AS sebelum New York dibuka. /latest titik akhir mengembalikan keadaan saat ini dari setiap indikator dilacak, masing-masing dengan cetakan sebelumnya dan perubahan di antara mereka:

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

Tanggapan representatif (dipotong menjadi tiga indikator):

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

Dari satu tanggapan ini pedagang atau model dapat langsung membaca judul itu Inflasi USD Perekonomian di Eropa mengalami penurunan sedikit dari bulan ke bulan sementara gaji non-pertanian meningkat secara signifikan dibandingkan bulan sebelumnya. tingkat pengangguran Kombinasi pekerjaan yang lebih kuat terhadap inflasi yang lebih lemah cukup untuk membentuk pandangan tentang jalur Fed jangka pendek tanpa membuka permintaan kedua.

Contoh Praktis: EUR/USD COT Scan

Laporan Komitmen Pedagang CFTC diterbitkan setiap minggu. /latest Endpoint mengembalikan snapshot lengkap terbaru bersama snapshot minggu sebelumnya, dengan perubahan persentase per bidang. fx_overlay pasangan untuk overlay grafik:

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

Jawaban perwakilan:

{
  "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
  }
}

Dalam satu tanggapan, sistem posisi dapat melihat bahwa EUR panjang spekulatif meningkat 7,74% minggu ke minggu sementara pendek menyusut 2,86%, memperluas posisi panjang bersih lebih dari 24%.

Contoh Praktis: Komoditas Negara di Python

Alih-alih memilih setiap komoditas secara independen pada jadwal, komoditi /latest Endpoint mengembalikan semua indikator komoditas yang didukung dalam satu panggilan. Berikut ini contoh Python minimal yang mengambil snapshot penuh dan menandai komoditi yang telah bergerak lebih dari 2% sejak cetakan sebelumnya:

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)

Skrip ini membuat panggilan API tunggal terlepas dari berapa banyak indikator komoditas yang dilacak. Swap ambang atau memperluas kondisi filter untuk membangun aturan peringatan komoditi yang sesuai dengan strategi Anda.

Bagaimana Itu Cocok dengan Penutupan Pengumuman Lengkap

- Apa? /latest titik akhir dirancang untuk kesadaran keadaan, bukan sejarah. ketika Anda membutuhkan seri waktu backtesting, membangun rata-rata bergerak, menghitung perbandingan YoY, atau menggambar grafik menggunakan penuh pengumuman titik akhir Jika Anda ingin mengetahui keadaan makro mata uang saat ini, gunakan /latest.

- Apa? /latest Endpoint bekerja dengan baik dalam alur kerja yang didorong oleh acara: poll kalender rilis untuk mengetahui kapan cetak akan terjadi, kemudian hubungi /latest Jika Anda membutuhkan konteks yang lebih dalam untuk indikator cetak tren, perbandingan musiman, riwayat revisi ikuti dengan panggilan seri penuh yang ditargetkan ke indikator tertentu.

Hal ini membuat total volume permintaan proporsional dengan berapa banyak mata uang yang benar-benar menerbitkan data dalam sesi tertentu bukan dengan ukuran persediaan indikator Anda.

Mulailah

Pengumuman USD bersifat publik. Semua pengumuman mata uang lainnya, data COT, dan harga komoditas memerlukan kunci API yang otentikasi yang diberikan melalui ?api_key= parameter kueri.