No final deste guia, você será capaz de autenticar corretamente, escolher a família de endpoints certa para cada tarefa e fazer solicitações prontas para produção através da API FXMacroData sem adivinhar a estrutura da rota ou a cobertura do indicador.
Requisitos prévios
- Uma conta FXMacroData e uma chave API para solicitações não USD
- Um terminal com ...
curlou um tempo de execução como Python/Node.js - Familiarização básica com respostas JSON e parâmetros de consulta de URL
- Acesso aos documentos ao vivo em /documentação/
Passo 1 - Começar com a URL da base de produção
Todos os exemplos públicos devem começar a partir da base de produção API:
https://fxmacrodata.com/api/v1As famílias de endpoints que mais usará são:
/announcements/{currency}/{indicator}para valores históricos liberados com precisãoannouncement_datetime/calendar/{currency}para os próximos carimbos de lançamento/catalogue/{currency}para a identificação dos indicadores apoiados/cot/{currency}para posicionamento de compromissos de operadores/commodities/{indicator}para séries de matérias-primas e energia/forex/{pair}E .../market-sessionspara o contexto de mercado
Passo 2 - Autenticação correta com parâmetros de consulta
O FXMacroData usa autenticação por parâmetro de consulta em exemplos de uso público:
?api_key=YOUR_API_KEYO acesso ao ponto final USD está disponível sem uma chave, enquanto as rotas não USD exigem uma chave válida.
# USD endpoint (no key required)
curl "https://fxmacrodata.com/api/v1/announcements/usd/inflation"
# Non-USD endpoint (key required)
curl "https://fxmacrodata.com/api/v1/announcements/aud/policy_rate?api_key=YOUR_API_KEY"Passo 3 - Descubra o que está disponível antes de codificar
Quando não tiver certeza de quais indicadores existem para uma moeda, deve ligar primeiro para a rota do catálogo, evitando assim suposições de codificação rigorosa.
curl "https://fxmacrodata.com/api/v1/catalogue/eur?api_key=YOUR_API_KEY"Em seguida, use o índice da página do indicador em o índice de indicadores de documentação Para confirmar os percursos e os campos esperados.
Passo 4 - Extrair dados liberados dos endpoints de anúncios
Os pontos finais de anúncio retornam um objeto de nível superior mais um data Cada linha inclui um período de fim date- Não . valE um announcement_datetime - Marca de tempo.
curl "https://fxmacrodata.com/api/v1/announcements/gbp/unemployment?api_key=YOUR_API_KEY"{
"currency": "GBP",
"indicator": "unemployment",
"has_official_forecast": false,
"start_date": "2025-01-31",
"end_date": "2026-03-31",
"data": [
{
"date": "2026-01-31",
"val": 4.39,
"announcement_datetime": 1770521400
}
]
}Para saber a semântica e as unidades exatas dos indicadores, consulte as páginas de endpoints, como Taxa de política do dólar E ... Inflação em euros- Não .
Passo 5 - Utilize o calendário de lançamento para fluxos de trabalho orientados por eventos
O calendário de lançamento ajuda você a agendar as buscas em torno do momento da publicação em vez de pesquisas continuamente.
curl "https://fxmacrodata.com/api/v1/calendar/usd?indicator=non_farm_payrolls"
Um padrão robusto é: calendário de consulta -> ler em seguida announcement_datetime -> busque a rota correspondente de anúncios no momento do lançamento.
Passo 6 - Adicionar famílias de endpoints suplementares
Uma vez que o seu fluxo de anúncios básicos está estável, estenda a cobertura com rotas específicas de domínio:
- COT:
/api/v1/cot/{currency}para o contexto do posicionamento de futuros - Outros metais:
/api/v1/commodities/{indicator}para o ouro, prata, platina e insumos de abrigo seguro relacionados - Forex:
/api/v1/forex/{pair}para o alinhamento spot com as macros - Sessões de mercado:
/api/v1/market-sessionspara automação de estado de sessão
curl "https://fxmacrodata.com/api/v1/cot/usd"
curl "https://fxmacrodata.com/api/v1/commodities/gold"
curl "https://fxmacrodata.com/api/v1/forex/eurusd"
curl "https://fxmacrodata.com/api/v1/market-sessions"Passo 7 - Exemplo de Python de ponta a ponta
O snippet abaixo verifica a disponibilidade, recupera uma série de indicadores e retorna a impressão mais recente.
import requests
BASE = "https://fxmacrodata.com/api/v1"
API_KEY = "YOUR_API_KEY"
def fetch_latest(currency: str, indicator: str, api_key: str | None = None) -> dict | None:
params = {}
if api_key:
params["api_key"] = api_key
catalogue = requests.get(f"{BASE}/catalogue/{currency}", params=params, timeout=10)
catalogue.raise_for_status()
endpoint = requests.get(
f"{BASE}/announcements/{currency}/{indicator}",
params=params,
timeout=10,
)
endpoint.raise_for_status()
rows = endpoint.json().get("data", [])
return rows[-1] if rows else None
latest = fetch_latest("aud", "policy_rate", API_KEY)
print(latest)
O que pode construir a seguir
Agora você tem o caminho completo para autenticar, descobrir cobertura, solicitar séries de lançamento históricas e expandir para automação orientada por calendário. Como usar a API do calendário de lançamento Assim, o seu sistema reage exatamente quando novos dados macro são publicados.
