FXMacroData: Dados Macroeconômicos e de Câmbio

Visão Geral

FXMacroData é uma API REST para dados macroeconômicos extraídos de publicadores oficiais (escritórios de estatística, bancos centrais, a CFTC). Ela cobre 22 moedas: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD e USD. Cada série carrega seu publicador, URL de origem e o horário em que o número foi divulgado, para que as respostas possam citar de onde um valor veio e quando ele se tornou público.

Esta funcionalidade cobre a descoberta de "slugs" de indicadores, a obtenção do histórico de divulgações, a leitura do calendário de divulgações, a comparação de taxas de política entre duas moedas e os limites de acesso que se aplicam sem uma chave de API.

Quando Usar

• Use quando o usuário solicitar um dado macro oficial para um país ou moeda: IPC, inflação subjacente, PIB, desemprego, folha de pagamento, vendas no varejo, confiança empresarial e do consumidor, balança comercial, rendimentos de títulos.
• Use quando o usuário perguntar quando o próximo IPC, folha de pagamento, PIB ou decisão do banco central está previsto, ou quiser o calendário de divulgações para uma semana.
• Use ao comparar taxas de política de bancos centrais ou diferenciais de rendimento entre duas moedas (por exemplo, "carry" USD vs JPY).
• Use quando o usuário quiser taxas de referência de câmbio diárias ou o posicionamento "Commitments of Traders" da CFTC para um futuro de moeda.
• Não use para dados de "tick" intraday, ações, criptomoedas ou execução de ordens. Estes são dados de referência somente leitura.

Acesso e Autenticação

• URL Base: https://api.fxmacrodata.com/v1
• A autenticação é opcional. Se o usuário tiver uma chave, leia-a da variável de ambiente FXMACRODATA_API_KEY e envie-a no cabeçalho X-API-Key. Nunca coloque a chave na URL ou a imprima na saída.
• Sem chave:
  • Indicadores dos EUA, o calendário de divulgações dos EUA, o catálogo de dados dos EUA e os dados COT dos EUA funcionam.
  • Os dados de anúncios dos EUA são atrasados em 15 minutos. Cada resposta inclui um objeto freemium_delay com o horário de corte e withheld_count, o número de divulgações mais recentes que o horário de corte.
  • O histórico é limitado aos 90 dias mais recentes. O objeto freemium_window mostra a data de corte aplicada, e requested_start_date na resposta mostra a data de início realmente utilizada.
• Todas as outras moedas, /forex, /rate_differentials e /commodities precisam de uma chave. Sem uma, elas retornam HTTP 401 com "code": "api_key_required". Isso significa que os dados existem, mas precisam de uma assinatura; não relate como ausentes.

# Keyless (USD only)
curl -s "https://api.fxmacrodata.com/v1/announcements/usd/policy_rate?limit=3"

# With a key, from the environment
curl -s -H "X-API-Key: $FXMACRODATA_API_KEY" \
  "https://api.fxmacrodata.com/v1/announcements/eur/policy_rate?limit=3"

Endpoints

Códigos de moeda e "slugs" de indicadores são em minúsculas nos caminhos (usd, policy_rate).

Parâmetros de consulta comuns

Formato da Resposta

Respostas de anúncios carregam metadados (source, source_url, source_series_name, seasonal_adjustment, pagination) e um array data. Cada linha tem:

…