Introducing the Release Calendar Endpoint

O ponto final do calendário de lançamento do FXMacroData está agora ativo. Em uma chamada, você pode recuperar os carimbos de tempo de lanço próximos para uma moeda, filtrar para um indicador quando necessário e agendar buscas de anúncios de acompanhamento contra o segundo exato de publicação.

O que há de novo?

A rota de lançamento da produção é: /api/v1/calendar/{currency}, com opcional ?indicator=... Em vez de manter manualmente os calendários do banco central e do gabinete de estatísticas, pode consultar um único ponto final de produção e receber linhas de publicação ordenadas por tempo.

Cada linha é construída em torno de dois campos principais:

• libertação - o indicador canónico utilizado pelos endpoints de anúncios, como inflation- Não . policy_rate- Não . unemploymentOu ... non_farm_payrolls
• Anúncio_data/hora - o carimbo de data e hora da publicação UTC utilizado para a programação e estudos de eventos

Alguns cronogramas de domínio misto também incluem metadados de roteamento aditivo , como endpoint_family- Não . endpoint_path- Não . titleE ... schedule_statusEsses campos ajudam os clientes a rotear a próxima solicitação, mas o fluxo de trabalho de cronometragem ainda começa com release - Mais . announcement_datetime- Não .

Por que é importante

Os macros não são lançados em intervalos perfeitamente regulares. Os bancos centrais publicam calendários de reuniões com bastante antecedência, enquanto o IPC, PIB, trabalho e liberações comerciais podem mudar de mês para mês. Se você estiver pesquisando a cada cinco minutos, você ou desperdiça pedidos ou aceita latência evitável.

Exemplo prático: Programação da taxa de juro de política do AUD

Suponha que você só se importa com a próxima decisão do RBA. policy_rate - Não .

curl "https://fxmacrodata.com/api/v1/calendar/aud?indicator=policy_rate&api_key=YOUR_API_KEY"

Resposta representativa:

{
  "currency": "AUD",
  "indicator": "policy_rate",
  "data": [
    {
      "announcement_datetime": 1773077400,
      "release": "policy_rate"
    }
  ]
}

Isso diz ao seu agendador quando acordar e ligar . o ponto final do anúncio da taxa de juro da política de divisas do AUDO calendário diz-te . Quando? O próximo evento chega; o ponto final de anúncios diz-lhe . - O que é ? Impresso assim que aterrar.

Exemplo prático: US$ Semana de Anterior

Se quiser a programação mais ampla do USD, consulte a moeda sem um filtro de indicador e revise os próximos lançamentos em ordem cronológica.

curl "https://fxmacrodata.com/api/v1/calendar/usd"

Resposta representativa:

{
  "currency": "USD",
  "indicator": null,
  "data": [
    {
      "announcement_datetime": 1773077400,
      "release": "inflation"
    },
    {
      "announcement_datetime": 1773682200,
      "release": "non_farm_payrolls"
    }
  ]
}

Isto é suficiente para construir janelas de risco pré-lançamento, suprimir um modelo durante eventos macro conhecidos, ou fila de recuperações de acompanhamento para o Inflação em USD E ... Lista de salários não agrícolas em USD Pontos finais quando esses carimbos de tempo chegarem.

Como se encaixa com o ponto final dos anúncios

O calendário de lançamento é intencionalmente restrito: ele informa qual é o próximo lançamentos e quando é programado. /api/v1/announcements/{currency}/{indicator} Para obter a série histórica lançada e ler a última linha no retorno data - A linha.

Essa divisão mantém a lógica de agendamento limpa. Você consulta o calendário para o tempo, em seguida, consulta o ponto final de anúncios para valores e histórico de anuncio.

Comece

O acesso ao calendário USD é público. Outras moedas suportadas exigem uma chave API. Comece com uma chamada de teste gratuita USD, em seguida, passe para fluxos de trabalho de moeda autenticados uma vez que seu agendador esteja ligado.