Introdução do último ponto final da moeda: Um chamado para o instantâneo completo da macro

Anteriormente, a digitalização do estado macro de uma moeda significava disparar uma chamada API separada para cada indicador uma para inflação, uma para desemprego, uma pela taxa de juros, e assim por diante. A partir de hoje, você pode recuperar o valor mais recente, a impressão anterior e a mudança percentual do período sobre o período para cada indicado em uma única solicitação autenticada. O mesmo padrão de chamada única está agora disponível para posicionamento COT e preços de commodities.

O que há de novo?

Três novos . /latest Os endpoints agregados estão a funcionar na API FXMacroData:

Cada resposta inclui um nível superior . as_of Cada entrada de indicador segue uma forma consistente:

• indicador o "slug" canónico correspondente ao ponto final dos anúncios
• unidade E ... frequência do catálogo de dados, para que possa formatar os valores corretamente sem uma segunda consulta
• mais recente - Não . date- Não . valE ... announcement_datetime da edição mais recente
• anterior a observação anterior nos mesmos domínios
• pct_diff_prev variação percentual pré-computada da anterior para a última, arredondada para duas casas decimais

Para os dados COT, pct_diff_prev é um mapa em vez de um escalar uma variação percentual por campo de posicionamento numérico (interesse aberto, posições longas e curtas não comerciais, posição líquida, etc.) porque o instantâneo completo do COT é multidimensional.

Por que é importante para os comerciantes

Se o seu sistema monitora sete moedas algo como USD, EUR, GBP, AUD, JPY, CAD e CHF com dez a quinze indicadores cada, um ciclo de sondagem ingênuo pode exigir mais de cem chamadas individuais de API para atualizar um painel ou alimentar um modelo. Além da sobrecarga da rede, essa abordagem também significa processar estado parcial: o valor da inflação em USD pode ser dois segundos mais velho que o valor do desemprego em USD, dependendo de quando cada solicitação for concluída.

O ... /latest Os endpoints lidos da loja de anúncios do Firestore os mesmos dados que suportam a série histórica completa para que não haja cache separado ou atraso introduzido pela chamada agregada. Os dados que você obtém são idênticos a consultar cada indicador individualmente.

Exemplo prático: USD Macro Snapshot

Estão a monitorizar o panorama dos EUA antes da abertura de Nova Iorque. /latest Endpoint retorna o estado actual de cada indicador rastreado, cada um com a sua impressão anterior e a alteração entre eles:

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

Resposta representativa (truncada em três indicadores):

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

A partir desta única resposta um comerciante ou modelo pode ler imediatamente esse título Inflação em USD Os salários das empresas não agrícolas foram significativamente mais elevados do que no mês anterior. taxa de desemprego A combinação emprego mais forte contra inflação mais fraca é suficiente para moldar uma visão sobre a trajetória do Fed no curto prazo sem abrir uma segunda solicitação.

Exemplo prático: EUR/USD COT Scan

Os relatórios do Compromiss of Traders da CFTC são publicados semanalmente. /latest O endpoint retorna o instantâneo completo mais recente junto com o do mês anterior, com alterações porcentuais por campo. fx_overlay par para sobreposições de gráficos:

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

Resposta representativa:

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

Em uma resposta, um sistema de posicionamento pode ver que os longs especulativos do EUR aumentaram 7,74% semana a semana, enquanto os shorts contraíram 2,86%, ampliando a posição longa líquida em mais de 24%.

Exemplo prático: Estado de mercadorias em Python

Em vez de pesquisar cada mercadoria de forma independente num calendário, as mercadorias /latest endpoint retorna todos os indicadores de commodities suportados em uma única chamada. Aqui está um exemplo de Python mínimo que recupera o instantâneo completo e sinaliza qualquer commodity que tenha se movido mais de 2% desde sua impressão anterior:

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)

O script faz uma única chamada de API independentemente de quantos indicadores de commodities são rastreados.

Como se encaixa com o ponto final de anúncios completos

O ... /latest Quando você precisa de uma série de tempo backtesting, construção de médias móveis, computação de comparações de ano a ano, ou desenho de um gráfico use o completo Anúncios ponto final Quando você precisa saber o estado macroeconômico atual de uma moeda agora, use /latest- Não .

O ... /latest O endpoint funciona bem em fluxos de trabalho orientados por eventos: pesquise o calendário de lançamento para saber quando uma impressão é prevista, e depois ligue /latest Se precisar de um contexto mais profundo para o indicador impresso tendência, comparação sazonal, histórico de revisões , siga-se com uma chamada direcionada de série completa para esse indicador específico.

Isto mantém o volume total de pedidos proporcional ao número de moedas que publicam efectivamente dados numa determinada sessão e não ao tamanho do seu inventário de indicadores.

Comece

Todos os outros anúncios de moeda, dados COT e preços de commodities requerem uma chave API autenticada fornecida através do ?api_key= Parâmetro de consulta.